[sphinx-dev] Re: Custom char for bullet list?

On 2012-10-28, Boris Kheyfets wrote: > [-- Type: text/plain, Encoding: quoted-printable --] > How do I use custom bullet char? > Is there a way I can give a bullet list a class -- so to assign "–" char as > a bullet char for a given list (and have the default bullets in other > lists)? > I ne

[sphinx-dev] Re: .. image::. prob

On 2012-10-25, Renato Pontefice wrote: > Sorry Gunter, what do you mean with: > "Mark, that you now have an "inline" " Images defined via :: .. image:: myimage.svn are block-level elements (like literal blocks or quotes), while images defined via :: .. |biohazard| image:: biohazard

[sphinx-dev] Re: .. image::. prob

On 2012-10-24, Renato wrote: > [-- Type: text/plain, Encoding: quoted-printable --] > I've solved. > this is the code: > ___ > The |biohazard| symbol must be used on containers used to > dispose of medical waste. > .. |biohazard| imag

[sphinx-dev] Re: .. image::. prob

On 2012-10-24, Renato wrote: > [-- Type: text/plain, Encoding: --] > Hi, > I've image problems. > with this statement: > .. image:: /xyz/image.png > I don' t receive neither the images, nor an error. What do you receive instead of the image? Maybe you just forgot to put a blank line before th

[sphinx-dev] Re: Different numbering schemes in nested ordered lists?

On 2012-10-12, leam hall wrote: > [-- Type: text/plain, Encoding: --] > For my next trick... > I have nested ordered lists, so that: > 1. blah > 2. blah > 1. foo > 2. bar > 3. More blah > I got them to indent correctly, mostly, in PDF and HTML. However, in one > foo is 1.1 and i

[sphinx-dev] Re: section number

On 2012-10-08, Federico Bruni wrote: > 2012/10/8 Renato Pontefice : >> it seems like I cant use more that 2 sign for the section marker... > Actually, you should use a different sign for each section level. > So in this case 3 different signs for 3 different sections, IIUC. > But this is obvious

[sphinx-dev] Re: extension which includes CSS

On 2012-09-24, Jake Vanderplas wrote: > Thanks Günter, > I'd thought of that, but I'd prefer this to be as easy for users as > possible: that is, they can just load the sphinx extension, and not have to > modify their style sheet. Is there any way to modify what is within > without using a custo

[sphinx-dev] Re: extension which includes CSS

On 2012-09-23, Jake Vanderplas wrote: > Hi, > I'm attempting to build a sphinx extension for the inclusion of ipython > notebooks, based on nbviewer [1]. I have a quick-and-dirty implementation > that works in HTML by deriving from the raw directive [2]. Eventually I > hope to write a better cus

[sphinx-dev] Re: MathML to sphinx

On 2012-09-16, Daniele Zambelli wrote: > I'm writing a python programm to convert Open Document Format (ODT) > into Sphinx (ReST), I'm trying to improve the odt2rst: > http://code.google.com/p/odt2rst/ > I would like to manage the math equation, the ODT format for the math > equation is the MathM

[sphinx-dev] Re: How do I use xelatex to build epub?

On 2012-09-12, Boris Kheyfets wrote: > I want to use epub builder with math. > I found that mathjax currently is not supported by epub. So I swithed to > pngmath. > But it doesn't render mathjax's unicode greek letter I like to use. It > there a work around? Does this mean you want to use Gr

[sphinx-dev] Re: Specifying Sphinx configuration overrides when invoking sphinx-build

On 2012-09-03, Simon Holywell wrote: > I am writing a custom build script for a set of projects documented with > Sphinx. I want to be able to override the html_theme and html_theme_path > using -D arguments, but seem to be having an issue setting html_theme_path. > The command I am running per

[sphinx-dev] Re: Color table?

On 2012-09-04, Boris Kheyfets wrote: > [-- Type: text/plain, Encoding: --] > This works, and is cool, I took the note. But this will color all the > tables in the document, wouldn't it? Yes, but the tip can easily be extended to tables with a specific class argument by making the CSS selector

[sphinx-dev] Re: Align figure center and bottom?

On 2012-08-31, Boris Kheyfets wrote: > [-- Type: text/plain, Encoding: quoted-printable --] > Oh I am sorry -- I've made a wrong link to screenshoot here's a right one: > screenshot . > I get no warning or errors, and here's html co

[sphinx-dev] Re: Align figure center and bottom?

