<?xml version='1.0' encoding='utf-8'?>
<?xml-stylesheet href="/style/browser.xsl" type="text/xsl"?>
<essay xmlns="http://docbook.org/ns/docbook"
       xmlns:xlink="http://www.w3.org/1999/xlink"
       xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'
       xmlns:dc='http://purl.org/dc/elements/1.1/'
       xmlns:dcterms="http://purl.org/dc/terms/"
       xmlns:gal='http://norman.walsh.name/rdf/gallery#'
       version="pto">
<info>
<title>DocBook NG: The “Frangelico” Release</title>
<volumenum>7</volumenum>
<issuenum>185</issuenum>
<pubdate>2004-10-18T07:46:20-04:00</pubdate>
<date>$Date: 2005-09-11 10:27:02 -0400 (Sun, 11 Sep 2005) $</date>
<author><personname>
<firstname>Norman</firstname><surname>Walsh</surname>
</personname></author>
<copyright><year>2004</year><holder>Norman Walsh</holder></copyright>
<abstract>
<para>This release uses xml:id and XLink, including some support for
extended links, and fixes a couple of bugs. I thought it made sense
to get another release out before XML 2004.</para>
</abstract>
</info>

<para xml:id='p1'>This is <link xlink:href="/threads/refactorDocBook">the sixth</link>
release of <link xlink:href="http://docbook.org/docbook-ng/">DocBook NG</link>.
</para>

<para xml:id='p2'>With
<link xlink:href="http://www.xmlconference.org/xmlusa/2004/">XML 2004</link>
coming up, I thought I’d get another release out so the DocBook crowd
has something to argue about
<link xlink:href="http://www.tbray.org/ongoing/When/200x/2003/05/27/XML2003">in the
bar</link>.</para>

<para xml:id='p3'>To that end, I’m sure what we need is a little controversy, so I’ve
switched to using XLink. And to make it a more interesting, I’ve
added an extended link element. This, for example, is one of my test
cases:</para>

<programlisting xml:id="example"><![CDATA[<article xmlns="http://docbook.org/docbook-ng"
	 xmlns:xl="http://www.w3.org/1999/xlink"
	 version="frangelico">
<info>
<title>XLink Test</title>
<extendedlink>
  <locator xl:label="person" xl:href="#xperson"/>
  <locator xl:label="website" xl:href="http://www.example.com/"/>
  <locator xl:label="otherwebsite" xl:href="http://www.example.org/"/>
  <arc xl:from="person" xl:to="website" xl:title="To Website"/>
  <arc xl:from="person" xl:to="otherwebsite" xl:title="To Other Website"/>
</extendedlink>
</info>

<para xml:id='p4'>This is an
<phrase xl:href="http://www.example.com/">inline link</phrase>.
</para>

<para xml:id='p5'>This is an <phrase xml:id="xperson">out-of-line link</phrase>.
</para>

</article>]]></programlisting>

<para xml:id='p6'>I have a not-yet-published stylesheet that does “the right thing”.
Sort of.</para>

<para xml:id='p7'>Here’s a summary of all the user-visible changes in the
“Frangelico” release:</para>

<itemizedlist>
<listitem>
<para xml:id='p8'>Use <link xlink:href="http://www.w3.org/TR/xml-id/"><tag class="attribute">xml:id</tag></link>.</para>
</listitem>
<listitem>
<para xml:id='p9'>Use <link xlink:href="http://www.w3.org/TR/xlink/">XLink</link>.</para>
</listitem>
<listitem>
<para xml:id='p10'>A link is required on <tag>biblioref</tag> (not optional).</para>
</listitem>
<listitem>
<para xml:id='p11'>The <tag class="attribute">numeration</tag>
attribute on <tag>orderedlist</tag> is an enumeration (not text).</para>
</listitem>
</itemizedlist>

<para xml:id='p12'><tag class="starttag">plug role='shameless'</tag>And if all this DocBook stuff is just too confusing, there’s probably
still time to sign up for
<link xlink:href="/2004/09/02/docbookTutorial">my tutorial</link>.
<tag class="endtag">plug</tag></para>

</essay>
