LaTeX to Sphinx – Conversion Experience

LaTeX to Sphinx – Conversion Experience

LATEX to Sphinx Conversion Experience
Ryszard Kubiak
BachoTeX 2015
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
reStructuredText, docutils, Sphinx
reStructuredText
markup notation
docutils document converter
David Goodger (Canada)
and others
Sphinx
for many-le documents
Georg Brandl (Germany)
and others
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
One source many output formats
reStructuredText → HTML, PDF (via TeX), ePub, ...
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Markup example: reStructuredText
BachoTeX 2015
=============
#. ‘RODA
- Otwarcie konferencji 9:00
- Do±wiadczenie konwersji 9:15
#. CZWARTEK
- Warsztaty 9:00
Ju» mo»na si¦ zapisywa¢ na warsztaty po±wi¦cone
kaligrafii japo«skiej oraz pismu Rotunda.
Warsztaty b¦d¡ prowadzone równolegle.
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Okno a conversion sample
\okno{formatka-szkody}
{Szkody | (wyszukanie) | Poka»}
{Okno stanu danych szkody}
.. okno:: formatka-szkody
:wywol: Szkody | (wyszukanie) | Poka»
:tytul: Okno stanu danych szkody
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Markup converter
pandoc many input and output variants.
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Markup converter
pandoc many input and output variants.
LATEX → reStructuredText
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Conversion steps
1
2
Clearing LATEX by hand
Automatic pre-conversion
3
Conversion using pandoc
4
Automatic post-converison
5
Clearing reStructuredText by hand
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Extensibility
Extensions (Python)
Own classes (for directives and text roles).
Class overloading.
Transformations.
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Compromises, losses, ...
Properly justied paragraph blocks in TEX.
Left justication natural on the WEB.
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Hypertext, not numbers
Sections, tables, gures, citations, ...
numbering natural in traditional books.
hypertext links natural in WEB pages
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Hypertext, not numbers
Sections, tables, gures, citations, ...
numbering natural in traditional books.
hypertext links natural in WEB pages
Paragraph texts have to be rephrased.
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Comments
% in TEX
\begin{comment}...\end{comment} in LATEX
.. Strange comment convention
in reStructuredText.
Ryszard Kubiak
LATEX to Sphinx Conversion Experience
Divs & boxes
boxes, glues, penalties TEX's typographic model.
divs and CSS typography on the WEB
Ryszard Kubiak
LATEX to Sphinx Conversion Experience