{"repo":"maltfield/rtd-github-pages","free":true,"listed":false,"github":"https://github.com/maltfield/rtd-github-pages","clone":"git clone https://github.com/maltfield/rtd-github-pages.git","description":"Fork-ready base for your project's documentation using Sphinx + Read the Docs on GitHub Pages","language":"Python","stars":57,"topics":["continuous-documentation","github-actions","python","read-the-docs","rtd","sphinx","github-pages"],"license":"GPL-3.0","category":"workflow-automation","readme_excerpt":"Continuous Documentation: Hosting Read the Docs on GitHub Pages This repo is a fork-ready base for your project's documentation. It lets you host a sphinx-generated site (with the Read the Docs theme) on GitHub Pages using GitHub Actions. For more information, see this article: https://tech.michaelaltfield.net/2020/07/18/sphinx-rtd-github-pages-1/ How to use this repo 1. Fork this repo 1. On your forked repo, go to the \"Actions\" tab and click \"I understand my workflows, go ahead and enable them\" to enable GitHub workflows 1. On your forked repo, go to the \"Settings\" tab. Under \"Pages\", then \"Source\" choose 'Deploy from a branch' 2. On your forked repo, in the \"Settings\" tab. Under \"Pages\". Under \"Branch\". Choose 'gh-pages' then '/(root)' then click 'Save' 1. Make a small change to docs/index.rst 1. git commit and git push something to trigger your site to be built Every time you push to github.com on master, github will automatically spin up a container in their cloud to update your documentation. After you begin to edit the contents of the site, you'll probably also want to customize the following files: 1. docs/conf.py 1. The python files in src/ 1. Other .rst files in docs/ as needed For more details on how this works, see Continuous Documentation: Hosting Read the Docs on GitHub Pages Demo The GitHub-Pages-hosted \"Hello World\" example site built by this repo can be viewed here: https://maltfield.github.io/rtd-github-pages/ In the wild The following Githb-Pages-hosted Read","default_branch":null,"files":null,"tree":[],"storefront":"/r/maltfield","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/maltfield/rtd-github-pages/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}