434/7879097568_94e652749f_s.jpg> If I interpret the screenshot right, the problem is that the left caption is missing, right? Could you have a look at the generated HTML file, whether it is already missing there? Did you get warnings or errors? How about PDF export, does it work? Günter >

[sphinx-dev] Re: Feature request :nowrap:/:pre-wrap: code-block directive options

ed from your examples and write rules to style them. (In my experiments, I often temporarily add a "background: green;" or similar line to CSS rules, so that I can see which elements are matched by the rule.) Hope this gets you going, Günter > On Monday, August 27, 2012 5:31:40 PM U

[sphinx-dev] Re: Figure caption?

On 2012-08-28, Boris Kheyfets wrote: >> Is it somehow possible to have a figure caption different form the text of >> the link to that figure? > Oh I found it: > See :ref:`link title `. > .. _figure: > .. figure:: _static/UnixFileSystem.jpg >:width: 50% >:alt: Unix file system >:a

[sphinx-dev] Re: Align figure center and bottom?

On 2012-08-27, Boris Kheyfets wrote: > [-- Type: text/plain, Encoding: quoted-printable --] > Thanks Gunter. > I tried: > ++---+ >|.. _SuperCompArch: |.. > _ClustArch: | >|

[sphinx-dev] Re: Underline inline markup?

On 2012-08-27, Boris Kheyfets wrote: > [-- Type: text/plain, Encoding: quoted-printable --] > Hello Gunter > I tried: > .. _doc: > .. role:: underlined(raw) >:format: html >:style: text-decoration: underline; This creates a role based on the raw role, i.e. it expects the content to be

[sphinx-dev] Re: Feature request :nowrap:/:pre-wrap: code-block directive options

On 2012-08-27, Boris Kheyfets wrote: > [-- Type: text/plain, Encoding: --] > I wont to cite code word-wraped in code-block. I can turn on the line > numbers to preserve the integrity. This can be done by adding > white-space: pre-wrap; > to pre in css. > However sometimes I cite csv file

[sphinx-dev] Re: Looking for literal block that supports inline directives

On 2012-08-23, m...@mikesolomon.org wrote: > Hey all, > I know that parsed-literal is a literal block that supports inline > markups, but is there a literal block that supports inline directives? All reST directives are block-level elements, but only inline-markup is parsed in a parsed-literal bl

[sphinx-dev] Re: Underline inline markup?

On 2012-08-20, Boris Kheyfets wrote: > [-- Type: text/plain, Encoding: --] > Is it somehow possible to have an underline inline markup? I know I can use >:title: -- but it's somehow crooked way of getting things underlined. Use a custom role and style it with CSS and/or in the LaTeX preamble.

[sphinx-dev] Re: Align figure center and bottom?

On 2012-08-20, Boris Kheyfets wrote: > [-- Type: text/plain, Encoding: --] > I have two figure in a table: > ++---+ >|.. _SuperCompArch: |.. > _ClustArch: | >|

[sphinx-dev] Re: Word-wrap in code-block?

