Skip to content

Warning

You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?

docs-build-action

Actions
Build Upload documentation
v1.0.0
Star (0)

docs-build-action GitHub action

Inputs

  • revision (required) - The revision or version identifier for the documentation to be built.
  • src-root (required) - The root directory where the source documentation files are located. The action will use this directory as the base location to look for the source files that need to be built.
  • storage-bucket (required) - The name of the storage bucket where the built documentation will be stored. After the documentation is successfully built, it will be uploaded to this specified bucket.
  • storage-endpoint (required) - The endpoint URL of the storage service.
  • storage-access-key-id (required) - The access key ID associated with the account that has permission to access and upload to the specified storage bucket.
  • storage-secret-access-key (required) - The secret access key associated with the account.
  • storage-region (required) - The region where the specified storage bucket is located.
  • lint-root (default: ./_docs-lint) - The root directory for the linting process. This is an optional parameter, and if not specified, the default value will be used.
  • build-root (default: ./_docs-build) - The root directory for the built documentation. This is an optional parameter, and if not specified, the default value will be used.

Example

name: Build

on:
  pull_request:

jobs:
  build-docs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
      - name: Build
        uses: diplodoc-platform/docs-build-action@v1
        with:
          revision: "pr-${{ github.event.pull_request.number }}"
          src-root: "./docs"
          storage-bucket: ${{ secrets.DOCS_AWS_BUCKET }}
          storage-endpoint: ${{ vars.DOCS_AWS_ENDPOINT }}
          storage-access-key-id: ${{ secrets.DOCS_AWS_KEY_ID }}
          storage-secret-access-key: ${{ secrets.DOCS_AWS_SECRET_ACCESS_KEY }}
          storage-region: ${{ vars.DOCS_AWS_REGION }}

docs-build-action is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Build Upload documentation
v1.0.0

docs-build-action is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.