Skip to content

sosiristseng/template-juliabook-matrix

Repository files navigation

Template for publishing Julia Jupyter notebooks with dynamic matrix

Click Use this template button to copy this repository.

See also:

Notebook execution and publish

In ci.yml, Jupyter (*.ipynb) and Literate (*.jl) notebooks under the docs folder are executed by GitHub actions; then Jupyter book creates a beautiful website.

Parallel execution

The notebooks are executed in parallel by dynamic matrix. Every notebook runs on an individual runner.

Enable GitHub pages

Open your repository settings => Pages => GitHub Pages => Build and deployment => Source, select GitHub actions.

Automatic dependency updates

Dependabot and Kodiak Bot

See dependabot.yml configuration.

This repository also uses Kodiak Bot to automatically merge updates. You might need to enable the Kodiak Bot APP.

Julia dependencies

update-manifest.yml regularly updates Julia dependencies, make a PR with the updated dependencies, and automatically merge the updates if the notebooks are executed smoothly.

See the instructions for how to trigger CI workflows in a PR. This repo uses a custom GitHub APP to generate a token on the fly.

Checking HTTP links

linkcheck.yml uses GitHub actions to regularly check if the web links in the notebooks are valid.