This GitHub Action simplifies the process of building and deploying Writerside documentation to GitHub Pages. It is based on the official document Build and publish on GitHub - Writerside and provides an easy-to-use interface for automating your documentation workflow.
- Build Writerside documentation using Docker.
- Deploy documentation directly to GitHub Pages.
Before using this action, ensure you have the following:
- A GitHub repository with Writerside documentation.
- GitHub Pages enabled for your repository.
To use this action, add the following configuration to your GitHub Actions workflow file (e.g.,
.github/workflows/pages.yml):
name: "[Pages] Build and deploy Writerside documentation to GitHub Pages"
on:
push:
branches:
- main
paths: [ 'Writerside/**/*' ]
workflow_dispatch:
permissions:
contents: read
id-token: write
pages: write
jobs:
wrs_pages:
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.pages.outputs.page_url }}
steps:
- name: Build Writerside docs using Docker and deploy to GitHub Pages
id: pages
uses: xooooooooox/writerside-action@v1
with:
instance: 'Writerside/radp' # <- Required: modify to your writerside instance
docker_version: '243.22562' # <- Optional: default is 243.22562instance: Required. The Writerside instance to use for building the documentation.docker_version: Optional. Specify the Docker version to use. Defaults to the latest version if not provided.
page_url: The URL of the deployed GitHub Pages site.
Here's an example of how to configure the action in your workflow:
jobs:
wrs_pages:
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.pages.outputs.page_url }}
steps:
- name: Build Writerside docs using Docker and deploy to GitHub Pages
id: pages
uses: xooooooooox/writerside-action@v1
with:
instance: 'Writerside/radp' # <- Required: modify to your writerside instance
docker_version: '243.22562' # <- Optional: default is 243.22562This project is licensed under the MIT License - see the LICENSE file for details.
Contributions are welcome! Please see the CONTRIBUTING file for more information.
If you encounter any issues or have questions, please open an issue on the GitHub repository.