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

GitHub Action

docfx-action

v0.1.0

docfx-action

book

docfx-action

Runs docfx as a GitHub Action

Installation

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

              

- name: docfx-action

uses: nikeee/docfx-action@v0.1.0

Learn more about this action in nikeee/docfx-action

Choose a version

docfx-action

A GitHub action to run DocFX and generate a documentation site.

Usage

jobs:
  hello_world_job:
    runs-on: ubuntu-latest
    name: A job to say hello
    steps:
    - uses: actions/checkout@v1
    # ...
    - uses: nikeee/docfx-action@master
      name: Build Documentation
      with:
        args: path/to/your/docfx.json

    # Publish generated site using GitHub Pages
    - uses: maxheld83/ghpages@master
      name: Publish Documentation on GitHub Pages
      env:
        BUILD_DIR: _site # docfx's default output directory is _site
        GH_PAT: ${{ secrets.GH_PAT }} # See https://github.com/maxheld83/ghpages

In general, to run docfx <something>, you can use:

    - uses: nikeee/docfx-action@master
      with:
        args: <something>