Skip to content

Warning

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

Auto Sphinx Page

Actions
Creates website from repo using Sphinx
v1
Star (6)

auto-sphinx-page-action

GitHub action that creates website using Sphinx.

This action creates a website from your repository, by building with Sphinx.

Features

  • Set up the configuration of Sphinx automatically.
  • Use README as the homepage if index does not exist at the root level.
  • Use PyData theme.
  • Support MyST Markdown. For more information, see MyST-Parser.
  • Publish to GitHub Pages.

Usage

Refer to the GitHub docs to enable publishing to GitHub Pages.

Set up a workflow in Actions. An example .yml file is as below.

on:
  workflow_dispatch:
  push:
    branches:
      - main
      - master

jobs:
  build-deploy:
    permissions:
      pages: write
      id-token: write
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    steps:
      - id: deployment
        uses: yuanx749/auto-sphinx-page-action@main
        with:
          project: "project"  # project's name, optional, default repository name
          author: "author"  # author name, optional, default username

Or use a reusable workflow:

on:
  workflow_dispatch:
  push:

jobs:
  build-deploy:
    permissions:
      pages: write
      id-token: write
    uses: yuanx749/auto-sphinx-page-action/.github/workflows/main.yml@main

Auto Sphinx Page 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

Creates website from repo using Sphinx
v1

Auto Sphinx Page 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.