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=&quot;http://www.w3.org/2001/XInclude%22;</phrase> - to a top-level element such as - <wordasword>&lt;chapter&gt;</wordasword>. Unfortunately this - causes the DocBook file to fail validation. The solution is to - place the namespace declaration directly in the &lt;xi:include&gt; - element: - </para> - </section> - <index id="generated-index"></index> </article>