test-jekyll-github-actions

About

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.

Important

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".

Note

This is just an example for future reference. The Jekyll Action was created by Alain Hélaïli.