GitHub Actions for mdBook
rust-lang/mdBook Setup Action.
We can run mdBook on a virtual machine of GitHub Actions by this mdBook action. Linux, macOS, and Windows are supported.
| OS (runs-on) | ubuntu-18.04 | macos-latest | windows-2019 |
|---|---|---|---|
| Support |
|
|
|
Table of Contents
Getting Started
⭐️
Create your workflow
An example workflow .github/workflows/gh-pages.yml with GitHub Actions for GitHub Pages. For the first deployment, we have to do this operation: First Deployment with GITHUB_TOKEN - peaceiris/actions-gh-pages
name: github pages
on:
push:
branches:
- main
jobs:
deploy:
runs-on: ubuntu-18.04
steps:
- uses: actions/checkout@v2
- name: Setup mdBook
uses: peaceiris/actions-mdbook@v1
with:
mdbook-version: '0.4.6'
# mdbook-version: 'latest'
- run: mdbook build
- name: Deploy
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./book
Options
⭐️
Use the latest version of mdBook
Set mdbook-version: 'latest' to use the latest version of mdBook.
- name: Setup mdBook
uses: peaceiris/actions-mdbook@v1
with:
mdbook-version: 'latest'
This action fetches the latest version of mdBook by mdbook — Homebrew Formulae
Tips
⭐️
Read mdBook version from file
How to sync a mdBook version between a Docker Compose and a GitHub Actions workflow via .env file.
Write a MDBOOK_VERSION to the .env file like the following and push it to a remote branch.
MDBOOK_VERSION=0.4.6
Next, add a step to read a mdBook version from the .env file.
- name: Read .env
id: mdbook-version
run: |
. ./.env
echo "::set-output name=MDBOOK_VERSION::${MDBOOK_VERSION}"
- name: Setup mdBook
uses: peaceiris/actions-mdbook@v1
with:
mdbook-version: '${{ steps.mdbook-version.outputs.MDBOOK_VERSION }}'
Here is a docker-compose.yml example.
version: '3'
services:
mdbook:
container_name: mdbook
image: "peaceiris/mdbook:v${MDBOOK_VERSION}"
# image: "peaceiris/mdbook:v${MDBOOK_VERSION}-rust" # Large image including Rust compiler
stdin_open: true
tty: true
ports:
- 3000:3000
- 3001:3001
volumes:
- ${PWD}:/book
command:
- serve
- --hostname
- '0.0.0.0'
The alpine base mdBook Docker image is provided on the following repository.
CHANGELOG
License
About Maintainer
Maintainer Notes
Run npm and git commit commands on a container.
On Host
# Docker
make build
make run
make run cmd="env"
make test
make commit msg="chore: Add Makefile"
# Release
./release.sh
3 Oct 5, 2022
7 Nov 4, 2022
5 Feb 28, 2022
3 Oct 18, 2021
1 Apr 19, 2022
8 Nov 2, 2023
104 Nov 8, 2022
36 Jan 12, 2022
6 Dec 30, 2022
294 Dec 23, 2022
11 Jun 15, 2023
1.6k Jan 9, 2023
27 Oct 24, 2022
6 Aug 7, 2023
1.2k Dec 30, 2022
1.2k Dec 29, 2022
1.1k Jan 3, 2023
60 Dec 9, 2022
41 Dec 17, 2022