On 2013-05-28, [email protected] wrote:

> # Operation System: Windows XP pro SP3, win32, Chinese Simplified 
> # Sphinx version: 1.2b1           ( Sphinx-1.2b1-py2.7.egg )
> # Python version: 2.7.5
> # Docutils version: 0.10 release  (Auto installed by sphinx egg)
> # Jinja2 version: 2.7             (Auto installed by sphinx egg)

> The paragraph below is copied from 
> [docutils-0.10.tar.gz]/docutils-0.10/docs/user/rst/demo.txt (line 89~101)
> The paragraph cannot 'make html' until I add a '|' at the beginning of the 
> line ([CIT2002]_)...

It is strange that addint '|' should help.

> Is it a bug?

Hard to say without more context and the error message.

A citation will fail if the target is missing: if you only copied this
paragraph, there will be a lot of missing links.

If you also copied the targets, it depends...

> Paragraphs contain text and may contain inline markup: *emphasis*,
> **strong emphasis**, ``inline literals``, standalone hyperlinks
> (http://www.python.org), external hyperlinks (Python_), internal
> cross-references (example_), external hyperlinks with embedded URIs
> (`Python web site <http://www.python.org>`__), footnote references
> (manually numbered [1]_, anonymous auto-numbered [#]_, labeled
> auto-numbered [#label]_, or symbolic [*]_), citation references
> ([CIT2002]_), substitution references (|example|), and _`inline
> hyperlink targets` (see Targets_ below for a reference back to here).
> Character-level inline markup is also possible (although exceedingly
> ugly!) in *re*\ ``Structured``\ *Text*.  Problems are indicated by
>|problematic| text (generated by processing errors; this one is
> intentional).


Günter

-- 
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 [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to