Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.python > #97388

Re: Footnotes in ReST

Show key headers only | View raw

Blake Garretson wrote:

> On Oct 3, 2015 7:40 AM, "Steven D'Aprano" <steve@pearwood.info> wrote:
>> I need to add a footnote between [2] and [3], but I don't want to have to
>> renumber the following 997 footnotes by hand. Is there something I can
>> do, within the syntax of ReST itself, to help?
> 
> I would use a regular expression to find and replace all the numbers with
> the auto-numbering feature.  So something like "\[\d+\]_" should be
> replaced with "\[#\]_".

With labeled autonumbers:

>>> text = """\
...     blah blah blah [1]_ and blah blah blah [2]_.
...     blah blah [3]_ blah ... blah blah
...     blah blah [999]_.
... 
...     .. [1] fe
...     .. [2] fi
...     .. [3] fo
...        ...
...     .. [999] fum
... """
>>> print(re.compile(r"\[(\d+)\]").sub(r"[#n\1]", text))
    blah blah blah [#n1]_ and blah blah blah [#n2]_.
    blah blah [#n3]_ blah ... blah blah
    blah blah [#n999]_.

    .. [#n1] fe
    .. [#n2] fi
    .. [#n3] fo
       ...
    .. [#n999] fum

Changing numbers to make room for a new footnote is not much harder (but 
less convenient as you have to repeat it for every new footnote):

>>> def replace(match, n=2):
...     index = int(match.group(1))
...     if index >= n:
...         index += 1
...     return "[{}]".format(index)
... 
>>> print(re.compile(r"\[(\d+)\]").sub(replace, text))
    blah blah blah [1]_ and blah blah blah [3]_.
    blah blah [4]_ blah ... blah blah
    blah blah [1000]_.

    .. [1] fe
    .. [3] fi
    .. [4] fo
       ...
    .. [1000] fum

Back to comp.lang.python | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

Footnotes in ReST Steven D'Aprano <steve@pearwood.info> - 2015-10-03 21:39 +1000
  Re: Footnotes in ReST Chris Angelico <rosuav@gmail.com> - 2015-10-03 21:57 +1000
  Re: Footnotes in ReST Laura Creighton <lac@openend.se> - 2015-10-03 14:21 +0200
    Re: Footnotes in ReST Steven D'Aprano <steve@pearwood.info> - 2015-10-04 00:22 +1000
  Re: Footnotes in ReST Peter Otten <__peter__@web.de> - 2015-10-04 11:50 +0200
  Re: Footnotes in ReST Peter Otten <__peter__@web.de> - 2015-10-04 12:14 +0200

csiph-web