Building static websites in Julia
Franklin is a simple, customisable static site generator oriented towards technical blogging and light, fast-loading pages.Key features
click on the '✓' sign to know more
✓→Augmented markdown allowing definition of LaTeX-like commands,
✓→ Easy inclusion of user-defined div-blocks,
✓→ Maths rendered viaKaTeX, code viahighlight.js both can be pre-rendered,
✓→ Can live-evaluate Julia code blocks,
✓→ Live preview of modifications,
✓→ Simple optimisation step to compress and pre-render the website,
✓→ Simple publication step to deploy the website,
✓→ Straightforward integration withLiterate.jl.
Quick start
To install Franklin with Julia≥ 1.3,
(v1.6) pkg> add FranklinYou can then just try it out:
julia> using Franklinjulia> newsite("mySite", template="pure-sm")✓ Website folder generated at "mySite" (now the current directory).→ Use serve() from Franklin to see the website in your browser.julia> serve()→ Initial full pass...→ Starting the server...✓ LiveServer listening on http://localhost:8000/ ... (use CTRL+C to shut down)If you navigate to that URL in your browser, you will see the website. If you then openindex.md in an editor and modify it at will, the changes will be live rendered in your browser. You can also inspect the filemenu1.md which offers more examples of what Franklin can do.
Installing optional extras
Franklin allows a post-processing step to compress HTML and CSS and pre-render code blocks and math environments. This requires a couple of dependencies:
You will then need to installhighlight.js, which you should do from Julia using theNodeJS.jl package:
julia> using NodeJSjulia> run(`sudo $(npm_cmd()) install highlight.js`)Note: a key advantage of usingNodeJS for this instead of usingnpm yourself is that it puts the libraries in the "right place" for Julia to find them.
Assuming you havepython3, Franklin will try to install the python packagecss_html_js_minify if viapip3.
node weirdness or related, things will likely still work if you use GitHub to deploy.