You are viewing a plain text version of this content. The canonical link for it is here.
Posted to xindice-dev@xml.apache.org by vl...@apache.org on 2002/11/22 09:14:23 UTC
cvs commit: xml-xindice/src/documentation/content/xdocs/community/howto/installation book.xml
vladimir 2002/11/22 00:14:23
Modified: src/documentation/content/xdocs/community/howto/installation
book.xml
Log:
removed link to tomcat (see forrest examples)
Revision Changes Path
1.2 +9 -11 xml-xindice/src/documentation/content/xdocs/community/howto/installation/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/installation/book.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- book.xml 21 Nov 2002 22:39:51 -0000 1.1
+++ book.xml 22 Nov 2002 08:14:23 -0000 1.2
@@ -1,17 +1,15 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" "http://localhost/forrest/dtd/book-cocoon-v10.dtd">
+<!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" "book-cocoon-v10.dtd">
+
<!--
- Version: $Revision$ $Date$
- Author: Vladimir R. Bossicard (vladimir@apache.org)
-->
+
<book software="Xindice" title="Xindice installation HOWTOs" copyright="2002 The Apache Foundation" xmlns:xlink="http://www.w3.org/1999/xlink">
- <menu label="How-Tos">
- <menu-item label="Index" href="../index.html"/>
- </menu>
- <menu label="Installation How-Tos">
- <!--
- <menu-item label="Introduction" href="index.html"/>
- -->
- <menu-item label="Tomcat" href="tomcat.html"/>
- </menu>
+
+ <menu label="How-Tos">
+ <menu-item label="Index" href="../index.html"/>
+ </menu>
+
</book>
RE: cvs commit: xml-xindice/src/documentation/content/xdocs/community/howto/installation book.xml
Posted by Dave Viner <dv...@yahoo-inc.com>.
Here's my initial understanding of the forrest convention. When you are in
a single howto (possibly in a subdir), there are 2 applicable rules:
1. if there is only one howto, then the book.xml should only reference the
howto index. forrest has an example of this at
http://xml.apache.org/forrest/community/howto/cvs-ssh/howto-cvs-ssh.html.
2. if there are multiple howtos, then the book.xml should reference the
howto index, and all the howtos at that level. forrest has an example of
this at
http://xml.apache.org/forrest/community/howto/xmlform/howto-xmlform.html
If this is accurate, then you made the right decision. Since there is only
one howto (tomcat), then the book.xml should only reference the howto index.
I guess I was assuming that there'd be other howto's at the tomcat level...
hence my inclusion of the tomcat.html link in the book.xml.
But I think you made the right decision. No need to add multiple links
until there are multiple howtos.
thanks again.
dave
-----Original Message-----
From: Vladimir R. Bossicard [mailto:vladimir@apache.org]
Sent: Friday, November 22, 2002 9:38 AM
To: xindice-dev@xml.apache.org
Subject: Re: cvs commit:
xml-xindice/src/documentation/content/xdocs/community/howto/installation
book.xml
> I'm not arguing that it should be one way or the other. I thought I had
> done it the proper way, but as a newbie forrester, I am uncertain.
I'm not a Forrest guru, I just followed the Forrest website
<http://xml.apache.org/forrest/community/howto/index.html>.
I think the concept is that when you select a how-to, you don't see the
references to the others.
-Vladimir
--
Vladimir R. Bossicard
Apache Xindice - http://xml.apache.org/xindice
Re: cvs commit: xml-xindice/src/documentation/content/xdocs/community/howto/installation
book.xml
Posted by "Vladimir R. Bossicard" <vl...@apache.org>.
> I'm not arguing that it should be one way or the other. I thought I had
> done it the proper way, but as a newbie forrester, I am uncertain.
I'm not a Forrest guru, I just followed the Forrest website
<http://xml.apache.org/forrest/community/howto/index.html>.
I think the concept is that when you select a how-to, you don't see the
references to the others.
-Vladimir
--
Vladimir R. Bossicard
Apache Xindice - http://xml.apache.org/xindice
RE: cvs commit: xml-xindice/src/documentation/content/xdocs/community/howto/installation book.xml
Posted by Dave Viner <dv...@yahoo-inc.com>.
Hi Vladimir,
I'm not sure I understand why you removed the link to tomcat.html from the
book.xml for community/howto/installation. I thought the idea was to have
multiple 'installation how-tos', so there eventually would be tomcat.html,
foo.html, bar.html. In this case, wouldn't the installation/ subdirectory's
book.xml look more like the book.xml in forrest's community/howto/xmlform
(http://cvs.apache.org/viewcvs/xml-forrest/src/documentation/content/xdocs/c
ommunity/howto/xmlform/book.xml?rev=1.1&content-type=text/vnd.viewcvs-markup
)?
I'm not arguing that it should be one way or the other. I thought I had
done it the proper way, but as a newbie forrester, I am uncertain.
thanks
dave
-----Original Message-----
From: vladimir@apache.org [mailto:vladimir@apache.org]
Sent: Friday, November 22, 2002 12:14 AM
To: xml-xindice-cvs@apache.org
Subject: cvs commit:
xml-xindice/src/documentation/content/xdocs/community/howto/installation
book.xml
vladimir 2002/11/22 00:14:23
Modified: src/documentation/content/xdocs/community/howto/installation
book.xml
Log:
removed link to tomcat (see forrest examples)
Revision Changes Path
1.2 +9 -11
xml-xindice/src/documentation/content/xdocs/community/howto/installation/boo
k.xml
Index: book.xml
===================================================================
RCS file:
/home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/instal
lation/book.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- book.xml 21 Nov 2002 22:39:51 -0000 1.1
+++ book.xml 22 Nov 2002 08:14:23 -0000 1.2
@@ -1,17 +1,15 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN"
"http://localhost/forrest/dtd/book-cocoon-v10.dtd">
+<!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN"
"book-cocoon-v10.dtd">
+
<!--
- Version: $Revision$ $Date$
- Author: Vladimir R. Bossicard (vladimir@apache.org)
-->
+
<book software="Xindice" title="Xindice installation HOWTOs"
copyright="2002 The Apache Foundation"
xmlns:xlink="http://www.w3.org/1999/xlink">
- <menu label="How-Tos">
- <menu-item label="Index" href="../index.html"/>
- </menu>
- <menu label="Installation How-Tos">
- <!--
- <menu-item label="Introduction" href="index.html"/>
- -->
- <menu-item label="Tomcat" href="tomcat.html"/>
- </menu>
+
+ <menu label="How-Tos">
+ <menu-item label="Index" href="../index.html"/>
+ </menu>
+
</book>