基于Julia的静态网站生成器Franklin.jl

 

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 via KaTeX, code via highlight.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 with Literate.jl.

⚠ Note

If you already have experience with Franklin and just want to keep an eye on (new) tips and tricks, have a look at the short demos

Quick start

To install Franklin with Julia ≥ 1.3,

(v1.6) pkg> add Franklin

You can then just try it out:

julia> using Franklin
julia> 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 open index.md in an editor and modify it at will, the changes will be live rendered in your browser. You can also inspect the file menu1.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:

• python3 for the minification of the site,

• node.js for the pre-rendering of KaTeX and code highlighting.

You will then need to install highlight.js, which you should do from Julia using the NodeJS.jl package:

julia> using NodeJS
julia> run(`sudo $(npm_cmd()) install highlight.js`)

Note: a key advantage of using NodeJS for this instead of using npm yourself is that it puts the libraries in the "right place" for Julia to find them.

Assuming you have python3, Franklin will try to install the python package css_html_js_minify if via pip3.

⚠ Note

You don't have to install these libraries and you can safely ignore any message suggesting you install those. Also note that if you do want this but it doesn't work locally due to some node weirdness or related, things will likely still work if you use GitHub to deploy.

© Thibaut Lienart. Last modified: April 06, 2026. Website built with Franklin.jl and the Julia programming language. 

 

from  https://franklinjl.org/

（项目地址： https://github.com/tlienart/Franklin.jl 

 https://github.com/JuliaDocs/Franklin.jl）

示范网站： https://abhishalya.github.io/blog/

---------------------------------------------------------------

 

Build site with Franklin.jl

 

Forward#

Franklin.jl is a simple, customisable static site generator oriented towards technical blogging and light, fast-loading pages.

At first, I want to learning Julia with a small open source project, smaller and better. Then I search on github with topic#julia, and I find this tool. As I learned about it on its site, I think I can use this for my massively personal site(maybe it is beautiful, but too complex), and learning Julia when rebuilding my site.

Therefore, I write this tutorial as my beginning.

Last but not least, Franklin.jl has many features:

• Augmented markdown allowing definition of LaTeX-like commands,

• Easy inclusion of user-defined div-blocks,

• Maths rendered via KaTeX, code via highlight.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 with Literate.jl.

Setup Environment#

1. Download Julia from official site for your OS.
2. Install it.
3. Open julia REPL.
4. Then excute using Pkg; Pkg.add(Franklin)

Start building#

1. New a site with the following scripts:

julia> using Franklin
julia> 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.

Once you excuted the command above, this Julia REPL workspace will be in your site folder.

2. Start local server for debug:

julia> serve()
→ Initial full pass...
→ Starting the server...
✓ LiveServer listening on http://localhost:8000/ ...
  (use CTRL+C to shut down)

you can get this page in your browser: note: this mySite folder will be created in your current directory. You can check your current directory withpwd().

Site Structure#

Page structure#

your mySite folder structure like this:

├─.github
│  └─workflows
├─_assets
│  └─scripts
│      └─output
├─_css
├─_layout
├─_libs
│  ├─highlight
│  ├─katex
│  │  └─fonts
│  └─pure
└─__site
├─assets
│  ├─menu1
│  │  ├─code
│  │  │  └─output
│  │  └─output
│  └─scripts
│      └─output
├─css
├─layout
├─libs
│  ├─highlight
│  ├─katex
│  │  └─fonts
│  └─pure
├─menu1
├─menu2
├─menu3
└─tag
    ├─code
    ├─image
    └─syntax

The .github folder is generated for Github Actions, you can config some fields for your customization.Fox example, you can change trigger branch from dev to your workspace branch like master.

name: Build and Deploy
on:
  push:
branches:
      - dev
      - master

Then you should change another BRANCH(I named it as site branch) field here:

name: Build and Deploy
uses: JamesIves/github-pages-deploy-action@releases/v3
with:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      BRANCH: master
      BRANCH: dev
  FOLDER: __site

NOTE: you must keep the site branch different from the workspace branch(in the case it’s master), because you site files will be generated on dev branch

If you use config above, your master branch is your workspace branch and your dev branch is your Github Pages site branch.

Deploying on GitHub#

local config#

1. Create a personal repo on github, named username.github.io, or you can name it whatever you want to if you have a domain.

2. Open local folder you created with Franklin before with bash or any other shell.

3. Follow these steps below to config your repo:
   i)git remote add origin URL_TO_YOUR_REPO
   ii)git add . && git commit -m "initial files"
   iii)git push -u origin master

github config#

1. Open Settings on your repo page, and scrolling down until you find GitHub Pages option.

2. Config it as below:

   note: you must make the branch same as the site branch in the deploy.yml

DONE!

You can find some examples of websites using Franklin.jl from Franklin.jl.

By the way, I following this blog site as templates and customizing it. It is a very simple and wonderful site.

Please email me if there are any errors.

REFERENCE#

https://franklinjl.org/

https://github.com/abhishalya/abhishalya.github.io

https://docs.github.com/

from https://web.archive.org/web/20260918022100/https://smj.im/blog/build-site-with-franklin/