Terrence Brannon wrote:
I found the docs on external refs to be a bit terse.

Patches are welcome...

Given the external refs in the sample site.xml:

 <external-refs>
    <forrest href="http://forrest.apache.org/ <http://forrest.apache.org/>">
      <linking href="docs/linking.html"/>
      <validation href="docs/validation.html"/>
      <webapp href="docs/your-project.html#webapp"/>
      <dtd-docs href="docs/dtd- docs.html"/>
    </forrest>
    <cocoon href="http://cocoon.apache.org/"/>
    <xml.apache.org <http://xml.apache.org> href=" http://xml.apache.org/"/>
  </external-refs>

I would like to know how to form ext: elements these:

Looking at: http://forrest.apache.org/docs_0_70/linking.html#indirect-linking

(which may be the docs you refer to above - as I say, patches welcome)

* http://forrest.apache.org/docs/validation.html

ext:forrest/validation

* http://cocoon.apache.org/

ext:cocoon

* http://cocoon.apache.org/2.1/features.html

This does not appear in the sitemap so cannot be referenced with an ext: url. You'd need to change <cocoon href="http://cocoon.apache.org/"/> to something like:

<cocoon href="http://cocoon.apache.org/";>
  <2_1Features @href="2.1/features.html"/>
</cocoon>

and then use

ext:cocoon/2_1Features


Ross