aboutsummaryrefslogtreecommitdiff
path: root/TODO
blob: 8a0e47291a8f2214113c38c4248523c7c77e3056 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# TODO

*   Use new downloads and wiki features on googlecode?  Perhaps
    some makefile targets can be simplified...

*   state license on first page of website.  also at top of every
    source file... (c) date, and license with link to text.

*   Use XHTML library for HTML writer?  Not yet - it's not standard
    with 6.4.2 (but is with 6.6).  When we can drop support for 
    6.4.2, we can use it.

*   Consider merging changes in pandoc-wrappers (symlinks rather than
    wrapper scripts, except web2markdown and markdown2pdf). 

*   pandoc's HTML output fails to validate completely (w3c).
    There are a few quirks:
    + HTML doesn't like the \> at the end of <meta tags.
      But if we remove them, we'll have trouble with S5 output,
      which seems to need the xhtml header?
    + There's also a problem with the email obfuscation scheme.
      <noscript> isn't allowed inside <p> blocks.  <script> is
      allowed!  Options:
          - come up with another scheme, perhaps more like markdown.pl's
          - ignore the validation problems
          - others?

*   Consider adding support for acronyms.
    Perhaps like this:  [AAAS]
      [AAAS]: "American association for the advancement of science"
    <acronym title="American association for the advancement 
    of science">AAAS</acronym>

*   Consider changing footnote syntax so that all footnotes in markdown
    are embedded (and automatic).^[Like this.  Here's a footnote.  It
    is parsed like a block, so you can have embedded code blocks:

         like this { code }

    ] That was the end of the note.  This means having block elements
    embedded in inline elements, which is possible.
    Advantage:  Much easier to write.  You don't have to pick a label,
    move down to type your note, move back up.
    Disadvantage:  Perhaps slightly harder to read.  (But HTML and LaTeX
    output will still be easy to read.)

    Perhaps a better idea would be to conform to the syntax suggested
    in http://rephrase.net/box/word/footnotes/syntax/#fnref-4
    which seems to have become a de facto standard.  Note that this
    allows inline footnotes, with a slightly uglier syntax - though
    we could introduce ^[blah] as a simplified alternate syntax.
    Note also the implementation changes: auto-numbered footnotes
    in HTML.