Commit 2aed19fc authored by Jim Campbell's avatar Jim Campbell

docs: Added two files to allow for schematron checks of docs.

Included both gnome-help.sct and schematron.sh. Running
./schematron.sh will call gnome-help.sct, providing further
validation of docs within gedit help.
parent 3dbd63fc
<schema xmlns="http://www.ascc.net/xml/schematron" >
<title>Some sanity checks for the GNOME desktop help</title>
<ns prefix="mal" uri="http://projectmallard.org/1.0/"/>
<ns prefix="xi" uri="http://www.w3.org/2001/XInclude"/>
<pattern name="Info element checks">
<rule context="mal:page/mal:info">
<assert test="not(mal:license)">Must not include license directly</assert>
<assert test="xi:include[@href='legal.xml']">Must include legal.xml</assert>
</rule>
</pattern>
<pattern name="Desc checks">
<rule context="mal:page/mal:info">
<assert test="normalize-space(mal:desc) != ''">Must have non-empty desc</assert>
</rule>
<rule context="mal:page/mal:info/mal:desc">
<assert test="substring(normalize-space(.), string-length(normalize-space(.))) = '.'">Desc must end with a period</assert>
</rule>
<rule context="mal:page/mal:info/mal:desc/mal:link">
<assert test="substring(normalize-space(..), string-length(normalize-space(..)) - 2) = '...'">Desc with links must end with an ellipsis</assert>
</rule>
</pattern>
</schema>
xmllint --noout --schematron gnome-help.sct *.page 2>&1 | grep -v validates
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment