https://github.com/diplodoc-platform/docs-build-static-action

https://github.com/diplodoc-platform/docs-build-static-action

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/diplodoc-platform/docs-build-static-action
• Owner: diplodoc-platform
• Created: 2024-04-01T09:19:38.000Z (9 months ago)
• Default Branch: master
• Last Pushed: 2024-08-17T09:47:44.000Z (5 months ago)
• Last Synced: 2024-08-17T10:48:54.538Z (5 months ago)
• Size: 4.88 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

        
# docs-build-static-action GitHub action

This GitHub action does two things:

- Builds project documentation using [@diplodoc/cli](https://github.com/diplodoc-platform/cli).

- Uploads the build files, logs, and inputs as artifacts.

## Inputs

- `src-root` (default: `./`) - 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.

- `build-root` (default: `./_site`) - The root directory for the built documentation. This is an optional parameter, and if not specified, the default value will be used.

## Usage

Create a file named `.github/workflows/build.yml` in your repo.

This workflow is triggered every time a pull request is opened or updated.

```yaml

name: Build

on:

  workflow_dispatch:

  push:

    branches: [ "main" ]

  pull_request:

    branches: [ "main" ]

permissions:

  contents: read

  pages: write

  id-token: write

concurrency:

  group: "pages"

  cancel-in-progress: false

jobs:

  build-docs:

    environment:

      name: github-pages

      url: ${{ steps.deployment.outputs.page_url }}

    runs-on: ubuntu-latest

    permissions: write-all

    steps:

      - name: Checkout

        uses: actions/checkout@v3

      - name: Build

        uses: diplodoc-platform/docs-build-static-action@v1

        with:

          src-root: "./docs"

```