[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#271951: debian-installer-manual: please document how to typeset manual in PDF using free tools

Hoi Frans,

On Sat, Sep 25, 2004 at 01:29:01PM +0200, Joost van Baal wrote:
> On Thu, Sep 16, 2004 at 09:01:06PM +0200, Joost van Baal wrote:
> > On Thu, Sep 16, 2004 at 07:46:09PM +0200, Frans Pop wrote:
> > > On Thursday 16 September 2004 13:30, Joost van Baal wrote:
> > > > I've typeset the installer manual in PostScript and PDF, since I like to
> > > > read big documents like this one from paper.  This required some
> > > > hacking.  It'd be cool if a note on how to do this (like this bugreport)
> > > > was shipped with the sources.  Or perhaps you'd like to ship a PDF with
> > > > the .deb itself.  Anyway, this is what I did:
> > > 
> > > Thank you very much for working on this and providing us with a way to 
> > > generate a PS/PDF version of the manual using free tools.
> > 
> > Beware: my patch cripples the table in 2.1.1 "Supported Architectures".

This table typesets reasonable if it looks like this:

------------------------------------

<informaltable>
<tgroup cols="4">
<thead>
<row>
  <entry>Architecture</entry><entry>Debian Designation</entry>
  <entry>Subarchitecture</entry><entry>Flavor</entry>
</row>
</thead>

<tbody>
<row>
  <entry morerows="2" valign="middle">Intel x86-based</entry>
  <entry morerows="2" valign="middle">i386</entry>
  <entry morerows="2"/>
  <entry>vanilla</entry>
</row><row>
  <entry/>
  <entry/>
  <entry/>
  <entry>speakup</entry>
</row><row>
  <entry/>
  <entry/>
  <entry/>
  <entry>linux26</entry>
</row>

<row>
  <entry morerows="3" valign="middle">Motorola 680x0</entry>
  <entry morerows="3" valign="middle">m68k</entry>
  <entry>Atari</entry>
  <entry>atari</entry>
</row><row>
  <entry/>
  <entry/>
  <entry>Amiga</entry>
  <entry>amiga</entry>
</row><row>
  <entry/>
  <entry/>
  <entry>68k Macintosh</entry>
  <entry>mac</entry>
</row><row>
  <entry/>
  <entry/>
  <entry>VME</entry>
  <entry>bvme6000, mvme147, mvme16x</entry>
</row>

<row>
  <entry morerows="2" valign="middle">DEC Alpha</entry>
  <entry morerows="2" valign="middle">alpha</entry>
  <entry morerows="2"/>
  <entry>generic</entry>
</row><row>
  <entry/>
  <entry/>
  <entry/>
  <entry>jensen</entry>
</row><row>
  <entry/>
  <entry/>
  <entry/>
  <entry>nautilus</entry>
</row>

<row>
  <entry morerows="1" valign="middle">Sun SPARC</entry>
  <entry morerows="1" valign="middle">sparc</entry>
  <entry morerows="1"/>
  <entry>sun4cdm</entry>
</row><row>
  <entry/>
  <entry/>
  <entry/>
  <entry>sun4u</entry>
</row>

<row>
  <entry morerows="3" valign="middle">ARM and StrongARM</entry>
  <entry morerows="3" valign="middle">arm</entry>
  <entry morerows="3"/>
  <entry>netwinder</entry>
</row><row>
  <entry/>
  <entry/>
  <entry/>
  <entry>riscpc</entry>
</row><row>
  <entry/>
  <entry/>
  <entry/>
  <entry>shark</entry>
</row><row>
  <entry/>
  <entry/>
  <entry/>
  <entry>lart</entry>
</row>

<row>
  <entry morerows="3" valign="middle">IBM/Motorola PowerPC</entry>
  <entry morerows="3" valign="middle">powerpc</entry>
  <entry>CHRP</entry>
  <entry>chrp</entry>
</row><row>
  <entry/>
  <entry/>
  <entry>PowerMac</entry>
  <entry>powermac, new-powermac</entry>
</row><row>
  <entry/>
  <entry/>
  <entry>PReP</entry>
  <entry>prep</entry>
</row><row>
  <entry/>
  <entry/>
  <entry>APUS</entry>
  <entry>apus</entry>
</row>

<row>
  <entry morerows="1" valign="middle">HP PA-RISC</entry>
  <entry morerows="1" valign="middle">hppa</entry>
  <entry>PA-RISC 1.1</entry>
  <entry>32</entry>
</row><row>
  <entry/>
  <entry/>
  <entry>PA-RISC 2.0</entry>
  <entry>64</entry>
</row>

<row>
  <entry>Intel ia64-based</entry>
  <entry>ia64</entry>
  <entry></entry>
  <entry></entry>
</row>

<row>
  <entry>MIPS (big endian)</entry>
  <entry>mips</entry>
  <entry>SGI Indy/I2</entry>
  <entry>r4k-ip22</entry>
</row>

<row>
  <entry morerows="1" valign="middle">MIPS (little endian)</entry>
  <entry morerows="1" valign="middle">mipsel</entry>
  <entry morerows="1" valign="middle">DEC Decstation</entry>
  <entry>r4k-kn04</entry>
</row><row>
  <entry/>
  <entry/>
  <entry/>
  <entry>r3k-kn02</entry>
</row>

<row>
  <entry morerows="1" valign="middle">IBM S/390</entry>
  <entry morerows="1" valign="middle">s390</entry>
  <entry morerows="1"/>
  <entry>tape</entry>
</row><row>
  <entry/>
  <entry/>
  <entry/>
  <entry>vmrdr</entry>
</row>

</tbody></tgroup></informaltable>

---------------------------

The table about hardware requirements is fixed in a similar way:
each row should have _two_ <entry> thingies.  So it should be e.g.:

 <row arch="not-s390"><entry/><entry>Hun volgorde in het
 systeem.</entry></row>

and

 <row arch="not-s390"><entry/><entry>Verticale frequentie.</entry></row>

.

> <snip>
> > > I have one question for you.
> > > Do you have any idea if it will be possible to use your method for other 
> > > languages than English? I'm thinking especially of Japanese, and to a 
> > > lesser degree Russian, Czech and Greek because of the different character 
> > > sets.
> > 
> > O, I've no experience typesetting non-european documents...
> 
> I've just successfully generated an install.ru.profiled.ps, which looks
> pretty good.
<snip>

> Japanese seems to work fine too, just make sure no utf-8 style japanese
> characters are left in the input file, but all are converted to things
> like &#x3082; .  I've seen "raw" japanese in commented-out sections, you
> have to completely remove these before feeding to jade.

But even then, things still fail...  :(  Lot's of stuff like:

 Warning: Unknown character 12540, at 100

.  It might be possible to get japanese characters using Jade and
jadetex.  I don't know how though...  So: russian is OK, japanese is not
OK out of the box on my system.  (NB: the japanese HTML output generated
by xsltproc is fine.)

Groeten,

Joost

Attachment: signature.asc
Description: Digital signature

Reply to: