cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject cvs commit: cocoon-2.1/src/webapp/samples/text-wrap welcome.html
Date Sat, 06 Dec 2003 05:06:12 GMT
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 &lt;source&gt; elements had their long
  -lines split by the included split.xsl stylesheet.
  +<p>All &lt;source&gt; 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 &lt;pre&gt; 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 &lt;source&gt; 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 &lt;p&gt; element.
  +<p>Only &lt;source&gt; 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 &lt;p&gt; 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 &lt;code&gt>&lt;br/&gt;
  +This keeps the text indentation that would be obtained with a &lt;pre&gt; 
  +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>
  
  
  

Mime
View raw message