You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@forrest.apache.org by "Gavin (JIRA)" <ji...@apache.org> on 2009/05/17 12:55:45 UTC
[jira] Created: (FOR-1168) Sample pages that fail validation
Sample pages that fail validation
---------------------------------
Key: FOR-1168
URL: https://issues.apache.org/jira/browse/FOR-1168
Project: Forrest
Issue Type: Bug
Components: Documentation and website, Plugin: internal.dispatcher
Affects Versions: 0.9-dev
Reporter: Gavin
Fix For: 0.9-dev
The main 'sample.html' passes validation fine, however some other pages fail xhtml 1.0 strict validation. Mainly due to the use of the + symbol in name anchors. Not a problem for sites validating to HTML4.01.
These pages include (but check for more)
samples-b/usemap.html
samples-b/xinclude.html
samples-b/static.html
samples-b/linking.html
samples-b/howto-wowto.html
samples-b/embedded_html.html
samples-b/ascii-art.html
locationmap/index.html
samples-c/subdir/index.html
samples-c/showonlywhenselected/page1.html
samples-c/showonlywhenselected/page2.html
pluginDocs/plugins_0_90/index.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Assigned: (FOR-1168) Sample pages that fail validation
Posted by "Gavin (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/FOR-1168?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Gavin reassigned FOR-1168:
--------------------------
Assignee: Gavin
> Sample pages that fail validation
> ---------------------------------
>
> Key: FOR-1168
> URL: https://issues.apache.org/jira/browse/FOR-1168
> Project: Forrest
> Issue Type: Bug
> Components: Documentation and website, Plugin: internal.dispatcher
> Affects Versions: 0.9-dev
> Reporter: Gavin
> Assignee: Gavin
> Fix For: 0.9-dev
>
>
> The main 'sample.html' passes validation fine, however some other pages fail xhtml 1.0 strict validation. Mainly due to the use of the + symbol in name anchors. Not a problem for sites validating to HTML4.01.
> These pages include (but check for more)
> samples-b/usemap.html
> samples-b/xinclude.html
> samples-b/static.html
> samples-b/linking.html
> samples-b/howto-wowto.html
> samples-b/embedded_html.html
> samples-b/ascii-art.html
> locationmap/index.html
> samples-c/subdir/index.html
> samples-c/showonlywhenselected/page1.html
> samples-c/showonlywhenselected/page2.html
> pluginDocs/plugins_0_90/index.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (FOR-1168) Sample pages that fail validation
Posted by "Tim Williams (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/FOR-1168?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Tim Williams updated FOR-1168:
------------------------------
Fix Version/s: 0.10
(was: 0.9-dev)
Effects dispatcher, pushing off 'til next release.
> Sample pages that fail validation
> ---------------------------------
>
> Key: FOR-1168
> URL: https://issues.apache.org/jira/browse/FOR-1168
> Project: Forrest
> Issue Type: Bug
> Components: Documentation and website, Plugin: internal.dispatcher
> Affects Versions: 0.9-dev
> Reporter: Gavin
> Assignee: Gavin
> Fix For: 0.10
>
>
> The main 'sample.html' passes validation fine, however some other pages fail xhtml 1.0 strict validation. Mainly due to the use of the + symbol in name anchors. Not a problem for sites validating to HTML4.01.
> These pages include (but check for more)
> samples-b/usemap.html
> samples-b/xinclude.html
> samples-b/static.html
> samples-b/linking.html
> samples-b/howto-wowto.html
> samples-b/embedded_html.html
> samples-b/ascii-art.html
> locationmap/index.html
> samples-c/subdir/index.html
> samples-c/showonlywhenselected/page1.html
> samples-c/showonlywhenselected/page2.html
> pluginDocs/plugins_0_90/index.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (FOR-1168) Sample pages that fail validation
Posted by "Gavin (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/FOR-1168?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12710196#action_12710196 ]
Gavin commented on FOR-1168:
----------------------------
Currently it looks like spaces in titles are converted to + , such as
<title>Link Rewriting</title>
gets converted to
<a name="Link+Rewriting" title="Link Rewriting"> </a>
though I cant see where that is happening currently.
> Sample pages that fail validation
> ---------------------------------
>
> Key: FOR-1168
> URL: https://issues.apache.org/jira/browse/FOR-1168
> Project: Forrest
> Issue Type: Bug
> Components: Documentation and website, Plugin: internal.dispatcher
> Affects Versions: 0.9-dev
> Reporter: Gavin
> Assignee: Gavin
> Fix For: 0.9-dev
>
>
> The main 'sample.html' passes validation fine, however some other pages fail xhtml 1.0 strict validation. Mainly due to the use of the + symbol in name anchors. Not a problem for sites validating to HTML4.01.
> These pages include (but check for more)
> samples-b/usemap.html
> samples-b/xinclude.html
> samples-b/static.html
> samples-b/linking.html
> samples-b/howto-wowto.html
> samples-b/embedded_html.html
> samples-b/ascii-art.html
> locationmap/index.html
> samples-c/subdir/index.html
> samples-c/showonlywhenselected/page1.html
> samples-c/showonlywhenselected/page2.html
> pluginDocs/plugins_0_90/index.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (FOR-1168) Sample pages that fail validation
Posted by "Gavin (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/FOR-1168?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12781335#action_12781335 ]
Gavin commented on FOR-1168:
----------------------------
Does anyone have ideas as to where I can look to replace the + with a _ .
Also opinions welcome in whether this fix is suitable as suggested.
> Sample pages that fail validation
> ---------------------------------
>
> Key: FOR-1168
> URL: https://issues.apache.org/jira/browse/FOR-1168
> Project: Forrest
> Issue Type: Bug
> Components: Documentation and website, Plugin: internal.dispatcher
> Affects Versions: 0.9-dev
> Reporter: Gavin
> Assignee: Gavin
> Fix For: 0.9-dev
>
>
> The main 'sample.html' passes validation fine, however some other pages fail xhtml 1.0 strict validation. Mainly due to the use of the + symbol in name anchors. Not a problem for sites validating to HTML4.01.
> These pages include (but check for more)
> samples-b/usemap.html
> samples-b/xinclude.html
> samples-b/static.html
> samples-b/linking.html
> samples-b/howto-wowto.html
> samples-b/embedded_html.html
> samples-b/ascii-art.html
> locationmap/index.html
> samples-c/subdir/index.html
> samples-c/showonlywhenselected/page1.html
> samples-c/showonlywhenselected/page2.html
> pluginDocs/plugins_0_90/index.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (FOR-1168) Sample pages that fail validation
Posted by "David Crossley (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/FOR-1168?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12875433#action_12875433 ]
David Crossley commented on FOR-1168:
-------------------------------------
I reckon that this is a good solution.
However, it would need emphasis in the "upgrading" doc and "changes", because it would break linking if people were relying on the current format. Hopefully they are using a "site.xml" navigation, making it easy to change.
By the way, in most of the xdocs that i write, i tend to use an explicit section@id attribute in the source doc. Much better than relying on those generated links, which can be very verbose depending on the "title". That also helps to separate the concern of "linking", and protects against an author tweaking the section title and hence breaking the links.
> Sample pages that fail validation
> ---------------------------------
>
> Key: FOR-1168
> URL: https://issues.apache.org/jira/browse/FOR-1168
> Project: Forrest
> Issue Type: Bug
> Components: Documentation and website, Plugin: internal.dispatcher
> Affects Versions: 0.9-dev
> Reporter: Gavin
> Assignee: Gavin
> Fix For: 0.9-dev
>
>
> The main 'sample.html' passes validation fine, however some other pages fail xhtml 1.0 strict validation. Mainly due to the use of the + symbol in name anchors. Not a problem for sites validating to HTML4.01.
> These pages include (but check for more)
> samples-b/usemap.html
> samples-b/xinclude.html
> samples-b/static.html
> samples-b/linking.html
> samples-b/howto-wowto.html
> samples-b/embedded_html.html
> samples-b/ascii-art.html
> locationmap/index.html
> samples-c/subdir/index.html
> samples-c/showonlywhenselected/page1.html
> samples-c/showonlywhenselected/page2.html
> pluginDocs/plugins_0_90/index.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (FOR-1168) Sample pages that fail validation
Posted by "David Crossley (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/FOR-1168?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12875391#action_12875391 ]
David Crossley commented on FOR-1168:
-------------------------------------
I presume that this is handled in main/webapp/sitemap.xmap ...
----------------
<!-- Generates @id attributes from <title> strings -->
<map:transformer name="idgen" src="org.apache.forrest.util.IdGeneratorTransformer">
<element>//*[local-name() = 'section']</element>
<id>title/text()</id>
</map:transformer>
----------------
> Sample pages that fail validation
> ---------------------------------
>
> Key: FOR-1168
> URL: https://issues.apache.org/jira/browse/FOR-1168
> Project: Forrest
> Issue Type: Bug
> Components: Documentation and website, Plugin: internal.dispatcher
> Affects Versions: 0.9-dev
> Reporter: Gavin
> Assignee: Gavin
> Fix For: 0.9-dev
>
>
> The main 'sample.html' passes validation fine, however some other pages fail xhtml 1.0 strict validation. Mainly due to the use of the + symbol in name anchors. Not a problem for sites validating to HTML4.01.
> These pages include (but check for more)
> samples-b/usemap.html
> samples-b/xinclude.html
> samples-b/static.html
> samples-b/linking.html
> samples-b/howto-wowto.html
> samples-b/embedded_html.html
> samples-b/ascii-art.html
> locationmap/index.html
> samples-c/subdir/index.html
> samples-c/showonlywhenselected/page1.html
> samples-c/showonlywhenselected/page2.html
> pluginDocs/plugins_0_90/index.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (FOR-1168) Sample pages that fail validation
Posted by "Gavin (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/FOR-1168?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12710193#action_12710193 ]
Gavin commented on FOR-1168:
----------------------------
See http://www.w3.org/TR/xhtml1/#C_8 for more details.
Mainly we know that the 'name' attribute is deprecated but usable for backwards compatibility; and has been reduced to NMTOKEN status, and that + is a symbol that cannot be used in the value of the 'name' attribute.
We should be looking to remove 'name' altogether in future versions, for now to ensure backwards compatibility (as most of our documents would still be served as text/html) we should just remove instance of + and replace with _ .
> Sample pages that fail validation
> ---------------------------------
>
> Key: FOR-1168
> URL: https://issues.apache.org/jira/browse/FOR-1168
> Project: Forrest
> Issue Type: Bug
> Components: Documentation and website, Plugin: internal.dispatcher
> Affects Versions: 0.9-dev
> Reporter: Gavin
> Assignee: Gavin
> Fix For: 0.9-dev
>
>
> The main 'sample.html' passes validation fine, however some other pages fail xhtml 1.0 strict validation. Mainly due to the use of the + symbol in name anchors. Not a problem for sites validating to HTML4.01.
> These pages include (but check for more)
> samples-b/usemap.html
> samples-b/xinclude.html
> samples-b/static.html
> samples-b/linking.html
> samples-b/howto-wowto.html
> samples-b/embedded_html.html
> samples-b/ascii-art.html
> locationmap/index.html
> samples-c/subdir/index.html
> samples-c/showonlywhenselected/page1.html
> samples-c/showonlywhenselected/page2.html
> pluginDocs/plugins_0_90/index.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (FOR-1168) Sample pages that fail validation
Posted by "Gavin (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/FOR-1168?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12875001#action_12875001 ]
Gavin commented on FOR-1168:
----------------------------
any thoughts?
> Sample pages that fail validation
> ---------------------------------
>
> Key: FOR-1168
> URL: https://issues.apache.org/jira/browse/FOR-1168
> Project: Forrest
> Issue Type: Bug
> Components: Documentation and website, Plugin: internal.dispatcher
> Affects Versions: 0.9-dev
> Reporter: Gavin
> Assignee: Gavin
> Fix For: 0.9-dev
>
>
> The main 'sample.html' passes validation fine, however some other pages fail xhtml 1.0 strict validation. Mainly due to the use of the + symbol in name anchors. Not a problem for sites validating to HTML4.01.
> These pages include (but check for more)
> samples-b/usemap.html
> samples-b/xinclude.html
> samples-b/static.html
> samples-b/linking.html
> samples-b/howto-wowto.html
> samples-b/embedded_html.html
> samples-b/ascii-art.html
> locationmap/index.html
> samples-c/subdir/index.html
> samples-c/showonlywhenselected/page1.html
> samples-c/showonlywhenselected/page2.html
> pluginDocs/plugins_0_90/index.html
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.