dpkq: data picker
dpkq is a tool from the Epeios project which picks a random record stored in a XML file and put it in another XML file with an XSL file association so it can be displayed in a Web Browser in a HTML layout.
dpkq works with GNU/Linux (and probably other POSIX compliant operating systems), macOS and Windows, on IA-32, AMD64 and ARM (AArch32 and AArch64, like those on Raspberry Pi, Banana Pi, ODROID… devices) architectures.
See the compilation dedicated page to see how to obtain the binaries.
Two files called
dpkq.xlcl have to be in the same directory as the one containing the binary.
The data file
See the dedicated page.
Take also a look to the examples page.
The output file
See the dedicated page.
See the configuration dedicated page.
Other configurations parameters are generally put in a project file, which filename is given as a command-line argument (see
dpkq --help), like following:
<?xml version="1.0" encoding="utf-8"?> <Projects> <Project target="dpkq"> <Parameters> <Output>OutputFilename</Output> <Data>DataFilename</Data> <XSL>XSLFilename</XSL> <Context>ContextFilename</Context> <SessionMaxDuration>SessionDuration</SessionMaxDuration> <Viewer>ViewerCommand</Viewer> </Parameters> </Project> </Projects>
OutputFilenameis the name of the generated XML file (hence generally suffixed with
.xml) which contains the picked record,
DataFilenameis the name of the XML file (hence also generally suffixed with
.xml) from where the record is picked,
XSLFilenameis the name of the file containing the XSL stylesheet (hence generally suffixed with
.xsl) which should be applied on the file referenced by
XSLFilenameis added in a
<?xml-stylesheet …?>processing instruction into the
OutputFilenamefile, so that the XSLT processing is performed automatically when the output file is opened in a Web browser,
- if the delay between two successive calls of
dpkqon project files using same
ContextFilename(which is generated by
SessionDurationminutes, the session related data are reseted.
ViewerCommandusually contains the command to launch to open the output file name in a Web Browser ; it can contain following markers:
$RI$: the record index,
$RL$: the record label,
$TI$: the table index,
$TL$: the table label,
$LB$: the last box for the current session,
$CB$: the box containing the record,
$Data$: the data filename,
$Output$: the output filename,
$XSL$: the XSL filename,
dpkq is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Other rights can be granted, but only by an explicitly written permission from the author of dpkq.
- Last stable release: 20150630
dpkq is developed by Claude SIMON (http://q37.info/contact/).
- dpkq is hosted1) on GNU Savannah2) ; you will find there some other resources for this tool (bug tracking service, tech support manager…),
- dpkq is also on Freshcode, with its own RSS/Atom feed to which you can subscribe to be informed when there are new releases.