This project will require careful adjustment of build systems in the htdocs repository and those used by the pkgsrc guide.Ī working proposal should demonstrate one page (of the website, pkgsrc guide, or NetBSD guide), converted to asciidoc and hooked up to the build system, integrated, with reasonable looking output. We might leverage this so we can convert the website step-by-step, and keep the existing templates. There is a tool for converting DocBook to asciidoc, but it is likely not perfect, and output will require manual adjustment:Īsciidoc itself can also output DocBook. It preserves the same advantages as DocBook: easy conversion to PDF and other formats for book distribution, and rich semantics. NetBSD has large amounts of documentation in XML DocBook: the Guide, the pkgsrc Guide, large parts of the website.Īsciidoc is a much nicer, friendlier format than XML.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |