Hi Alexey,
On Samstag, 28. Juli 2007, Alexey Eremenko wrote:
>
> I have LfL question: how-to subdivide very big articles ?
> That is: I have "VirtualBox" article - a big guide actually.
>
> I want to have it's chapters to be available as links at the top of the
> article.
>
> Thomas once told me about using chapter IDs, but I didn't understood
> then. I will try now...
>
> So, can you help with example XML code ?
Sure. You will see, it's pretty easy after you get the idea behind.
For example, you want to link from a paragraph to a chapter. These are the
steps that you need:
1. Determine the ID value of the chapter that you want to link to. You can
also link to sections, figures, tables, appendices, etc. the method is
the same. It should look like this:
<chapter id="chap.foo">
<!-- ^^^^^^^^_____ Your ID value -->
<title>Something about Foo</title>
...
2. If you do not find an ID value, "define" your own ID value. Insert an
attribute "id" with your ID value in the respective element. The ID value
should be legible so that any writer have at least some idea what is this
chapter about. :) Look for other examples.
Be careful, the definied ID value must be unique (appears only once in the
whole document), otherwise you get validation errors.
3. Go back to your paragraph and insert a xref element. This is the cross
reference to your ID and looks like this:
<para>...
See <xref linkend="chap.foo"/> for more information ...
</para>
You can insert as many xrefs to your chapter as you like.
That's all! The stylesheets take care of how the xref appears in your
text. Usually you get something like this:
See Chapter 1, »Something about Foo« for more information.
Does it help?
Have fun,
Tom
--
----------------------------------------------------------------------
SUSE LINUX Products GmbH >o)
Maxfeldstrasse 5 /\\ Documentation Specialist
90409 Nuernberg, Germany _\_v http://en.opensuse.org/Documentation_Team
SUSE LINUX Products GmbH, GF: Markus Rex, HRB 16746 (AG Nürnberg)
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
