Skip to content
book-open

GitHub Action

Tangy Mkdocs Build Action

v1 Latest version

Tangy Mkdocs Build Action

book-open

Tangy Mkdocs Build Action

Builds documentation using Mkdocs and deploys to GitHub pages

Installation

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

              

- name: Tangy Mkdocs Build Action

uses: Tangerine-Community/tangy-mkdocs-build-action@v1

Learn more about this action in Tangerine-Community/tangy-mkdocs-build-action

Choose a version

tangy-mkdocs-build-action

This GitHub Action will compile your MkDocs site and Deploy it to GitHub Pages using one of the default themes. It assumes that you have a mkdocs.yml file a in the top-level directory of your project and that the documentation source files (in Markdown format) are stored within the docs/ directory.

GitHub Action for building the Tangerine Documentation with Mkdocs and publish to GitHub Pages

Example Action Workflow for your Repo

name: Build Documentation using MkDocs

# Controls when the action will run. Triggers the workflow on push or pull request
# events but only for the master branch
on:
  push:
    branches: [master]
  pull_request:
    branches: [master]

jobs:
  build:
    name: Build and Deploy Documentation
    runs-on: ubuntu-latest

    steps:
      - name: Checkout Master
        uses: actions/checkout@v2

      - name: Build and Deploy Documentation using MkDocs
        uses: Tangerine-Community/tangy-mkdocs-build-action@v1