<?xml version="1.0" encoding="UTF-8"?>
<essay xml:lang="en" version="pto" 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#">
<info>
    
    
    
    
    
    
<title>DocBook NG: The “Frangelico” Release</title><biblioid class="uri">http://norman.walsh.name/2004/10/18/frangelico</biblioid>
<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>
<dc:subject rdf:resource="http://norman.walsh.name/knows/taxonomy#DocBook"/>
</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">&lt;article xmlns="http://docbook.org/docbook-ng"
	 xmlns:xl="http://www.w3.org/1999/xlink"
	 version="frangelico"&gt;
&lt;info&gt;
&lt;title&gt;XLink Test&lt;/title&gt;
&lt;extendedlink&gt;
  &lt;locator xl:label="person" xl:href="#xperson"/&gt;
  &lt;locator xl:label="website" xl:href="http://www.example.com/"/&gt;
  &lt;locator xl:label="otherwebsite" xl:href="http://www.example.org/"/&gt;
  &lt;arc xl:from="person" xl:to="website" xl:title="To Website"/&gt;
  &lt;arc xl:from="person" xl:to="otherwebsite" xl:title="To Other Website"/&gt;
&lt;/extendedlink&gt;
&lt;/info&gt;

&lt;para xml:id='p4'&gt;This is an
&lt;phrase xl:href="http://www.example.com/"&gt;inline link&lt;/phrase&gt;.
&lt;/para&gt;

&lt;para xml:id='p5'&gt;This is an &lt;phrase xml:id="xperson"&gt;out-of-line link&lt;/phrase&gt;.
&lt;/para&gt;

&lt;/article&gt;</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>

