There is alreay an out-of-box actions for publishing Sphinx documentation to gh-pages: https://github.com/sphinx-notes/pages/
在2022年3月19日星期六 UTC+8 10:52:24<dave.d...@gmail.com> 写道: > That is how I generate my home page: https://davedittrich.github.io/ > > I use this Makefile from the Sphinx source directory to copy/commit to the > GitHub Pages repo before pushing. > > # Don't put trailing slash here: add it in rsync > # commands where necessary because its existence means > # something. > GHPAGES:=../davedittrich.github.io > SHELL=/bin/bash > > # Implement a date-based version numbering scheme. > SHORT_YEAR=$(shell date +%y) > # Strip leading spaces so math works right > MONTH=$(shell date +%m | sed 's/^0//') > DAY_OF_MONTH=$(shell date +%d|sed 's/^0//') > MINS_PAST_MIDNIGHT=$(shell expr `date +%H` \* 60 + `date +%M`) > MINUTE_IN_MONTH=$(shell echo $$(( ( $(DAY_OF_MONTH) - 1 ) * 24 * 60 + > $(MINS_PAST_MIDNIGHT) )) ) > DATE_VERSION=$(SHORT_YEAR).$(MONTH).$(MINUTE_IN_MONTH) > VERSION=$(shell cat VERSION) > > .PHONY: _help > _help: > @echo VERSION=$(VERSION) > @echo DATE_VERSION=$(DATE_VERSION) > $(MAKE) help > > .PHONY: bump > bump: > bumpversion --no-tag patch --current-version $(VERSION) --new-version > $(DATE_VERSION) > > .PHONY: publish > publish: > $(MAKE) gh-pages-commit > $(MAKE) gh-pages-push > > .PHONY: push > push: > git push > > source/robots.txt: robots.j2 > env bash render_template robots.j2 source/robots.txt > > .PHONY: gh-pages > gh-pages: > $(MAKE) -B source/robots.txt > $(MAKE) html > rsync -av \ > --delete \ > --exclude=README.md \ > --exclude=.git \ > --exclude=_downloads \ > --exclude=.nohyde \ > --exclude=.nojekyll \ > -r \ > build/html/ pgpkey.txt nwba redirect $(GHPAGES) > rsync -av \ > downloads/ $(GHPAGES)/_downloads/ > > .PHONY: gh-pages-commit > gh-pages-commit: gh-pages > (cd $(GHPAGES) && git add _downloads/* && git commit -a -m 'Update > gh-pages') > > .PHONY: gh-pages-push > gh-pages-push: > (cd $(GHPAGES) && git push) > > .PHONY: livehtml > livehtml: > sphinx-autobuild -p 0 \ > --re-ignore '.*.swp' \ > --re-ignore '.*.swx' \ > -b html \ > $(ALLSPHINXOPTS) \ > $(BUILDDIR)/html > > > On Wed, Mar 9, 2022 at 12:00 AM <c.b...@posteo.jp> wrote: > >> Hello Miguel >> >> Am 09.03.2022 03:36 schrieb Miguel Villa Floran: >> > GitHub Pages. Has anyone implemented this approach before? >> >> Not on GitHub but on Codeberg (based on Gitea). >> >> Here is the landing page of my repo. On top of the README.md you can see >> a link to the "page" directing to the "docs" folder and its >> "index.html". >> https://codeberg.org/buhtz/sphinx_versuch >> >> -- >> You received this message because you are subscribed to the Google Groups >> "sphinx-users" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to sphinx-users...@googlegroups.com. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/sphinx-users/b767d1481f881c3209a6835fb793bd60%40posteo.de >> . >> > > > -- > Dave Dittrich > @davedittrich > dave.d...@gmail.com > https://davedittrich.github.io/ > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/d6979a06-d0d9-4cd5-80bf-287e170755f3n%40googlegroups.com.