[docs] xmldocs - docelic modified 10 files
docs at icdevgroup.org
docs at icdevgroup.org
Mon Nov 22 19:29:45 EST 2004
User: docelic
Date: 2004-11-23 00:29:45 GMT
Modified: . Makefile
Added: glossary CATROOT DOCROOT SKU SQL WWWROOT catalog hello-world
Added: tarball
Added: howtos validate
Log:
Add various glossary/howto files
Revision Changes Path
1.47 +1 -1 xmldocs/Makefile
rev 1.47, prev_rev 1.46
Index: Makefile
===================================================================
RCS file: /var/cvs/xmldocs/Makefile,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -r1.46 -r1.47
--- Makefile 22 Nov 2004 22:26:11 -0000 1.46
+++ Makefile 23 Nov 2004 00:29:44 -0000 1.47
@@ -152,7 +152,7 @@
-rm -rf $T
-rm -rf {refs,glossary,howtos}/*.xml
-rm -rf docbook/auto{refs,glossary,howtos}.ent
-look-clean: clean clean-cache
+look-clean:
-mv $T $T.temporary 2>/dev/null
1.1 xmldocs/glossary/CATROOT
rev 1.1, prev_rev 1.0
Index: CATROOT
===================================================================
<glossentry id="CATROOT">
<glossterm>CATROOT</glossterm>
<glossterm>Interchange Catalogs Root Directory</glossterm>
<glossdef>
<para>
</para>
</glossdef>
</glossentry>
1.1 xmldocs/glossary/DOCROOT
rev 1.1, prev_rev 1.0
Index: DOCROOT
===================================================================
<glossentry id="DOCROOT">
<glossterm>DOCROOT</glossterm>
<glossterm>Catalog Root Directory</glossterm>
<glossdef>
<para>
</para>
</glossdef>
</glossentry>
1.1 xmldocs/glossary/SKU
rev 1.1, prev_rev 1.0
Index: SKU
===================================================================
<glossentry id="SKU">
<glossterm>SKU</glossterm>
<glossterm>Stock Keeping Unit</glossterm>
<glossdef>
<para>
</para>
</glossdef>
</glossentry>
1.1 xmldocs/glossary/SQL
rev 1.1, prev_rev 1.0
Index: SQL
===================================================================
<glossentry id="SQL">
<glossterm>SQL</glossterm>
<glossterm>Structured Query Language</glossterm>
<glossdef>
<para>
</para>
</glossdef>
</glossentry>
1.1 xmldocs/glossary/WWWROOT
rev 1.1, prev_rev 1.0
Index: WWWROOT
===================================================================
<glossentry id="WWWROOT">
<glossterm>WWWROOT</glossterm>
<glossterm>Virtual Host (Web Server) Root Directory</glossterm>
<glossdef>
<para>
</para>
</glossdef>
</glossentry>
1.1 xmldocs/glossary/catalog
rev 1.1, prev_rev 1.0
Index: catalog
===================================================================
<glossentry id="catalog">
<glossterm>catalog</glossterm>
<glossterm>Catalog</glossterm>
<glossdef>
<para>
</para>
</glossdef>
</glossentry>
1.1 xmldocs/glossary/hello-world
rev 1.1, prev_rev 1.0
Index: hello-world
===================================================================
<glossentry id="hello-world">
<glossterm>Hello, World!</glossterm>
<glossdef>
<para>
<emphasis>Hello, World!</emphasis> resource at
<ulink url="http://en.wikipedia.org/wiki/Hello_world">Wikipedia</ulink>.
</para>
</glossdef>
</glossentry>
1.1 xmldocs/glossary/tarball
rev 1.1, prev_rev 1.0
Index: tarball
===================================================================
<glossentry id="tarball">
<glossterm>tarball</glossterm>
<glossterm>Tarball</glossterm>
<glossdef>
<para>
</para>
</glossdef>
</glossentry>
1.1 xmldocs/howtos/validate
rev 1.1, prev_rev 1.0
Index: validate
===================================================================
<chapter id="validate">
<chapterinfo>
<title>Validate Interchange-produced Markup</title>
<titleabbrev>validate</titleabbrev>
<keywordset>
<keyword>markup</keyword>
<keyword>html</keyword>
<keyword>valid</keyword>
<keyword>validation</keyword>
<keyword>validator</keyword>
<keyword>validate</keyword>
<keyword>w3c</keyword>
<keyword>jigsaw</keyword>
<keyword>xhtml</keyword>
<keyword>xml</keyword>
<keyword>css</keyword>
<keyword>rdf</keyword>
</keywordset>
<authorgroup>
<author>
<firstname>Davor</firstname>
<surname>Ocelic</surname>
<affiliation>
<email>docelic at icdevgroup.org</email>
</affiliation>
</author>
</authorgroup>
</chapterinfo>
<sect1 id='validate_introduction'>
<title>Introduction</title>
<para>
HOW-TO version: $Id: validate,v 1.1 2004/11/23 00:29:44 docelic Exp $
</para>
<para>
Validate pages at W3C.
</para>
</sect1>
<sect1 id='validate_solution'>
<title>Solution</title>
<para>
testing your pages with
&css-validator; or &markup-validator;.
</para>
<para>
&IC; does not output any CSS on its own, so the CSS validation outcome
will depend solely on your CSS skills.
</para>
<para>
&IC; does, however, output a lot of HTML markup.
That produced markup is, we can say, pretty inconsistent in
letter case (uppercase/lowecase) and argument quoting.
In later 2004., and in the spirit of the upcoming XHTML standards, a
consensus was reached among &ICDEVGROUP; members to start a long-term
process of converting all
output markup to lowercase and quoting all arguments using double quotes.
</para>
<para>
The above does not harm any compatiblity with ancient Web browser
programs, and is a nice step towards strict XHTML compliance.
If you are interested in helping out, please contact &docelic;.
</para>
<para>
For the complete XHTML compliance, non-container markup tags should
be closed with
<literal>/></literal> instead of just
<literal>></literal>.
We plan to establish a new &glos-pragma; that will adjust the output
markup for the few non-container HTML tags.
</para>
</sect1>
</chapter>
More information about the docs
mailing list