just FYI:
This feature is requested as https://github.com/sphinx-doc/sphinx/issues/326
Thanks,
Takeshi KOMIYA
2016年9月13日火曜日 6時20分15秒 UTC+9 Fiona Hanington:
>
> Thanks! This works, and now I can build. However, the extension doesn't
> seem to be working -- my refs still render as the titles not the section
> numbers. Anyone on this list use the extension?
>
> On Monday, 12 September 2016 08:24:24 UTC-7, Komiya Takeshi wrote:
>>
>> Hi,
>>
>> I've never used the extension, but it might work with following steps:
>>
>> 1. copy numsec.py into your project
>> 2. rewrite your conf.py to add current directory into sys.path::
>>
>> sys.path.insert(0, os.path.abspath('.'))
>>
>> 3. add "numsec" (without .py suffix) into extensions list
>>
>> extensions = [..., 'numsec']
>>
>> Please try it out.
>>
>> Thanks,
>> Takeshi KOMIYA
>>
>> 2016年9月9日金曜日 7時39分57秒 UTC+9 Fiona Hanington:
>>>
>>> Hi,
>>>
>>> I know there has been discussion here lately re: references to section
>>> numbers (eg, see Section 2.3) rather than names.
>>>
>>> In the meantime, I am trying to install the numsec.py extension to get
>>> this functionality. But I am a newby and am having some trouble.
>>>
>>> Where should I install it in my docs repo? How do I need to modify
>>> conf.py to point to it?
>>>
>>> Here's how conf.py looks now, but the Sphinx build is failing. Note
>>> that I put numsec.py into the same dir as conf.py - is this OK? and how do
>>> I tell conf.py to look for it there?
>>>
>>>
>>> import sys, os
>>>
>>> # If extensions (or modules to document with autodoc) are in another
>>> directory,
>>> # add these directories to sys.path here. If the directory is relative
>>> to the
>>> # documentation root, use os.path.abspath to make it absolute, like
>>> shown here.
>>> #sys.path.insert(0, os.path.abspath('.'))
>>>
>>>
>>> # -- General configuration
>>> -----------------------------------------------------
>>>
>>> # If your documentation needs a minimal Sphinx version, state it here.
>>> #needs_sphinx = '1.0'
>>>
>>> # Add any Sphinx extension module names here, as strings. They can be
>>> extensions
>>> # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
>>>
>>> extensions = ['sphinx.ext.autodoc',
>>> 'sphinx.ext.doctest',
>>> 'sphinx.ext.intersphinx',
>>> 'sphinx.ext.todo',
>>> 'sphinx.ext.ifconfig',
>>> 'sphinx.ext.viewcode',
>>> 'sphinx.ext.mathjax',
>>> * 'numsec.py'*]
>>>
>>
--
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 https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.
