Purpose/use of loadsetup interface *.xml files
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 -->
participants (1)
-
Stephen Gaito