forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "David Crossley (JIRA)" <j...@apache.org>
Subject [jira] Commented: (FOR-1168) Sample pages that fail validation
Date Fri, 04 Jun 2010 02:27:55 GMT

    [ 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.


Mime
View raw message