[<<] [<] Page 1 of 1 [>] [>>] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Subject:
ldptool complete: was [1. automation of source to output
publication]
From: "Martin A. Brown" ####@####.#### Date: 14 Mar 2016 19:25:35 +0000 Message-Id: <alpine.LSU.2.11.1603141053510.12423@znpeba.jbaqresebt.arg> Greetings TLDP, I am happy to report success. I am releasing a tested [0], working utility called 'ldptool' furnished as part of python-tldp-0.5.5, which can process all of TLDP's source documents [1] [2] and generate chunked and single-page HTML, PDF and textual outputs for each. Source document formats supported are: * Linuxdoc # 226 documents in collection * AsciiDoc # 0 documents in collection * DocBook XML 4.x # 129 documents in collection * DocBook 5.x # 1 document in collection * DocBook SGML 4.x # 66 documents in collection * DocBook SGML 3.x # 80 supported, but no longer accepted The ldptool does not yet produce an ePub output format. I will write separately about that. If anybody is interested in code review, ad-hoc testing or pointing out my documentation gaps (sorry, no manpage yet, though there is a README.rst and basic --help). In short, I am ready to roll this out, -Martin [0] The code coverage module reports 93% coverage when running both the integration tests and the unit tests. In addition, I have repeatedly processed all of our documents into the supported outputs, a process which takes only 45-50m. [1] The HOWTO-INDEX, which was a generated document, does not validate. This is part of the metadata problem. I plan to spend some time with Greg Ferguson's code and see what can be done here. The HOWTO-INDEX is pretty useful, so it would be good to be able to generate it again, even if the tools are different. [2] The PHP-Nuke-HOWTO uses an array of parameter entities to control the image choice at output production time. On OpenSUSE, I can build the document fine. On Debian, it still has fits. This is a bug, and I will attend to this, but of the 503 documents, this is the only unsolved processing item. -- Martin A. Brown http://linux-ip.net/ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
[<<] [<] Page 1 of 1 [>] [>>] |