Hi all,

I want to document ConTeXt commands.

I set up a new directive and role with:


def setup(app):
    app.add_object_type('contextcommand', 'contextcommand',
    objname='ConTeXt command',
    indextemplate='pair: %s; ConTeXt command')

But I have some issues.

A typical ConTeXt command is:

\setupbackgrounds[foo][bar][baz=4]

or

\at{foo}{bar}{baz}

The things in brackets are the options and configurations of the command.

I have to escape the backslash. This is annoying but no big issue.

But I want that only the core command appears in the index not all the
options.

But

.. contextcommand:: \at {foo} {bar} {baz}

makes an entry with the whole line: \at {foo} {bar} {baz}

And I need the full line to reference the command. But I would like to
reference it with the core command name only, like this:

The command :contextcommand:`\\at` does foo bar...

Any hints?

Has anybody yet documented LaTeX or ConTeXt code with Sphinx?

Ciao!
juh

-- 
Software-Dokumentation mit Sphinx
http://www.amazon.de/dp/1497448689/
Paperback: 224 Seiten

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to