Re: Manpages konvertieren nach dvi / pdf / html / amazon kindle (troff, groff, kindlegen)

[Raphael Eiselstein <rabe@xxxxxxxxx>]

Hi Christian,

On Mo, Jan 02, 2012 at 01:07:52 +0000, Christian Weisgerber wrote:
> Raphael Eiselstein <rabe@xxxxxxxxx> 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@xxxxxxxxxx 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@xxxxxxxxx>               http://rabe.uugrn.org/
xmpp:freibyter@xxxxxx  | 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/