[gatewiki-commits] SF.net SVN: gatewiki:[1435] trunk/cow/doc
|
View:
New views
1 Messages
—
Rating Filter:
Alert me
|
 |
[gatewiki-commits] SF.net SVN: gatewiki:[1435] trunk/cow/doc
by ggorrell
::
Rate this Message:
Revision: 1435
http://gatewiki.svn.sourceforge.net/gatewiki/?rev=1435&view=rev Author: ggorrell Date: 2009-07-02 10:25:31 +0000 (Thu, 02 Jul 2009) Log Message: ----------- Added some problems I have been having with CoW Modified Paths: -------------- trunk/cow/doc/cow-backlog.html trunk/cow/doc/cow-backlog.yam trunk/cow/doc/index.html trunk/cow/doc/yam/yam-version-3/yam.html Modified: trunk/cow/doc/cow-backlog.html =================================================================== --- trunk/cow/doc/cow-backlog.html 2009-07-01 12:56:36 UTC (rev 1434) +++ trunk/cow/doc/cow-backlog.html 2009-07-02 10:25:31 UTC (rev 1435) @@ -562,8 +562,25 @@ <li>CowPermission(Wiki 1, directory "", controller [page, search], actions [Read])</li> </ul> +<li>GG (Check to see if these really are bugs :)</li> + <ul> + <li><span class="cow-escape">%</span>contents links do not include path to current page, therefore links you back to + front page, i.e. <a class="cow-url" href="http://localhost:8080/#section_0.1.">http://localhost:8080/#section_0.1.</a> rather than + <a class="cow-url" href="http://localhost:8080/mydoc.html#section_0.1.">http://localhost:8080/mydoc.html#section_0.1.</a></li> + <li>relative links in areas other than area 2 do not work because they assume + you are in the default area (i.e. <a class="cow-non-existant-url" href="page1.html">page1.html</a> links to + <a class="cow-url" href="http://localhost:8080/page1.html">http://localhost:8080/page1.html</a> even if it should be <a class="cow-url" href="http://localhost:8080/page/show/4/page1.html)">http://localhost:8080/page/show/4/page1.html)</a></li> + <li>Make a page containing a table with two rows, one of which is empty. Save or + preview results in the entire page content being dropped without warning.</li> + <li>If the last thing in a table is a verbatim (<span class="cow-escape">%</span><span class="cow-escape"><</span>...<span class="cow-escape">></span><span class="cow-escape">%</span>) item, that thing will not + be verbatimised</li> + <li>No apparent way to make a picture into a link</li> + <li>Tables need more power if we are to use them for layout, i.e. control over borders and + width</li> + </ul> </ul> + <!--%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%--> <a class="cow-section-anchor" name="section-3."/><h1 class="cow-heading"><span class="cow-sec-number">3. </span>Completed Tasks</h1> Modified: trunk/cow/doc/cow-backlog.yam =================================================================== --- trunk/cow/doc/cow-backlog.yam 2009-07-01 12:56:36 UTC (rev 1434) +++ trunk/cow/doc/cow-backlog.yam 2009-07-02 10:25:31 UTC (rev 1435) @@ -387,7 +387,22 @@ defined over sets of controllers, in the same way we do for actions: - CowPermission(Wiki 1, directory "", controller [page, search], actions [Read]) +- GG (Check to see if these really are bugs :) + - \%contents links do not include path to current page, therefore links you back to + front page, i.e. http://localhost:8080/#section_0.1. rather than + http://localhost:8080/mydoc.html#section_0.1. + - relative links in areas other than area 2 do not work because they assume + you are in the default area (i.e. %(page1.html) links to + http://localhost:8080/page1.html even if it should be http://localhost:8080/page/show/4/page1.html) + - Make a page containing a table with two rows, one of which is empty. Save or + preview results in the entire page content being dropped without warning. + - If the last thing in a table is a verbatim (\%\<...\>\%) item, that thing will not + be verbatimised + - No apparent way to make a picture into a link + - Tables need more power if we are to use them for layout, i.e. control over borders and + width + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %1 Completed Tasks Modified: trunk/cow/doc/index.html =================================================================== --- trunk/cow/doc/index.html 2009-07-01 12:56:36 UTC (rev 1434) +++ trunk/cow/doc/index.html 2009-07-02 10:25:31 UTC (rev 1435) @@ -62,7 +62,7 @@ <ul> <li><a class="cow-url" href="../test/reports/index.html">JUnit tests</a></li> <li><a class="cow-url" href="../selenium/results.html">Selenium functional tests</a></li> -<li><a class="cow-url" href="../logfile.txt">the log file</a></li> +<li><a class="cow-non-existant-url" href="../logfile.txt">the log file</a></li> </ul> <!-- @@ -75,8 +75,8 @@ <p>APIs</p> <ul> -<li><a class="cow-url" href="api/javadoc/index.html">Java API</a> (<a class="cow-url" href="api/javadoc/constant-values.html">constants</a>)</li> -<li><a class="cow-url" href="api/gapi/index.html">Groovy API</a></li> +<li><a class="cow-non-existant-url" href="api/javadoc/index.html">Java API</a> (<a class="cow-non-existant-url" href="api/javadoc/constant-values.html">constants</a>)</li> +<li><a class="cow-non-existant-url" href="api/gapi/index.html">Groovy API</a></li> </ul> <p>Mailing lists</p> Modified: trunk/cow/doc/yam/yam-version-3/yam.html =================================================================== --- trunk/cow/doc/yam/yam-version-3/yam.html 2009-07-01 12:56:36 UTC (rev 1434) +++ trunk/cow/doc/yam/yam-version-3/yam.html 2009-07-02 10:25:31 UTC (rev 1435) @@ -56,13 +56,13 @@ can produce output in HTML and LaTeX and thence PDF. </p> <p>Although simple YAM is rich in features. From simple text processing features -like <b>bold</b>, <em>emphasis</em>. and <tt>teletype</tt> to tables, a title page, and a table +like <b>bold</b>, <em>emphasis</em>. and =teletype= to tables, a title page, and a table of contents, there is a range of features which can help create highly presentable documents in both LaTeX and HTML:</p> <ul> <li>Headings</li> -<li>Text processing: <b>bold</b>, <em>emphasis</em>, <tt>teletype</tt></li> +<li>Text processing: <b>bold</b>, <em>emphasis</em>, =teletype=</li> <li>Line breaks</li> <li>Hrules</li> <li>Nested Lists</li> @@ -81,13 +81,13 @@ <a class="cow-section-anchor" name="section-1.1."/><h2 class="cow-heading"><span class="cow-sec-number">1.1. </span>Bold, italic and teletype #bold</h2> -<p>Bold text is contained in stars: <tt><b>this is bold</b></tt> becomes <b>this is bold</b>.</p> +<p>Bold text is contained in stars: =<b>this is bold</b>= becomes <b>this is bold</b>.</p> -<p>Italic text is contained in underscores: <tt><em>this is italic</em></tt> becomes <em>this is +<p>Italic text is contained in underscores: =<em>this is italic</em>= becomes <em>this is italic</em>.</p> -<p>Fixed-width text is contained in equals signs: <span class="cow-escape">=</span><tt>this is teletype</tt><span class="cow-escape">=</span> -becomes <tt>this is teletype</tt>.</p> +<p>Fixed-width text is contained in equals signs: <span class="cow-escape">=</span>=this is teletype=<span class="cow-escape">=</span> +becomes =this is teletype=.</p> <a class="cow-section-anchor" name="section-1.2."/><h2 class="cow-heading"><span class="cow-sec-number">1.2. </span>Horizontal lines #hr</h2> @@ -170,12 +170,12 @@ '=http://gate.ac.uk/=' </pre> <p>the equals signs are translated, but not the URL they contain (with the -result '<tt><a class="cow-url" href="http://gate.ac.uk/=').">http://gate.ac.uk/=').</a></p> +result '=<a class="cow-url" href="http://gate.ac.uk/=').">http://gate.ac.uk/=').</a></p> <a class="cow-section-anchor" name="section-1.7."/><h2 class="cow-heading"><span class="cow-sec-number">1.7. </span>Headings #headings</h2> -<p>Headings are lines starting with </tt>%1<tt> (for first level), </tt>%2<tt>, </tt>%3<tt> or </tt>%4<tt>. +<p>Headings are lines starting with =%1= (for first level), =%2=, =%3= or =%4=. For example, the heading for this section is</p> <pre> %2 Headings @@ -186,26 +186,26 @@ <p>Links can be specified in four ways:</p> <ol> -<li>As plain text, e.g. '</tt><a class="cow-url" href="http://gate.ac.uk/='">http://gate.ac.uk/='</a> +<li>As plain text, e.g. '=<a class="cow-url" href="http://gate.ac.uk/='">http://gate.ac.uk/='</a> will become <a class="cow-url" href="http://gate.ac.uk/">http://gate.ac.uk/</a></li> -<li>Using '<tt><a class="cow-non-existant-url" href="target">target</a></tt>', e.g. <tt><a class="cow-url" href="http://gate.ac.uk/">http://gate.ac.uk/</a></tt> +<li>Using '=<a class="cow-non-existant-url" href="target">target</a>=', e.g. =<a class="cow-url" href="http://gate.ac.uk/">http://gate.ac.uk/</a>= will become <a class="cow-url" href="http://gate.ac.uk/">http://gate.ac.uk/</a></li> -<li>Using '<tt><a class="cow-non-existant-url" href="target">label</a></tt>', e.g. <tt><a class="cow-url" href="http://gate.ac.uk/">GATE home</a></tt> +<li>Using '=<a class="cow-non-existant-url" href="target">label</a>=', e.g. =<a class="cow-url" href="http://gate.ac.uk/">GATE home</a>= will become <a class="cow-url" href="http://gate.ac.uk/">GATE home</a></li> <li>Using Wiki syntax %<span class="cow-escape"> </span> <b>NOT DONE YET</b></li> </ol> -<p>Anchors and labels are specified using '<tt>#name</tt>'. For example,</p> +<p>Anchors and labels are specified using '=#name='. For example,</p> <pre> %2 A Heading #label </pre> -<p>will result in a heading followed by the anchor <tt>label</tt>.</p> +<p>will result in a heading followed by the anchor =label=.</p> <a class="cow-section-anchor" name="section-1.9."/><h2 class="cow-heading"><span class="cow-sec-number">1.9. </span>Quotations #quotations</h2> -<p>Quotations are enclosed in '<tt>"</tt>' marks that start are preceded by two spaces +<p>Quotations are enclosed in '="=' marks that start are preceded by two spaces at the start of a line. For example,</p> <pre> %"This is a quote%" @@ -258,14 +258,14 @@ file in the plugins directory, and that's no good. get resource doesn't appear to work well either in this case</li> <li>the target in a url gets interpreted as an anchor when the protocol - isn't specified (e.g. <tt>antlr.org/doc/lexer.html#unicode</tt>)</li> + isn't specified (e.g. =antlr.org/doc/lexer.html#unicode=)</li> <li>unclosed <span class="cow-escape">=</span> causes open tt with no close</li> <li>text at the end of a URL can get included in the URL, e.g. <a class="cow-url" href="http://antlr.org/doc/lexer.html#unicode:">http://antlr.org/doc/lexer.html#unicode:</a> includes the ":"</li> <li>there's no way to end an embedded list element except by another list element (embedded or higher level)</li> <li>percentage signs need to be escaped in latex output</li> -<li>odd behaviour on non-native newlines (e.g. ^M on macs)</li> +<li>odd behaviour on non-native newlines (e.g. <tt>M on macs)</li> <li>URLs that contain commas don't work properly with the <span class="cow-escape">%</span>() syntax</li> <li>URLs don't work in headings</li> <li>the type of the .yam character set should be output to the HTML, e.g. @@ -281,14 +281,14 @@ <li><em>the citation plugin is HTML specific</em></li> <li><em>the citation plugin closes any embedding lists; what is needed is to be able to tell the context not to do further processing on the - results of the plugin, instead of using the</em> <tt>output</tt> <em>mechanism</em></li> + results of the plugin, instead of using the</em> =output= <em>mechanism</em></li> <li><em>an empty notes field results in null pointer exception</em></li> </ol> <a class="cow-section-anchor" name="section-2.2."/><h2 class="cow-heading"><span class="cow-sec-number">2.2. </span>Wish list:</h2> <ul> <li>a syntax for "less than" symbol and other symbols / unicode escapes</li> <li>anchors that are at the end of a heading line should be sent to - the translator as a separate call, <tt>link(url, title, anchor)</tt>, so that + the translator as a separate call, =link(url, title, anchor)=, so that the translator can position the anchor before or after the heading as appropriate</li> <li>change the use of backslash to trigger a newline to something else</li> @@ -329,17 +329,17 @@ <li><em>allow e.g. - in anchors</em></li> </ul> <a class="cow-section-anchor" name="section-2.3."/><h2 class="cow-heading"><span class="cow-sec-number">2.3. </span>WikiLinks -WikiLinks are just links, created either like other links (<tt><span class="cow-escape">%</span>(...)</tt>), or by +WikiLinks are just links, created either like other links (=<span class="cow-escape">%</span>(...)=), or by typing a WikiWord. Some points:</h2> <ul> <li>WikiSyntaxForLinks should include an optional relative path, e.g. - <tt>path/to/WikiWord</tt></li> + =path/to/WikiWord=</li> <li>when the target of a WikiLink exists, it is treated exactly like a normal link</li> <li>when the target doesn't exist, the link is rendered specially (perhaps - a different colour, or italic, or with a postfix <tt>?</tt> like in Twiki), and - clicking directs you to a <tt>create</tt> page</li> -<li>therefore, the renderer (<tt>yam2...</tt>) has to know whether a local link + a different colour, or italic, or with a postfix =?= like in Twiki), and + clicking directs you to a =create= page</li> +<li>therefore, the renderer (=yam2...=) has to know whether a local link exists or not in every case</li> </ul> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. ------------------------------------------------------------------------------ _______________________________________________ gatewiki-commits mailing list gatewiki-commits@... https://lists.sourceforge.net/lists/listinfo/gatewiki-commits |
| Free embeddable forum powered by Nabble | Forum Help |
