Echidna is the central piece of software taking care of the new publication workflow at W3C. The plan is for Echidna and related sub-projects (see below) to automate the publication of new specs under http://www.w3.org/TR/.
Using Echidna as an editor
If you are a spec editor, you do not need to install Echidna, nor to run it locally.
Please see the wiki for how to use Echidna as a spec editor.
Hacking Echidna as a developer
Then run the following commands with your favorite terminal:
git clone https://github.com/w3c/echidna.git cd echidna cp config.js.example config.js npm install
Running it locally
Note: local setup of the full system is not supported currently due to dependency on W3C's DB and IPP system, but having mock services that emulate these pieces is our short-term goal.
In your terminal, run the following:
npm start [-- STAGING_PATH [HTTP_LOCATION [PORT [RESULT_PATH]]]]
You may use the optional defined below:
STAGING_PATH: path in the local filesystem where documents will be downloaded; staged. (Default
HTTP_LOCATION: HTTP endpoint for Specberus and the Third Party Resources Checker. (Default
PORT: where Echidna will be listening for publication requests. (Default
RESULT_PATH: local path where Echidna will dump the results of publication requests in JSON format.
Alternatively, you can use the configuration file
Once the server is started, you can throw publication requests at it through a
POST request to its enpoint, http://localhost:3000/api, or using the web-based testbed (described below).
You can also use a simple web client to send and monitor those requests, at http://localhost:3000/ui.
This section describes how to run Echidna's test suite to make sure that the project itself is working properly over time. Note that the test suite is not intended to test actual documents.
Running the unit test suite
You can run the test suite with the following command line:
Using test documents
For testing purposes, we are using a local web server. The test server simulates some of the W3C services, such as the CSS and HTML validators, or the token authorization checker. It also serves a set of sample drafts.
You can launch this test server separately by using:
npm run testserver
When the test server is running, the testbed with all drafts will be available in http://localhost:3001.
Feedback and contributions
Please refer to our contribution reference to learn how to contact us, give feedback, or actively contribute to this project.