You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by cr...@apache.org on 2003/12/06 06:06:12 UTC
cvs commit: cocoon-2.1/src/webapp/samples/text-wrap welcome.html
crossley 2003/12/05 21:06:12
Modified: src/webapp/samples/text-wrap welcome.html
Log:
* wrap2para was inadvertently trying to deal with all types of source rather
than just source with XML content. (Sorry for mis-representing Conal's work.)
* Removed ASCII art samples. People should really not try ASCII art in source
elements. If they do, then their long lines should be just automatically split.
An alternative is for them to use the Cocoon block asciiart.
* Explained Sylvain's new "nbsp" sample a bit more.
Revision Changes Path
1.9 +28 -33 cocoon-2.1/src/webapp/samples/text-wrap/welcome.html
Index: welcome.html
===================================================================
RCS file: /home/cvs/cocoon-2.1/src/webapp/samples/text-wrap/welcome.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- welcome.html 15 Nov 2003 02:37:00 -0000 1.8
+++ welcome.html 6 Dec 2003 05:06:12 -0000 1.9
@@ -17,10 +17,8 @@
</p>
<p>
-We need to find a way to consistently split lines that are too wide.
-Here are demonstrations of various solutions. Each one has pros and cons.
-Please help to enhance these solutions so that one can soon be implemented.
-(See <a href="#notes">Notes</a> below.)
+If everyone followed code conventions for Java and XML then this
+would not happen. However, there is no way to guarantee that.
</p>
<p>
@@ -30,6 +28,13 @@
</p>
<p>
+We need to find a way to consistently split lines that are too wide.
+Here are demonstrations of various solutions. Each one has pros and cons.
+Please help to enhance these solutions so that one can soon be implemented.
+(See <a href="#notes">Notes</a> below.)
+</p>
+
+<p>
The following examples are deliberately extreme to ensure that the issues
are triggered.
</p>
@@ -52,17 +57,16 @@
<li>
<a href="raw/cdata-model-2">CDATA and deeply embedded xml content model with long names</a>
</li>
-<li>
-<a href="raw/ascii-art">Ascii Art</a>
-</li>
</ul>
<h2>Using the "split.xsl" stylesheet</h2>
-<p>All <source> elements had their long
-lines split by the included split.xsl stylesheet.
+<p>All <source> elements had their long lines wrapped at a defined
+width (72) by the included split.xsl stylesheet. Lines with no whitespace
+(such as long URLs) are forcefully split at 72 characters.
The content is wrapped with a <pre> element.
</p>
-<p>Note: In past Cocoons this stylesheet has been reported to be a memory hog on certain Java JDKs. How does it go for you?
+<p>Note: In past Cocoons this stylesheet has been reported to be a memory
+hog on certain JVMs. How does it go for you?
</p>
<ul>
<li>
@@ -77,38 +81,31 @@
<li>
<a href="split/cdata-model-2">CDATA and deeply embedded xml content model with long names</a>
</li>
-<li>
-<a href="split/ascii-art">Ascii Art</a>
-</li>
</ul>
<h2>Using the "wrap2para.xsl" stylesheet</h2>
-<p>Only <source> elements that did not
-contain an xml content model, had their long
-lines handled by the included wrap2para.xsl stylesheet.
-Such lines are each wrapped with a styled <p> element.
+<p>Only <source> elements that contain an xml content model had their
+lines handled by the included wrap2para.xsl stylesheet. It does not intend to
+address all cases of source, only type=xml source.
+Lines are each wrapped with a styled <p> element.
</p>
<ul>
<li>
-<a href="wrap2para/with-word-boundaries">Long Line With Word Boundaries</a>
-</li>
-<li>
-<a href="wrap2para/without-word-boundaries">Long Line Without Word Boundaries</a>
-</li>
-<li>
<a href="wrap2para/cdata-model">CDATA and deeply embedded xml content model</a>
</li>
<li>
<a href="wrap2para/cdata-model-2">CDATA and deeply embedded xml content model with long names</a>
</li>
-<li>
-<a href="wrap2para/ascii-art">Ascii Art</a>
-</li>
</ul>
<h2>Using the "docnbsp.xsl" stylesheet</h2>
-<p>Sequences of two consecutive spaces are replaced by a non-breaking space and a regular space.
-
+<p>
+Sequences of two consecutive spaces are replaced by a non-breaking space
+and a regular space.
+Each line is encased in a <code>><br/>
+This keeps the text indentation that would be obtained with a <pre>
+while still allowing line wrapping by the browser.
+This utilises the <a href="http://exslt.org/">exslt extension</a> for strings.
</p>
<ul>
<li>
@@ -123,12 +120,8 @@
<li>
<a href="nbsp/cdata-model-2">CDATA and deeply embedded xml content model with long names</a>
</li>
-<li>
-<a href="nbsp/ascii-art">Ascii Art</a>
-</li>
</ul>
-
<a name="notes" />
<h2>Other notes</h2>
<p>
@@ -141,7 +134,9 @@
</p>
<p>
-See the Bugzilla report and the cocoon-dev and forrest-dev mail lists.
+See the Bugzilla report
+(<a href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=23796">23796</a>)
+and the links to the cocoon-dev and forrest-dev mail discussion.
</p>
<p>