Menu
▾
▴
axkit-docs-commits — The list for CVS commits
You can subscribe to this list here.
| 2001 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
(1) |
Dec
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2002 |
Jan
|
Feb
(3) |
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
|
From: Matt S. <mat...@us...> - 2002-02-06 17:36:33
|
Update of /cvsroot/axkit-docs/axkit-docs/stylesheets
In directory usw-pr-cvs1:/tmp/cvs-serv20693/stylesheets
Modified Files:
axon_sdocbook_html.xsl
Log Message:
Added image support
Index: axon_sdocbook_html.xsl
===================================================================
RCS file: /cvsroot/axkit-docs/axkit-docs/stylesheets/axon_sdocbook_html.xsl,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -u -d -r1.1.1.1 -r1.2
--- axon_sdocbook_html.xsl 2001/10/06 18:28:37 1.1.1.1
+++ axon_sdocbook_html.xsl 2002/02/06 17:36:29 1.2
@@ -427,7 +427,23 @@
</blockquote>
</xsl:template>
+<xsl:template match="inlinemediaobject">
+ <span class="mediaobject">
+ <xsl:apply-templates/>
+ </span>
+</xsl:template>
+
+<xsl:template match="mediaobject">
+ <div class="mediaobject">
+ <xsl:apply-templates/>
+ </div>
+</xsl:template>
+<xsl:template match="imageobject">
+ <img src="{imagedata/@fileref}"/>
+</xsl:template>
+
+
<!--the "css forwarder" template
These are the sdocbook elements
for which there is no reasonable
@@ -454,4 +470,4 @@
<xsl:template match="title|/article/articleinfo/*"></xsl:template>
<!-- end core sdocbook elements -->
-</xsl:stylesheet>
\ No newline at end of file
+</xsl:stylesheet>
|
|
From: Robin B. <da...@us...> - 2002-02-05 19:25:31
|
Update of /cvsroot/axkit-docs/axkit-docs
In directory usw-pr-cvs1:/tmp/cvs-serv13038
Modified Files:
config-quickref.dkb
Log Message:
filled in most of the holes. There are prolly mistakes and there are still a few omissions though
Index: config-quickref.dkb
===================================================================
RCS file: /cvsroot/axkit-docs/axkit-docs/config-quickref.dkb,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- config-quickref.dkb 2002/02/05 17:48:16 1.2
+++ config-quickref.dkb 2002/02/05 19:25:04 1.3
@@ -153,81 +153,191 @@
<section label='AxAddRootProcessor'>
<title>AxAddRootProcessor</title>
- <para>TAKE3</para>
<para>
- a mime type, a stylesheet, and a root element
+ <emphasis>Syntax:</emphasis>
+ AxAddRootProcessor
+ <literal>mime/type</literal>
+ <filename>processor-stylesheet</filename>
+ <literal>root-element</literal>
</para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
+ </para>
+
+ <para>
+ Adds a step to the processing pipeline which will feed the
+ <filename>processor-stylesheet</filename> file to the processor
+ mapped to handle that <literal>mime/type</literal> by an
+ <xref linkend='AxAddStyleMap'>AddStyleMap</xref> directive and use
+ that to process the requested file if it happens to have a root element
+ that matches the given <literal>root-element</literal>.
+ </para>
+
+ <para>
+ Note that <literal>root-element</literal> is expressed in JClark notation,
+ that is if your element has a namespace it is written {ns}lname.
+ </para>
</section>
<section label='AxAddURIProcessor'>
<title>AxAddURIProcessor</title>
- <para>TAKE3</para>
<para>
- a mime type, a stylesheet, and a Perl regexp to match the URI
+ <emphasis>Syntax:</emphasis>
+ AxAddURIProcessor
+ <literal>mime/type</literal>
+ <filename>processor-stylesheet</filename>
+ <literal>regexp</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
+ </para>
+
+ <para>
+ Adds a step to the processing pipeline which will feed the
+ <filename>processor-stylesheet</filename> file to the processor
+ mapped to handle that <literal>mime/type</literal> by an
+ <xref linkend='AxAddStyleMap'>AddStyleMap</xref> directive and use
+ that to process the requested file if it happens to have a URI
+ that matches the given <literal>regexp</literal>.
</para>
</section>
<section label='AxResetProcessors'>
<title>AxResetProcessors</title>
- <para>NO_ARGS</para>
<para>
- reset the list of processors
+ <emphasis>Syntax:</emphasis>
+ AxResetProcessors
</para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
+ </para>
+
+ <para>
+ Removes all previously configured processors in the pipeline.
+ </para>
</section>
</section>
+
+
+
+
+
+
+
<section label='plugins'>
<title>Plugin Directives</title>
<section label='AxAddPlugin'>
<title>AxAddPlugin</title>
- <para>TAKE_ONE</para>
<para>
- Add a plugin
+ <emphasis>Syntax:</emphasis>
+ AxAddPlugin <literal>Perl::Package</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> 1.5
+ </para>
+
+ <para>
+ Will add a Plugin to the list of plugins that will be run before the
+ processing beings. A plugin may modify all sorts of request parametres and
+ notes in order to influence the behaviour of the processor.
+ </para>
+
+ <para>
+ The <literal>handler()</literal> in the given <literal>Perl::Package</literal>
+ will be called with $r, as if it were a normal modperl handler (except that it
+ is not expected to do anything fancy there, or to return something).
</para>
</section>
<section label='AxResetPlugins'>
<title>AxResetPlugins</title>
- <para>TAKE1</para>
<para>
- remove all plugins
+ <emphasis>Syntax:</emphasis>
+ AxResetPlugins
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> 1.5
+ </para>
+
+ <para>
+ Removes all previously configured plugins.
</para>
</section>
</section>
+
+
+
+
+
+
+
<section label='media'>
<title>Media Directives</title>
<section label='AxMediaType'>
<title><AxMediaType></title>
- <para>RAW_ARGS</para>
<para>
- Media type block
+ <emphasis>Syntax:</emphasis>
+ ???
</para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
+ </para>
+
+ <para>
+ ???
+ </para>
</section>
<section label='AxMedia'>
<title>AxMedia</title>
- <para>TAKE1</para>
<para>
- a default media to use other than screen
+ <emphasis>Syntax:</emphasis>
+ ???
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
</para>
+
+ <para>
+ ???
+ </para>
</section>
</section>
+
+
+
+
+
+
<section label='style'>
<title>Style Directives</title>
@@ -235,87 +345,183 @@
<section label='AxStyleName'>
<title><AxStyleName></title>
- <para>RAW_ARGS</para>
<para>
- Style name block
+ <emphasis>Syntax:</emphasis>
+ ???
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
+ </para>
+
+ <para>
+ ???
</para>
</section>
<section label='AxAddStyleMap'>
<title>AxAddStyleMap</title>
- <para>TAKE2</para>
<para>
- a mime type and a module name to use
+ <emphasis>Syntax:</emphasis>
+ AxAddStyleMap <literal>mime/type</literal> <literal>Perl::Module</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
+ </para>
+
+ <para>
+ Adds a type to the StyleMap, to be used by Processors so that they
+ know which module you use. The benefit of this is that you only define
+ that mapping once. For instance, if you were processing XSLT with
+ Apache::AxKit::Language::FooXSLT and you suddenly want to change to using
+ Apache::AxKit::Language::BarXSLT, all you'll have to do to switch is to
+ change the AxAddStyleMap mapping for text/xsl from the former to the
+ latter, and all Processors using text/xsl will switch automatically.
</para>
</section>
<section label='AxResetStyleMap'>
<title>AxResetStyleMap</title>
- <para>NO_ARGS</para>
<para>
- reset the styles
+ <emphasis>Syntax:</emphasis>
+ AxResetStyleMap
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
</para>
+
+ <para>
+ Removes all previously configured StyleMaps.
+ </para>
</section>
<section label='AxStyleProvider'>
<title>AxStyleProvider</title>
- <para>TAKE1</para>
<para>
- alternative module to use for reading the stylesheet
+ <emphasis>Syntax:</emphasis>
+ AxStyleProvider <literal>Perl::Module</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
</para>
+
+ <para>
+ ??? (alternative module to use for reading the stylesheet)
+ [I thought Matt said this was given up on]
+ </para>
</section>
<section label='AxStyle'>
<title>AxStyle</title>
- <para>TAKE1</para>
<para>
- a default stylesheet (title) to use
+ <emphasis>Syntax:</emphasis>
+ ???
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
</para>
+
+ <para>
+ ???
+ </para>
</section>
</section>
+
+
+
+
+
+
+
<section label='cache'>
<title>Cache Directives</title>
<section label='AxCacheDir'>
<title>AxCacheDir</title>
- <para>TAKE1</para>
<para>
- directory to store cache files
+ <emphasis>Syntax:</emphasis>
+ AxCacheDir <filename>cache-dir</filename>
</para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Specifies the directory in which the cache is maintained, as
+ opposed to using .axcache in the current directory. It is recommended
+ that this be set to a non web-accessible directory.
+ </para>
</section>
<section label='AxCacheModule'>
<title>AxCacheModule</title>
- <para>TAKE1</para>
<para>
- alternative cache module
+ <emphasis>Syntax:</emphasis>
+ AxCacheModule <literal>Perl::Module</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Specifies an alternative module to use in order to implement caching.
+ That module must implement the same API as is found in
+ <literal>Apache::AxKit::Cache</literal>, and probably ought to subclass
+ it to avoid future breakage should that API evolve.
</para>
</section>
<section label='AxNoCache'>
<title>AxNoCache</title>
- <para>FLAG</para>
<para>
- On or Off [default] to not cache results
+ <emphasis>Syntax:</emphasis>
+ AxNoCache <literal>On | Off</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Whether results should be cached (default) or not.
</para>
</section>
<section label='AxDependencyChecks'>
<title>AxDependencyChecks</title>
- <para>FLAG</para>
<para>
- On [default] or Off to disable dependency checking
+ <emphasis>Syntax:</emphasis>
+ AxDependencyChecks <literal>On | Off</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> 1.5
+ </para>
+
+ <para>
+ Whether dependencies (eg external entities) should be
+ checked (default) or not. Turning this off can be a major
+ performance boost if you know what you're doing.
</para>
</section>
</section>
@@ -329,120 +535,251 @@
<section label='AxAddOutputTransformer'>
<title>AxAddOutputTransformer</title>
- <para>TAKE1</para>
<para>
- An output transformer function, qualified with package name.
+ <emphasis>Syntax:</emphasis>
+ AxAddOutputTransformer <literal>Perl::sub</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Adds an OutputTransformer subroutine. That subroutine will receive
+ the content to modify in @_ and must modify it in place. It is run
+ right after cache which makes it the ideal place to perform small
+ per request modifications while still benefitting from the caching
+ of the other operations.
</para>
</section>
<section label='AxResetOutputTransformers'>
<title>AxResetOutputTransformers</title>
- <para>NO_ARGS</para>
<para>
- Reset list of output transformers.
+ <emphasis>Syntax:</emphasis>
+ AxResetOutputTransformers
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Removes all previously configured OutputTransformers.
</para>
</section>
<section label='AxOutputCharset'>
<title>AxOutputCharset</title>
- <para>TAKE1</para>
<para>
- character set used by iconv
+ <emphasis>Syntax:</emphasis>
+ AxOutputCharset <literal>charset</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Requests that the output be translated to the given
+ <literal>charset</literal> before it is sent.
</para>
</section>
<section label='AxGzipOutput'>
<title>AxGzipOutput</title>
- <para>FLAG</para>
<para>
- On or Off [default] to gzip the output
+ <emphasis>Syntax:</emphasis>
+ AxGzipOutput <literal>On | Off</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Whether the output should be gzipped or not (default).
</para>
</section>
<section label='AxTranslateOutput'>
<title>AxTranslateOutput</title>
- <para>FLAG</para>
<para>
- On or Off [default] to automatically change character set on output
+ <emphasis>Syntax:</emphasis>
+ AxTranslateOutput <literal>On | Off</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
</para>
+
+ <para>
+ Whether the output should have automatic charset conversion on
+ or not (default). [and that kicks in when???]
+ </para>
</section>
</section>
+
+
+
+
+
+
+
+
<section label='logging'>
<title>Logging Directives</title>
<section label='AxDebugLevel'>
<title>AxDebugLevel</title>
- <para>TAKE1</para>
<para>
- debug level (0 == none, higher numbers == more debugging)
+ <emphasis>Syntax:</emphasis>
+ AxDebugLevel <literal>level</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
</para>
+
+ <para>
+ Sets the debugging level. 0 is no debugging and higher numbers mean
+ more of it. The max should normally be 10.
+ </para>
</section>
<section label='AxLogDeclines'>
<title>AxLogDeclines</title>
- <para>FLAG</para>
<para>
- On or Off [default] to log why AxKit declined to process the resource
+ <emphasis>Syntax:</emphasis>
+ AxLogDeclines <literal>On | Off</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
</para>
+
+ <para>
+ Whether the requests that AxKit declines to handle should be
+ logged or not or not (default).
+ </para>
</section>
<section label='AxStackTrace'>
<title>AxStackTrace</title>
- <para>FLAG</para>
<para>
- On or Off [default] to maintain a stack trace with exceptions
+ <emphasis>Syntax:</emphasis>
+ AxStackTrace <literal>On | Off</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Whether the a stack trace of AxKit exceptions should be maintained
+ or not (default).
</para>
</section>
</section>
+
+
+
+
+
+
+
<section label='misc'>
<title>Miscellaneous Directives</title>
<section label='AxConfigReader'>
<title>AxConfigReader</title>
- <para>TAKE1</para>
<para>
- alternative module to use for reading configuration
+ <emphasis>Syntax:</emphasis>
+ AxConfigReader <literal>Perl::Module</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Specifies an alternative module to use in order to implement configuration.
+ That module must implement the same API as is found in
+ <literal>Apache::AxKit::ConfigReader</literal>, and probably ought to subclass
+ it to avoid future breakage should that API evolve.
</para>
</section>
<section label='AxProvider'>
<title>AxProvider</title>
- <para>TAKE1</para>
<para>
- alternative module to use for reading the xml
+ <emphasis>Syntax:</emphasis>
+ AxProvider <literal>Perl::Module</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Specifies an alternative module to use in order to implement providing of
+ files to AxKit.
+ That module must implement the same API as is found in
+ <literal>Apache::AxKit::Provider</literal>, and probably ought to subclass
+ it to avoid future breakage should that API evolve.
</para>
</section>
<section label='AxErrorStylesheet'>
<title>AxErrorStylesheet</title>
- <para>TAKE2</para>
<para>
- mime type and Error Stylesheet to use for displaying errors
+ <emphasis>Syntax:</emphasis>
+ AxErrorStylesheet <literal>mime/type</literal> <filename>stylesheet</filename>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Defines the stylesheet to use for error documents when errors occur. It's
+ syntax is comparable to that of <xref linkend='AxAddProcessor'>AxAddProcessor</xref>.
+ [and supposedly the document it gets to transform is described somewhere???]
</para>
</section>
<section label='AxAddXSPTaglib'>
<title>AxAddXSPTaglib</title>
- <para>TAKE1</para>
<para>
- module that provides a taglib functionality
+ <emphasis>Syntax:</emphasis>
+ AxAddXSPTaglib <literal>Perl::Module</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> ???
+ </para>
+
+ <para>
+ Adds an XSP handling module. This is required in order to use taglibs as
+ it gives them a chance to register their namespaces with the XSP dispatcher.
+ Without this, taglib code in XSP will not function properly.
</para>
</section>
</section>
|
|
From: Robin B. <da...@us...> - 2002-02-05 17:48:20
|
Update of /cvsroot/axkit-docs/axkit-docs
In directory usw-pr-cvs1:/tmp/cvs-serv18542
Modified Files:
config-quickref.dkb
Log Message:
in the process of filling it out
Index: config-quickref.dkb
===================================================================
RCS file: /cvsroot/axkit-docs/axkit-docs/config-quickref.dkb,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- config-quickref.dkb 2001/11/09 20:41:37 1.1
+++ config-quickref.dkb 2002/02/05 17:48:16 1.2
@@ -48,42 +48,105 @@
</abstract>
</articleinfo>
+
<section label='processor'>
<title>Processor Directives</title>
<section label='AxAddProcessor'>
<title>AxAddProcessor</title>
- <para>TAKE2</para>
<para>
- a mime type and a stylesheet to use
+ <emphasis>Syntax:</emphasis>
+ AxAddProcessor <literal>mime/type</literal> <filename>processor-stylesheet</filename>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
+ </para>
+
+ <para>
+ Adds a step to the processing pipeline which will feed the
+ <filename>processor-stylesheet</filename> file to the processor
+ mapped to handle that <literal>mime/type</literal> by an
+ <xref linkend='AxAddStyleMap'>AddStyleMap</xref> directive and use
+ that to process the requested file.
</para>
</section>
+
<section label='AxAddDocTypeProcessor'>
<title>AxAddDocTypeProcessor</title>
- <para>TAKE3</para>
<para>
- a mime type, a stylesheet, and an XML public identifier
+ <emphasis>Syntax:</emphasis>
+ AxAddDocTypeProcessor
+ <literal>mime/type</literal>
+ <filename>processor-stylesheet</filename>
+ <literal>PUBLIC_ID</literal>
</para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
+ </para>
+
+ <para>
+ Adds a step to the processing pipeline which will feed the
+ <filename>processor-stylesheet</filename> file to the processor
+ mapped to handle that <literal>mime/type</literal> by an
+ <xref linkend='AxAddStyleMap'>AddStyleMap</xref> directive and use
+ that to process the requested file if it happens to have a DOCTYPE
+ pointing to the specified <literal>PUBLIC_ID</literal>.
+ </para>
</section>
<section label='AxAddDTDProcessor'>
<title>AxAddDTDProcessor</title>
- <para>TAKE3</para>
<para>
- a mime type, a stylesheet, and a dtd filename
+ <emphasis>Syntax:</emphasis>
+ AxAddDTDProcessor
+ <literal>mime/type</literal>
+ <filename>processor-stylesheet</filename>
+ <literal>SYSTEM_ID</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis>
+ ???
</para>
+
+ <para>
+ Adds a step to the processing pipeline which will feed the
+ <filename>processor-stylesheet</filename> file to the processor
+ mapped to handle that <literal>mime/type</literal> by an
+ <xref linkend='AxAddStyleMap'>AddStyleMap</xref> directive and use
+ that to process the requested file if it happens to have a DOCTYPE
+ pointing to the specified <literal>SYSTEM_ID</literal>.
+ </para>
</section>
<section label='AxAddDynamicProcessor'>
<title>AxAddDynamicProcessor</title>
- <para>TAKE1</para>
<para>
- a package name
+ <emphasis>Syntax:</emphasis>
+ AxAddDynamicProcessor <literal>Perl::Package</literal>
+ </para>
+
+ <para>
+ <emphasis>Version:</emphasis> 1.5
+ </para>
+
+ <para>
+ Will call the <literal>handler()</literal> in the given <literal>Perl::Package</literal>
+ before processing takes place. The <literal>handler()</literal> must set up the list of
+ processors to be used, manipulating them with the <literal>AxKit::reset_stylesheets()</literal>
+ (which empties the processor list), <literal>AxKit::insert_next_stylesheet($type,$path)</literal>
+ which adds a stylesheet to the front of the list, and
+ <literal>AxKit::insert_next_stylesheet($type,$path)</literal> which adds a stylesheet to
+ the end of the list.
</para>
</section>
@@ -106,7 +169,7 @@
</section>
<section label='AxResetProcessors'>
- <title>AxAddProcessor</title>
+ <title>AxResetProcessors</title>
<para>NO_ARGS</para>
<para>
@@ -114,6 +177,29 @@
</para>
</section>
+ </section>
+
+
+ <section label='plugins'>
+ <title>Plugin Directives</title>
+
+ <section label='AxAddPlugin'>
+ <title>AxAddPlugin</title>
+
+ <para>TAKE_ONE</para>
+ <para>
+ Add a plugin
+ </para>
+ </section>
+
+ <section label='AxResetPlugins'>
+ <title>AxResetPlugins</title>
+
+ <para>TAKE1</para>
+ <para>
+ remove all plugins
+ </para>
+ </section>
</section>
|
|
From: Robin B. <da...@us...> - 2001-11-09 21:44:43
|
Update of /cvsroot/axkit-docs/axkit-docs
In directory usw-pr-cvs1:/tmp/cvs-serv5526
Modified Files:
index.dkb
Log Message:
small change to index
Index: index.dkb
===================================================================
RCS file: /cvsroot/axkit-docs/axkit-docs/index.dkb,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- index.dkb 2001/11/09 20:55:26 1.3
+++ index.dkb 2001/11/09 21:44:40 1.4
@@ -39,7 +39,9 @@
Welcome to the AxKit Documentation ! Presently, the documentation
is being entirely overhauled. As a result, some of the links below
are considered to be potentially outdated, that is they may be good
- but haven't been looked into for updates yet.
+ but haven't been looked into for updates yet. Contribution to the
+ docs project is very welcome, subscribe to axk...@ax... to
+ get in the loop.
</para>
</abstract>
</articleinfo>
|
