search

hplgit / doconce

Lightweight markup language - document once, include anywhere
http://hplgit.github.io/doconce/doc/web/index.html
Other
309 stars 60 forks source link

Numbering in sphinx #155

Closed mikaem closed 6 years ago

mikaem commented 6 years ago

Hi

Just a question really. The default behaviour when creating sphinx is to rename all references. Referring to the rst_bib signature:

def rst_bib(filestr, citations, pubfile, pubdata, numbering=True):
    """
    Replace doconce citations and bibliography with reST syntax.
    If numbering is True, the keys used in the bibliography are
    replaced by numbers (RefX). This will often look better.
    """

How is it possible to set numbering to False without hardcoding this in the signature? I cannot find any way to overload this keyword argument.

KGHustad commented 6 years ago

There is presently no command line option to control this setting.

KGHustad commented 6 years ago

It's very easy to add such an option, though. We could add something like --sphinx_preserve_bib_keys which sets numbering=False in the call to rst_bib. Does that sound like a reasonable solution?

mikaem commented 6 years ago

That would be great:-)