[OpenStack-docs] Handling common sections

Andreas Jaeger aj at suse.com
Wed Oct 15 13:06:38 UTC 2014


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



More information about the OpenStack-docs mailing list