On 10/21/10, SHIBUKAWA Yoshiki <yosh...@shibu.jp> wrote:
> Hi,
>
>> I've wondered for a while how the Sphinx home page at
>> http://sphinx.pocoo.org/index.html is created. Unlike all the other
>> pages on the site there isn't a Show Source link. It also doesn't seem
>> to be in http://bitbucket.org/birkenfeld/sphinx/src/tip/doc/.
>
> This page is not created from reST file.
> See _template directory and you can see the file.
>
> http://bitbucket.org/birkenfeld/sphinx/src/tip/doc/
>
> Sphinx supports static html and Jinja2 template
> (you add suffix "_t" like "style.css_t") too.
>
> I was asked same question from my friend :-)
>
> --
> #! /usr/bin/python2
> def shibu(shibukawa, yoshiki):
> web = "http://www.shibu.jp";
> mail = "yosh...@shibu.jp"
> twitter = "@shibukawa"
> return "smile!"
>
> --
> You received this message because you are subscribed to the Google Groups
> "sphinx-dev" group.
> To post to this group, send email to sphinx-...@googlegroups.com.
> To unsubscribe from this group, send email to
> sphinx-dev+unsubscr...@googlegroups.com.
> For more options, visit this group at
> http://groups.google.com/group/sphinx-dev?hl=en.
>
>
Aha, thanks! You also need to add the following to your conf.py file:
master_doc = 'contents'
html_index = 'index.html'
# Custom sidebar templates, maps document names to template names.
html_sidebars = {
'index' :
['indexsidebar.html',
'searchbox.html'],
(Other custom sidebars here)
}
# Additional templates that should be rendered to pages, maps page names to
# template names.
html_additional_pages = {'index': 'index.html'}
(and then change the name of your default main .rst page from
index.rst to contents.rst)
The html_index conf.py option doesn't seem to be documented at
http://sphinx.pocoo.org/config.html#options-for-html-output and
perhaps it should be?
Also copy (and then edit)
http://bitbucket.org/birkenfeld/sphinx/src/tip/doc/_templates/index.html
& indexsidebar.html to either the _templates directory or to your
custom theme directory.
Doing "make html" will now automatically create your new index.html Home page.
--
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to sphinx-...@googlegroups.com.
To unsubscribe from this group, send email to
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en.
