Re: manual in sgml
Hello Osamu, thanks for the hint: I have just midified accordingly the `debian/control' file. On 10/03/15 16:40, Osamu Aoki wrote: Hi, On Mon, Mar 09, 2015 at 08:17:53PM +0100, Jerome BENOIT wrote: Hello List, the manual of my package is written in SGML language. I guess that it may be translate into a more readable format: What is the best Debian way to convert it in HTML and/or PDF (via LaTeX) ? If it is linuxdoc, please consider to use debiandoc-sgml which is superset of linuxdoc as I understand as its maintainer. If it is SGML with old DocBook, use dockbook tool chain. You can see debian-faq and several other packages building HTML and/or PDF from SGML. Please note converting to PDF from the tables in DocBook SGML is not easy especially for non-English as I see the state of the tool chain. SGML and XML is minimal difference for DocBook case. Please check exsisting packages :-) Osamu Cheers, Jerome -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org Archive: https://lists.debian.org/54ff2378.7010...@rezozer.net
Re: manual in sgml
Hi, On Mon, Mar 09, 2015 at 08:17:53PM +0100, Jerome BENOIT wrote: Hello List, the manual of my package is written in SGML language. I guess that it may be translate into a more readable format: What is the best Debian way to convert it in HTML and/or PDF (via LaTeX) ? If it is linuxdoc, please consider to use debiandoc-sgml which is superset of linuxdoc as I understand as its maintainer. If it is SGML with old DocBook, use dockbook tool chain. You can see debian-faq and several other packages building HTML and/or PDF from SGML. Please note converting to PDF from the tables in DocBook SGML is not easy especially for non-English as I see the state of the tool chain. SGML and XML is minimal difference for DocBook case. Please check exsisting packages :-) Osamu -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org Archive: https://lists.debian.org/20150310154041.GB2313@goofy.local
Re: manual in sgml
the manual of my package is written in SGML language. I guess that it may be translate into a more readable format: What is the best Debian way to convert it in HTML and/or PDF (via LaTeX) ? I recently had to deal with this problem myself, when packaging the documentation for granule. If there are Makefiles distributed with the SGML, it might be easier, but otherwise, you can just use the relevant commands. Firstly, you should install the docbook-utils package. Then, for html, you can use the command db2html -i online path/to/file.sgml As for PDF and PS formats, I'm not sure. You might be able to use other tools in the docbook-utils package, though. pgpUHUbJH0o6u.pgp Description: PGP signature
Re: manual in sgml
Hello Riley, thanks for your prompt reply. Meanwhile I realized that it is a linuxdoc document: what I need can be found in the following page: https://www.debian.org/doc/manuals/sgml-howto/x277.html On 09/03/15 20:49, Riley Baird wrote: the manual of my package is written in SGML language. I guess that it may be translate into a more readable format: What is the best Debian way to convert it in HTML and/or PDF (via LaTeX) ? I recently had to deal with this problem myself, when packaging the documentation for granule. If there are Makefiles distributed with the SGML, it might be easier, but otherwise, you can just use the relevant commands. Firstly, you should install the docbook-utils package. Then, for html, you can use the command db2html -i online path/to/file.sgml As for PDF and PS formats, I'm not sure. You might be able to use other tools in the docbook-utils package, though. Best wishes, Jerome -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org Archive: https://lists.debian.org/54fdfbcb.9010...@rezozer.net
Re: manual in sgml
On 09/03/15 21:00, Jerome BENOIT wrote: Hello Riley, thanks for your prompt reply. Meanwhile I realized that it is a linuxdoc document: what I need can be found in the following page: https://www.debian.org/doc/manuals/sgml-howto/x277.html which contains obsolete material: a better start may be here: https://packages.debian.org/jessie/linuxdoc-tools On 09/03/15 20:49, Riley Baird wrote: the manual of my package is written in SGML language. I guess that it may be translate into a more readable format: What is the best Debian way to convert it in HTML and/or PDF (via LaTeX) ? I recently had to deal with this problem myself, when packaging the documentation for granule. If there are Makefiles distributed with the SGML, it might be easier, but otherwise, you can just use the relevant commands. Firstly, you should install the docbook-utils package. Then, for html, you can use the command db2html -i online path/to/file.sgml As for PDF and PS formats, I'm not sure. You might be able to use other tools in the docbook-utils package, though. Best wishes, Jerome hth, Jerome -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org Archive: https://lists.debian.org/54fdfe06.9050...@rezozer.net
Re: manual in sgml
Hi, it appears that it is LinuxDoc document: https://www.debian.org/doc/manuals/sgml-howto/x277.html Sorry for the noise, Jerome On 09/03/15 20:17, Jerome BENOIT wrote: Hello List, the manual of my package is written in SGML language. I guess that it may be translate into a more readable format: What is the best Debian way to convert it in HTML and/or PDF (via LaTeX) ? Thanks in advance, Jerome -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org Archive: https://lists.debian.org/54fdfb26.7090...@rezozer.net
manual in sgml
Hello List, the manual of my package is written in SGML language. I guess that it may be translate into a more readable format: What is the best Debian way to convert it in HTML and/or PDF (via LaTeX) ? Thanks in advance, Jerome -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org Archive: https://lists.debian.org/54fdf1e1.2010...@rezozer.net
Re: manual in sgml
On Tue, Mar 10, 2015 at 3:17 AM, Jerome BENOIT wrote: the manual of my package is written in SGML language. I guess that it may be translate into a more readable format: What is the best Debian way to convert it in HTML and/or PDF (via LaTeX) ? It sounds like this is a manual that is only available in Debian? If so please talk to upstream about including it and ask what format they would prefer for documentation source. Personally I would recommend one of the plain text formats like markdown or reStructuredText. Then work out the conversion method. The pandoc package has a lot of different converters. Once that is done and the documentation is converted to upstream's preferred documentation source format, they will need to add build-time conversion to an end-user format. In Debian we recommend man or HTML but they probably will want different formats depending on the platform. For example on Windows they will probably want CHM format. -- bye, pabs https://wiki.debian.org/PaulWise -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org Archive: https://lists.debian.org/CAKTje6G9=byPgHTnvch-B8MEZkFbAvY=6nood2vwqkbo6as...@mail.gmail.com
