"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "docutils-0.5/docutils/writers/newlatex2e/notes.txt" of archive docutils-0.5.tar.gz:

    1 New LaTeX Writer
    2 ================
    3 
    4 :Copyright: This document has been placed in the public domain.
    5 
    6 The new LaTeX writer (newlatex2e) is in active development.  These are
    7 development notes -- edit ahead!  Ultimately, they will be moved to
    8 the global to-do list, but while newlatex2e is incomplete, they remain
    9 here.
   10 
   11 * It appears that all visit_ methods can be turned into before_
   12   methods (and renamed thereafter).
   13 
   14 * Also pass raw text (foo_bar) and not only renderable text (foo{\_}bar).
   15   See http://article.gmane.org/gmane.text.docutils.user/2516.
   16 
   17 * Try the commands mentioned in
   18   <http://groups.google.com/groups?selm=c7opho%248ts%241%40wsc10.lrz-muenchen.de>.
   19 
   20 * <http://www.tug.org/applications/pdftex/pdfTeX-FAQ.pdf>::
   21 
   22       3.1.6. How can I make a document portable to both latex and pdflatex
   23       Contributed by: Christian Kumpf
   24       Check for the existence of the variable \pdfoutput:
   25       \newif\ifpdf
   26       \ifx\pdfoutput\undefined
   27       \pdffalse % we are not running PDFLaTeX
   28       \else
   29       \pdfoutput=1 % we are running PDFLaTeX
   30       \pdftrue
   31       \fi
   32       Then use your new variable \ifpdf
   33       \ifpdf
   34       \usepackage[pdftex]{graphicx}
   35       \pdfcompresslevel=9
   36       \else
   37       \usepackage{graphicx}
   38       \fi
   39 
   40 * Need to get some simple docinfo field handling. Move language look-up logic to nodes.py?
   41   Same for admonitions.
   42 
   43 * Footnotes should be placed on the same page as their references.
   44   However, there may be multiple references per footnote, so
   45   we'll probably need an option and some sophisticated handling for this.
   46 
   47 * Make sure we don't break ligatures (and possibly hyphenation) with zealous brace protection.
   48   See http://article.gmane.org/gmane.text.docutils.user/2586.
   49 
   50 * Tables inside of footnotes have too large vertical margins.
   51   Need a "reduced vertical margin" mode, maybe?
   52 
   53 * There's not enough vertical space between fields::
   54 
   55       :Name:
   56           Paragraph.
   57           Paragraph.
   58       :Name:
   59           Paragraph.
   60           Paragraph.
   61 
   62 * Another edge case with too much vertical margin::
   63 
   64       +--------------------+
   65       | :Name:             |
   66       |     Paragraph.     |
   67       | :Name:             |
   68       |     Paragraph.     |
   69       +--------------------+
   70 
   71 * We want to support underscores in citation references, they need to
   72   appear unescaped.
   73 
   74 * If there's raw code between paragraphs, it gets appended to the last
   75   paragraph unless we do ``\par``.  That's a little bit ugly.  Can we
   76   fix this?  (Change paragraph handling maybe?)
   77 
   78 * Test that, say, all Latin 1 characters are renderable.  (And
   79   possibly test more characters.)