Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Implement Auto-Publishing of Docs to GitHub Pages (Issue #333) #340

Closed
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions .github/workflows/publish-docs.ym
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
name: Publish Documentation

on:
push:
tags:
- '*'
workflow_dispatch:
Comment on lines +3 to +7
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like we'd only want this to run when a commit on main is tagged, correct?

Otherwise tagging a release candidate on a branch or any other tag on a non-main branch would update docs


jobs:
TechWizard9999 marked this conversation as resolved.
Show resolved Hide resolved
build-and-deploy:
runs-on: ubuntu-latest

steps:
- name: Checkout Repository
uses: actions/checkout@v2
TechWizard9999 marked this conversation as resolved.
Show resolved Hide resolved

- name: Set up Node.js
uses: actions/setup-node@v2
TechWizard9999 marked this conversation as resolved.
Show resolved Hide resolved
with:
node-version: '14'
TechWizard9999 marked this conversation as resolved.
Show resolved Hide resolved

- name: Install Dependencies
run: npm install

- name: Generate Documentation
run: npx typedoc

- name: Deploy to GitHub Pages
uses: JamesIves/[email protected]
TechWizard9999 marked this conversation as resolved.
Show resolved Hide resolved
with:
branch: gh-pages # The branch the action should deploy to.
folder: docs # The folder the action should deploy.
102 changes: 101 additions & 1 deletion package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

3 changes: 2 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@
"devDependencies": {
"@npmcli/package-json": "5.0.0",
"@typescript-eslint/eslint-plugin": "6.4.0",
"eslint-plugin-mocha": "10.1.0"
"eslint-plugin-mocha": "10.1.0",
"typedoc": "^0.25.4"
TechWizard9999 marked this conversation as resolved.
Show resolved Hide resolved
}
}
Loading