diff options
| author | Chris Johns <chrisj@rtems.org> | 2017-08-07 09:59:49 +1000 |
|---|---|---|
| committer | Chris Johns <chrisj@rtems.org> | 2017-08-07 09:59:49 +1000 |
| commit | 8b96e17c8abf61d97dd224b23370dc148f32fe3c (patch) | |
| tree | e8eb043159d145ffbbbf9c23ef872226de5ab059 /source-builder/sb/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt | |
| parent | 4.12: Fix SIS patch URL (diff) | |
| download | rtems-source-builder-8b96e17c8abf61d97dd224b23370dc148f32fe3c.tar.bz2 | |
doc: Remove in source documentation and the asciidoc package
The RSB documentation is now in ReST format and part of the RTEMS
Documentation project. See https://docs.rtems.org/.
Remove support for the GPL based asciidoc tool and remove the
asciidoc package from the RSB.
Add the Python Markdown package and update the reporter to use
Markdown for HTML generation. The resuling HTML report is a single
self contained file.
Closes #3047.
Diffstat (limited to '')
| -rw-r--r-- | source-builder/sb/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt | 65 |
1 files changed, 0 insertions, 65 deletions
diff --git a/source-builder/sb/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt b/source-builder/sb/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt deleted file mode 100644 index fd71e63..0000000 --- a/source-builder/sb/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt +++ /dev/null @@ -1,65 +0,0 @@ -AsciiDoc DocBook XSL Stylesheets Notes -====================================== - -Output file customisation is achieved by tweaking the DocBook XSL -stylesheets. I've tried to keep customization to a minimum and -confine it to the separate XSL driver files in the distribution -`./docbook-xsl/` directory (see the User Guide for details). - -To polish some rough edges I've written some patches for the DocBook -XSL stylesheets -- you don't need them but they're documented below -and included in the distribution `./docbook-xsl/` directory. - - -Manually upgrading Debian to the latest DocBook XSL stylesheets ---------------------------------------------------------------- -The DocBook XSL Stylesheets distribution is just a directory full of -text files and you can switch between releases by changing the -directory name in the system XML catalog. - -To upgrade to the latest docbook-xsl stylesheets without having to -wait for the Debian `docbook-xsl` package: - -- Download the latest docbook-xsl tarball from - http://sourceforge.net/projects/docbook/. Bleeding edge snapshots - can be found at http://docbook.sourceforge.net/snapshots/ - -- Unzip the tarball to `/usr/share/xml/docbook/stylesheet/`: - - $ cd /usr/share/xml/docbook/stylesheet - $ sudo tar -xzf /tmp/docbook-xsl-1.72.0.tar.gz - -- Edit `/etc/xml/docbook-xsl.xml` catalog and replace occurences of - the current stylesheets directory with the new one (in our example - it would be `/usr/share/xml/docbook/stylesheet/docbook-xsl-1.72.0`. - - $ cd /etc/xml/ - $ sudo cp -p docbook-xsl.xml docbook-xsl.xml.ORIG - $ sudo vi docbook-xsl.xml - - -Customizing Generated Text --------------------------- -An example -http://www.sagehill.net/docbookxsl/CustomGentext.html#CustomGenText[DocBook -XSL Stylesheets customization file] for formatting chapter titles -without chapter numbering. - -.custom-chapter.xml ---------------------------------------------------------------------- -<!-- Customize chapter title --> -<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"> - <l:l10n language="en"> - <l:context name="title"> - <l:template name="chapter" text="%t"/> - </l:context> - </l:l10n> -</l:i18n> ---------------------------------------------------------------------- - -Executed with this 'xsltproc' parameter: - - --param local.l10n.xml document\(\'custom-chapter.xml\'\) - -NOTE: This example is hypothetical -- use the 'xsltproc' -`--stringparam chapter.autolabel 0` option to do the same job. |