Skip to content

GitHub Pages Pelican Build Action

Actions
This action builds a Pelican project and deploys it to GitHub Pages
0.2.0
Latest
Star (40)

Tags

 (1)

GitHub Pages Pelican Build Action

This action builds a Pelican project and deploys it to GitHub Pages.

Please ensure a requirements.txt is present for your site and installs pelican and other requirements needed to build your site.

A requirements.txt can be generated by running pip freeze > requirements.txt in the virtual environment your pelican site is developed in.

Environment variables

  • GH_PAGES_BRANCH (optional): override the default gh-pages deployment branch
  • GH_PAGES_CNAME (optional): specify the custom domain you've configured (if any)
  • PELICAN_CONFIG_FILE (optional): override the default pelicanconf.py config file
  • PELICAN_CONTENT_FOLDER (optional): override the default content content folder
  • PELICAN_THEME_FOLDER (optional): setup the theme folder with package.json file, it is required if you need install node modules.
  • GITHUB_TOKEN: (required) should be ${{secrets.GITHUB_TOKEN}}, see the workflow demo in the demo repository for an example of this. This secret is fulfilled by GitHub.

Demo

Repository: https://github.com/nelsonjchen/pelican-action-demo

Website: https://pelican-action-demo.mindflakes.com/

History

Extracted from https://github.com/desertpy/desertpy-pelican.

It is not used there anymore though. For most sites though, this should suffice.

GitHub Pages Pelican Build Action 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

This action builds a Pelican project and deploys it to GitHub Pages
0.2.0
Latest

Tags

 (1)

GitHub Pages Pelican Build Action 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.