Several moves have been made to promote Roboconf’s DSL and provide syntax highlighting.
This page gives some tips to update them if necessary.
On the web site
Efforts were pushed to contribute to Pygments, with few success unfortunately. In fact, it seems hardly possible to push a custom lexer on Github Pages (the solution that hosts Roboconf’s web site). This is mainly due to Github’s security policies.
The script that highlights code on the web site is available at the web site’s root.
To use it, just wrap your Roboconf code snippet with HTML mark-ups.
<pre><code class="language-roboconf"> Your Roboconf snippet </code></pre>
If for some reason, the Roboconf DSL is upgraded, or if there is an enhancement to bring to Roboconf’s support in highlight.js, here are some tips to update it.
- Fork the highlight.js git repository.
- Check src/languages/roboconf.js. It contains the parsing rules for Roboconf.
- If necessary, update the test/detect/roboconf/default.txt file.
Propagate these modifications in the src/test.html file.
- To preview your changes, run the following commands.
# Get JS dependencies (to perform only once) npm install # Build support for all the languages, Roboconf included nodejs tools/build.js -t node # Prepare an overview for your web browser nodejs tools/build.js -t browser # Open the src/test.html file in your web browser. # Find the Roboconf snippet and make sure the rendering is correct. # Run the test to make sure Roboconf DSL is recognized correctly. nodejs tools/build.js -t node npm test
Once you have performed your modifications, create a pull request on the project.
- Make the required changes and upgrades.
- Update and run the tests (coffee scripts).
- Commit and push the version.
- Run apm publish minor and follow the instructions in the console to publish a new version of the package.