Read this in other languages: English, 日本語.

This is a GitHub Actions to generate TOC (Table of Contents),
which executes DocToc and commits if changed.

1. Specify location of TOC (option)
   e.g. README.md

   <!-- START doctoc --><!-- END doctoc -->

   detail
2. Setup workflow
   e.g. .github/workflows/toc.yml

   on: pushname: TOC Generatorjobs: generateTOC: name: TOC Generatorruns-on: ubuntu-lateststeps: - uses: technote-space/toc-generator@v4

The options used for doctoc can be commented to specify values.
If you want to generate multiple TOCs with different settings, specify the values individually as follows.

e.g.

<!-- START doctoc --><!-- param::isNotitle::true:: --><!-- param::isCustomMode::true:: --><!-- END doctoc --> ... 

• The following activity types must be explicitly specified (detail)
  • labeled, unlabeled, closed

• push to branch (not tag)
  • branch name (TARGET_BRANCH_PREFIX)

• specified labels included? (INCLUDE_LABELS)
• branch name (TARGET_BRANCH_PREFIX)

The GITHUB_TOKEN that is provided as a part of GitHub Actions doesn't have authorization to create any successive events.
So it won't spawn actions which triggered by push.

This can be a problem if you have branch protection configured.

If you want to trigger actions, use a personal access token instead.

1. Generate a personal access token with the public_repo or repo scope.
   (repo is required for private repositories).
2. Save as ACCESS_TOKEN
3. Add input to use ACCESS_TOKEN instead of GITHUB_TOKEN.
   e.g. .github/workflows/toc.yml

   on: pushname: TOC Generatorjobs: generateTOC: name: TOC Generatorruns-on: ubuntu-lateststeps: - uses: technote-space/toc-generator@v4with: GITHUB_TOKEN: ${{secrets.ACCESS_TOKEN }}

If CREATE_PR is set to true, a PullRequest is created.

on: pull_requestname: TOC Generatorjobs: generateTOC: name: TOC Generatorruns-on: ubuntu-lateststeps: - uses: technote-space/toc-generator@v4with: CREATE_PR: true

If the closed activity type is set, this action closes the PR when it is no longer needed.

on: pull_request: types: [opened, synchronize, reopened, closed]name: TOC Generatorjobs: generateTOC: name: TOC Generatorruns-on: ubuntu-lateststeps: - uses: technote-space/toc-generator@v4

Payload example

• Context variables

Execute actions at push without limiting the branch and commit directly

on: pushname: TOC Generatorjobs: generateTOC: name: TOC Generatorruns-on: ubuntu-lateststeps: - uses: technote-space/toc-generator@v4

Create or update a Pull Request by executing actions on a Pull Request update only for branches starting with release/.

on: pull_request: types: [opened, synchronize, reopened, closed]name: TOC Generatorjobs: generateTOC: name: TOC Generatorruns-on: ubuntu-lateststeps: - uses: technote-space/toc-generator@v4with: CREATE_PR: trueTARGET_BRANCH_PREFIX: release/

Execute actions in the schedule for the default branch only and commit directly.
（Using the Token created for the launch of other workflows）

on: schedule: - cron: "0 23 * * *"name: TOC Generatorjobs: generateTOC: name: TOC Generatorruns-on: ubuntu-lateststeps: - uses: technote-space/toc-generator@v4with: GITHUB_TOKEN: ${{secrets.ACCESS_TOKEN }}CHECK_ONLY_DEFAULT_BRANCH: true

GitHub (Technote)
Blog