Load Smarty 3 documentation

Author: uwetews

docs/Makefile-dist

@@ -0,0 +1,80 @@
+STYLESHEETS_DIR = /usr/share/xml/docbook/stylesheet/docbook-xsl
+PHP = /usr/bin/php
+ZIP = /usr/bin/zip
+FOP = /usr/bin/fop
+XMLTO = /usr/bin/xmlto
+XSLTPROC = /usr/bin/xsltproc
+WINE = /usr/bin/wine
+LANG = en
+LANGS_AVAIL = de en es fr it ja pt_BR ru
+
+all: html pdf
+
+allweb: html htmlweb pdf
+
+html: set-current-lang-symlink set-date
+	rm -rf manual-$(LANG)
+	$(XMLTO) html \
+           -o manual-$(LANG) \
+           --stringparam use.id.as.filename=1 \
+           --stringparam chunker.output.encoding='UTF-8' \
+           --stringparam chunker.output.indent='yes' \
+           -x $(STYLESHEETS_DIR)/html/chunk.xsl \
+           manual.xml
+	$(ZIP) -r manual-$(LANG).zip manual-$(LANG)
+
+set-current-lang-symlink:
+	rm -f current_lang
+	ln -s $(LANG) current_lang
+
+set-date:
+	sed "s/{DATE}/`date '+%Y-%m-%d'`/" entities/version.ent.in > entities/version.ent
+
+fo:
+	$(XSLTPROC) -o manual-$(LANG).fo $(STYLESHEETS_DIR)/fo/docbook.xsl manual.xml
+
+pdf: set-current-lang-symlink set-date fo
+	$(FOP) \
+            -c fop/$(LANG).conf \
+            -pdf manual-$(LANG).pdf \
+            -fo manual-$(LANG).fo
+	rm -f manual-$(LANG).fo
+
+htmlweb: set-current-lang-symlink set-date
+	rm -rf manualweb-$(LANG) htmlweb-$(LANG)
+	$(XMLTO) html \
+           -o manualweb-$(LANG) \
+           --stringparam use.id.as.filename=1 \
+           --stringparam html.ext='.tpl' \
+           --stringparam chunker.output.encoding='UTF-8' \
+           --stringparam chunker.output.indent='yes' \
+           -x $(STYLESHEETS_DIR)/html/chunk.xsl \
+           manual.xml
+	$(PHP) -f scripts/makeweb.php manualweb-$(LANG) htmlweb-$(LANG)
+	rm -rf manualweb-$(LANG)
+
+chm: set-current-lang-symlink set-date
+	rm -rf htmlhelp-$(LANG)
+	$(XSLTPROC) \
+	 -o htmlhelp-$(LANG)/ \
+	 --stringparam htmlhelp.encoding 'UTF-8' \
+	 --stringparam htmlhelp.enhanced.decompilation 1  \
+	 --stringparam htmlhelp.hhc.binary 1 \
+	 --stringparam htmlhelp.autolabel 1 \
+     --stringparam suppress.navigation 0 \
+	 --stringparam htmlhelp.default.topic 'make_chm_index.html' \
+	 --stringparam htmlhelp.use.hhk 1 \
+	 $(STYLESHEETS_DIR)/htmlhelp/htmlhelp.xsl \
+	 manual.xml
+	cp $(LANG)/make_chm_index.html htmlhelp-$(LANG)/
+	$(WINE) regsvr32 tools/hhw/it*.dll
+	WINEDLLOVERRIDES="itircl,itss=n" wine tools/hhw/hhc.exe htmlhelp-en/htmlhelp.hhp || true
+	cp htmlhelp-$(LANG)/htmlhelp.chm ./manual-$(LANG).chm
+	rm -rf htmlhelp-$(LANG)
+
+revcheck:
+	$(PHP) -f scripts/revcheck.php $(LANG) > revcheck.html
+
+clean:
+	for x in $(LANGS_AVAIL); do rm -rf manual-$${x} manual-$${x}.fo manual-$${x}.pdf htmlweb-$${x}; done
+	rm -f revcheck.html

docs/README

@@ -0,0 +1,24 @@
+This directory contains the documentation for Smarty. All files are in docbook
+format with an .xml extension. Different subdirs contain different available languages.
+
+Programs required:
+
+xmlto
+xsltproc
+fop
+
+Files required:
+
+Default XSL stylesheets, ship with Ubuntu under:
+/usr/share/xml/docbook/stylesheet/docbook-xsl
+
+MAKE:
+ * make html         (make plain html english docs)
+ * make pdf          (make pdf english docs)
+ * make LANG=de html (make plain html german docs)
+ * make LANG=de pdf  (make pdf german docs)
+
+CHM files (todo)
+
+Revision Tracking (for translations):
+ * make LANG=de revcheck (this will create revcheck.html)

docs/current_lang

@@ -0,0 +1 @@
+en

docs/de/appendixes/bugs.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 1.2 Maintainer: andreas Status: ready -->
+<!-- $Revision: 2972 $ -->
+<chapter id="bugs">
+	<title>BUGS</title>
+	<para>
+	Bitte konsultieren Sie die Datei <filename>BUGS</filename> welche mit Smarty ausgeliefert wird,
+	oder die Webseite.
+	</para>
+</chapter>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

docs/de/appendixes/resources.xml

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- $Revision: 2978 $ -->
+<!-- EN-Revision: 1.4 Maintainer: andreas Status: ready -->
+<chapter id="resources">
+ <title>Weiterf&uuml;hrende Informationen</title>
+ <para>
+  Smarty's Homepage erreicht man unter <ulink
+  url="&url.smarty;">&url.smarty;</ulink>. Sie k&ouml;nnen der Smarty
+  Mailingliste beitreten in dem sie ein E-mail an
+  &ml.general.sub;. Das Archiv der Liste ist hier <ulink
+  url="&url.ml.archive;">&url.ml.archive;</ulink> einsehbar.
+ </para>
+</chapter>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->