[sphinx-users] Re: Numbered start/offset for multiple toctrees?

2016-09-21 Thread geekademy
Thanks,

Unfortunately, I don't know *anything* about latex.  Would a new toctree 
parameter, say :startnum: be accepted if it only worked only html & epub?  
Perhaps another developer could enhance latex later.


-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.


Re: [sphinx-users] Re: Excluding particular base classes from autodoc inherited-members

2016-09-21 Thread Jake Vanderplas
Thanks Komiya,

In case anyone comes across this thread, what I ended up doing was creating
a custom Documenter for the objects in question which injects an
:exclude-members: option that explicitly lists every member of the base
class. A bit clunky, maybe, but it works.

Code is here:
https://github.com/ellisonbg/altair/blob/e4eff3ce59947b203ee08768c917a4976fd16071/doc/sphinxext/altair_ext/altair_autodoc.py#L53
   Jake

On Wed, Sep 21, 2016 at 1:33 AM, Komiya Takeshi  wrote:

> Hi Jake,
>
> As far as I know, there are no option to do that.
>
> Thanks,
>
> 2016年9月16日金曜日 0時41分01秒 UTC+9 Jake:
>
>> Hi all,
>> I hope to use autodoc for a project I'm working on. Most of my classes
>> inherit from some very low-level base classes, whose methods I don't want
>> in the documentation.
>>
>> Unfortunately, there are some other parent classes whose methods I *do*
>> want documented, so simply excluding autodoc's :inherited-members: is not
>> an option.
>>
>> Is there a way to specify particular base classes to exclude when using
>> autodoc's :inherited-members: option? If not, I'll probably end up forking
>> autodoc to extend it this way... thanks!
>>Jake
>>
> --
> 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 sphinx-users+unsubscr...@googlegroups.com.
> To post to this group, send email to sphinx-users@googlegroups.com.
> Visit this group at https://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.
>

-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.


[sphinx-users] Re: Numbered start/offset for multiple toctrees?

2016-09-21 Thread Komiya Takeshi
Hi,

sorry. I'd misread about the option. As you said, the parameter of 
:numbered: means the section depth.
It seems there are no options to do that.


If you want to do that, you need to modify sphinx.environment package. It 
assigns the section numbers for HTML.
(For LaTeX/PDF, the section numbers are assigned by LaTeX. So you need to 
modify both HTML and LaTeX)

Thanks,
Takeshi KOMIYA

2016年9月20日火曜日 8時08分48秒 UTC+9 geek...@mgmiller.net:
>
> Hi, thank you,
>
> According to the docs, the parameter to :numbered: is the section depth, 
> which seems odd and perhaps poorly thought out.  Also, it doesn't seem to 
> work.  I put a 10 there in the second toctree and it had no effect to 
> renumber the chapters.
>
> Is this something I could fix or enhance?  Would anyone else want it?  
> Where would code of this sort go?  Which files?  I'd really like to keep 
> the "parts" and not have to remove them.
>
> Thanks again,
> Mike
>
>
> On Tuesday, September 6, 2016 at 9:26:52 PM UTC-7, Komiya Takeshi wrote:
>

-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.


[sphinx-users] Re: Excluding particular base classes from autodoc inherited-members

2016-09-21 Thread Komiya Takeshi
Hi Jake,

As far as I know, there are no option to do that.

Thanks,

2016年9月16日金曜日 0時41分01秒 UTC+9 Jake:
>
> Hi all,
> I hope to use autodoc for a project I'm working on. Most of my classes 
> inherit from some very low-level base classes, whose methods I don't want 
> in the documentation.
>
> Unfortunately, there are some other parent classes whose methods I *do* 
> want documented, so simply excluding autodoc's :inherited-members: is not 
> an option.
>
> Is there a way to specify particular base classes to exclude when using 
> autodoc's :inherited-members: option? If not, I'll probably end up forking 
> autodoc to extend it this way... thanks!
>Jake
>

-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.


Re: [sphinx-users] Sphinx-1.5a1 has been released

2016-09-21 Thread Paolo Cavallini
Il 21/09/2016 09:00, Komiya Takeshi ha scritto:

> Please refer CHANGES file.
> You can see it here: https://github.com/sphinx-doc/sphinx/blob/1.5a1/CHANGES

Thanks. A lot of work, compliments.
All the best.
-- 
Paolo Cavallini - www.faunalia.eu
QGIS & PostGIS courses: http://www.faunalia.eu/training.html

-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.


Re: [sphinx-users] Sphinx-1.5a1 has been released

2016-09-21 Thread Komiya Takeshi
Hi Paolo,

Please refer CHANGES file.
You can see it here: https://github.com/sphinx-doc/sphinx/blob/1.5a1/CHANGES

Thanks,
Takeshi KOMIYA

2016年9月21日水曜日 15時53分03秒 UTC+9 Paolo Cavallini:
>
> Il 21/09/2016 05:42, Komiya Takeshi ha scritto: 
> > Hi developers, 
> > 
> > We just released 1.5a1. 
> > It includes much of improvements. I believe it will help you. 
> > Please let me us if you got errors with your docs. 
>
> Thanks Takeshi-san, 
> where do we find the list of new features? 
> All the best. 
>
> -- 
> Paolo Cavallini - www.faunalia.eu 
> QGIS & PostGIS courses: http://www.faunalia.eu/training.html 
>

-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.