Writing tips for LaTeX writers who want to convert to DocOnce and generate other formats
-
doconce latex2doconce helps the translation
- Use
\[ \], equation, equation*, align, align* and nothing more for
equations
- Figures: avoid subfigures (combine image files instead), use
\includegraphics, have captions after graphics, use short figure captions, position exactly where needed
- Tables: have them inline (not floating), with no caption
- Computer codes: have them inline (not floating)
- Rewrite all
pageref commands
- Do not use algorithm environments, use simple list formatting instead
- Avoid math in section headings
- Use
pdflatex or xetex
- Use BibTeX (can easily be converted to publish used by DocOnce)
- Use
\href for links (and insert links frequently)
- Use the
bm package for boldface \( \boldsymbol{u} \)
- Place all newcommands in a separate file, with one definition per line
(multiline definitions goes to a separate LaTeX preamble file in DocOnce)
- Avoid all fancy LaTeX constructs - more backslashes than needed in math
and sections is a bad thing...