Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
book-open

GitHub Action

MkDocs Action

v0.9.0

MkDocs Action

book-open

MkDocs Action

GitHub Action to build HTML files of MkDocs project

Installation

Copy and paste the following snippet into your .yml file.

              

- name: MkDocs Action

uses: Tiryoh/[email protected]

Learn more about this action in Tiryoh/actions-mkdocs

Choose a version

actions-mkdocs

Test

GitHub Actions for MkDocs

Inputs

mkdocs_version

Default: 'latest'

The version of pip, MkDocs.

requirements

Default: requirements.txt

The path to requirements.txt

configfile

Default: mkdocs.yml

The path to mkdocs.yml

Example usage

name: Deploy
on:
  push:
    branches:
      - main
jobs:
  build:
    name: Deploy docs to GitHub Pages
    runs-on: ubuntu-latest
    steps:
      - name: Checkout 
        uses: actions/checkout@v2
      - name: Build
        uses: Tiryoh/actions-mkdocs@v0
        with:
          mkdocs_version: 'latest' # option
          #mkdocs_version: '1.1' # option
          requirements: 'requirements.txt' # option
          configfile: 'mkdocs.yml' # option
      - name: Deploy
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./site

Related projects