[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

RE: Linking documents that "belong" together == BestPractices

• From: "W. Hugh Chatfield I.S.P." <hchatfield@u...>
• To: Adam Van Den Hoven <Adam.Hoven@b...>,"XML Development Mailing List (E-mail)" <xml-dev@l...>
• Date: Wed, 10 Oct 2001 08:06:41 -0400

Hi Adam...
The way you stated the problem -  seems to me your problem is not "linking
related documents" - but one of assembling pieces of one logical document.
Presumably the "chapter" pieces were written primarily targetted at final
assembly into your book.

Given this - all your suggestions seem like solutions in search of a
problem. The first solution that occurred to me was to use a fundamental
SGML/XML feature - the separation of logical document (your book) and its
physical parts (multiple entities consisting of a document entity and one or
more named entity files).

The document entity is the "document plan or template"  for your book. Sort
of "assembly instructions".
<book>
	<title>Some Book</title>
	<section><title>section 2</title>
		&chapter01;
		&chapter02;
		&chapter03;
		&chapter04;
	</section>
	<section><title>section 2</title>
		&chapter05;
		&chapter06;
		&chapter07;
		&chapter08;
	</section>
</book>

Final assembly would include Entity declarations for the various pieces
(i.e. where might I find the pieces)in the internal subset of the DOCTYPE
statement.

<!DOCTYPE book
[<!ENTITY chapter01 SYSTEM "...">
...
<!ENTITY chapter08 SYSTEM "...">
]>
<book> .... </book>

This seems to have met your criteria for separation of the physical pieces -
each possibly having its own metadata.  But perhaps I don't totally
understand your problem.

Cheers....Hugh
CyberSpace Industries 2000 Inc.

-----Original Message-----
From: Adam Van Den Hoven [mailto:Adam.Hoven@b...]
Sent: Friday, October 05, 2001 9:54 PM
To: XML Development Mailing List (E-mail)
Subject:  Linking documents that "belong" together == Best
Practices


Hey guys,

I need some suggestions about best practices for linking documents that
"belong" together. For instance I have a number of chapters of a book, each
in its own XML file. I need some way to bind them all into a book, with an
order and probably those chapters are going to belong to sections that make
up the book.

I can think of a number of ways to do this.

1) Build a custom schema
<book>
	<title>Some Book</title>
	<section><title>section 2</title>
		<chapter xlink:href="chapter01.xml" />
		<chapter xlink:href="chapter02.xml" />
		<chapter xlink:href="chapter03.xml" />
		<chapter xlink:href="chapter04.xml" />
	</section>
	<section><title>section 2</title>
		<chapter xlink:href="chapter05.xml" />
		<chapter xlink:href="chapter06.xml" />
		<chapter xlink:href="chapter07.xml" />
		<chapter xlink:href="chapter08.xml" />
	</section>
</book>
But that seems to be a poor choice long term (particularly for a publicly
available document.

2) Use RDF in some way (using Dublin Core Relation IsPartOf constructs
maybe)
3) Use Extended XLinks

What are the things to consider when deciding how to do these things. I
don't want to put everything into a single document since each can validly
have its own metadata. What is the "best practice" for this situation?

Thanks.


Adam van den Hoven
Internet Software Developer
Blue Zone
tel. 604 685 4310 ext. 260
fax 604 685 4391

Blue Zone makes you interactive. http://www.bluezone.net/

-----------------------------------------------------------------
The xml-dev list is sponsored by XML.org <http://www.xml.org>, an
initiative of OASIS <http://www.oasis-open.org>

The list archives are at http://lists.xml.org/archives/xml-dev/

To subscribe or unsubscribe from this elist use the subscription
manager: <http://lists.xml.org/ob/adm.pl>

• References:
  • Linking documents that "belong" together == Best Practices
    • From: Adam Van Den Hoven <Adam.Hoven@b...>

• Prev by Date: Re: Web Service: SOAP or {HTML + Servlets}?
• Next by Date: Re: Linking documents that "belong" together == BestPractices
• Previous by thread: Linking documents that "belong" together == Best Practices
• Next by thread: Re: Linking documents that "belong" together == BestPractices
• Index(es):
  • Date
  • Thread