[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 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".

Will look into that today.

<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.

I've ran:

joostvb@nagy:~/sv...staller/doc/manual/build% ./buildone.sh i386 ru
joostvb@nagy:~/sv...staller/doc/manual/build% cp install.ru.profiled.xml \
  install.ru.profiled.dbx
joostvb@nagy:~/sv...staller/doc/manual/build% sed -i \
  's/<entry\/>/<entry><\/entry>/; s/<para\/>/<\/para><para>/' install.ru.profiled.dbx
joostvb@nagy:~/sv...staller/doc/manual/build% make -f \
  /usr/share/caspar/mk/docbook.mk install.ru.profiled.ps

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.

Groeten,

Joost

Attachment: signature.asc
Description: Digital signature


Reply to: