Hello,
Problem:
--------
I am having trouble getting a simple module's documentation to
load setup information.
Question:
---------
Where can I find up-to-date documentation on the load setup
interface file use and required format?
Background:
----------
I have a current standalone ConTeXt installation with only luatex(mkiv)
and all modules (updated yesterday).
I intend to write a number of ConTeXt modules to assist in my work.
My first module is ConTests a simple wrapper around lua's lunatest
framework. ( GitHub: stephengaito/ConTests )
As I work I like to write unit-tests and documentation
concurrently with the code itself (as much as possible).
I am basing my documentation effort on t-fancybreak.mkvi. As such I
have written a setup interface file t-contests.xml.
My directory structure is:
t-contests/tex/context/interface/third/t-contests.xml
t-contests/tex/context/third/ConTests/t-contests.mkiv
t-contests/tex/context/third/ConTests/t-contests.lua
I am building my module documentation using:
mtxrun --script modules --process t-contexts.mkiv
(inside the t-contests/tex/context/third/ConTests directory).
The resluting t-contests-mkiv.pdf file has 'MISSING SETUP' where I
would expect the \showsetup{loadSuite} output to be placed.
The mtxrun log output has the line:
xml > core > load error in [id: setups:, file: .xml]: empty xml file
I interpret this to mean that my interface file was not found (or
possibly not correctly specified).
The relevant contents of t-contests.mkiv are:
------------
%M \usemodule[contests]
%M \loadsetups[t-contests.xml]
\writestatus{loading}{ConTeXt User Module / ConTests}
%D \subject{Implementation}
\unprotect
\ctxloadluafile{t-contests}
%D \macros{loadSuite}
%D
%D \showsetup{loadSuite}
\def\loadSuite#1{\directlua{thirddata.contests.lunatest.loadSuite('#1.lua')}}
\protect \endinput
-----------------
The contents of t-contests.xml is:
--------------
<?xml version="1.0" encoding="UTF-8"?>
<!-- This is the ConTeXt interface for the t-contests module -->
<!-- We have based the structure of this interface on the t-fancybreak module
-->
<cd:interface xmlns:cd="http://www.pragma-ade.com/commands"; name="context"
language="en" version="2010.06.21">
<cd:command name="loadSuite" generated="yes" file="t-contests.mkiv">
<cd:sequence>
<cd:string value="loadSuite"?>
</cd:sequence>
<cd:arguments>
<cd:content n="1" optional="no"/>
</cd:arguments>
</cd:command>
</cd:interface>
-----------------
Any and all assistance would be greatly appreciated.
Regards,
Stephen Gaito
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the
Wiki!
maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage : http://www.pragma-ade.nl / http://context.aanhet.net
archive : https://bitbucket.org/phg/context-mirror/commits/
wiki : http://contextgarden.net
___________________________________________________________________________________
