summaryrefslogtreecommitdiff
path: root/docs/user/latex.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/user/latex.txt')
-rw-r--r--docs/user/latex.txt44
1 files changed, 34 insertions, 10 deletions
diff --git a/docs/user/latex.txt b/docs/user/latex.txt
index 8aa361faa..3b49f233a 100644
--- a/docs/user/latex.txt
+++ b/docs/user/latex.txt
@@ -128,7 +128,7 @@ line spacing Is done with package *setspace*, which gives
for bigger linespacing.
--------------------- ------------------------------------------------
use verbatim when When possibile, use verbatim for literal-blocks.
-possible Default is to always use the mbox environment.
+possible Compatibility alias for "--literal-env=verbatim".
A literal-block element, when processed by a
docutils-writer might have it's origin in a
@@ -204,18 +204,33 @@ Unicode
The generated LaTeX documents are in the input encoding per default.
-If the source document is in utf-8 encoding (or
-``--output-encoding=utf-8`` is set), LaTeX needs unicode support
-(the ``ucs`` package). If this is not available, specify
-a different output-encoding, e.g. ``latin1``.
+* If the source document is in utf-8 encoding (or
+ ``--output-encoding=utf-8`` is set), LaTeX needs unicode support
+ (the ``ucs`` package). If this is not available, specify
+ a different output-encoding, e.g. ``latin1``.
-If LaTeX issues a Warning about unloaded/known characters adding ::
+* If LaTeX issues a Warning about unloaded/known characters adding ::
\PreloadUnicodePage{n}
-where *n* is the unicode pagenumber, might help.
+ where *n* is the unicode pagenumber, might help.
-.. _LaTeX unicode: http://www.unruh.de/DniQ/latex/unicode/
+ .. _LaTeX unicode: http://www.unruh.de/DniQ/latex/unicode/
+
+* Unicode box drawing characters
+
+ - generate LaTeX code with ``--output-encoding=utf-8:strict``.
+
+ - In the latex file, edit the preamble to load "ucs" with "postscript"
+ option and also load the pstricks package::
+
+ \usepackage{shortvrb}
+ - \usepackage{ucs}
+ + \usepackage[postscript]{ucs}
+ + \usepackage{pstricks}
+ \usepackage[utf8x]{inputenc}
+
+ - Convert to PDF with ``latex``, ``dvips``, and ``ps2pdf``.
Table of figures
----------------
@@ -284,6 +299,7 @@ image formats depend on the used driver (dvi, dvips, pdftex, ...).
If pdf-image inclusion in pdf files fails, specify
``--graphicx-option=pdftex`` or ``--graphicx-option=auto``.
+Wrapping text around images requires the wrapfig package.
Commands directly to LaTeX
==========================
@@ -348,6 +364,13 @@ Problems
Open to be fixed or open to discussion.
+Lists
+-----
+
+Definitions in definition lists start on the same line as the term. Putting
+``\leavevmode`` after the term results in a new newline if the definition
+starts with a item list or similar.
+
footnotes and citations
-----------------------
@@ -401,6 +424,9 @@ Tables
uses raggedright.
- Ragged right fails on followup paragraphs as the vertical space would be
missing.
+* Use tabularx column type ``X`` and let latex decide width.
+* csv-tables do not have a colwidth.
+
Notes
~~~~~
@@ -423,8 +449,6 @@ Miscellaneous
* recognize LaTeX and replace by ``\LaTeX``.
* Support embed-stylesheet.
* Sidebar handling.
-* Maybe add end of line after term in definition list. see
- http://roundup.sf.net/doc-0.5/features.pdf
* Pdfbookmark level 4 (and greater) does not work (might be settable but OTOH).
* center subsection{Abstract} gives a LaTeX error here.
``! LaTeX Error: Something's wrong--perhaps a missing \item.``