On 2012-08-18, Boris Kheyfets wrote: > [-- Type: text/plain, Encoding: --] > Thanks. It works. I wonder if it is possible for latexpdf also. Not out of the box. You might try with the listings package (relatively easy in Docutils, but I don't know whether/how possible in Sphinx). Günter -- Y

[sphinx-dev] Re: How to avoid text floating around images?

On 2012-08-17, helix wrote: > [-- Type: text/plain, Encoding: --] > Hi folks, > the subject says it all. > I use html output with sphinx and the text following an image is floating > around it. > How can I avoid that? This behaviour is controled by CSS rules. You can change it in a custom

[sphinx-dev] Re: In line syntax highlighting?

On 2012-08-18, Boris Kheyfets wrote: > [-- Type: text/plain, Encoding: --] > Is somehow possible to highlight a piece of text in line in a given > language (with pygments)? > Something like this: > Some text :myLanguage:`from i to j; do` some more text. Yes, there is the :code: role for this

[sphinx-dev] Re: How to write unbalanced paretheses in literal text?

On 2012-08-18, Aivar Annamaa wrote: > [-- Type: text/plain, Encoding: --] > Hi! > I'm trying to write an inline code sample with a syntax error in it: ``x = > 3 + (4 * 5 ``, but I get error "Inline literal start-string without > end-string". If I close the parens, then the error goes away. T

[sphinx-dev] Re: Use other verbatim environments

On 2012-07-06, Jose Gomez-Dans wrote: > [-- Type: text/plain, Encoding: --] > Hi, > I am including a lot of files that are basically long plain ascii files. > fancyvrb doesn't allow line breaking on a long space (like spverbatim > does). Ideally, you should get a symbol showing you that the lin

[sphinx-dev] Re: how to show ''' (triple-single quote)?

On 2012-07-04, Kevin Hunter wrote: > [-- Type: text/plain, Encoding: quoted-printable --] > At 2:49pm -0400 Wed, 04 Jul 2012, Günter Milde wrote: >> On 2012-07-04, Kevin Hunter wrote: >>> I think the issue is LaTeX interpreting it, >> ... >> Yes, if it affects only the latexpdf output, maybe it

[sphinx-dev] Re: how to show ''' (triple-single quote)?

On 2012-07-04, Kevin Hunter wrote: > At 3:52am -0400 Sun, 01 Jul 2012, Guenter Milde wrote: >> On 2012-06-28, Kevin Hunter wrote: >>> ReST input

[sphinx-dev] Re: how to show ''' (triple-single quote)?

On 2012-06-28, Kevin Hunter wrote: > Hi Sphinx Group, > I'm trying to show an inline code example of a triple single quote. > I've tried a number of iterations, but can't seem to find the magic > incantation. Here's some of what I've tried so far: > ReST input Output > --

[sphinx-dev] Re: styles for root and normal user shell command

On 2012-06-13, Federico Bruni wrote: > Il 13/06/2012 09:25, Guenter Milde ha scritto: >> On 2012-06-12, Federico Bruni wrote: >>> Il 12/06/2012 11:31, Guenter Milde ha scritto: >>>> (The "code" directive is new in reStructuredText (docutils 0.

[sphinx-dev] Re: styles for root and normal user shell command

On 2012-06-13, Federico Bruni wrote: > Il 13/06/2012 21:18, Federico Bruni ha scritto: >> I see: I think I'll end up using a general style for shell prompt and >> use 'sudo' to show the commands which need root privileges. >> Thinking twice, it's better, because quite often a single code block >> m

[sphinx-dev] Re: auto numbering and figures

On 2012-06-13, SFL wrote: > I would like to combine documents dynamically, therefore I intend to use > the automatic numbering feature. However, > including figures seems to break the numbering. All topics will start with > "1" instead of continuous counting steps. Any element other than the n

[sphinx-dev] Re: styles for root and normal user shell command

On 2012-06-12, Federico Bruni wrote: > Il 12/06/2012 11:31, Guenter Milde ha scritto: >> (The "code" directive is new in reStructuredText (docutils 0.9 >> (2012-05-02). Use the Sphinx extension "sourcecode" with earlier >> Docutils versions.)

[sphinx-dev] Re: styles for root and normal user shell command

On 2012-06-12, Federico Bruni wrote: > Il 13/06/2012 00:48, Federico Bruni ha scritto: >> Currently I have docutils 0.8 on my debian system. >> I've tried installing latest svn version but code is not recognized: > Nevermind, it didn't work because I followed the README in docutils > source code

[sphinx-dev] Re: styles for root and normal user shell command

On 2012-06-12, Federico Bruni wrote: > Hi, > the easiest way to enter shell commands is probably not using any $ and > # sign in front of the command and using sudo for commands to be run as > root. > But it would be nice to handle it differently. > I'd like to be able to define two styles for

[sphinx-dev] Re: Clickable field list labels

On 2012-06-03, Roger Binns wrote: > I have a bunch of data presented using field lists like this (dummy labels > and data): > :Validity: 37.2 > :Duration: 17 of 6 > I'd like to provide a way of linking to another ref which has detailed > explanations of what each label means and how it was cal

[sphinx-dev] Re: Referencing options when .. program:: is used, ~ does not work as expected

On 2012-05-30, Michael Schlenker wrote: > Hello, > i tried to cross reference some option when program contexts are used. > Contrary to the documentation > (http://sphinx.pocoo.org/markup/inline.html#xref-syntax) it is not > currently possible to suppress the > program name when referencing. > E

[sphinx-dev] Re: Using Sphinx to document configuration files in e.g. JSON, YAML, etc?

On 2012-05-17, Ramon wrote: > We are defining an integration SDK that includes some fairly involved > parameter files, currently formatted in YAML syntax. I’d like to provide > “sample code” for these configurations (i.e. sample configuration files) as > well as detailed technical documentation

[sphinx-dev] Re: wrap text around image

On 2012-05-06, Gour wrote: > On Sun, 6 May 2012 15:24:53 + (UTC) > Guenter Milde wrote: >> It works on HTML using CSS rules (Docutils feature). > Yeah, that's expected. >> Docutils LaTeX writer does currently not support text around figures - >> this is

[sphinx-dev] Re: wrap text around image

On 2012-05-05, Gour wrote: > [-- Type: text/plain, Encoding: quoted-printable --] > Hello! > I got reply on rst2pdf list that rst2pdf cannot wrap text around > (floating) images due to limitation in reportlab. > Considering it's one of the features we're not happy about with > AsciiDoc, I wonde

[sphinx-dev] Re: mixing fonts or reST/Sphinx vs. AsciiDoc

On 2012-05-04, Gour wrote: > On Wed, 28 Mar 2012 11:46:06 + (UTC) > Guenter Milde wrote: > Excuse me for late reply...I was playing a bit with AsciiDoc and had > some other tasks in the meantime... >> On the input side, reStructuredText allows both, direct input as >&

[sphinx-dev] Re: Docutils 0.9

On 2012-05-02, Werner wrote: > On 02/05/2012 21:17, Guenter Milde wrote: >> On 2012-05-02, Werner wrote: >>> On 02/05/2012 10:26, Guenter Milde wrote: >>>> Dear Sphinxers, >>>> the Docutils team is going to release Docutils v. 0.9. >>> Didn'

[sphinx-dev] Re: Docutils 0.9

On 2012-05-02, Werner wrote: > On 02/05/2012 10:26, Guenter Milde wrote: >> Dear Sphinxers, >> the Docutils team is going to release Docutils v. 0.9. > Didn't see the PIL import issue mentioned, will this be fixed in this > release? > https://bitbucket.org/birk

[sphinx-dev] Docutils 0.9

Dear Sphinxers, the Docutils team is going to release Docutils v. 0.9. It would be nice if people could test their setup and extensions with the repository__ version or snapshot__ for eventual compatibilty problems. __ http://docutils.sourceforge.net/docs/dev/repository.html __ http://docutils.s

[sphinx-dev] Re: list-table, header has extra new line

On 2012-04-19, helix wrote: > Hi folks, > when I use a list-table to generate a table that has headers with line > blocks, a blank line seems to be added. If you look at the HTML source, you will realize that there is no blank line. Instead, the line block is wrapped in a div element: info

[sphinx-dev] Re: Directive for Custom Structured Content

On 2012-04-14, Tom Willis wrote: > I have a fairly involved question that I'm looking for advice on. I posted > this on stackoverflow but I don't know what the action is like for > questions regarding sphinx in docutils. (Its the other way round: Docutils is the core, used programatically by S

[sphinx-dev] Re: csv-table span multiple columns

On 2012-04-16, Austin Godber wrote: > [-- Type: text/plain, Encoding: --] > Does anyone know offhand if multiple columns can be spanned with a header > using the csv-table directive? I don't think it is possible. See the "official" description http://docutils.sourceforge.net/docs/ref/rst/direc

[sphinx-dev] Re: Width of columns in Sphinx tables

On 2012-04-08, Nathann Cohen wrote: > I have a small problem with simple tables... I have in my file many simple > tables following each other, all of them on two columns, and I would like > that their column all have the same width. The current result really is not > pretty :-) ... > The other

[sphinx-dev] Re: mixing fonts or reST/Sphinx vs. AsciiDoc

On 2012-03-26, Gour wrote: > I'm considering which markup to use for our open-source project to write > user's manuals as well as for general writing (study notes etc.) I recommend to use Docutils_ for single documents (study notes etc.) and Sphinx for projects (web sites, software documentation)

[sphinx-dev] Re: literalinclude and line wrapping in Latex

On 2012-02-13, Jose Gomez-Dans wrote: > On 11 February 2012 20:10, Guenter Milde wrote: >> On 2012-02-11, Jose Gomez-Dans wrote: >> >> But this just changes the font, and does not affect line wrapping. >> >> Or am I missing something? >> The idea is to us

[sphinx-dev] Re: literalinclude and line wrapping in Latex

On 2012-02-11, Jose Gomez-Dans wrote: >> Another option is to define a different "teletype" font in the LaTeX >> preamble, e.g. with >> \renewcommand{\ttdefault}{txtt} >> But this just changes the font, and does not affect line wrapping. Or am I > missing something? The idea is to use a narro

[sphinx-dev] Re: literalinclude and line wrapping in Latex

On 2012-02-10, Jose Gomez-Dans wrote: > I am grabbing data from some configuration files using literalinclude. > These files are plain ASCII and are properly processed for the HTML > documentation. For the PDF, however, the lines are too long, and get > clipped out. I understand that this is becau

[sphinx-dev] Re: Numbering of code lines

On 2012-01-18, Nikolaj wrote: > Hello group, > Sorry if I bring this subject back but I couldn't find any > satisfactory answer on the net. > I'm using Sphinx v1.1.2 with Pygments 1.4 under Ubuntu 11.04 64 bits. Which Docutils version (try, e.g., ``rst2html --version``)? > I could not find how

[sphinx-dev] Re: section* vs. section commands in LaTeX writer

On 2012-02-06, Eric Jacoboni wrote: > I'm wondering if it's possible to configure sphinx for producing > unnumbered versions of sectionning commands (chapter* instead of > chapter, section* instead of section, etc.) with the LaTeX Writer. Docutils has the "sectnum" directive that enables section

[sphinx-dev] Re: Issue with .. note:: and similar

On 2011-08-29, Infinity77 wrote: > However, now I am getting this kind of errors: > E:\AGW\agw\aui\auibook.py:docstring of > aui.auibook.AuiNotebook.DeletePage:6: (ERROR/3) Error in "note" > directive: > invalid option block. > Which is fantastically wrong as the "note" directive is perfectly >

[sphinx-dev] Re: Output-format-dependent substitution

On 2012-01-10, Purnank H G wrote: > On Jan 10, 1:16 am, andreash wrote: >> Hi Sphinx experts, >> how can I make a substitution depending on the output-format? >> Basically, I would like to have something like this:: >>    if html: >>       |CLICK| unicode:: U+21E8 >>    elif latex: >>       |

[sphinx-dev] Re: Output-format-dependent substitution

On 2012-01-09, andreash wrote: > Hi Sphinx experts, > how can I make a substitution depending on the output-format? > Basically, I would like to have something like this:: >if html: > |CLICK| unicode:: U+21E8 >elif latex: > |CLICK| raw:: latex > $\LongRightA

[sphinx-dev] Re: equations references across files

On 2012-01-08, Ondřej Čertík wrote: > On Fri, Jan 6, 2012 at 3:22 PM, Fernando Perez wrote: >> 2012/1/6 Ondřej Čertík : ... >> are the other parts of writing a thesis/book with sphinx working OK >> for you?  I'm thinking: >> - labeled references for other elements besides equations, such as say

[sphinx-dev] Re: Feature Request: Auto-Extracting Examples

On 2012-01-06, Bruce Eckel wrote: > I'd love to see some kind of tag that indicates that something is, or is > part of, a working example, so that Sphinx would automatically extract the > example and it could be downloaded, run, etc. > I ask for this because I see too much documentation where the

[sphinx-dev] Re: How to reduce memory usage of sphinx-build

On 2012-01-06, Neck Acm wrote: > Hi all, I am new to sphinx, I am trying to convert massive plain text > files to well-organized html, not program documentation, just some > plain text record. > The source text files is about 116 MB ... > eventually eats all my memory ( 1.5 GB ), returning Memory

[sphinx-dev] Re: Underfull \hbox (badness 10000) in paragraph at lines... in Sphinx 1.1.2

On 2012-01-02, Kristina D.C. Hoeppner wrote: > Thank you very much for your explanation. It is interesting though > that one of the underfull warnings is only given for "warning" but not > "note". However, as it is just a warning, I'll review them and see if > I can ignore them. The "underful \hb

[sphinx-dev] Re: Underfull \hbox (badness 10000) in paragraph at lines... in Sphinx 1.1.2

On 2012-01-01, Kristina Hoeppner wrote: > I get a number of "Underfull \hbox (badness 1) in paragraph at > lines..." warning when I generate a LaTeX PDF in Sphinx 1.1.2. This is just a warning. Have a look at the PDF output on the relevant line(s) and see if you can just ignore it. Günter -

[sphinx-dev] Re: different rendering of images size and position of sphinx html to latex to pdf

On 2011-12-13, maning sambale wrote: > Thanks Günter for the advice. > I was able to control image size by specifying the "real" units. Fine. BTW: it should suffice to specify just one of height or width. > The "image on the last page of the preceding project page" problem > still persist. Th

[sphinx-dev] Re: different rendering of images size and position of sphinx html to latex to pdf

On 2011-12-09, maning sambale wrote: > I am trying to compile a pdf version for printing of the OSGeo Live > DVD documentation [0] the sources are available in the svn [1]. > I did the following: > 1. Modified the conf.py for latex generation. > 2. Created a separate index.rst as the source of t

[sphinx-dev] Re: Is there possible for bold and italic text

On 2011-12-12, lyhcode wrote: > rst has > *italic* > **bold** > but if I need a text bold and italic in the same time. > something like > ***italic.bold*** > Is there a easy way to implement this? > thanks a lot Currently, nested inline markup is not supported. The workaround is easy but not ni

[sphinx-dev] Re: How to include an additional pure Docutils directive as extension?

On 2011-12-08, Martin Bless wrote: > Q: How can I add a pure Docutils directive - that does not inherit > from sphinx.util.compat.Directive - to Sphinx? Is that possible? As the Sphinx config file is Python code, you could try to replicate the steps otherwise done in a Docutils front-end, i.e. re

[sphinx-dev] Re: Sphinx vs. docutils for textbook

On 2011-12-01, Bob Plantz wrote: > I am converting a textbook I have written in LaTeX to epub. The book > (500+ pages) is on assembly language. It has many drawings (vector > graphics), a fair amount of math equations (but only simple algebra > notation), and many code listings. My goal is to make

[sphinx-dev] Re: Splitting HTML output at subsection boundaries

On 2011-12-06, Fernando Perez wrote: > On Thu, Dec 1, 2011 at 9:04 AM, Friedrich Romstedt > wrote: >> 2011/12/1 Fernando Perez : >>> On Thu, Dec 1, 2011 at 2:56 AM, Friedrich Romstedt >>> wrote: > Many thanks for the informative posts and discussion. It does seem > that sphinx is actually getti

[sphinx-dev] MathML (was Re: Splitting HTML output at subsection boundaries)

On 2011-12-03, Friedrich Romstedt wrote: > Hello Guenter, >>> 3)  Maths as PNGs (if not using JSMath, what is not an option for >>> ebook readers) not properly aligned in inline text mostly. >> Since version 0.8, Docutils supports math with MathML and HTML+CSS output >> options in HTML. (I don't

[sphinx-dev] Re: Splitting HTML output at subsection boundaries

On 2011-12-01, Friedrich Romstedt wrote: > 2011/11/30 Olivier Bonaventure : > I tried once to write my Dipoma thesis in Sphinx, because I thought > the same as you do. But I switched back to LaTeX later, rewriting all > the stuff again. The reasons are that Sphinx/Docutils is nice for > HTML do

[sphinx-dev] Re: Some characters rendering wrongly in HTML output

On 2011-11-25, Guenter Milde wrote: > On 2011-11-25, Friedrich Romstedt wrote: >> Am 25.11.2011 um 08:44 schrieb Guenter Milde : >>> On 2011-11-24, Friedrich Romstedt wrote: >>>> I'm experiencing some problem with Sphinx 1.1.2 (and also an earlier >>>&

[sphinx-dev] Re: Some characters rendering wrongly in HTML output

On 2011-11-25, Friedrich Romstedt wrote: > Am 25.11.2011 um 08:44 schrieb Guenter Milde : >> On 2011-11-24, Friedrich Romstedt wrote: >>> I'm experiencing some problem with Sphinx 1.1.2 (and also an earlier >>> version from July), that some characters in my H

[sphinx-dev] Re: Some characters rendering wrongly in HTML output

On 2011-11-24, Friedrich Romstedt wrote: > Hi, > I'm experiencing some problem with Sphinx 1.1.2 (and also an earlier > version from July), that some characters in my HTML are > occuring as strange Unicode character sequences in the HTML. Here's > an example: > http://www.roentgen.physik.uni-go

[sphinx-dev] Re: conditional exclusion of rst files

On 2011-11-23, Viktor Haag wrote: > On Wednesday, 20 July 2011 06:39:43 UTC-4, Alastair Dent wrote: >> I need to be able to exclude specific rst files, depending on a built >> parameter. You might try with a "condotional include" directive like .. only:: ... .. include:: foo.txt > The righ

[sphinx-dev] Re: Drawing trees

On 2011-11-17, Felix Hummel wrote: > Hi Carlos, > as far as I know, there is no reSt directive offering a nice tree > representation in both HTML and PDF. ... > Of course you could go fancy with Graphviz ... There is a graphviz extension for Sphinx. Günter -- You received this message becaus

[sphinx-dev] Re: chapter numbering

On 2011-11-11, Daniele Zambelli wrote: > [-- Type: text/plain, Encoding: quoted-printable --] > Hi, > I wish that the chapter numbering starts at 0 instead of 1. > It is possible do this? Yes. Use the :start: option to the sectnum directive. See http://docutils.sourceforge.net/docs/ref/rst/d

[sphinx-dev] Re: multiple replace

On 2011-11-07, Alex Wilkie wrote: ... > I am putting lots of repeated rst in files that I am "including" in > the actual source rst for a given file that I am documenting. As these > files that need to be documented there is a lot of duplicated class > attributes that have different prefixes - an

[sphinx-dev] Re: Exception running Sphinx

On 2011-11-06, Greg D wrote: > Hi, > I'm attempting to install tortoisehg-py27 on my Mac, using fink. When > I do, I get the following report. Any suggestions re: what went > wrong, and how to get it working, would be greatly appreciated. ... > python2.7 ../sphinx-build.py -b latex -d _build/do

[sphinx-dev] Re: Non-compact lists do not wrap sub-lists in paragraph

On 2011-11-04, Friedrich Romstedt wrote: > 2011/11/4 Guenter Milde : >>> It appears by inspection of the html source code, that indeed the >>> sublist is not contained in a tag.  This appears like a mistake to >>> me.  Because it should be a paragraph, since it is

[sphinx-dev] Re: Non-compact lists do not wrap sub-lists in paragraph

On 2011-11-03, Friedrich Romstedt wrote: > It seems there is a kind-of problem with sub-lists in non-compact lists. ... > * item 1 > - subitem 1.1 > - subitem 1.2 > * item 2 > second paragraph ... is rendered like: > * item 1 > - subitem 1.1 > - subitem 1

[sphinx-dev] Re: Python 3 style Print Giving Errors

On 2011-11-02, James Maxwell wrote: > [-- Type: text/plain, Encoding: --] > When I "make html" in Sphinx I'm getting syntax errors for Python 3 style > print statements such as: > print(x,y,z,sep="\t",end="\n",file=data) >^ > SyntaxError: invalid syntax > The code runs fin

[sphinx-dev] Re: wrap text around figures

On 2011-10-31, Pietro wrote: > I would like to wrap text around figures when figures are positioned > on the right (or left) hand side of the page (see the > wouldlike-pdf.jpeg). The HTML output is ok (get-html.jpeg), instead > the LaTex generate from sphinx code reach a different result > (get-pd

[sphinx-dev] Re: parsed-literal problems

On 2011-11-01, Georg Brandl wrote: > On 10/29/2011 01:19 PM, Guenter Milde wrote: ... >> I am not sure "parsed-literal" content should be highlit as code. >> (But, of course a consistent behaviour is to be expected - i.e. either >> always or never highlight parsed-

[sphinx-dev] Re: parsed-literal problems

On 2011-10-29, Andrea Crotti wrote: > On 10/28/2011 10:28 PM, Guenter Milde wrote: >> What do you expect and what do you get? > I would think to get the code highlighted, instead is just not > recognized as code, I am not sure "parsed-literal" content should be highlit

[sphinx-dev] Re: parsed-literal problems

On 2011-10-28, Andrea Crotti wrote: > On 10/27/2011 01:54 PM, Andrea Crotti wrote: >> It was quite simple, this is a simple failing example: >> .. parsed-literal:: >> class SampleCommand(AbstractCommand): >> def do(self): >> # var >> (and I don't get any compilation war

[sphinx-dev] Re: inline code highlighting?

On 2011-10-27, Tim Arnold wrote: > [-- Type: text/plain, Encoding: --] > Hi, I'm learning sphinx now--great stuff! > I'm using the code-block highlighting a lot--flipping between 'html', > 'latex', and 'python' languages. For example, > .. code-block:: latex > Is there any directive for hi

[sphinx-dev] Re: parsed-literal problems

On 2011-10-25, Andrea Crotti wrote: > I'm fighting a little bit in trying to understand parsed-literal. ... > This block of code for example is recognised and colored perfectly: ... > I thought it was just an highlighting problem, but it's just not seen > as a parsed-literal. What does the ou

[sphinx-dev] Re: LaTeX fancy formatting for admonitions

On 2011-10-13, Robin wrote: > [-- Type: text/plain, Encoding: --] > Hello guys, > I've been struggling for a week on a custom LaTeX style-sheet for some > corporate documentation. Right now I managed to get it almost right. > The only thing I miss is the formatting of the admonitions *with col

[sphinx-dev] Re: Estonian translation

Dear Aivar, On 2011-09-18, Aivar wrote: > I translated UI strings to Estonian (locale code 'et'). > http://www.aivarannamaa.ee/sphinx/sphinx.po Thanks for sharing. For parsing the reStructuredText sources, Sphinx uses Docutils_. For localized directive and role names, the corresponding translat

[sphinx-dev] Re: I have created locale for Serbian language

Dear Vitalije, On 2011-06-02, vitalije wrote: > Hello, > this is my first post to this group, so I want to thank to all > developers of such a wonderful tool. > And now, I wish to give my two cents. Translation for Serbian language > I have made for using in documenting my own projects. I have upl

[sphinx-dev] Re: Nepali Translation of Sphinx

On 2011-06-01, Matthew Gallagher wrote: > Hello, > We are in the process of creating a Nepali translation of the > documentation for Schooltool(schooltool.org), which > is built using Sphinx. As part of that process, we had to create a > Nepali translation locale for Sphinx, and translate the s

[sphinx-dev] Re: Crash reports caused by non-ascii characters

On 2011-09-18, Aivar wrote: > I discovered now that I get those crashes only when I execute "sphinx- > build" with option "-W". Without this the error message is displayed > fine. > And Günter, thanks for the tip about workaround! I think it is still worth a proper fix. Could you please add a bug

[sphinx-dev] Re: Crash reports caused by non-ascii characters

On 2011-08-31, Aivar wrote: > Hi! > In some cases, when I make syntax mistake in reST source and when > there is a non-ascii character around, I get stacktrace instead of > helpful message telling me where is the mistake. It's quite hard to > track down such mistakes. > One example is when I forg

[sphinx-dev] Re: Issue with .. note:: and similar

On 2011-08-30, Infinity77 wrote: > On Aug 30, 9:51 am, Guenter Milde wrote: >> On 2011-08-29, Infinity77 wrote: >> > However, now I am getting this kind of errors: >> > E:\AGW\agw\aui\auibook.py:docstring of >> > aui.auibook.AuiNotebook.DeletePage:6: (ERR

[sphinx-dev] Re: Crash reports caused by non-ascii characters

On 2011-08-31, Ernesto Posse wrote: > On Wed, Aug 31, 2011 at 3:38 PM, Aivar wrote: >> Hi! >> In some cases, when I make syntax mistake in reST source and when >> there is a non-ascii character around, I get stacktrace instead of >> helpful message telling me where is the mistake. It's quite hard

[sphinx-dev] Re: Changing section numbering in HTML and Latex

On 2011-08-23, Gaël Varoquaux wrote: > I have a biggish document written in Sphinx (yeah go go go Sphinx!): > http://scipy-lectures.github.com/ > It has 'parts', and chapters below them, as you can see from the above page. > So far the parts where just implemented as an extra layer of headers. T

[sphinx-dev] Re: Issue with .. note:: and similar

On 2011-08-29, Infinity77 wrote: > However, now I am getting this kind of errors: > E:\AGW\agw\aui\auibook.py:docstring of > aui.auibook.AuiNotebook.DeletePage:6: (ERROR/3) Error in "note" > directive: > invalid option block. > Which is fantastically wrong as the "note" directive is perfectly >

[sphinx-dev] Re: Include other Sphinx projects as LaTex appendices

On 2011-08-20, Thomas wrote: > I have to make a summary of multiple works which have all been > documented using Sphinx, with a LaTex output. > Those documentations must be inserted in my summary as appendices, but > can't find a way to do that correctly. > Is there a simple way to insert those

[sphinx-dev] Re: Image Cross-Referencing

On 2011-07-02, Gabor Bernat wrote: > [-- Type: text/plain, Encoding: quoted-printable --] > Relative like ..\x.html ? > I was thinking of a way that could work from both HTML and PDF build. Then you need two image elements, one for HTML and one for PDF with the appropriate URLs and "only-*" or

  1   2   3   4   >