sparql & turtle highlight.js in reveal.js

Intro

This project adds highlighters for the semantic languages Turtle and SPARQL to highlight.js, and then reveal.js. It assumes the three projects are cloned next to each other.

Links

• https://github.com/hakimel/reveal.js/blob/master/plugin/highlight/highlight.js embeds v9.11.0 (13 months old)
• highlightjs/highlight.js#1553 adds sparql/turtle, and has been waiting for 11 months.
• can be downloaded from https://github.com/ellismarkf/highlight.js/tree/feature/language-sparql-ttl
• hakimel/reveal.js#2148 is to upgrade reveal.js (to a future 9.13)
• highlightjs/highlight.js#1736 (notified @ellismarkf) asks for fixes to ttl parser

Steps to Build

1. git clone https://github.com/ellismarkf/highlight.js/
2. switch highlight.js to branch feature/language-sparql-ttl
3. git clone https://github.com/hakimel/reveal.js
4. read https://github.com/isagalaev/highlight.js/blob/master/docs/building-testing.rst
5. install node.js from https://nodejs.org/en/download/
6. install prerequisites

   cd highlight.js 
   npm install
       

7. OPT: see options of the build tool

   node tools/build.js --help
       

8. OPT: build semantic languages (2) without compression, so they can be debugged

   node tools/build.js -n sparql ttl pie
       

9. OPT: check highlighting: open tools/developer.html and try these files:
   • test/detect/sparql/default.txt
   • test/detect/ttl/default.txt
   • test/detect/pie/default.txt
10. build all required languages (23 core + 2 semantic) with compression

    node tools/build.js :common sparql ttl pie
        

11. copy highlight.js/build/highlight.pack.js into reveal.js/plugin/highlight/highlight.js using the script ./highlight-to-reveal.sh

How to Use in Your Project

Add sub-modules to your project (.gitmodules)

[submodule "scripts/highlight.js"]
	path = scripts/highlight.js
	url = https://github.com/VladimirAlexiev/highlight.js
	branch = feature/language-sparql-ttl
[submodule "scripts/highlight-to-reveal"]
	path = scripts/highlight-to-reveal
	url = https://github.com/VladimirAlexiev/highlight-to-reveal

If you don’t need to modify reveal, also use it as a sub-module. The version below patches plugin/highlight/highlight.js to add sparql and turtle:

[submodule "scripts/reveal.js"]
	path = scripts/highlight.js
	url = https://github.com/VladimirAlexiev/reveal.js

If you need to modify reveal (eg to add an Ontotext theme), clone this repo and modify it.