Publishing with a custom GitHub Actions workflow

[terual]

Has anybody already published a mkdocs-material site using a custom GitHub Actions workflow? I am looking for a yaml GH Actions script which uses the GitHub Actions as a source for publishing instead of the standard "deploy from a branch".

There are some pointers here but I can't seem to make it work.

[kamilkrzyskow]

Hello @terual,
from the page with the pointers I see that the upload-pages-artifacts and deploy-pages actions are used.
The same is used in the workflow for this project's documentation:

mkdocs-material/.github/workflows/documentation.yml

Lines 92 to 112 in b6b5313

	- name: Build documentation
	env:
	GH_TOKEN: ${{ secrets.GH_TOKEN }}
	GOOGLE_ANALYTICS_KEY: ${{ secrets.GOOGLE_ANALYTICS_KEY }}
	run: |
	mkdocs build --clean
	mkdocs --version
	- name: Adjust permissions
	run: |
	chmod -c -R +rX site/ | while read line; do
	echo "::warning title=Invalid file permissions automatically fixed::$line"
	done
	- name: Upload to GitHub Pages
	uses: actions/upload-pages-artifact@v3
	with:
	path: site
	- name: Deploy to GitHub Pages
	uses: actions/deploy-pages@v4

So you should be able to use it as reference 🤔