[Distutils] Proposal: moving PyPA projects to pydoctheme

Ionel Cristian Mărieș contact at ionelmc.ro
Sat May 27 07:51:13 EDT 2017


Interestingly this doesn't have the "sticky" sidebar (eg: it moves as you
scroll page) as the py3 docs have. This is my attempt to package it into a
reusable theme btw:
http://ionelmc.github.io/sphinx-py3doc-enhanced-theme/bare/reference/foo.bar.html

You probably don't want to use that directly but maybe there is stuff you
can just copy from it.


Thanks,
-- Ionel Cristian Mărieș, http://blog.ionelmc.ro

On Fri, May 26, 2017 at 7:32 PM, Jon Wayne Parrott via Distutils-SIG <
distutils-sig at python.org> wrote:

> Awesome, more good feedback. I've made some stylesheet adjustments to
> highlight both the current page (by bolding) and the current section (by
> coloring links). Let me know on the PR if you have alternative
> recommendations (leaving out the current section coloring is actually fine,
> IMO). Staged again here (http://temp.theadora.io/
> pypug-pydoctheme/self_hosted_repository.html).
>
> Since we mostly seem to all be in agreement, can someone who's an admin on
> the PyPA org create the pypa-theme repository for me?
>
> On Fri, May 26, 2017 at 5:13 AM Nick Coghlan <ncoghlan at gmail.com> wrote:
>
>> Thanks for working on this, Jon!
>>
>> On 26 May 2017 at 17:06, Nathaniel Smith <njs at pobox.com> wrote:
>> > Further nitpick: the new version shows the whole ToC, but doesn't do
>> > anything to mark which part of it corresponds to the current page (cf
>> > the RTD theme's grey box), which makes it hard to orient oneself when
>> > looking at it. Some sort of "you are here" indicator would help :-)
>>
>> While the subtree expansion does provide a bit of that, I do agree
>> that some additional contrast between the expanded section and the
>> rest of the ToC would be beneficial.
>>
>> Cheers,
>> Nick.
>>
>> --
>> Nick Coghlan   |   ncoghlan at gmail.com   |   Brisbane, Australia
>>
>
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG at python.org
> https://mail.python.org/mailman/listinfo/distutils-sig
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20170527/a26ccb82/attachment.html>


More information about the Distutils-SIG mailing list