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