Website Jekyll / AsciiDoctor prototype
Created by: iainbryson
The goal of this issue is a functioning prototype of using a static site generator (Jekyll) with AsciiDoc file types to replace the pages system in the current enote website.
This will include both a prototype of the static site generator (+ asciidoc extensions for our extensions) and a prototype of the code required to translate from "MD + enote extensions" to "ADoc + enote extensions"
The stack will be something like:
- Jekyll + https://github.com/asciidoctor/jekyll-asciidoc + (math rendering tool) + (enote custom extensions)
- pandoc + enote extensions translator
The extensions we need for the course are the following:
-
include directive (inspiration: https://github.com/asciidoctor/asciidoctor-latex#macros ) -
page reference/link directive (inspiration: https://github.com/jirutka/asciidoctor-interdoc-reftext) -
question/hint/answer (inspiration: https://github.com/hobbypunk90/asciidoctor-question) -
embedded quiz -
MathJax (inspiration https://rubygems.org/gems/asciidoctor-latex or asciidoctor-mathematical)
Edited by iaibrys