summaryrefslogtreecommitdiffstats
path: root/source-builder/sb/asciidoc/examples/website/latex-filter.txt
diff options
context:
space:
mode:
authorChris Johns <chrisj@rtems.org>2017-08-07 09:59:49 +1000
committerChris Johns <chrisj@rtems.org>2017-08-07 09:59:49 +1000
commit8b96e17c8abf61d97dd224b23370dc148f32fe3c (patch)
treee8eb043159d145ffbbbf9c23ef872226de5ab059 /source-builder/sb/asciidoc/examples/website/latex-filter.txt
parent4.12: Fix SIS patch URL (diff)
downloadrtems-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/examples/website/latex-filter.txt')
-rw-r--r--source-builder/sb/asciidoc/examples/website/latex-filter.txt196
1 files changed, 0 insertions, 196 deletions
diff --git a/source-builder/sb/asciidoc/examples/website/latex-filter.txt b/source-builder/sb/asciidoc/examples/website/latex-filter.txt
deleted file mode 100644
index 9af9d28..0000000
--- a/source-builder/sb/asciidoc/examples/website/latex-filter.txt
+++ /dev/null
@@ -1,196 +0,0 @@
-LaTeX Filter
-============
-
-:blogpost-status: published
-:blogpost-doctype: article
-:blogpost-posttype: page
-:blogpost-categories: AsciiDoc,LaTeX,python
-
-The AsciiDoc distribution includes a LaTeX filter that translates
-LaTeX source to PNG image which is automatically inserted into the
-AsciiDoc output document. Although it can accept any LaTeX source, the
-primary use is to render mathematical formulae (see the examples
-below). The filter implements the 'latex' Listing block and Paragraph
-styles.
-
-This LaTeX paragraph:
-
-[listing]
-.....................................................................
-[latex]
-$y = \int_0^\infty \gamma^2 \cos(x) dx$
-.....................................................................
-
-Renders:
-
-[latex]
-$y = \int_0^\infty \gamma^2 \cos(x) dx$
-
-This LaTeX block:
-
-[listing]
-.....................................................................
-["latex","latex1.png",align="center"]
----------------------------------------------------------------------
-$\displaystyle{ V_i = C_0 - C_3
-\frac{C_1\cos(\theta_i+C_3)}{C_4+C_1\cos(\theta_i+C_2)} }$
----------------------------------------------------------------------
-.....................................................................
-
-Renders:
-
-["latex","latex1.png",align="center"]
----------------------------------------------------------------------
-$\displaystyle{ V_i = C_0 - C_3
-\frac{C_1\cos(\theta_i+C_3)}{C_4+C_1\cos(\theta_i+C_2)} }$
----------------------------------------------------------------------
-
-This LaTeX block:
-
-[listing]
-.....................................................................
-.LaTeX filter example
-[latex]
-["latex","latex3.png"]
----------------------------------------------------------------------
-\begin{equation}
-\Re{z} =\frac{n\pi \dfrac{\theta +\psi}{2}}{
-\left(\dfrac{\theta +\psi}{2}\right)^2 + \left( \dfrac{1}{2}
-\log \left\lvert\dfrac{B}{A}\right\rvert\right)^2}.
-\end{equation}
-
-\begin{equation}
-\boxed{\eta \leq C(\delta(\eta) +\Lambda_M(0,\delta))}
-\end{equation}
-
-\begin{equation}\label{first}
-a=b+c
-\end{equation}
-
-\begin{subequations}\label{grp}
-\begin{align}
-a&=b+c\label{second}\\
-d&=e+f+g\label{third}\\
-h&=i+j\label{fourth}
-\end{align}
-\end{subequations}
----------------------------------------------------------------------
-.....................................................................
-
-Renders:
-
-.LaTeX filter example
-[latex]
----------------------------------------------------------------------
-\begin{equation}
-\Re{z} =\frac{n\pi \dfrac{\theta +\psi}{2}}{
-\left(\dfrac{\theta +\psi}{2}\right)^2 + \left( \dfrac{1}{2}
-\log \left\lvert\dfrac{B}{A}\right\rvert\right)^2}.
-\end{equation}
-
-\begin{equation}
-\boxed{\eta \leq C(\delta(\eta) +\Lambda_M(0,\delta))}
-\end{equation}
-
-\begin{equation}\label{first}
-a=b+c
-\end{equation}
-
-\begin{subequations}\label{grp}
-\begin{align}
-a&=b+c\label{second}\\
-d&=e+f+g\label{third}\\
-h&=i+j\label{fourth}
-\end{align}
-\end{subequations}
----------------------------------------------------------------------
-
-This LaTeX paragraph:
-
-[listing]
-.....................................................................
-.A LaTeX table
-[latex]
-\begin{tabular}{c r @{.} l}
-Pi expression &
-\multicolumn{2}{c}{Value} \\
-\hline
-$\pi$ & 3&1416 \\
-$\pi^{\pi}$ & 36&46 \\
-$(\pi^{\pi})^{\pi}$ & 80662&7 \\
-\end{tabular}
-.....................................................................
-
-Renders:
-
-.A LaTeX table
-[latex]
-\begin{tabular}{c r @{.} l}
-Pi expression &
-\multicolumn{2}{c}{Value} \\
-\hline
-$\pi$ & 3&1416 \\
-$\pi^{\pi}$ & 36&46 \\
-$(\pi^{\pi})^{\pi}$ & 80662&7 \\
-\end{tabular}
-
-
-Using the Filter
-----------------
-- The LaTeX filter is invoked by setting the Listing block or
- Paragraph style (the first positional block attribute) to 'latex'.
-- The second positional attribute (named 'target' is optional, it sets
- the name of the generated PNG image file. If this is not supplied a
- file name like `{docname}__{target-number}.png` is synthesised
- (where `{docname}` is the document file name and `{target-number}`
- is an integer number.
-- The third positional attribute, named 'dpi', is also optional; it is
- an integer number that sets the output resolution in dots per inch.
-
-Because the LaTeX images are rendered using the image block templates
-you can also use the optional named image block attributes (see
-link:userguide.html#X55[Image macro attributes] in the AsciiDoc User
-Guide).
-
-[TIP]
-=====================================================================
-You can also change the image size using the following LaTeX commands:
-
- \tiny
- \scriptsize
- \footnotesize
- \small
- \normalsize
- \large
- \Large
- \LARGE
- \huge
-
-For example:
-
- [latex]
- \Large $y = \int_0^\infty \gamma^2 \cos(x) dx$
-
-The `\Large` command is outside the `$` math delimiters.
-
-=====================================================================
-
-The filter (`./filters/latex/latex2png.py`) can be used outside
-AsciiDoc to convert LaTeX source to PNG images.
-
-Execute the following command to see how to use it:
-
- $ ./filters/latex/latex2png.py --help
-
-
-Limitations
------------
-- The `asciidoc(1)` input and output files cannot both be `-` (stdin
- and stdout), either the input or output files (or both) must be a
- named file.
-
-
-Installation
-------------
-In addition to AsciiDoc you will need to have `latex(1)` and
-`dvipng(1)` installed.