[Openstack-docs] Use of XML xi:include with xpointer

Anne Gentle annegentle at justwriteclick.com
Tue Jul 30 13:54:17 UTC 2013


I think DocBook sees the markup as a closed section followed by a para whic is invalid.

Anne Gentle
Content Stacker
anne at openstack.org


On Jul 30, 2013, at 8:38 AM, Sean Roberts <seanrob at yahoo-inc.com> wrote:

> I am pulling in a section through <xi:include href="http.....xpointer="element(foobar)"></xi:include>
> If I want to use additional text, I'm forced to make it a section as well. I want to add text to the beginning or end of the the included section. 
> I tried <xi:include href="http.....xpointer="element(foobar)"><para>blah blah</para></xi:include>
> , which shows up without error in oxygen, but maven seems to strip it out during HTML build. 
> 
> ~sean
> 
> On Jul 30, 2013, at 6:24, "Anne Gentle" <annegentle at justwriteclick.com> wrote:
> 
>> Hi Sean, 
>> Post your XML code so we can take a closer look, or a link to the patch and the file name so we can look at it. 
>> Thanks!
>> Anne
>> 
>> 
>> On Tue, Jul 30, 2013 at 2:56 AM, Sean Roberts <seanrob at yahoo-inc.com> wrote:
>>> I have another question. I'm bringing in the sections which is the smallest page into the built HTML. I'm trying to add text and links within the final HTML page without success. Oxygen shows the link and text fine, but the maven built site only has the included section. Perhaps some adjustment within the pom file...
>>> 
>>> ~sean
>>> 
>>> On Jul 29, 2013, at 9:34, "Diane Fleming" <diane.fleming at rackspace.com> wrote:
>>> 
>>> > I don't know if this will work, but this is how I used xpointer to pull in
>>> > content from one file to another:
>>> >
>>> >
>>> > Target file (pulls in content)
>>> >
>>> > <title>Overview</title>
>>> > <xi:include href="ch_gs_overview.xml"
>>> >                xpointer="element(over1)"/>
>>> > <xi:include href="ch_gs_overview.xml"
>>> >                xpointer="element(over2)"/>
>>> > <xi:include href="ch_gs_overview.xml"
>>> >                xpointer="element(over3)"/>
>>> > <xi:include href="ch_gs_overview.xml"
>>> >                xpointer="element(over4)"/>
>>> > <xi:include href="ch_gs_overview.xml"
>>> >                xpointer="element(over5)"/>
>>> > <xi:include href="ch_gs_overview.xml"
>>> >                xpointer="element(over6)"/>
>>> > <xi:include href="ch_gs_overview.xml"
>>> >                xpointer="element(over7)"/>
>>> > <xi:include href="ch_gs_overview.xml"
>>> >                xpointer="element(over8)"/>
>>> > <xi:include href="ch_gs_overview.xml"
>>> >                xpointer="element(over9)"/>
>>> > <xi:include href="ch_gs_overview.xml"
>>> >                xpointer="element(over10)"/>
>>> > <xi:include href="section_virt_ext.xml"/>
>>> >
>>> >
>>> >
>>> > Source file
>>> >
>>> >
>>> >    <title>Overview</title>
>>> >    <section xml:id="cn_overview"><title>Cloud Networks</title>
>>> >    <para xml:id="over1">Cloud Networks lets you create a virtual
>>> >        Layer 2 network, known as an isolated network, which gives you
>>> >        greater control and security when you deploy web applications.
>>> > </para>
>>> >    <para xml:id="over2">When you create a next generation Cloud
>>> >        Server, Cloud Networks enables you to attach one or more
>>> >        networks to your server. You can attach an isolated network
>>> >        that you have created or a Rackspace network. </para>
>>> >    <para xml:id="over3">If you install the &virt_ext;, you can create
>>> >        a virtual interface to a specified Rackspace or isolated
>>> >        network and attach that network to an existing server
>>> >        instance. You can also list virtual interfaces for and delete
>>> >        virtual interfaces from a server instance. For information
>>> >        about the &virt_ext;, see <xref linkend="section_virt_ext"
>>> >        />.</para>
>>> >
>>> >
>>> > etc.
>>> >
>>> >
>>> > Diane
>>> >
>>> > ----------------------------------------------
>>> > Diane Fleming
>>> > Software Developer II - US
>>> >
>>> > diane.fleming at rackspace.com
>>> > Cell  512.323.6799
>>> > Office 512.874.1260
>>> > Skype drfleming0227
>>> > Google-plus diane.fleming at gmail.com
>>> >
>>> >
>>> >
>>> >
>>> >
>>> >
>>> > On 7/29/13 9:27 AM, "Sean Roberts" <seanrob at yahoo-inc.com> wrote:
>>> >
>>> >> I'm working on reusing content from remote XML formatted sources to
>>> >> create new content. I'm using xi:include xpointer to a section of an
>>> >> existing XML file. Using the editor oxygen I can see the remote content,
>>> >> so I know my href is valid. But maven fails to build the html from the
>>> >> xml returning bad pointer.
>>> >>
>>> >> The remote content isn't using DTD or XMLschema. I'm hoping I can figure
>>> >> out how to walk the structure without having to.
>>> >> Any XML peoples that can help?
>>> >>
>>> >> ~sean
>>> >> _______________________________________________
>>> >> Openstack-docs mailing list
>>> >> Openstack-docs at lists.openstack.org
>>> >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>> >
>>> >
>>> 
>>> _______________________________________________
>>> Openstack-docs mailing list
>>> Openstack-docs at lists.openstack.org
>>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>> 
>> 
>> 
>> -- 
>> Anne Gentle
>> annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130730/3c3dc956/attachment.html>


More information about the Openstack-docs mailing list