Skip to content
/ spec-prod Public

GitHub Action to build ReSpec/Bikeshed specs, validate output and publish to GitHub pages or W3C

License

Notifications You must be signed in to change notification settings

w3c/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 w3.org (using Echidna).

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@v4
      - uses: w3c/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.w3.org/Archives/Public/public-group/2014JulSep/1234.html
          # Usually, you want the following set too...
          W3C_BUILD_OVERRIDE: |
            shortName: your-specs-shortname-here
            specStatus: WD

More examples

Learn from usage examples, including:

Options

Read more about the available options