nicolaken 02/03/17 05:32:06
Modified: src/documentation/stylesheets book2menu.xsl site2xhtml.xsl
src/documentation cocoon.xconf
src/documentation/images label-background_b.gif
src/documentation/xdocs mail-lists.xml
Removed: src/documentation/svg addlabel.xsl header.xml label.xml
label_over.xml label_select.xml separator.xml
src/documentation linkalarm-broken.txt linkalarm-readme.txt
Log:
The docs now have svg stuff removed and these enhancements:
1. menu items are in text
2. page title is in text
3. pages have new clean style courtesy of Stefano
4. added Stefano's explanation on how to write mails
5. the docs are generated with the TreeProcessor
6. the docs generation uses JispStore
Revision Changes Path
1.2 +11 -48 xml-cocoon2/src/documentation/stylesheets/book2menu.xsl
Index: book2menu.xsl
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/stylesheets/book2menu.xsl,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- book2menu.xsl 3 Jan 2002 12:31:01 -0000 1.1
+++ book2menu.xsl 17 Mar 2002 13:32:06 -0000 1.2
@@ -23,16 +23,8 @@
<!-- Encode label to escape any reserved characters such as space -->
<xsl:variable name="encLabel" select="NetUtils:encodePath(@label)"/>
<tr>
- <td align="left" valign="top">
- <img border="0"
- height="20"
- hspace="0"
- src="graphics/{$encLabel}-separator.jpg"
- vspace="0"
- width="120"
- alt="{@label}"/>
- <br/>
- </td>
+ <td valign="top" bgcolor="#959595" background="images/label-background_b.gif">
+ <span class="menutitle"><xsl:value-of select="@label"/></span></td>
</tr>
<xsl:apply-templates/>
</xsl:template>
@@ -42,32 +34,16 @@
<xsl:if test="not(@type) or @type!='hidden'">
<xsl:variable name="encLabel" select="NetUtils:encodePath(@label)"/>
<tr>
- <td align="left" valign="top">
+ <td bgcolor="#959595" valign="top">
<xsl:choose>
<xsl:when test="@href=$resource">
- <img alt="{@label}"
- src="graphics/{$encLabel}-label_select.jpg"
- border="0"
- height="12"
- width="120"
- name="{@label}"
- hspace="0"
- vspace="0"/>
+ <xsl:attribute
name="background">images/label-background_a.gif</xsl:attribute>
+ <span class="menuselected"><xsl:value-of select="@label"/></span>
</xsl:when>
- <xsl:otherwise>
- <a href="{@href}" onMouseOut="rolloverOff('{@label}')"
- onMouseOver="rolloverOn('{@label}')">
- <img alt="{@label}"
- src="graphics/{$encLabel}-label.jpg"
- border="0"
- height="12"
- width="120"
- name="{@label}"
- hspace="0"
- vspace="0"
- onLoad="rolloverLoad('{@label}',
'graphics/{$encLabel}-label_over.jpg', 'graphics/{$encLabel}-label.jpg');"/>
- </a>
- </xsl:otherwise>
+ <xsl:otherwise>
+ <xsl:attribute
name="background">images/label-background_a.gif</xsl:attribute>
+ <a href="{@href}" class="menu"><xsl:value-of select="@label"/></a>
+ </xsl:otherwise>
</xsl:choose>
</td>
</tr>
@@ -77,21 +53,8 @@
<xsl:template match="external">
<xsl:if test="not(@type) or @type!='hidden'">
<xsl:variable name="encLabel" select="NetUtils:encodePath(@label)"/>
- <tr>
- <td align="left" valign="top">
- <a href="{@href}" target="new"
- onMouseOut="rolloverOff('{@label}')"
- onMouseOver="rolloverOn('{@label}')">
- <img alt="{@label}"
- src="graphics/{$encLabel}-label.jpg"
- border="0"
- height="12"
- hspace="0"
- name="{@label}"
- vspace="0"
- width="120"
- onLoad="rolloverLoad('{@label}',
'graphics/{$encLabel}-label_over.jpg', 'graphics/{$encLabel}-label.jpg');"/>
- </a>
+ <tr><td bgcolor="#959595" background="images/label-background_a.gif"
valign="top">
+ <a href="{@href}" target="new" class="menu"><xsl:value-of
select="@label"/></a>
</td>
</tr>
</xsl:if>
1.6 +51 -25 xml-cocoon2/src/documentation/stylesheets/site2xhtml.xsl
Index: site2xhtml.xsl
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/stylesheets/site2xhtml.xsl,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- site2xhtml.xsl 23 Feb 2002 23:25:03 -0000 1.5
+++ site2xhtml.xsl 17 Mar 2002 13:32:06 -0000 1.6
@@ -11,7 +11,33 @@
<html>
<head>
<title><xsl:value-of select="/site/document/title"/></title>
- <script language="JavaScript" src="resources/script.js"
type="text/javascript"></script>
+<STYLE type="text/css">
+a.menu {
+ color: #000000;
+ text-align:left;
+ font-size:12px;
+ font-family: arial,helvetica,sanserif;
+ font-weight:plain;
+ padding-left: 14px
+}
+.menutitle {
+ color: #000000;
+ text-align:left;
+ font-size:12px;
+ font-family: arial,helvetica,sanserif;
+ font-weight:bold;
+ padding-left: 8px
+}
+.menuselected {
+ color: #000000;
+ text-align:left;
+ font-size:12px;
+ font-family: arial,helvetica,sanserif;
+ font-weight:plain;
+ font-style:italic;
+ padding-left: 14px
+}
+</STYLE>
</head>
<body text="#000000" link="#039acc" vlink="#0086b2" alink="#cc0000"
@@ -32,56 +58,48 @@
</tr>
<tr>
<td width="100%" height="35" valign="top" align="right" colspan="2"
bgcolor="#0086b2">
- <img
src="{$header}?label={NetUtils:encodePath(/site/document/title)}" hspace="0"
vspace="0" border="0" alt="{/site/document/title}" align="right"/>
+ <font size="5" face="arial,helvetica,sanserif"
color="#ffffff"><xsl:value-of select="/site/document/title"/></font>
</td>
</tr>
<tr>
- <!-- <td width="100%" height="20" valign="top" align="left"
bgcolor="#0086b2" background="images/bottom.gif">
- <img width="3" height="20" src="images/bottom.gif" hspace="0"
vspace="0" border="0" align="left"/>
- </td> -->
<td align="right" bgcolor="#0086b2" height="20" valign="top"
width="100%" colspan="2" background="images/bottom.gif">
- <table border="0" cellpadding="0" cellspacing="0" width="288">
+ <table border="0" cellpadding="0" cellspacing="0" width="288">
<tr>
<td width="96" height="20" valign="top" align="left">
- <a href="http://xml.apache.org/"; target="new"
- onMouseOut="rolloverOff('xml');"
- onMouseOver="rolloverOn('xml');">
+ <a href="http://xml.apache.org/"; target="new">
<img alt="http://xml.apache.org/"; width="96" height="20"
src="images/button-xml-lo.gif"
- name="xml" hspace="0" vspace="0" border="0"
- onLoad="rolloverLoad('xml', 'images/button-xml-hi.gif',
'images/button-xml-lo.gif');"/>
+ name="xml" hspace="0" vspace="0" border="0"/>
</a>
</td>
<td width="96" height="20" valign="top" align="left">
- <a href="http://www.apache.org/"; target="new"
- onMouseOut="rolloverOff('asf');"
- onMouseOver="rolloverOn('asf');">
+ <a href="http://www.apache.org/"; target="new">
<img alt="http://www.apache.org/"; width="96" height="20"
src="images/button-asf-lo.gif"
- name="asf" hspace="0" vspace="0" border="0"
- onLoad="rolloverLoad('asf', 'images/button-asf-hi.gif',
'images/button-asf-lo.gif');"/>
+ name="asf" hspace="0" vspace="0" border="0"/>
</a>
</td>
<td width="96" height="20" valign="top" align="left">
- <a href="http://www.w3.org/"; target="new"
- onMouseOut="rolloverOff('w3c');"
- onMouseOver="rolloverOn('w3c');">
+ <a href="http://www.w3.org/"; target="new">
<img alt="http://www.w3.org/"; width="96" height="20"
src="images/button-w3c-lo.gif"
- name="w3c" hspace="0" vspace="0" border="0"
- onLoad="rolloverLoad('w3c', 'images/button-w3c-hi.gif',
'images/button-w3c-lo.gif');"/>
+ name="w3c" hspace="0" vspace="0" border="0"/>
</a>
</td>
</tr>
- </table>
+ </table>
</td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr width="100%">
- <td width="120" valign="top">
- <table border="0" cellpadding="0" cellspacing="0" width="120">
+
+
+
+ <!-- THE SIDE BAR -->
+ <td width="120" valign="top" align="left">
+ <table bgclolor="#a0a0a0" background="#a0a0a0" border="0"
cellpadding="0" cellspacing="0" width="120">
<tr>
<td align="left" valign="top">
<img border="0" height="14" hspace="0"
src="images/join.gif" vspace="0" width="120"/>
@@ -97,13 +115,21 @@
</tr>
</table>
</td>
+
+
+ <!-- THE CONTENTS -->
<td>
<table border="0" cellpadding="0" cellspacing="15">
<tr><td><xsl:copy-of
select="/site/document/body/node()|@*"/></td></tr>
</table>
</td>
+
+
</tr>
- </table>
+</table>
+
+
+
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td bgcolor="#0086b2">
1.9 +9 -9 xml-cocoon2/src/documentation/cocoon.xconf
Index: cocoon.xconf
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/cocoon.xconf,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- cocoon.xconf 14 Feb 2002 15:47:53 -0000 1.8
+++ cocoon.xconf 17 Mar 2002 13:32:06 -0000 1.9
@@ -25,12 +25,13 @@
logger="core.store.repository">
<parameter name="use-work-directory" value="true"/>
</repository>
-
+ <!--
<cache-persistent class="org.apache.cocoon.components.store.FilesystemStore"
logger="core.store.persistent">
<parameter name="use-cache-directory" value="true"/>
</cache-persistent>
- <!--
+ -->
+
<cache-persistent class="org.apache.cocoon.components.store.JispFilesystemStore"
logger="core.store.persistent">
<parameter name="use-cache-directory" value="true"/>
@@ -38,7 +39,6 @@
<parameter name="indexfile" value="cocoon-cache.idx"/>
<parameter name="order" value="1701"/>
</cache-persistent>
- -->
<!-- Memory Storing -->
<cache-transient class="org.apache.cocoon.components.store.MRUMemoryStore"
@@ -84,7 +84,7 @@
<!-- Program Generator -->
<program-generator logger="core.program-generator">
<parameter name="auto-reload" value="true"/>
- <parameter name="root-package" value="org.apache.cocoon.www"/>
+ <parameter name="root-package" value="org_apache_cocoon_www"/>
<parameter name="preload" value="true"/>
</program-generator>
@@ -116,16 +116,16 @@
<!-- Stream Pipeline -->
<stream-pipeline
class="org.apache.cocoon.components.pipeline.CachingStreamPipeline"
- pool-max="32" pool-min="8" pool-grow="4"
+ pool-max="16" pool-min="4" pool-grow="2"
logger="core.pipeline.stream"/>
<!-- Event Pipeline -->
<event-pipeline class="org.apache.cocoon.components.pipeline.CachingEventPipeline"
- pool-max="32" pool-min="8" pool-grow="4"
+ pool-max="16" pool-min="4" pool-grow="2"
logger="core.pipeline.event"/>
<!-- ======================== The sitemap ============================== -->
-
- <sitemap file="sitemap.xmap" reload-method="asynchron" check-reload="yes"
- logger="sitemap"/>
+
+ <sitemap class="org.apache.cocoon.components.treeprocessor.TreeProcessor"
logger="sitemap"/>
+
</cocoon>
1.2 +1 -1 xml-cocoon2/src/documentation/images/label-background_b.gif
<<Binary file>>
1.2 +67 -0 xml-cocoon2/src/documentation/xdocs/mail-lists.xml
Index: mail-lists.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/mail-lists.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- mail-lists.xml 3 Jan 2002 12:31:01 -0000 1.1
+++ mail-lists.xml 17 Mar 2002 13:32:06 -0000 1.2
@@ -29,6 +29,73 @@
</p>
</s1>
+ <s1 title="Tips (keeping focus helps your points come across!)">
+
+ <p>We use the mail list both as a media to transmit our thoughts and as a
+virtual location to hang around and feel part of something.
+ </p><p>
+In order for the second to happen, you just have to subscribe. That's
+it, nothing fancy.
+ </p><p>
+But in order for the first to happen (transmit your thoughts) it's an
+entirely different matter.
+ </p><p>
+Here are a few things that help a lot:
+ </p><p>
+ 1) reduce noise, increase signal: your email client will quote the
+message you are replying to automatically, but it's *your*
+responsibility to remove those parts that aren't part of the signal of
+your email. Sure, you might let this operation to the reader, but you
+must understand that the reader is not supposed to do this. Or, at
+least, it should be *you* to make the reader confortable.
+ </p><p>
+ 2) be respectful, be aware of community dynamics: sending HTML in the
+mail more than *doubles* the message size and interferes with text-based
+mail clients. You want your point to come across, so make sure that
+everybody can get to that point with the *easiest* possible effort, or,
+otherwise, your signal might be wasted in the noise and the time you
+think you are saving, you are, in fact, loosing it completely.
+ </p><p>
+ 3) promote your signal: people on mail lists are used to read tons of
+email a day. Without a good 'promotion' of your points, they might get
+missed in the noise. (note: 'noise' is a subjective notion, what is
+signal for you might be noise for others, it's up to you to make your
+signal stand up). Things that help in this respect:
+ </p><p>
+ a) a simple yet effective email title. Geeks are ultimately curious
+animals, tickle their curiosity!
+ </p><p>
+ b) be elegant and visually effective. Sure, you have to use ASCII,
+but there is a lot that you can convey with ASCII
+ </p><source><![CDATA[
+ +---------------------------------+
+ | I'm sure nobody will miss this! |
+ +---------------------------------+
+ ]]></source><p>
+ c) structure your text. Whenever possible, use *strong* or
+_underline_ or /italic/ or use bullet lists and so on. Consider textual
+RFC, that's how you should write your emails. Sure, it takes a little
+more time, but I guarantee you that it saves a lot of it later on.
+ </p><p>
+ d) keep paragraphs short! you can go on and on forever, I'm sure you
+do, but keep your point focused, so that the signal/noise ratio is
+increased.
+ </p><p>
+ 4) be respectful of other's opinion: your email will be stored forever,
+archived in several locations around the world, indexed by Google,
+locked in magnetic tapes into the NSA caves and so on. Just keep this in
+mind before you hit "send", this will keep your ego honest :)
+ </p><p>
+ 5) admit your incapacity/ignorance/mistakes: there is nothing more
+appreciated in a community that someone that can stand up and apologize
+for something. Remember: if you don't make mistakes, you can't learn.
+And if you don't admit you made it, nobody knows you are learning :)
+ </p><p>
+Keep all these things in mind and you'll be impressed by how much fun
+and knowledge you can get out of all this open development thing.
+ </p>
+ </s1>
+
<s1 title="Cocoon Users">
<p><link href="mailto:[EMAIL PROTECTED]";>Subscribe</link>
<link href="mailto:[EMAIL PROTECTED]";>Unsubscribe</link>
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
