summaryrefslogtreecommitdiffstats
path: root/kdoctools/customization/README
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce4a32fe52ef09d8f5ff1dd22c001110902b60a2 (patch)
tree5ac38a06f3dde268dc7927dc155896926aaf7012 /kdoctools/customization/README
downloadtdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.tar.gz
tdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kdoctools/customization/README')
-rw-r--r--kdoctools/customization/README58
1 files changed, 58 insertions, 0 deletions
diff --git a/kdoctools/customization/README b/kdoctools/customization/README
new file mode 100644
index 000000000..c4b47c687
--- /dev/null
+++ b/kdoctools/customization/README
@@ -0,0 +1,58 @@
+2002-11-12
+Some short documentation on the different stylesheets, and how to use them.
+
+kde-chunk.xsl
+
+The standard KDE stylesheet, as used to generate the content for
+KHelpCenter. If you do not specify a stylesheet, this is the default.
+
+This stylesheet includes kde-navig.xsl, which controls the
+presentation of the top and bottom of the page graphics, and is reused
+in other places. You should probably not call kde-navig.xsl on it's own.
+
+kde-nochunk.xsl
+
+This is very similar to the standard KDE stylesheet, but it creates
+one single html file for the entire document. This is one way to get
+print output, using html2pdf or html2ps. It's also useable to create
+a "printable version" of a document to link to on a website.
+
+kde-style.xsl
+
+All KDE "look and feel" customizations (other than the navigation
+graphics in kde-navig.xsl) are here. This is where changes to how
+things render are placed. In most cases, the actual rendering is
+controlled by the CSS files, and this file simply has the instructions
+to ensure class attributes are written into the HTML as necessary, for
+the CSS to display.
+
+kde-ttlpg.xsl
+
+The Title Page layout for the KDE documentation. This one covers
+customizing the TOC, presentation of legal notices, and a slightly
+different navigation graphic.
+
+kde-web.xsl
+(This stylesheet includes kde-web-navig.xsl, which should not be used
+directly on it's own)
+
+Simplified version of the KDE stylesheet, aimed at websites. Content
+is constrained to a 680px wide table. You could use this for example,
+to generate web pages that will print nicely and display on older
+browsers nicely.
+
+kde-chunk-online.xsl
+(This stylesheet includes kde-web-navig-online.xsl, which should not
+be used directly on it's own)
+
+Slightly altered version of the KDE stylesheet, used to generate the
+docs.kde.org website, among others.
+
+kde-man.xsl
+
+A stylesheet for generating *roff output (for manpages) from DocBook
+files. It's virtually the same as the original manpages/docbook.xsl file
+from the DocBook XSL package, except that the output file's name is
+hardcoded to 'manpage.troff', and the 'Writing manpage.troff' message
+is suppressed.
+