Re: [sphinx-dev] Re: image directive :align: bottom not working
Thanks Guenter. I need to learn more CSS. Thanks. On Wed, Jan 26, 2011 at 4:11 AM, Guenter Milde wrote: > On 2011-01-25, Curiouslearn wrote: >> Hi, > >> I am using version 1.0.7 of Sphinx. I entered the following code at >> the top of my index.rst file: > >> .. image:: _static/dataimage.pdf >> :height: 100px >> :width: 200px >> :align: bottom > >> The image does not show up. I get an error saying, > >> (ERROR/3) Error in "image" directive: "bottom" is not a valid value >> for the "align" option. Valid values for "align" are: "left", >> "center", "right". > >> The information on docutils website >> (http://docutils.sourceforge.net/docs/ref/rst/directives.html#image) >> says that "bottom" is a valid option. Is this a restriction in Sphinx >> or is this a bug? > > It is a restriction in Docutils: bottom and top alignment is only > valid in in-line images (the ones you get via |substitution|). > >> If it is a restriction, is there another way I can get the title of >> the index.rst file to align with the bottom of the image. > > CSS styling. > > Günter > > -- > 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.
[sphinx-dev] image directive :align: bottom not working
Hi, I am using version 1.0.7 of Sphinx. I entered the following code at the top of my index.rst file: .. image:: _static/dataimage.pdf :height: 100px :width: 200px :align: bottom The image does not show up. I get an error saying, (ERROR/3) Error in "image" directive: "bottom" is not a valid value for the "align" option. Valid values for "align" are: "left", "center", "right". The information on docutils website (http://docutils.sourceforge.net/docs/ref/rst/directives.html#image) says that "bottom" is a valid option. Is this a restriction in Sphinx or is this a bug? If it is a restriction, is there another way I can get the title of the index.rst file to align with the bottom of the image. Thank you. -- 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.
[sphinx-dev] matplotlib plot directive
Hello, I just learnt how to add matplotlib extension for sphinx to the sphinx project so that I can embed matplotlib code that is coverted to figures on the fly. I tried two figures and matplotlib gives these figures the name of "hires.png". I have not specified the name "hires" anywhere in my document, so I suppose it is somewhere in the extension code. Can someone please tell me how can I get rid of this name "hires"? Thanks -- 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.
[sphinx-dev] Re: Change some auto generated text in the html
Please ignore the last email. It was just the title in the index file that was auto generated. Sorry. On Fri, Jan 14, 2011 at 9:12 PM, Curiouslearn wrote: > Hello All, > > I am using the 'default' theme for some notes about data in a folder. > I changed the 'html_title' to > > html_title = "Information about Data Files" > > This changes the title at the very top of the page (I think it is > called relbar, but I am not sure). However, the main heading (the one > in big letters) in index.html is still > > "Welcome to data_price_decision's documentation". > > I think in the sphinx-quickstart, I had written 'data_price_decision ' > as the project name. Can someone please point me to the file where I > need to change this main title. > > Thanks. > -- 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.
[sphinx-dev] Change some auto generated text in the html
Hello All, I am using the 'default' theme for some notes about data in a folder. I changed the 'html_title' to html_title = "Information about Data Files" This changes the title at the very top of the page (I think it is called relbar, but I am not sure). However, the main heading (the one in big letters) in index.html is still "Welcome to data_price_decision's documentation". I think in the sphinx-quickstart, I had written 'data_price_decision ' as the project name. Can someone please point me to the file where I need to change this main title. Thanks. -- 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] how to share documents created using Sphinx (html version)
Kevin, thanks for writing the Mathjax extension. I changed the path to your suggestion below. It now works great. Thanks. On Thu, Jan 13, 2011 at 6:01 PM, Kevin Dunn wrote: > On Thu, Jan 13, 2011 at 17:54, Curiouslearn wrote: >> Transferring just the _build/html directory works best except that the >> math does not compile. I am using Mathjax extension. It shows fine on >> my computer but not on my personal website. Everything else (like the >> links, search seem to work) > > Hi Bharat, > > MathJax has a large overhead (around 100Mb) to transfer. I host a free > MathJax installation - read more about it at > http://mathjax.connectmv.com > > Basically all you need to do is set in your Sphinx ``conf.py`` that: > > mathjax_path = 'http://mathjax.connectmv.com/MathJax.js' > > and as long as you have an internet connection you don't need to worry > about the MathJax files. Otherwise, you will need to copy them along > with your HTML. > > The other option is, of course, to use the PNG math extension, which > will create small PNG files that go with your HTML. > > Kevin > > >> Can someone please help? Thanks. >> >> Best, >> Bharat >> >> On Thu, Jan 13, 2011 at 5:01 PM, Curiouslearn wrote: >>> @TP Thanks so much for all your responses. Really appreciate it. >>> >>> >>> On Thu, Jan 13, 2011 at 3:27 PM, TP wrote: >>>> On Thu, Jan 13, 2011 at 11:18 AM, Curiouslearn >>>> wrote: >>>>> Hello All, >>>>> >>>>> Two questions about sharing Sphinx documentation with others: >>>>> >>>>> (1) Do you know of an easy way of private hosting of Sphinx documents >>>>> online (where you can restrict access to it)? Is there a web host or >>>>> some solution that makes this possible easily? >>>>> >>>>> (2) If I want to email the documentation to someone, which files do I >>>>> need to email? Do I need to send _build, _template and _static >>>>> directories. Does the recipient need to have Python? >>>>> >>>>> Thanks, >>>>> Bharat >>>>> >>>>> -- >>>>> 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. >>>>> >>>>> >>>> >>>> All you have to do is copy the contents of the _build/html directory >>>> tree to your web host or email it to someone (You can skip the >>>> .buildinfo & objects.inv files if you want). The _static directory is >>>> automatically copied to _build/html/_static as are the processed >>>> template files (.css_t files get converted to .css files). >>>> >>>> It's up to your website configuration as to whether those pages are >>>> private or not. >>>> >>>> Recipients only need a web browser to view Sphinx generated HTML pages. >>>> >>>> -- >>>> 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. > > -- 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] how to share documents created using Sphinx (html version)
Transferring just the _build/html directory works best except that the math does not compile. I am using Mathjax extension. It shows fine on my computer but not on my personal website. Everything else (like the links, search seem to work) Can someone please help? Thanks. Best, Bharat On Thu, Jan 13, 2011 at 5:01 PM, Curiouslearn wrote: > @TP Thanks so much for all your responses. Really appreciate it. > > > On Thu, Jan 13, 2011 at 3:27 PM, TP wrote: >> On Thu, Jan 13, 2011 at 11:18 AM, Curiouslearn >> wrote: >>> Hello All, >>> >>> Two questions about sharing Sphinx documentation with others: >>> >>> (1) Do you know of an easy way of private hosting of Sphinx documents >>> online (where you can restrict access to it)? Is there a web host or >>> some solution that makes this possible easily? >>> >>> (2) If I want to email the documentation to someone, which files do I >>> need to email? Do I need to send _build, _template and _static >>> directories. Does the recipient need to have Python? >>> >>> Thanks, >>> Bharat >>> >>> -- >>> 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. >>> >>> >> >> All you have to do is copy the contents of the _build/html directory >> tree to your web host or email it to someone (You can skip the >> .buildinfo & objects.inv files if you want). The _static directory is >> automatically copied to _build/html/_static as are the processed >> template files (.css_t files get converted to .css files). >> >> It's up to your website configuration as to whether those pages are >> private or not. >> >> Recipients only need a web browser to view Sphinx generated HTML pages. >> >> -- >> 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] Two newbie questions
@TP Thanks for this example. I will read it carefully. This should be
really helpful. Thanks again.
On Thu, Jan 13, 2011 at 3:56 PM, TP wrote:
> On Thu, Jan 13, 2011 at 9:32 AM, Curiouslearn wrote:
>> @Federico: Thanks so much. This is great.
>>
>> @Daslch: Thanks. Do I just save my css file in the _static directory
>> and then invoke the styles I define there using raw html directive.
>>
>> Thanks again.
>
> Here's what I do. In my conf.py file I set:
>
> html_theme = 'customtheme'
>
> html_theme_path = ['.']
>
> rst_prolog="""
> .. role:: myrole
> :class: mycustomrole
> """
>
> My customtheme\theme.conf contains:
>
> [theme]
> inherit = default
> stylesheet = customtheme.css
> pygments_style = sphinx
>
> and customtheme\static\customtheme.css_t contains:
>
> @import url("default.css");
> .mycustomrole {
> font-family: monospace;
> font-size: 125%;
> }
>
> if for example I want all "myrole" text to be monospace and bigger.
>
> In my .rst files I can then do:
>
> Some text that uses :myrole:`my custom role`.
>
> and when Sphinx generates the HTML it will look like:
>
>
> ...
>
> Some text that uses my custom role.
>
> So, as you can see there is rarely any need to use the :raw-html: role.
>
>
>> On Thu, Jan 13, 2011 at 10:06 AM, Federico Bruni wrote:
>>> 2011/1/13 Curiouslearn
>>>>
>>>> Hello All,
>>>>
>>>> Sphinx seems great. I am trying it out and I think I will start using
>>>> it for most of my writing. I have two basic questions:
>>>>
>>>> (1) How to get rid of the text "v0.1" or something like that which
>>>> refers to the version. I am writing some notes and it is not a
>>>> documentation about any software. I commented out "version = 0.1" in
>>>> the conf.py file and then I just got a "v".
>>>>
>>>
>>> In your conf.py you should specify html_title.
>>> Search this paragraph:
>>>
>>> # The name for this set of Sphinx documents. If None, it defaults to
>>> # " v documentation".
>>> #html_title = None
>>>
>>> --
>>> 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.
>
>
--
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] how to share documents created using Sphinx (html version)
@TP Thanks so much for all your responses. Really appreciate it. On Thu, Jan 13, 2011 at 3:27 PM, TP wrote: > On Thu, Jan 13, 2011 at 11:18 AM, Curiouslearn wrote: >> Hello All, >> >> Two questions about sharing Sphinx documentation with others: >> >> (1) Do you know of an easy way of private hosting of Sphinx documents >> online (where you can restrict access to it)? Is there a web host or >> some solution that makes this possible easily? >> >> (2) If I want to email the documentation to someone, which files do I >> need to email? Do I need to send _build, _template and _static >> directories. Does the recipient need to have Python? >> >> Thanks, >> Bharat >> >> -- >> 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. >> >> > > All you have to do is copy the contents of the _build/html directory > tree to your web host or email it to someone (You can skip the > .buildinfo & objects.inv files if you want). The _static directory is > automatically copied to _build/html/_static as are the processed > template files (.css_t files get converted to .css files). > > It's up to your website configuration as to whether those pages are > private or not. > > Recipients only need a web browser to view Sphinx generated HTML pages. > > -- > 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.
[sphinx-dev] how to share documents created using Sphinx (html version)
Hello All, Two questions about sharing Sphinx documentation with others: (1) Do you know of an easy way of private hosting of Sphinx documents online (where you can restrict access to it)? Is there a web host or some solution that makes this possible easily? (2) If I want to email the documentation to someone, which files do I need to email? Do I need to send _build, _template and _static directories. Does the recipient need to have Python? Thanks, Bharat -- 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?
@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 wrote: > On Thu, Jan 13, 2011 at 2:07 AM, Curiouslearn 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 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| replace:: :raw-html:`` > > 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] Two newbie questions
@Federico: Thanks so much. This is great. @Daslch: Thanks. Do I just save my css file in the _static directory and then invoke the styles I define there using raw html directive. Thanks again. On Thu, Jan 13, 2011 at 10:06 AM, Federico Bruni wrote: > 2011/1/13 Curiouslearn >> >> Hello All, >> >> Sphinx seems great. I am trying it out and I think I will start using >> it for most of my writing. I have two basic questions: >> >> (1) How to get rid of the text "v0.1" or something like that which >> refers to the version. I am writing some notes and it is not a >> documentation about any software. I commented out "version = 0.1" in >> the conf.py file and then I just got a "v". >> > > In your conf.py you should specify html_title. > Search this paragraph: > > # The name for this set of Sphinx documents. If None, it defaults to > # " v documentation". > #html_title = None > > -- > 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?
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 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.
[sphinx-dev] Two newbie questions
Hello All, Sphinx seems great. I am trying it out and I think I will start using it for most of my writing. I have two basic questions: (1) How to get rid of the text "v0.1" or something like that which refers to the version. I am writing some notes and it is not a documentation about any software. I commented out "version = 0.1" in the conf.py file and then I just got a "v". (2) How do I increase the font size of a piece of text that I want? Can I use one of the available themes and just add some css to it? Thanks in advance for your time. Regards, Bharat -- 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.
[sphinx-dev] sphinx newbie - error in make html
Hello,
I am trying to learn sphinx from the sampledoc tutorial on Matplotlib
(available at:
http://matplotlib.sourceforge.net/sampledoc/getting_started.html)
The very first step that involved
sphinx-quickstart
and the following set up went okay. I could see the page that the
tutorial said, I should see.
Then, I downloaded the sample_doc tutorial files as suggested and
saved them and then made a change to index.rst as mentioned in the
tutorial. That is, I added the line getting_started.rst to the
index.rst file as suggested in the tutorial. I then typed
make html
at the prompt and hit enter. However, I get an error. Can someone
please help me and identify what is wrong? Here is the log file with
full traceback.
Thanks in advance. I really hope I can learn and use Sphinx.
__
# Sphinx version: 1.0.4
# Docutils version: 0.7 release
# Jinja2 version: 2.5.5
Traceback (most recent call last):
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/sphinx/cmdline.py", line 173, in main
app.build(force_all, filenames)
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/sphinx/application.py", line 207, in build
self.builder.build_update()
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/sphinx/builders/__init__.py", line 198, in
build_update
'out of date' % len(to_build))
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/sphinx/builders/__init__.py", line 254, in
build
self.write(docnames, list(updated_docnames), method)
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/sphinx/builders/__init__.py", line 293, in
write
self.write_doc(docname, doctree)
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/sphinx/builders/html.py", line 399, in
write_doc
self.docwriter.write(doctree, destination)
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/docutils/writers/__init__.py", line 76, in
write
self.translate()
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/sphinx/writers/html.py", line 38, in translate
self.document.walkabout(visitor)
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/docutils/nodes.py", line 173, in walkabout
if child.walkabout(visitor):
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/docutils/nodes.py", line 173, in walkabout
if child.walkabout(visitor):
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/docutils/nodes.py", line 173, in walkabout
if child.walkabout(visitor):
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/docutils/nodes.py", line 165, in walkabout
visitor.dispatch_visit(self)
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/docutils/nodes.py", line 1601, in
dispatch_visit
return method(node)
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/sphinx/writers/html.py", line 525, in
visit_literal_block
HTMLTranslator.visit_literal_block(self, node)
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/sphinx/writers/html.py", line 236, in
visit_literal_block
lang, linenos)
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/sphinx/highlighting.py", line 207, in
highlight_block
lexer = lexers[lang] = get_lexer_by_name(lang)
File "/Library/Frameworks/Python.framework/Versions/6.3/lib/
python2.6/site-packages/pygments/lexers/__init__.py", line 80, in
get_lexer_by_name
raise ClassNotFound('no lexer for alias %r found' % _alias)
ClassNotFound: no lexer for alias u'ipython' found
--
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.
