Ross Gardler wrote:
> Paterline, David L. wrote:
> >Hello all -
> >I'm a new user of Forrest and the associated technologies, so I hope I can
> >find some help with a basic question or two.
> >Basically, I'm looking for a way to centralize definitions of text
> >to be used throughout the various XML files in my project.
> >I'm using entity references to refer to contents of pre-defined entities
> >within my XML files. Within each file, I define the entity and then
> >reference it:
> > >"http://apache.org/forrest/dtd/document-v12.dtd" [
> > ]>
> > ...
> > ...
> >This works fine, within each XML file. For a couple of reasons, I'd like to
> >collect all these entity definitions into a single configuration file
> >(mainly to minimize maintenance issues, such as using a single definition
> >multiple XML files).
> You might want to read the docs on linking for some interesting tricks.
> See http://forrest.apache.org/docs/linking.html#indirect-linking in
> particular see the "site:" psuedo-protocol for internal linking and the
> "ext:" pseudo-protocol for external linking.
Yes, as Ross said, using site.xml to define these links
is a good idea. See examples in a fresh site from doing
'forrest seed' in a new directory.
If you have other reasons for wanting to use xml entities
(e.g. common words and phrases) then you can define them all
in one centralised file in your project's
src/documentation/resources/schema/ directory. Declare the
file in your src/documentation/resources/schema/catalog.xcat
giving it a Public Identifier.
Here is a demo ...
The file src/documentation/resources/schema/my-entities-v10.ent
The file src/documentation/resources/schema/catalog.xcat
The file src/documentation/content/xdocs/index.xml
Welcome to MyProjCongratulations
Entity replacement demo ... &foo; and &bar;
And the result is ...
Entity replacement demo ... This Foo and That Bar