Skip to content

GitHub Action to build ReSpec, validate output and publish to GitHub pages

License

Notifications You must be signed in to change notification settings

A11yReadTech/spec-prod

 
 

Repository files navigation

Spec Prod | Documentation 📘

This GitHub Action lets you:

  • Build ReSpec and Bikeshed specs.
  • Validate generated document's markup and check for broken hyperlinks.
  • Publish generated spec to GitHub Pages and/or ReadTech.org.

Basic Usage

During a pull request, the action:

  • figures out if you're using ReSpec (index.html) or Bikeshed (index.bs)
  • converts the ReSpec/Bikeshed source document to regular HTML
  • runs broken hyperlink checker, and validate markup using W3C nu validator

Additionally, if a commit is pushed to the "main" branch, the action deploys the built specification to /TR/.

# .github/workflows/auto-publish.yml
name: CI
on:
  pull_request: {}
  push:
    branches: [main]
jobs:
  main:
    name: Build, Validate and Deploy
    runs-on: ubuntu-20.04
    steps:
      - uses: actions/checkout@v3
      - uses: A11yReadTech/spec-prod@v2
        with:
          W3C_ECHIDNA_TOKEN: ${{ secrets.ECHIDNA_TOKEN }}
          # Replace following with appropriate value. See options.md for details.
          W3C_WG_DECISION_URL: https://lists.readtech.org/
          # Usually, you want the following set too...
          W3C_BUILD_OVERRIDE: |
            shortName: your-specs-shortname-here
            specStatus: ED

More examples

Learn from usage examples, including:

Options

Read more about the available options

About

GitHub Action to build ReSpec, validate output and publish to GitHub pages

Resources

License

Stars

Watchers

Forks

Languages

  • TypeScript 100.0%