Write a markdown - Docbook converter The NetBSD Project
Status: Closed Time to complete: 144 hrs Mentors: Julian Coleman, Julian Fagir Tags: C, docbook, research, markdown

This is not strictly for NetBSD, but about another project named libsoldout: http://fossil.instinctive.eu/libsoldout/home

libsoldout is a markdown converter written in C and published under public domain. There are already other tools which do this (markdown-docbook conversion), but they either have a strange licence or many dependencies.

Your task now is to write a renderer which renders markdown to docbook.

You can take the html, man or html converters from the libsoldout website as an example or template.


Uploaded Work
File name/URL File size Date submitted
md2db.zip 55.9 KB December 31 2012 16:08 UTC
mkd2docbook.zip 55.4 KB January 01 2013 03:48 UTC
wmzhere on December 30 2012 03:34 UTC Task Claimed

I would like to work on this task.

Aleksej Saushev on December 30 2012 14:31 UTC Task Assigned

This task has been assigned to wmzhere. You have 144 hours to complete this task, good luck!

wmzhere on December 31 2012 16:08 UTC Ready for review

The work on this task is ready to be reviewed.

Julian Fagir on December 31 2012 17:53 UTC Great!

Thank you very much, the result is great! There are just three caveats:

  • Could you please put everything in one source file, such that it can be included in the base libsoldout?

  • Please add also fill the hook to add a header containing the xml version tag

  • Please make it consistent with the other mk2* tools, they don't require an output file for running

  • Please add a final newline

Though I doubt it's valid for you, I wish you a happy new year. We will review the final submission next year. ;-)


Julian Fagir on December 31 2012 17:53 UTC Task Needs More Work

One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.

wmzhere on January 1 2013 03:49 UTC Ready for review

The work on this task is ready to be reviewed.

Julian Fagir on January 1 2013 21:39 UTC Very nice!

I just tried out your program, and it is indeed very good.

It won't work out-of-the-box the way you submitted it (you put a backslash in the path references, and errno.h was missing), but this is only a two-line diff.

Thank you!



Julian Fagir on January 1 2013 21:39 UTC Task Closed

Congratulations, this task has been completed successfully.

wmzhere on January 2 2013 02:56 UTC Built on Windows


Thank you for your reply. I'm sorry that I used gcc of MinGW (I'm at home using Windows)  to complie it(It's not OS-dependent) and haven't tested it on NetBSD.

I would be careful next time.