summaryrefslogtreecommitdiff
path: root/sandbox/code-block-directive/docs/pygments_with_docutils-latex-problems.txt
blob: 99ca7a48f8f7830c32fc4f1aff5623dcae174713 (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
Now to some of the details (This is rather for LaTeX inclined

> > * latex-output seems even less usable.

This is actually an understatement:

Currently, an inline node with a class unknown to the latex writer like::

  <inline classes="keyword">
            def

is converted to a function::

  \docutilsroleNone{def}

which is not defined in the preamble and hence leads to an error if the
documents is translated to PDF.

IMO, the missing feature is a "failsave" handling of class information:

  In HTML, the semantic syntax markup can be simply stored in a class
  argument to a <span> element. It can be used by the CSS stylesheet for
  syntax highlight and is simply ignored if no CSS rule for the given
  class exists.

LaTeX does not have a "class" attribute, so some emulation of this
concept is needed. Maybe we can use a \newcommand with optional argument?