Re: Manpages konvertieren nach dvi / pdf / html / amazon kindle (troff, groff, kindlegen)
From
Raphael Eiselstein <rabe@...>
Date
Hi Christian,
On Mo, Jan 02, 2012 at 01:07:52 +0000, Christian Weisgerber wrote:
> Raphael Eiselstein <rabe@...> wrote:
> > * Wie erzeuge ich aus manpage-sourcen html Version 2.0? -T html sieht
> > schlimm aus, der html-Output enthaelt keinerlei Absatzformatierung.
>
> Du hast vergessen, das Makro-Paket anzugeben.
> $ gzip -cd /usr/share/man/man1/ls.1.gz | groff -mandoc -Thtml
Danke, das war es. Damit klappt es wie erwartet.
Hier nochmal die Steps:
1. fbsd$ gzip -cd /usr/share/man/man5/rc.conf.5.gz | groff -mandoc -Thtml > man_5_rc.conf.html
2. linux$ kindlegen man_5_rc.conf.html
**************************************************
* Amazon.com kindlegen(Linux) V1.2 build 33307 *
* A command line e-book compiler *
* Copyright Amazon.com 2011 *
**************************************************
Info(prcgen): Added metadata dc:Title "man_5_rc.conf"
Info(prcgen): Parsing files 0000002
Info(prcgen): Resolving hyperlinks
Info(pagemap): No Page map found in the book
Warning(prcgen): Cover not specified
Info(prcgen): Computing UNICODE ranges used in the book
Info(prcgen): Found UNICODE range: Basic Latin [20..7E]
Info(prcgen): Found UNICODE range: General Punctuation - Windows 1252 [2013..2014]
Info(prcgen): Found UNICODE range: Miscellaneous Technical [2300..23FF]
Info(prcgen): Found UNICODE range: Mathematical Operators [2200..22FF]
Info(prcgen): Building MOBI file, record count: 0000041
Info(prcgen): Final stats - text compressed to (in % of original size): 036.08%
Info(prcgen): The document identifier is: "man_5_rc.conf"
Info(prcgen): The file format version is V5
Info(prcgen): Saving MOBI file
Info(prcgen): MOBI File generated with WARNINGS!
3. linux$ ls -l man_5_rc.conf.html man_5_rc.conf.mobi
-rw-r--r-- 1 rabe rabe 148239 2012-01-02 15:58 man_5_rc.conf.html
-rw-r--r-- 1 rabe rabe 97078 2012-01-02 15:59 man_5_rc.conf.mobi
4. Per Mail oder sonstwie an alias@... verschicken (muss
natuerlich eingerichtet sein!)
Ich habe den Anfang von rc.conf(5) auf meinem Kindle fotografiert,
jeweils mit verschiedenen Schriftgraden und Zeilenabstaenden und in
verschiedenen Orientierungen (Portrait, Landscape):
http://rabe.uugrn.org/files/tmp/ManPageKindle/
Abgesehen vom fehlenden Cover und TOC ist es damit so gut benutzbar wie
ein e-book, also auch durchsuchbar oder wer es mag auch ueber den
eingebauten Sprachsynthesizer vorlesbar ("text-to-speech"), das klingt
sogar ganz brauchbar, d.h. man kann ihm gut folgen.
Ist fuer mich jedenfalls nahe an dem, was ich gesucht habe.
Todo / Ausblick:
* Mehrere Manpages zu einem ebook kompilieren
* TOC
* Cover
Evtl ist es mit bisschen Extraaufwand machbar alle Manpages als Kapitel
eines grossen e-Books zu kompilieren. Das TOC ergaebe sich dann aus den
jeweiligen Manpages und das Cover waere die Kuer. Mal sehen.
> > Wer kennt bessere Alternativen oder Ansaetze zur Konvertierung von
> > troff-sourcen in ein kindle-taugliches format?
>
> Fuer beliebige roff-Dokumente nur groff -Thtml. Speziell fuer in
> mdoc(7) geschriebene Man-Pages bietet sich mandoc(1) an; in man(7)
> geschriebene werden mehr oder minder auch unterstuetzt.
Ich bin primaer darauf aus, die FreeBSD manpages zu konvertieren, darueber
hinaus aber auch alles andere, was der OpenSource-Zoo zu bieten hat. So
gesehen ist groff fuer mich ein sinnvolles tool.
Viele Gruesse
Raphael
--
Raphael Eiselstein <rabe@...> http://rabe.uugrn.org/
xmpp:freibyter@... | https://www.xing.com/profile/Raphael_Eiselstein
GnuPG: E7B2 1D66 3AF2 EDC7 9828 6D7A 9CDA 3E7B 10CA 9F2D
.........|.........|.........|.........|.........|.........|.........|..
--
UUGRN e.V. http://www.uugrn.org/
http://mailman.uugrn.org/mailman/listinfo/uugrn
Wiki: https://wiki.uugrn.org/UUGRN:Mailingliste
Archiv: http://lists.uugrn.org/