common/pdf/build/lw/STEPS-new.txt

   1
   2 Steps to create a new PDF book
   3
   4 1- Create the directory for the book: mkdir 0XXXX
   5 2- Copy the general Makefile: Makefile.basic into this directory
   6      cp Makefile.basic 0XXXX/Makefile
   7
   8 3- Edit the book series
   9 4- Edit the language (if other than english)
  10
  11
  12 5- Enter that directory
  13 6- Run 'make install'
  14 7- Your PDF files will be in the 'FINAL' subdirectory that has been created
  15    just for you
  16 8- Run 'make distclean' to clean all the files used for the build
  17
  18 Due to a bug in the XSL location you also have to do this:
  19
  20 - Go to the 'en/xml/' (or '/es/xml') directory (from the SVN root).
  21   Symlink/Copy the latex.xsl file with the one at 'common/xsl' like this:
  22   (  cd en/xml && ln -s ../../common/xsl/latex.xsl . )
  23
  24
  25 Enjoy!
  26
  27 Mon, 22 Sep 2008 01:55:36 +0200
  28 Javier Fernandez-Sanguino <javier.fernandez-sanguino@projectaon.org>
  29
  30 -----------------------------------------------------------------
  31
  32 The Makefile script should take care of the following automatically:
  33
  34 Generate the TeX file for the book using gbtolatex.pl
  35    Example:
  36      ../../../scripts/gbtolatex.pl 0XXXX  - English files
  37      ../../../scripts/gbtolatex.pl 0XXXX es - Spanish files
  38
  39 Link to the *tex files at ../../shared/*tex:
  40     for i in ../../shared/*sty ; do ln $i . ; done
  41
  42     English:
  43
  44     for i in ../../shared/*tex ; do ln $i . ; done
  45
  46     Spanish:
  47
  48     for i in ../../shared/es/*tex ; do ln $i . ; done
  49
  50     [ This makes all shared TeX files available:
  51       ac1.tex  ac2.tex  crtneg.tex  crtpos.tex  random.tex  souvenir.sty
  52       souverbt.sty ]
  53
  54 Link all common images:
  55  for i in ../../../../../en/gif/lw/0XXX/ill/*{pdf,gif}; do ln $i . ; done
  56
  57 Note: for translations you first have to link to the images in the
  58 translated directory and *then* link to the files to the original (English)
  59 book. So it's:
  60  for i in ../../../../../es/gif/ls/0XXX/ill/*/*{pdf,gif}; do ln $i . ; done
  61  for i in ../../../../../en/gif/lw/0XXX/ill/*{pdf,gif}; do ln $i . ; done
  62  [ The second one will probably output errors of common images that will
  63    not be overwritten, discard those ]
  64
  65 Convert the images into PDF so that they can be included in the TeX file:
  66
  67    sh ../../convert-images.sh
  68
  69