Thread: [Docutils-users] Cross references across files

Hi,

I'm using rST to write a book, and it consists of several chapter files. 
Cross references work fine if the reference is in the same chapter, but 
when it's in a different chapter (file) it fails.

So:

.. _whatever:

in one file and

A link to `whatever`_ in another file

gives me a

ERROR: Unknown target name: "whatever".

on build.

I'm using sphinx to build - so if I need to go ask the question over 
there instead, that's fine.

Thanks for any pointers you can give to get this working.

--Rich


-- 
Rich Bowen
rb...@rc...
Shosholoza

you should ask this on the sphinx list

but here is the answer:

change:  `whatever`_
to:      :ref:`whatever`

On 08/12/2013 06:02 PM, Rich Bowen wrote:
> Hi,
>
> I'm using rST to write a book, and it consists of several chapter files.
> Cross references work fine if the reference is in the same chapter, but
> when it's in a different chapter (file) it fails.
>
> So:
>
> .. _whatever:
>
> in one file and
>
> A link to `whatever`_ in another file
>
> gives me a
>
> ERROR: Unknown target name: "whatever".
>
> on build.
>
> I'm using sphinx to build - so if I need to go ask the question over
> there instead, that's fine.
>
> Thanks for any pointers you can give to get this working.
>
> --Rich
>
>

Many thanks, Pete.


On 08/12/2013 07:29 PM, Pete R. Jemian wrote:
> you should ask this on the sphinx list
>
> but here is the answer:
>
> change:  `whatever`_
> to:      :ref:`whatever`
>
> On 08/12/2013 06:02 PM, Rich Bowen wrote:
>> Hi,
>>
>> I'm using rST to write a book, and it consists of several chapter files.
>> Cross references work fine if the reference is in the same chapter, but
>> when it's in a different chapter (file) it fails.
>>
>> So:
>>
>> .. _whatever:
>>
>> in one file and
>>
>> A link to `whatever`_ in another file
>>
>> gives me a
>>
>> ERROR: Unknown target name: "whatever".
>>
>> on build.
>>
>> I'm using sphinx to build - so if I need to go ask the question over
>> there instead, that's fine.
>>
>> Thanks for any pointers you can give to get this working.
>>
>> --Rich
>


-- 
Rich Bowen
rb...@rc...
Shosholoza

On 2013-08-12, Pete R. Jemian wrote:
> you should ask this on the sphinx list

> but here is the answer:

> change:  `whatever`_
> to: 
     :ref:`whatever`

Mind, that this works with Sphinx only. With plain Docutils, you need
more verbose and, unfortunately, output-specific syntax as e.g. in the
Docutils documentation::

  LaTeX supports all `length units`_ defined for Docutils ...
  
  .. _length units: ../ref/rst/restructuredtext.html#length-units


Günter