~ubuntu-branches/ubuntu/lucid/python-docutils/lucid

« back to all changes in this revision

Viewing changes to docutils/writers/newlatex2e/notes.txt

  • Committer: Bazaar Package Importer
  • Author(s): Simon McVittie
  • Date: 2008-07-24 10:39:53 UTC
  • mfrom: (1.1.4 upstream) (3.1.7 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080724103953-8gh4uezg17g9ysgy
Tags: 0.5-2
* Upload docutils 0.5 to unstable
* Update rst.el to upstream Subversion r5596, which apparently fixes
  all its performance problems (17_speed_up_rst_el.dpatch, closes: #474941)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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.)