[Lumiera] Lumiera Trac #626: Documentation Style for printed documentation

[Lumiera Trac]

#626: Documentation Style for printed documentation
------------------------+-----------------------
 Reporter:  ct          |       Owner:
     Type:  todo        |      Status:  assigned
 Priority:  lesser      |   Milestone:
Component:  smallTasks  |  Resolution:
 Keywords:              |  Blocked By:  171
 Blocking:              |
------------------------+-----------------------
Changes (by ichthyo):

 * owner:  pseudoruprecht =>
 * priority:  grave => lesser
 * status:  accepted => assigned


Old description:

> As well as we working on stylesheets for HTML generation, someone needs
> to care for stylesheets and formatting of generated PDF's.
>
> This job involves a bit asciidoc/docbook/dblatex RTFM'ing and improving
> existing stylesheets or creating new ones.
>
> The default a2x pdf output looks like it enables all bells and whistles
> but it does not look nice. A non complete lists of what has to be
> investigated:
>
>  * Use Vector formats for graphics (thats already explained in ticket
> #171)
>  * Improve table rendering on pages so that they fit nice (big tables on
> their own pages in landscape?)
>  * Support different paper formats (Letter, A4, A5)
>  * duplex (book) printing, needs odd/even page numbering/styles
>  * proper generation of toc/index/glossary/titlepage and so on
>  * General style eye-candy, for example currently paragraphs get a
> "Example #." text which is improper, i have not found out how to disable
> that. Also the document revision table at the first page isn't used by
> us. Prettier recognizable fonts and general typeset/artwork.
>
> I put this little higher on the priority because it would be nice to get
> this done before FrOSCon so we can hand out some printed documentation to
> interested users ("Lumiera from Outer Space", and the NoBug manual)

New description:

 As well as we working on stylesheets for HTML generation, someone might
 investigate how to generate documents for printing (TeX or PDF)

 This job involves a bit asciidoc/docbook/dblatex RTFM'ing and improving
 existing stylesheets or creating new ones.

 The default a2x pdf output looks like it enables all bells and whistles
 but it does not look nice. A non complete lists of what has to be
 investigated:

  * Use Vector formats for graphics (thats already explained in ticket
 #171)
  * Improve table rendering on pages so that they fit nice (big tables on
 their own pages in landscape?)
  * Support different paper formats (Letter, A4, A5)
  * duplex (book) printing, needs odd/even page numbering/styles
  * proper generation of toc/index/glossary/titlepage and so on
  * General style eye-candy, for example currently paragraphs get a
 "Example #." text which is improper, i have not found out how to disable
 that. Also the document revision table at the first page isn't used by us.
 Prettier recognizable fonts and general typeset/artwork.

--

Comment:

 as far as I know, this topic isn't completely resolved yet -- on the other
 hand there is currently no urge to generate printed pages

-- 
Ticket URL: <http://issues.lumiera.org/ticket/626#comment:14>
Lumiera Issues Trac <http://lumiera.org>
Lumiera -- the new emerging NLE for GNU/Linux