[OpenStack-docs] Handling common sections

Anne Gentle anne at openstack.org
Wed Oct 15 13:15:33 UTC 2014


Ah yes, you want the xref linkend approach for within the deliverable
itself. Thanks Andreas!

On Wed, Oct 15, 2014 at 8:06 AM, Andreas Jaeger <aj at suse.com> wrote:

> On 10/15/2014 03:01 PM, Anne Gentle wrote:
> > Hi Lucian,
> > We have a common directory in openstack-manuals/doc/common used for when
> > more than one "book" deliverable includes the file. For references
> > within the same book, which sounds like your case, you can create a
> > common directory within the config-reference directory.
> >
> > To include the file, use xi:include syntax pointing to the correct
> > directory and file name.
> >
> > <xi:includehref="block-storage/section_volume-drivers.xml"/>
> >
> > Hope this helps.
>
> This would duplicate the content - and we need to take care of not
> creating duplicate xml:ids.
>
> I'm fine with the approach, just be careful with the ids ;)
>
> Andreas
> --
>  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
>   SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>    GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
>     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20141015/8193800f/attachment.html>


More information about the OpenStack-docs mailing list