Uploaded image for project: 'Forrest'
  1. Forrest
  2. FOR-1172

enable validation of the internal xml

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 0.9
    • Labels:
      None

      Description

      We already have one way to validate the xml at any part of the Cocoon sitemaps:
       "Using Cocoon Validation Transformers"
       http://forrest.apache.org/howto-dev.html#debug-validation

      So use this to enable validating the intermediate xml.

        Issue Links

          Activity

          Hide
          crossley David Crossley added a comment -
          Used Trang-20081028 to generate a RELAX NG schema from the "document-v13" DTD.

          http://code.google.com/p/jing-trang/

          Commandline was:
           java -jar trang.jar -I dtd \
           $FORREST_HOME/main/webapp/resources/schema/dtd/document-v13.mod \
           $FORREST_HOME/main/webapp/resources/schema/relaxng/unstable/document-v13.rng
          Show
          crossley David Crossley added a comment - Used Trang-20081028 to generate a RELAX NG schema from the "document-v13" DTD. http://code.google.com/p/jing-trang/ Commandline was:  java -jar trang.jar -I dtd \  $FORREST_HOME/main/webapp/resources/schema/dtd/document-v13.mod \  $FORREST_HOME/main/webapp/resources/schema/relaxng/unstable/document-v13.rng
          Hide
          crossley David Crossley added a comment -
          Added that at r780557.

          See instructions in the abovementioned document.
          Show
          crossley David Crossley added a comment - Added that at r780557. See instructions in the abovementioned document.
          Hide
          crossley David Crossley added a comment -
          The abovementioned work enabled doing intermediate validation during 'forrest run' by requesting URIs such as localhost:8888/index.validation.xml

          Now added a mechanism to do intermediate validation of all documents. (r782343)
          Show
          crossley David Crossley added a comment - The abovementioned work enabled doing intermediate validation during 'forrest run' by requesting URIs such as localhost:8888/index.validation.xml Now added a mechanism to do intermediate validation of all documents. (r782343)
          Hide
          crossley David Crossley added a comment -
          This is how it works ...

          When Cocoon generates the site, it crawls each document and gathers any new links to be processed. There is a special URI "linkmap" which is the map of the complete site.

          This is utilised to have a special sitemap match "linkmap.validation-start.xml" which transforms the linkmap to have links ending in "*.validation.xml".

          Cocoon has the ability to include extra URIs for processing. Add the line "linkmap.validation-start.xml" to a conf/uris.txt file. Then add the following line to the 'forrest.properties' configuration file:
          project.urifile=${project.home}/src/documentation/conf/uris.txt

          This causes Cocoon to generate all the "*.validation.xml" validation report files.

          After the 'forrest site' completes, Ant summarises all those reports into build/tmp/validation-reports.html and then removes all the individual reports.

          See also http://forrest.apache.org/howto-dev.html#validate-intermediate
          Show
          crossley David Crossley added a comment - This is how it works ... When Cocoon generates the site, it crawls each document and gathers any new links to be processed. There is a special URI "linkmap" which is the map of the complete site. This is utilised to have a special sitemap match "linkmap.validation-start.xml" which transforms the linkmap to have links ending in "*.validation.xml". Cocoon has the ability to include extra URIs for processing. Add the line "linkmap.validation-start.xml" to a conf/uris.txt file. Then add the following line to the 'forrest.properties' configuration file: project.urifile=${project.home}/src/documentation/conf/uris.txt This causes Cocoon to generate all the "*.validation.xml" validation report files. After the 'forrest site' completes, Ant summarises all those reports into build/tmp/validation-reports.html and then removes all the individual reports. See also http://forrest.apache.org/howto-dev.html#validate-intermediate

            People

            • Assignee:
              Unassigned
              Reporter:
              crossley David Crossley
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development