Warning, /frameworks/kdoctools/src/customization/README is written in an unsupported language. File is not indexed.

0001 2002-11-12
0002 Some short documentation on the different stylesheets, and how to use them.
0003 
0004 kde-chunk.xsl
0005 
0006 The standard KDE stylesheet, as used to generate the content for
0007 KHelpCenter.  If you do not specify a stylesheet, this is the default.
0008 
0009 This stylesheet includes kde-navig.xsl, which controls the
0010 presentation of the top and bottom of the page graphics, and is reused
0011 in other places.  You should probably not call kde-navig.xsl on it's own.
0012 
0013 kde-nochunk.xsl
0014 
0015 This is very similar to the standard KDE stylesheet, but it creates
0016 one single html file for the entire document.  This is one way to get
0017 print output, using html2pdf or html2ps.  It's also usable to create
0018 a "printable version" of a document to link to on a website.
0019 
0020 kde-style.xsl
0021 
0022 All KDE "look and feel" customizations (other than the navigation
0023 graphics in kde-navig.xsl) are here. This is where changes to how
0024 things render are placed.  In most cases, the actual rendering is
0025 controlled by the CSS files, and this file simply has the instructions
0026 to ensure class attributes are written into the HTML as necessary, for
0027 the CSS to display.
0028 
0029 kde-ttlpg.xsl
0030 
0031 The Title Page layout for the KDE documentation.  This one covers
0032 customizing the TOC, presentation of legal notices, and a slightly
0033 different navigation graphic.
0034 
0035 kde-web.xsl
0036 (This stylesheet includes kde-web-navig.xsl, which should not be used
0037 directly on it's own)
0038 
0039 Simplified version of the KDE stylesheet, aimed at websites.  Content
0040 is constrained to a 680px wide table.  You could use this for example,
0041 to generate web pages that will print nicely and display on older
0042 browsers nicely.
0043 
0044 kde-chunk-online.xsl
0045 (This stylesheet includes kde-web-navig-online.xsl, which should not
0046 be used directly on it's own)
0047 
0048 Slightly altered version of the KDE stylesheet, used to generate the
0049 docs.kde.org website, among others.
0050 
0051 kde-man.xsl
0052 
0053 A stylesheet for generating *roff output (for manpages) from DocBook
0054 files. It's virtually the same as the original manpages/docbook.xsl file
0055 from the DocBook XSL package, except that the output file's name is
0056 hardcoded to 'manpage.troff', and the 'Writing manpage.troff' message
0057 is suppressed.
0058