This GitHub Action publishes the contents of a directory to your project's wiki from a workflow.

In a new or existing workflow, add a step using SwiftDocOrg/github-wiki-publish-action@v1 with a path to a directory containing the documentation you wish to upload.

name: Documentation on: [push] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v1 # Additional steps to generate documentation in "Documentation" directory - name: Upload Documentation to Wiki uses: SwiftDocOrg/github-wiki-publish-action@v1 with: path: "Documentation" env: GH_PERSONAL_ACCESS_TOKEN: ${{ secrets.GH_PERSONAL_ACCESS_TOKEN }}

• GitHub.com
• GitHub Enterprise Cloud
• GitHub Enterprise Server
• GitHub AE

This GitHub action requires that your repository has the following:

• A wiki with at least one page in it
• A secret named GH_PERSONAL_ACCESS_TOKEN with a Github personal access token with "repo" authorization

Follow the steps below to ensure that everything's configured correctly.

Note GitHub doesn't currently provide APIs for interacting with project wikis, so much of the required setup must be done manually.

Navigate to the "Settings" tab for your repository, scroll down to the "Features" section, and ensure that the checkbox labeled "Wikis" is checked.

With the Wikis feature enabled for your repository, navigate to the "Wiki" tab. If prompted, create the first wiki page.

Navigate to the Personal access tokens page in your GitHub account settings (Settings > Developer settings > Personal access tokens) and click the "Generate a new token" button.

In the "New personal access token" form, provide a descriptive comment in the "Note" field, like "Wiki Management". Under "Select scopes", enable all of the entries under "repo" perms.

When you're done, click the "Generate token" button at the bottom of the form.

Note: GitHub actions have access to a GITHUB_TOKEN secret, but that token's permissions are limited to the repository that contains your workflow. This workflow requires the generation of a new personal access token to read and write to the git repository for your project's wiki.

Copy your generated personal access token to the clipboard and navigate to your project settings. Navigate to the "Secrets" page, click "Add a new secret", and fill in the form by entering GH_PERSONAL_ACCESS_TOKEN into the "Name" field and pasting your token into the "Value" field.

MIT

Mattt (@mattt)