<?xml version="1.0"?>
<!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->

<!-- CVS $Id: samples.xml 487707 2006-12-15 23:07:44Z joerg $ -->

<samples name="Catalogs and DocBook" xmlns:xlink="http://www.w3.org/1999/xlink">

 <group name="Back">
  <sample name="Back" href="../">
   Back to the samples home page.
  </sample>
 </group>

 <group name="XML Entity Catalogs">
  <sample name="Entity Resolution Using Catalogs" href="catalog-demo">
   Catalog entity resolver. External entities (e.g. DTDs, symbols,
   character entity sets, images) are resolved to local copies of the
   resources. The catalog manager facilitates the mapping between public
   identifiers or system identifiers and other system identifiers.
  </sample>
 </group>

 <group name="DocBook">
  <note>
   Follow the configuration steps first ...
  </note>
  <sample name="Entity Resolution With Catalogs"
          href="http://cocoon.apache.org/2.1/userdocs/concepts/catalog.html#config">
    The Apache Cocoon documentation "Entity
    resolution with catalogs" has a section "Example local configuration
    for Simplified DocBook". Do that and then ...
  </sample>
  <sample name="DocBook Demo"
          href="sdocbook-demo">
   Demonstration of Catalog Entity Resolver and Simplified DocBook.
   You will need the DocBook DTDs installed locally and the catalog
   properly configured.
  </sample>
  <note>
   If you get a FileNotFoundException, then you have not configured the
   OASIS catalog properly. Follow the documentation as suggested above.
  </note>
 </group>

</samples>
