An open API service indexing awesome lists of open source software.

https://github.com/rggh/jubilant-lamp

Automatic Python Documentation built with Sphinx and GitHub Actions hosted on GitHub Pages
https://github.com/rggh/jubilant-lamp

documentation-generator gh-pages ghp-import github-actions github-pages sphinx sphinx-apidoc

Last synced: about 1 month ago
JSON representation

Automatic Python Documentation built with Sphinx and GitHub Actions hosted on GitHub Pages

Awesome Lists containing this project

README

          

# Sphinx > GitHub Actions > Pages

![example workflow](https://github.com/RGGH/ghp2/actions/workflows/sphinx.yml/badge.svg)

### [jubilantlamp](https://rggh.github.io/jubilant-lamp/)

- click settings to enable github pages : https://docs.github.com/en/pages/quickstart
- add workflow permissions : https://github.com/ad-m/github-push-action/issues/96#issuecomment-889984928
- to use this as a base, use : git remote remove origin so you can start a new repo

eg : git remote add origin https://github.com/RGGH/the-new-repo-name.git
- The workflow action uses `pip install ghp-import`
- The yaml file uses 'master' not main
- [Full Article and Tutorial on the redandgreen website](https://redandgreen.co.uk/sphinx-to-github-pages-via-github-actions/)

[buymeacoffee](https://www.buymeacoffee.com/DrPi)