Author: jtr
Update of /cvs/docs/example-tutorial
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv27328
Modified Files:
example-tutorial-en.xml
Log Message:
Oops, too quick to commit the good news; remove the <xi:include>
usage blurb since it doesn't belong here: just the usage is
appropriate.
Index: example-tutorial-en.xml
===================================================================
RCS file: /cvs/docs/example-tutorial/example-tutorial-en.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- example-tutorial-en.xml 30 Jan 2006 19:11:23 -0000 1.23
+++ example-tutorial-en.xml 30 Jan 2006 19:17:05 -0000 1.24
@@ -165,41 +165,6 @@
</procedure>
</section>
- <section id="sn-external-files">
- <title>Including External Files</title>
-
- <para>
- An alternative to declaring and using system entities to obtain
- the content from other files is to use an
- <firstterm>XInclude</firstterm> reference. These work similarly to
- include files in familiar programming languages. Using the
- XInclude feature allows an entire file, or just a part of it, to
- be copied into the current document. External files are referenced
- using an <abbrev>URI</abbrev> so they may be located anywhere,
- even across the Internet.
- </para>
-
- <para>
- The official documentation for the XInclude feature may be found
- at the <ulink
url="http://www.w3.org/TR/XInclude"/> web site. A
- somewhat dated description at
- <ulink
url="http://www.sagehill.net/docbookxsl/ModularDoc.html"/>
- may be a more readible starting reference.
- </para>
-
- <para>
- Using the XInclude facility with DocBook requires a special
- technique to allow the document to pass XML validation. Often
- examples show adding the phrase
-
<
phrase>xmlns:xi="http://www.w3.org/2001/XInclude"<...
- to a top-level element such as
- <wordasword><chapter></wordasword>. Unfortunately this
- causes the DocBook file to fail validation. The solution is to
- place the namespace declaration directly in the <xi:include>
- element:
- </para>
- </section>
-
<index id="generated-index"></index>
</article>