Where can I find a sphinx theme used in Python official documentation site?

694 views
Skip to first unread message

Hiroki Watanabe

unread,
Jan 31, 2014, 11:36:46 PM1/31/14
to sphinx...@googlegroups.com
Hello,

Where can I find a sphinx theme used in the following Python official
documentation site made of sphinx 1.2.

Python 3.3.3 documentation:
http://docs.python.org/3/index.html

I think it is one of the most readable, calm and modern design.

Best regards,

Takayuki Shimizukawa

unread,
Jan 31, 2014, 11:54:21 PM1/31/14
to sphinx...@googlegroups.com
Hi,

I think this is the one:
http://hg.python.org/cpython/file/22e88355acd6/Doc/tools/sphinxext
However, I have not used it.

Regards,
--
Takayuki SHIMIZUKAWA
http://about.me/shimizukawa


2014-02-01 Hiroki Watanabe <hwatana...@gmail.com>:
> --
> 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...@googlegroups.com.
> To post to this group, send email to sphinx...@googlegroups.com.
> Visit this group at http://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/groups/opt_out.

Hiroki Watanabe

unread,
Feb 1, 2014, 7:52:34 AM2/1/14
to sphinx...@googlegroups.com
Hello,

Thank you very much!

I tried it. It worked well except color of sidebar's collapse button.

The followings are things I tried.

# Searching good themes, I noticed an extension theme,
# 'sphinxjp.themes.basicstrap' was also excellent.
# For while, I will use it for my purpose.

Things I tried
==============

1. Go the following site:

http://hg.python.org/cpython/file/22e88355acd6/Doc/tools/sphinxext/pydoctheme

2. Download a pydoctheme as a zip archive by clicking a "zip" link
where you can see left side of the site.

3. Unzip the archive under sphinx's source folder like this:

source/_themes/pydoctheme/theme.conf

4. Edit conf.py like this:

sys.path.append(os.path.abspath('_themes'))
html_theme_path = ['_themes']
html_theme = 'pydoctheme'

5. Execute 'make html'

You will notice that you can not see a collapse button on the sidebar. So,

6. Add 'collapsiblesidebar' option and its color to conf.py.

html_theme_options = {
   'collapsiblesidebar': True,
   'sidebarbtncolor': '#eeeeee',
}

A problem still exists. When you hover the collapse button, it will
disappear due to it having the same color of background. I don't know how to
solve this problem, maybe some CSS knowledge is required.

Best regards,


2014年2月1日土曜日 13時54分21秒 UTC+9 Takayuki SHIMIZUKAWA:
Reply all
Reply to author
Forward
0 new messages