[docs] xmldocs - docelic modified 2 files
docs at icdevgroup.org
docs at icdevgroup.org
Sat Nov 6 13:24:36 EST 2004
User: docelic
Date: 2004-11-06 18:24:36 GMT
Modified: . Makefile TODO
Log:
- Makefile:
- remove --nonet XSLT processor flag; we want to play by the rules
- improve perl oneliner from last commit which replaced 'tail +2'
- TODO: items
Profiling now works, although it's not supported by Makefile.
We'll use profiling for:
1) online examples
2) documentation tailored to specific interchange package (tarball,
.deb, .rpm etc..)
We will use two profiling fields which are already defined in docbook:
1) <example condition='online'> for online examples
2) <anything vendor='rh|deb|tarball|...'> for distro-specific includes
Revision Changes Path
1.38 +3 -3 xmldocs/Makefile
rev 1.38, prev_rev 1.37
Index: Makefile
===================================================================
RCS file: /var/cvs/xmldocs/Makefile,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- Makefile 6 Nov 2004 17:37:01 -0000 1.37
+++ Makefile 6 Nov 2004 18:24:36 -0000 1.38
@@ -23,7 +23,7 @@
# XSLT processor-specific
PSR = xsltproc
-PSR_FLAGS = --xinclude --nonet
+PSR_FLAGS = --xinclude
VPATH = guides refs howtos glossary
.SILENT:
@@ -100,14 +100,14 @@
--stringparam collect.xref.targets only \
--stringparam targets.filename $@ \
docbook/html-nochunks.xsl $<
- perl -ni -e'print if $$. > 1 or $$.==1 and !/^<!DOCTYPE/' $@
+ perl -ni -e'print unless $$.==1 and /^<!DOCTYPE/' $@
olinkdbs-c olinks-c: $(foreach f,$(ALL_DOCS),$T/$f-c.db)
$T/%-c.db: %.xml $T
$(PSR) $(PSR_FLAGS) \
--stringparam collect.xref.targets only \
--stringparam targets.filename $@ \
docbook/html-chunks.xsl $<
- perl -ni -e'print if $$. > 1 or $$.==1 and !/^<!DOCTYPE/' $@
+ perl -ni -e'print unless $$.==1 and /^<!DOCTYPE/' $@
#############################################################
1.44 +0 -6 xmldocs/TODO
rev 1.44, prev_rev 1.43
Index: TODO
===================================================================
RCS file: /var/cvs/xmldocs/TODO,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- TODO 6 Nov 2004 01:06:46 -0000 1.43
+++ TODO 6 Nov 2004 18:24:36 -0000 1.44
@@ -20,10 +20,6 @@
- Double-linked SeeAlso doesn't work. ConfigAllBefore points to ConfigAllAfter,
but the latter doesn't return love.
-- Switch to double-pass document generation. This will make PROPER
- <glossterm> links work again and will allow for profiles which we must
- have (for online examples etc..).
-
- In iccattut:
- make a "translation map" of /etc/interchange/* to RPM-equivs.
- item for package names, like interchange-cat-foundation, wenglish, etc..
@@ -79,8 +75,6 @@
Mid-term:
-- Think about adding "online example" (role=html in combination with
- a flag that says if html is to be static or for hosting on IC-enabled site)
- for "online" docs, also provide a form where users can add comments or
ask for clarification. (this could be done with either pure IC (forum?), or
XML forms capability, or wiki?)..
More information about the docs
mailing list