Re: [sphinx-dev] Possible to break a title across two lines?

2011-01-13 Thread Curiouslearn
I was also wondering about exactly the same thing yesterday. I, in
fact, sent an email to the group but did not see that email reach the
group.

Anyhow, is it possible to increase the text size in addition to using
strong emphasis?

Thanks.

On Thu, Jan 13, 2011 at 2:34 AM, Georg Brandl ge...@python.org wrote:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1

 Am 12.01.2011 22:21, schrieb Kevin Cole:
 Hi,

 I haven't been fooling w/ Sphinx or reST very long, and don't know LaTeX.  
 I'm
 currently running Sphinx 1.0.1 under Ubuntu Maverick.

 I've tried a few different ways to get a document subtitle, but in LaTeX, it
 interprets the subtitle as a section heading. Not what I want at all.  
 Ideally,
 I'd want a line of text in a large font, followed immediately by text in a
 smaller font.  But I could probably live w/ two lines of equally large fonts.

 Hi Kevin,

 it's not possible with either rST or LaTeX to break a title in two lines.

 What you could do is to just use strong emphasis:


 Title
 =

 **Subtitle**


 Georg

-- 
You received this message because you are subscribed to the Google Groups 
sphinx-dev group.
To post to this group, send email to sphinx-dev@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.



Re: [sphinx-dev] Possible to break a title across two lines?

2011-01-13 Thread Curiouslearn
@TP  Thanks! If you don't mind, can you send me an example of your
subtitle css. Also, did you save it in _static. Does one need both
container and class directives to do this?

Thanks for your patience.


On Thu, Jan 13, 2011 at 7:28 AM, TP wing...@gmail.com wrote:
 On Thu, Jan 13, 2011 at 2:07 AM, Curiouslearn curiousle...@gmail.com wrote:
 I was also wondering about exactly the same thing yesterday. I, in
 fact, sent an email to the group but did not see that email reach the
 group.

 Anyhow, is it possible to increase the text size in addition to using
 strong emphasis?

 Thanks.

 On Thu, Jan 13, 2011 at 2:34 AM, Georg Brandl ge...@python.org wrote:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1

 Am 12.01.2011 22:21, schrieb Kevin Cole:
 Hi,

 I haven't been fooling w/ Sphinx or reST very long, and don't know LaTeX.  
 I'm
 currently running Sphinx 1.0.1 under Ubuntu Maverick.

 I've tried a few different ways to get a document subtitle, but in LaTeX, 
 it
 interprets the subtitle as a section heading. Not what I want at all.  
 Ideally,
 I'd want a line of text in a large font, followed immediately by text in a
 smaller font.  But I could probably live w/ two lines of equally large 
 fonts.

 Hi Kevin,

 it's not possible with either rST or LaTeX to break a title in two lines.

 What you could do is to just use strong emphasis:


 Title
 =

 **Subtitle**


 Georg

 --
 You received this message because you are subscribed to the Google Groups 
 sphinx-dev group.
 To post to this group, send email to sphinx-dev@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.



 For HTML generation, I did something like this by doing:

    ===
    My Normal Title
    ===

    .. container::
       :class: subtitle

       This is My Very Long Subtitle |BR| That Spans Two Lines
       By Using a br /

    .. |BR| replace:: :raw-html:`br /`

 and creating a custom CSS style for my new subtitle class to make
 its font larger than normal. Maybe you can do something similar for
 LaTeX?

 --
 You received this message because you are subscribed to the Google Groups 
 sphinx-dev group.
 To post to this group, send email to sphinx-dev@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.



-- 
You received this message because you are subscribed to the Google Groups 
sphinx-dev group.
To post to this group, send email to sphinx-dev@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.



Re: [sphinx-dev] Possible to break a title across two lines?

2011-01-13 Thread TP
On Thu, Jan 13, 2011 at 9:35 AM, Curiouslearn curiousle...@gmail.com wrote:
 @TP  Thanks! If you don't mind, can you send me an example of your
 subtitle css. Also, did you save it in _static.

in my conf.py file I have:
html_theme = 'customtheme'

html_theme_path = ['.']

in my customtheme\static\customtheme.css_t file i have (along with a
bunch of other stuff):

@import url(default.css);
div.container.subtitle {
  font-size: 160%;
  font-family: sans-serif;
  font-weight: normal;
  margin-bottom: 0.5em;
}

(This makes sure that *only* div's that have both container 
subtitle class names will be affected)

Does one need both
 container and class directives to do this?

Given the following in a .rst file:

.. container::
   :class: subtitle

container is the standard docutils directive documented at
http://docutils.sourceforge.net/docs/ref/rst/directives.html#container.
:class:  is an option for that directive. It generates something
like the following HTML:

div class=class subtitle container
This is My Very Long Subtitle span class=raw-htmlbr //span
That Spans Two Lines By Using a lt;br /gt;
/div

After rereading the above mentioned documentation on container, I
see that I should probably have done the following:

.. container:: subtitle

Which generates the clearer:

div class=subtitle container

 Thanks for your patience.


 On Thu, Jan 13, 2011 at 7:28 AM, TP wing...@gmail.com wrote:
 On Thu, Jan 13, 2011 at 2:07 AM, Curiouslearn curiousle...@gmail.com wrote:
 I was also wondering about exactly the same thing yesterday. I, in
 fact, sent an email to the group but did not see that email reach the
 group.

 Anyhow, is it possible to increase the text size in addition to using
 strong emphasis?

 Thanks.

 On Thu, Jan 13, 2011 at 2:34 AM, Georg Brandl ge...@python.org wrote:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1

 Am 12.01.2011 22:21, schrieb Kevin Cole:
 Hi,

 I haven't been fooling w/ Sphinx or reST very long, and don't know LaTeX. 
  I'm
 currently running Sphinx 1.0.1 under Ubuntu Maverick.

 I've tried a few different ways to get a document subtitle, but in LaTeX, 
 it
 interprets the subtitle as a section heading. Not what I want at all.  
 Ideally,
 I'd want a line of text in a large font, followed immediately by text in a
 smaller font.  But I could probably live w/ two lines of equally large 
 fonts.

 Hi Kevin,

 it's not possible with either rST or LaTeX to break a title in two lines.

 What you could do is to just use strong emphasis:


 Title
 =

 **Subtitle**


 Georg

 --
 You received this message because you are subscribed to the Google Groups 
 sphinx-dev group.
 To post to this group, send email to sphinx-dev@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.



 For HTML generation, I did something like this by doing:

    ===
    My Normal Title
    ===

    .. container::
       :class: subtitle

       This is My Very Long Subtitle |BR| That Spans Two Lines
       By Using a br /

    .. |BR| replace:: :raw-html:`br /`

 and creating a custom CSS style for my new subtitle class to make
 its font larger than normal. Maybe you can do something similar for
 LaTeX?

 --
 You received this message because you are subscribed to the Google Groups 
 sphinx-dev group.
 To post to this group, send email to sphinx-dev@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.



 --
 You received this message because you are subscribed to the Google Groups 
 sphinx-dev group.
 To post to this group, send email to sphinx-dev@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.



-- 
You received this message because you are subscribed to the Google Groups 
sphinx-dev group.
To post to this group, send email to sphinx-dev@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.