sandbox/code-block-directive/docs/pygments_with_docutils-latex-problems.txt

   1 Now to some of the details (This is rather for LaTeX inclined
   2
   3 > > * latex-output seems even less usable.
   4
   5 This is actually an understatement:
   6
   7 Currently, an inline node with a class unknown to the latex writer like::
   8
   9   <inline classes="keyword">
  10             def
  11
  12 is converted to a function::
  13
  14   \docutilsroleNone{def}
  15
  16 which is not defined in the preamble and hence leads to an error if the
  17 documents is translated to PDF.
  18
  19 IMO, the missing feature is a "failsave" handling of class information:
  20
  21   In HTML, the semantic syntax markup can be simply stored in a class
  22   argument to a <span> element. It can be used by the CSS stylesheet for
  23   syntax highlight and is simply ignored if no CSS rule for the given
  24   class exists.
  25
  26 LaTeX does not have a "class" attribute, so some emulation of this
  27 concept is needed. Maybe we can use a \newcommand with optional argument?