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/dblatex | |
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 'source-builder/sb/asciidoc/dblatex')
3 files changed, 0 insertions, 133 deletions
diff --git a/source-builder/sb/asciidoc/dblatex/asciidoc-dblatex.sty b/source-builder/sb/asciidoc/dblatex/asciidoc-dblatex.sty deleted file mode 100644 index 9d89839..0000000 --- a/source-builder/sb/asciidoc/dblatex/asciidoc-dblatex.sty +++ /dev/null @@ -1,20 +0,0 @@ -%% -%% This style is derived from the docbook one. -%% -\NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{asciidoc}[2008/06/05 AsciiDoc DocBook Style] -%% Just use the original package and pass the options. -\RequirePackageWithOptions{docbook} - -% Sidebar is a boxed minipage that can contain verbatim. -% Changed shadow box to double box. -\renewenvironment{sidebar}[1][0.95\textwidth]{ - \hspace{0mm}\newline% - \noindent\begin{Sbox}\begin{minipage}{#1}% - \setlength\parskip{\medskipamount}% -}{ - \end{minipage}\end{Sbox}\doublebox{\TheSbox}% -} - -% For DocBook literallayout elements, see `./dblatex/dblatex-readme.txt`. -\usepackage{alltt} diff --git a/source-builder/sb/asciidoc/dblatex/asciidoc-dblatex.xsl b/source-builder/sb/asciidoc/dblatex/asciidoc-dblatex.xsl deleted file mode 100644 index 3df2d2e..0000000 --- a/source-builder/sb/asciidoc/dblatex/asciidoc-dblatex.xsl +++ /dev/null @@ -1,74 +0,0 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- -dblatex(1) XSL user stylesheet for asciidoc(1). -See dblatex(1) -p option. ---> -<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> - - <!-- TOC links in the titles, and in blue. --> - <xsl:param name="latex.hyperparam">colorlinks,linkcolor=blue,pdfstartview=FitH</xsl:param> - <xsl:param name="doc.publisher.show">1</xsl:param> - <xsl:param name="doc.lot.show"></xsl:param> - <xsl:param name="term.breakline">1</xsl:param> - <xsl:param name="doc.collab.show">0</xsl:param> - <xsl:param name="doc.section.depth">3</xsl:param> - <xsl:param name="table.in.float">0</xsl:param> - <xsl:param name="monoseq.hyphenation">0</xsl:param> - <xsl:param name="latex.output.revhistory">1</xsl:param> - - <!-- This doesn't work, don't know why, see: - http://dblatex.sourceforge.net/html/manual/apas03.html - ./docbook-xsl/common.xsl - --> - <!-- - <xsl:param name="doc.toc.show"> - <xsl:choose> - <xsl:when test="/processing-instruction('asciidoc-toc')"> -1 - </xsl:when> - <xsl:otherwise> -0 - </xsl:otherwise> - </xsl:choose> - </xsl:param> - <xsl:param name="doc.lot.show"> - <xsl:choose> - <xsl:when test="/book"> -figure,table,equation,example - </xsl:when> - </xsl:choose> - </xsl:param> - --> - <xsl:param name="doc.toc.show">1</xsl:param> - - <!-- - Override default literallayout template. - See `./dblatex/dblatex-readme.txt`. - --> - <xsl:template match="address|literallayout[@class!='monospaced']"> - <xsl:text>\begin{alltt}</xsl:text> - <xsl:text> \normalfont{} </xsl:text> - <xsl:apply-templates/> - <xsl:text> \end{alltt}</xsl:text> - </xsl:template> - - <xsl:template match="processing-instruction('asciidoc-pagebreak')"> - <!-- force hard pagebreak, varies from 0(low) to 4(high) --> - <xsl:text>\pagebreak[4] </xsl:text> - <xsl:apply-templates /> - <xsl:text> </xsl:text> - </xsl:template> - - <xsl:template match="processing-instruction('asciidoc-br')"> - <xsl:text>\newline </xsl:text> - </xsl:template> - - <xsl:template match="processing-instruction('asciidoc-hr')"> - <!-- draw a 444 pt line (centered) --> - <xsl:text>\begin{center} </xsl:text> - <xsl:text>\line(1,0){444} </xsl:text> - <xsl:text>\end{center} </xsl:text> - </xsl:template> - -</xsl:stylesheet> - diff --git a/source-builder/sb/asciidoc/dblatex/dblatex-readme.txt b/source-builder/sb/asciidoc/dblatex/dblatex-readme.txt deleted file mode 100644 index 39bb437..0000000 --- a/source-builder/sb/asciidoc/dblatex/dblatex-readme.txt +++ /dev/null @@ -1,39 +0,0 @@ -AsciiDoc dblatex README -======================= - -Customization -------------- -The `./dblatex` directory contains: - -`./dblatex/asciidoc-dblatex.xsl`:: Optional dblatex XSL parameter -customization. - -`./dblatex/asciidoc-dblatex.sty`:: Optional customized LaTeX styles. - -Use these files with dblatex(1) `-p` and `-s` options, for example: - - dblatex -p ../dblatex/asciidoc-dblatex.xsl \ - -s ../dblatex/asciidoc-dblatex.sty article.xml - - -Limitations ------------ -Observed in dblatex 0.2.8. - -- dblatex doesn't seem to process the DocBook 'literallayout' element - correctly: it is rendered in a monospaced font and no inline - elements are processed. By default the normal font should be used - and almost all DocBook inline elements should be processed - (http://www.docbook.org/tdg/en/html/literallayout.html). I almost - fixed this by overriding the default dblatex literallayout template - (in `./dblatex/asciidoc-dblatex.xsl`) and using the LaTeX 'alltt' - package, but there are remaining problems: - - * Blank lines are replaced by a single space. - * The 'literallayout' element incorrectly wraps text when rendered - inside a table. - -- Callouts do not work inside DocBook 'literallayout' elements which - means callouts are not displayed inside AsciiDoc literal blocks. A - workaround is to change the AsciiDoc literal block to a listing - block. |