Add custom title page

[Julia Evans]

Hi, 

I'm new to Sphinx, and I'd like to create a custom title page. I have figured out how I can suppress the title page by adding 'maketitle': ' ', in the conf.py file, but how do I replace it with a custom cover page? And If I can, what format doe sit have to be in? 

I'm using the "howto" sphinx template.

Thanks, 

Julia

[TP]

On Fri, Apr 4, 2014 at 1:58 PM, Julia Evans <jwev...@gmail.com> wrote:

I'm new to Sphinx, and I'd like to create a custom title page. I have figured out how I can suppress the title page by adding 'maketitle': ' ', in the conf.py file, but how do I replace it with a custom cover page? And If I can, what format doe sit have to be in? 

I'm using the "howto" sphinx template.

Sphinx uses its own custom front page in https://bitbucket.org/birkenfeld/sphinx/src/tip/doc/conf.py by doing;

   html_sidebars = {'index': ['indexsidebar.html', 'searchbox.html']}
   html_additional_pages = {'index': 'index.html'}

[documented at http://sphinx-doc.org/config.html#confval-html_additional_pages and http://sphinx-doc.org/config.html#confval-html_sidebars]

where index.html and indexsidebar.html are in https://bitbucket.org/birkenfeld/sphinx/src/tip/doc/_templates/

It also uses:

   master_doc = 'contents'

to rename the Sphinx generated main file.

 

[juh]

Am 04.04.2014 22:58, schrieb Julia Evans:
> Hi,
>
> I'm new to Sphinx, and I'd like to create a custom title page. I have
> figured out how I can suppress the title page by adding 'maketitle': '
> ', in the conf.py file, but how do I replace it with a custom cover
> page? And If I can, what format doe sit have to be in?

You can try to define a custom title page in the preamble section of
latex_elements.


juh

[Julia Evans]

Thanks, juh, 

Can you give me a little more direction on how I would do that? I see where I can add "Additional stuff for the LaTeX preamble" in conf.py...

- Julia

[juh]

Hi Julia,

I am sorry, but after a second thought I realize that the preamble is
not the right place to do this.

I even asked your question before and forgot the solution. Shame on me.

I never tried the solution myself but maybe this post will help you

https://groups.google.com/forum/#!topic/sphinx-users/xHXc5qem9QY

You can try to customize sphinxbook.cls as described in the posting.

juh

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