Permalink
Browse files

* Abandon the howtos/ mechanism and collect howtos in guides/howtos.xml

* Changes to common.xsl, Makefile etc. to support the above
* Few small text fixes to other files
  • Loading branch information...
1 parent 1448bfb commit a3d04552c29b3f36eca57e0b9e8f2fc9352c1b06 @docelic docelic committed Jul 11, 2008
View
@@ -13,10 +13,9 @@ IC_VERSIONS = 4.6.0 4.8.0 5.0.0 5.2.0 5.4.0 5.6.0 cvs-head
#############################################################
# Base definitions
SYMBOL_TYPES= pragmas vars tags confs filters orderchecks widgets
-GUIDES = iccattut programming-style upgrade faq index optimization search xmldocs WHATSNEW install databases
-HOWTOS = howtos
+GUIDES = iccattut programming-style upgrade faq index optimization search xmldocs WHATSNEW install databases howtos
GLOSSARY = glossary
-ALL_DOCS = $(GLOSSARY) $(HOWTOS) $(GUIDES) $(SYMBOL_TYPES)
+ALL_DOCS = $(GLOSSARY) $(GUIDES) $(SYMBOL_TYPES)
SHELL = /bin/sh
OUTPUT ?= -std
TARGET ?= $(XMLDOCS_CUR_DEVEL)
@@ -36,11 +35,11 @@ PSR_FLAGS = --xinclude --nonet
REFS_AUTOGEN = bin/refs-autogen
REFS_AUTOGEN_FLAGS ?=
-VPATH = guides refs howtos glossary whatsnew
+VPATH = guides refs glossary whatsnew
.SILENT:
.PHONY: all complete
.PHONY: skel
-.PHONY: guides howtos symbols glossary
+.PHONY: guides symbols glossary
#.PHONY: olinkdbs-nc olinks-nc olinkdbs-c olinks-c
.PHONY: clean clean-cache clean-refs distclean look-clean
.PHONY: up-all cvs-sources srcs cvsrcs cvs cvss all-up cvsup
@@ -53,7 +52,7 @@ VPATH = guides refs howtos glossary whatsnew
# Complete build
all: skel cache refxmls \
olinkdbs-nc olinkdbs-c \
- glossary symbols guides howtos
+ glossary symbols guides
chunked: skel cache refxmls olinkdbs-nc olinkdbs-c \
$(foreach doc,$(ALL_DOCS),OUTPUT/$(doc))
@@ -64,9 +63,6 @@ nonchunked: skel cache refxmls olinkdbs-nc olinkdbs-c \
guides: $(foreach doc,$(GUIDES),OUTPUT/$(doc).html ) \
$(foreach doc,$(GUIDES),OUTPUT/$(doc))
-howtos: $(foreach doc,$(HOWTOS),OUTPUT/$(doc).html ) \
- $(foreach doc,$(HOWTOS),OUTPUT/$(doc))
-
symbols: $(foreach doc,$(SYMBOL_TYPES),OUTPUT/$(doc).html ) \
$(foreach doc,$(SYMBOL_TYPES),OUTPUT/$(doc))
@@ -140,7 +136,7 @@ $T/%-c.db: %.xml
#############################################################
# STANDARD TARGETS || two-pass processing method
#OUTPUT/howtos.html: DEPTH = "--stringparam toc.max.depth 1"
-OUTPUT/%.html: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
+OUTPUT/%.html: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autofiles.ent
echo "C $@"
$(PSR) $(PSR_FLAGS) \
$(PROFILE) \
@@ -152,7 +148,7 @@ OUTPUT/%.html: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autoh
--stringparam current.docid $* \
--stringparam target.database.document ../docbook/olinkdb-nc.xml \
-o $@ docbook/html-nochunks.xsl $T/$*-nc.profiled
-OUTPUT/%: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
+OUTPUT/%: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autofiles.ent
echo "C $@/"
$(PSR) $(PSR_FLAGS) \
$(PROFILE) \
@@ -164,7 +160,7 @@ OUTPUT/%: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos
--stringparam current.docid $* \
--stringparam target.database.document ../docbook/olinkdb-c.xml \
-o $@/ docbook/html-chunks.xsl $T/$*-c.profiled
-OUTPUT/%.man: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent docbook/reference.xsl
+OUTPUT/%.man: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autofiles.ent docbook/reference.xsl
echo "C $@/"
mkdir -p "$@"
$(PSR) $(PSR_FLAGS) \
@@ -186,7 +182,7 @@ OUTPUT/%.man: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autoho
#############################################################
# Supporting target - LATEX output
-#tmp/%.latex: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
+#tmp/%.latex: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autofiles.ent
# $(PSR) $(PSR_FLAGS) \
# $(PROFILE) \
# --stringparam current.docid $* \
@@ -215,8 +211,8 @@ clean-refs:
-rm -f refs/*.xml
distclean: clean clean-cache
-rm -rf $T
- -rm -rf {refs,glossary,howtos}/*.xml
- -rm -rf docbook/auto{refs,glossary,howtos,files}.ent
+ -rm -rf {refs,glossary}/*.xml
+ -rm -rf docbook/auto{refs,glossary,files}.ent
look-clean:
-mv $T $T.temporary 2>/dev/null
commit:
@@ -253,7 +249,7 @@ cache/%/.cache.bin: sources/% bin/stattree
# Silly, rewrite this, I forgot about $*. Or $* wouldn't help? I'm not
# willing to think about it right now.
refxmls: BOTH = --both
-refxmls: $(REFS_AUTOGEN) $(foreach stype,$(SYMBOL_TYPES),refs/$(stype).xml) howtos/howtos.xml glossary/glossary.xml
+refxmls: $(REFS_AUTOGEN) $(foreach stype,$(SYMBOL_TYPES),refs/$(stype).xml) glossary/glossary.xml
:
$T/%.list: BNAME = $(subst $T/,,$@)
refs/%.xml: BNAME = $(subst refs/,,$@)
@@ -271,8 +267,6 @@ $T/%.list refs/%.xml: $(foreach icver,$(IC_VERSIONS),cache/$(icver)/.cache.bin)
# One-shot targets
glossary/glossary.xml docbook/autoglossary.ent: $(shell find glossary/ -regex '.+[^(\.xml)]$$') bin/generic-autogen
bin/generic-autogen glossary
-howtos/howtos.xml docbook/autohowtos.ent: $(shell find howtos/ -regex '.+[^(\.xml)]$$') bin/generic-autogen
- bin/generic-autogen howtos
docbook/autorefs.ent: refxmls
docbook/autofiles.ent: refxmls
View
@@ -7,6 +7,8 @@
- with tags from Interpolate.pm, context for systemtag is not always 'whole file', but can be x-y as well
- dal autogen preskoci kontekst koji je prazan? i zasto uopce unkondicionalno
ekspandira @$ctx ako moze da nema konteksta?
+- make howtos chunk
+- fix link to howtos after changing format
- order counter, Session->{mv_order_number}, cronjob -0001, or file da-te.counter, or session_id.time
- in iccattut, s/item-field/item-param/ at least on some places.
View
@@ -38,6 +38,7 @@
reference toc,title,example
book nop
glossary toc,title
+ qandaset toc
</xsl:param>
<xsl:template match="mv"><xsl:call-template name="inline.monoseq"/></xsl:template>
View
@@ -1,30 +1,26 @@
-&IC; allows you to create "virtual catalog pages" by associating
+&IC; allows you to create "virtual pages" by associating
code (such as &PERL; subroutines or &glos-ITL; tags) with parts of an URL.
This can be used for anything from implementing one-click searches and orders
to displaying on-the-fly data.
</para><para>
-On every &glos-catalog; access, the leading part of a requested page path
-(URL) is taken and checked if it represents
+On every &glos-catalog; access, the leading part of a requested
+URL is taken and checked if it represents
a valid <emphasis>action</emphasis>.
-If it does, the action name itself is removed from the
-path and invoked with the rest of the arguments provided in the URL.
+If it does, the action is
+invoked with the rest of the arguments provided in the URL.
</para><para>
Some of the predefined actions (which you might recognize from special
page names that you access in your catalog) are:
<itemizedlist>
<listitem><para>
-<literal>process</literal> - Generic form processing function.
-
-</para></listitem>
-<listitem><para>
-<literal>process</literal> - Generic &glos-HTML; form processor for user data
+<literal>process</literal> - Generic form processing function
</para></listitem>
<listitem><para>
<literal>order</literal> - Order items
</para></listitem>
<listitem><para>
-<literal>scan</literal> - Search based on path info
+<literal>scan</literal> - Search based on submitted URL
</para></listitem>
<listitem><para>
<literal>search</literal> - Search based on submitted form variables
View
@@ -2,15 +2,11 @@ A rectangular graphic image which is included on a content page for
advertising and promotional purposes.
</para><para>
In &IC;, when "banner" or "ad" is used to describe the functionality of
-the &tag-banner; tag, it does not necessarily mean an image, since you can
+the &tag-banner; tag and it does not necessarily mean an image, as you can
put anything in the content placeholder. In fact, banner examples from
<olink targetdoc='howtos' targetptr='implementbanners'/> HOW-TO use plain
text.
</para><para>
-Along with animation, contemporary banners are introducing an interactive
-dimension taking advantage of plug-ins such as SVG, Flash or Shockwave to
-liven them up or create banner-based games.
-</para><para>
Voluntary ad unit guidelines as suggested by the
<ulink url="http://www.iab.net/standards/adunits.asp">Interactive
Advertising Bureau</ulink> (specified in pixels, in ascending order):
Oops, something went wrong.

0 comments on commit a3d0455

Please sign in to comment.