Example set up using jekyll-action, a GitHub action that allows uploading a Jekyll website that uses other plugins not supported by GitHub Pages.
There are 2 branches:
- main: contains the Jekyll site code and the file
.github/workflows/jekyll.yml, which calls the actions (actions/checkout@v2 is also required). - gh-pages: the production site; its content is created automatically on every push to the main branch. The actions compile the code which is in the main branch.
The plugin AsciiDoc is not supported by GitHub Pages, however, in this way it is possible to use it. See this repository hosted on GitHub: https://martinmorando.github.io/test-jekyll-github-actions/ In this way it is possible to use many more useful plugins.
Remember to:
- Create a token under your repository Settings/Secrets. In this case is called "TOKEN".
- Under the repository Settings, select as source the branch "gh-pages".
This is just an example for future reference. The Jekyll Action was created by Alain Hélaïli.