austral / austral.github.io

The website for the Austral programming language.
https://austral-lang.org/
5 stars 12 forks source link

How to build tutorial? #61

Open AlbertoGP opened 1 year ago

AlbertoGP commented 1 year ago

The Makefile builds the specification, but not the tutorial.

I’ve got it build something by duplicating SPEC_SRC to TUTORIAL_SRC, then:

TUTORIAL_HTML := tutorial/tutorial.html

$(TUTORIAL_HTML): $(TUTORIAL_SRC) _spec/template.html Makefile
    pandoc -t html5 \
           -f markdown \
           --template=_spec/template.html \
           $(PANDOC_FLAGS) --listings --highlight-style=pygments \
           --mathjax \
           $(TUTORIAL_SRC) \
           -o $(TUTORIAL_HTML)

This however does not include the example listings read using {% capture source %}{% include examples/hello-world/hello.aum %}{% endcapture %} and then {{ source }} as is done in hello-world.md for instance.

Maybe this version of pandoc does not have the necessary modules or whatever, but is there some option I’m missing?

AlbertoGP commented 1 year ago

Maybe that’s not pandoc but jekyll because the include directives look like the liquid template language they use: https://jekyllrb.com/docs/liquid/

eudoxia0 commented 1 year ago

Yes, the tutorial is "built" entirely with Jekyll. Running it locally should be enough.