doc/manual/Makefile

   1 # DVD-o-matic manual makefile
   2
   3 all:    html pdf
   4
   5 DIAGRAMS :=
   6
   7 SCREENSHOTS := file-new.png new-film.png click-content-selector.png select-content-file.png examine-thumbs.png setup.png
   8
   9 XML := dvdomatic.xml
  10
  11 GRAPHICS :=
  12
  13 #
  14 # For the HTML, default to copying the screenshots direct
  15 #
  16 html/screenshots/%.png: screenshots/%.png
  17         mkdir -p html/screenshots
  18         cp $< $@
  19
  20 #
  21 # Some need resizing...
  22 #
  23 html/screenshots/editor.png: screenshots/editor.png
  24         mkdir -p html/screenshots
  25         convert -resize 50% $< $@
  26 html/screenshots/mixer.png: screenshots/mixer.png
  27         mkdir -p html/screenshots
  28         convert -resize 50% $< $@
  29 html/screenshots/default-folder-for-new-sessions.png: screenshots/default-folder-for-new-sessions.png
  30         mkdir -p html/screenshots
  31         convert -resize 75% $< $@
  32 html/screenshots/welcome-to-ardour.png: screenshots/welcome-to-ardour.png
  33         mkdir -p html/screenshots
  34         convert -resize 75% $< $@
  35 html/screenshots/monitoring-choices.png: screenshots/monitoring-choices.png
  36         mkdir -p html/screenshots
  37         convert -resize 75% $< $@
  38 html/screenshots/monitor-section.png: screenshots/monitor-section.png
  39         mkdir -p html/screenshots
  40         convert -resize 75% $< $@
  41 html/screenshots/audio-midi-setup-device.png: screenshots/audio-midi-setup-device.png
  42         mkdir -p html/screenshots
  43         convert -resize 75% $< $@
  44 html/screenshots/new-session.png: screenshots/new-session.png
  45         mkdir -p html/screenshots
  46         convert -resize 75% $< $@
  47 html/screenshots/export-dialogue.png: screenshots/export-dialogue.png
  48         mkdir -p html/screenshots
  49         convert -resize 75% $< $@
  50
  51 # For HTML: convert graphics from SVG to PNG
  52 graphics/%.png: graphics/%.svg
  53         inkscape -z -f $< --export-png $@ --export-area-drawing
  54
  55 # For LaTeX/PDF: convert graphics from SVG to PDF
  56 graphics/%.pdf: graphics/%.svg
  57         inkscape -z -f $< --export-pdf $@ --export-area-drawing
  58
  59 # For HTML: convert diagrams from SVG to PNG
  60 diagrams/%.png: diagrams/%.svg
  61         inkscape -z -f $< --export-png $@ --export-area-drawing
  62
  63 # For LaTeX/PDF: convert diagrams from SVG to PDF
  64 diagrams/%.pdf: diagrams/%.svg
  65         inkscape -z -f $< --export-pdf $@ --export-area-drawing
  66
  67 #
  68 # HTML
  69 #
  70
  71 html:   $(XML) dvdomatic-html.xsl extensions-html.ent dvdomatic.css \
  72         $(addprefix html/screenshots/,$(SCREENSHOTS)) \
  73         $(subst .svg,.png,$(addprefix diagrams/,$(DIAGRAMS))) \
  74         $(subst .svg,.png,$(addprefix graphics/,$(GRAPHICS))) \
  75
  76 #       The DocBook needs to know what file extensions to look for
  77 #       for screenshots and diagrams; use the correct file to tell it.
  78         cp extensions-html.ent extensions.ent
  79
  80 #       DocBoox -> html
  81         xmlto html -m dvdomatic-html.xsl dvdomatic.xml --skip-validation -o html
  82
  83 #       Copy graphics and CSS in
  84 #       mkdir -p html/diagrams html/graphics
  85 #       cp diagrams/*.png html/diagrams
  86 #       cp graphics/*.png html/graphics
  87         cp dvdomatic.css html
  88
  89 #
  90 # PDF
  91 #
  92
  93 pdf:    $(XML) dvdomatic-pdf.xsl extensions-pdf.ent screenshots/*.png $(subst .svg,.pdf,$(addprefix diagrams/,$(DIAGRAMS)))
  94
  95 #       The DocBook needs to know what file extensions to look for
  96 #       for screenshots and diagrams; use the correct file to tell it.
  97         cp extensions-pdf.ent extensions.ent
  98
  99         mkdir -p pdf
 100
 101         dblatex -p dvdomatic-pdf.xsl -s dvdomatic.sty -r pptex.py -T native dvdomatic.xml -t pdf -o pdf/dvdomatic.pdf
 102
 103
 104 #
 105 # LaTeX (handy for debugging)
 106 #
 107
 108 tex:    $(XML) dvdomatic-pdf.xsl extensions-pdf.ent
 109
 110 #       The DocBook needs to know what file extensions to look for
 111 #       for screenshots and diagrams; use the correct file to tell it.
 112         cp extensions-pdf.ent extensions.ent
 113
 114         mkdir -p tex
 115
 116 #       -P <foo> removes the revhistory table
 117         dblatex -P doc.collab.show=0 -P latex.output.revhistory=0 -p dvdomatic-pdf.xsl -s dvdomatic.sty -r pptex.py -T native dvdomatic.xml -t tex -o tex/dvdomatic.tex
 118
 119
 120 clean:; rm -rf html pdf diagrams/*.pdf diagrams/*.png graphics/*.png *.aux dvdomatic.cb dvdomatic.cb2 dvdomatic.glo dvdomatic.idx dvdomatic.ilg
 121         rm -rf dvdomatic.ind dvdomatic.lof dvdomatic.log dvdomatic.tex dvdomatic.toc extensions.ent dvdomatic.out