{"id":16551217,"url":"https://github.com/michaelcurrin/jekyll-actions-quickstart","last_synced_at":"2025-10-28T18:31:26.917Z","repository":{"id":52290102,"uuid":"253611806","full_name":"MichaelCurrin/jekyll-actions-quickstart","owner":"MichaelCurrin","description":"Deploy a Jekyll 4 site to GH Pages using the \"Jekyll Actions\" action","archived":false,"fork":false,"pushed_at":"2022-03-19T11:37:07.000Z","size":190,"stargazers_count":19,"open_issues_count":0,"forks_count":17,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-01T17:11:13.177Z","etag":null,"topics":["actions","demo","github-actions","github-pages","jekyll","template"],"latest_commit_sha":null,"homepage":"https://michaelcurrin.github.io/jekyll-actions-quickstart/","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MichaelCurrin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-06T20:47:17.000Z","updated_at":"2024-12-02T09:14:13.000Z","dependencies_parsed_at":"2022-09-07T08:20:55.810Z","dependency_job_id":null,"html_url":"https://github.com/MichaelCurrin/jekyll-actions-quickstart","commit_stats":null,"previous_names":[],"tags_count":4,"template":true,"template_full_name":"MichaelCurrin/simplest-jekyll","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fjekyll-actions-quickstart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fjekyll-actions-quickstart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fjekyll-actions-quickstart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fjekyll-actions-quickstart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MichaelCurrin","download_url":"https://codeload.github.com/MichaelCurrin/jekyll-actions-quickstart/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238700280,"owners_count":19515896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actions","demo","github-actions","github-pages","jekyll","template"],"created_at":"2024-10-11T19:36:39.824Z","updated_at":"2025-10-28T18:31:26.629Z","avatar_url":"https://github.com/MichaelCurrin.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jekyll Actions Quickstart\n\u003e Deploy a Jekyll 4 site to GH Pages using the \"Jekyll Actions\" action\n\n[![GH Pages CI](https://github.com/MichaelCurrin/jekyll-actions-quickstart/workflows/GH%20Pages%20CI/badge.svg)](https://github.com/MichaelCurrin/jekyll-actions-quickstart/actions?query=workflow:\"GH+Pages+CI\")\n[![GitHub tag](https://img.shields.io/github/tag/MichaelCurrin/jekyll-actions-quickstart)](https://github.com/MichaelCurrin/jekyll-actions-quickstart/tags/)\n[![License](https://img.shields.io/badge/License-MIT-blue)](#license)\n\n[![Hosted with GH Pages](https://img.shields.io/badge/Hosted_with-GitHub_Pages-blue?logo=github\u0026logoColor=white)](https://pages.github.com/)\n[![Made with GH Actions](https://img.shields.io/badge/CI-GitHub_Actions-blue?logo=github-actions\u0026logoColor=white)](https://github.com/features/actions)\n\n[![Made with Jekyll](https://img.shields.io/badge/Jekyll-4.x-blue?logo=jekyll\u0026logoColor=white)](https://jekyllrb.com)\n[![Made with Jekyll Actions](https://img.shields.io/badge/Jekyll_Actions-2.x-blue.svg)](https://github.com/marketplace/actions/jekyll-actions)\n\n\n## Purpose\n\nA live demo and introduction around deploying Jekyll 4 to GitHub Pages - using a GitHub Actions workflow and the [Jekyll Actions](https://github.com/marketplace/actions/jekyll-actions) action. If you prefer a more generic, flexible, and reusable flow, see my related quickstart repo - [jekyll-gh-actions-quickstart](https://github.com/MichaelCurrin/jekyll-gh-actions-quickstart). That uses a Ruby action to install Ruby and gems, builds using a shell command, and then deploys using an action that handles GitHub Pages.\n\nGitHub Pages already supports building a plain HTML or Jekyll site. No workflow configuration needed for that. So, the reason for GitHub Actions here to build a Jekyll site is that it gives us more control over the environment and build steps. Like the ability to choose Jekyll 4 instead of Jekyll 3, using custom gems, and adding in shell, Python, or NPM commands before the Jekyll build command.\n\nIf you are new to GH Actions, see links and code snippets in my [Workflow Builder](https://michaelcurrin.github.io/workflow-builder/) project.\n\n\n## How can I use Jekyll 4 with GitHub Actions?\n\nFollow one of the approaches below to learn how it works and set up your own site and workflow.\n\n### Tutorial\n\nThis project was developed as part of writing a step-by-step guide for the Jekyll site's documentation.\n\nHere is the link:\n\n- [Jekyll CI GitHub Actions tutorial](https://jekyllrb.com/docs/continuous-integration/github-actions/)\n\n### Demo\n\nSee this project's live demo hosted on GitHub Pages:\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub Pages site](https://img.shields.io/badge/site-GitHub_Pages-blue?style=for-the-badge)](https://michaelcurrin.github.io/jekyll-actions-quickstart/)\n\n\u003c/div\u003e\n\n### Create from template\n\nCreate your own repo like this one using the button below. Then continue following the setup and run instructions on this page.\n\n\u003cdiv align=\"center\"\u003e\n\n[![Use this template](https://img.shields.io/badge/Generate-Use_this_template-2ea44f?style=for-the-badge)](https://github.com/MichaelCurrin/jekyll-actions-quickstart/generate)\n\n\u003c/div\u003e\n\n### Comparing approaches\n\nThere are many ways to deploy a Jekyll site on GH Pages. I cover some in my [Code Cookbook](https://michaelcurrin.github.io/code-cookbook/recipes/ci-cd/github-actions/workflows/jekyll/).\n\nThose approaches have different levels of complexity:\n\n- You use an all-one Jekyll + GH Pages action, like the one in this project and tutorial.\n- Or use a separate action for Jekyll and then another for GH Pages for more modularity (you can swap out one action easily and you can reuse the GH PAges deploy action for other projects like for React).\n- Or you can avoid pre-made actions and write all the low-level code yourself (not recommended.\n\nThe approaches have varying levels of security.\n\n- Some flows use the GitHub-generated `GITHUB_TOKEN`. This only has access to one repo during workflow a run, is never seen by a human and so is _very_ secure.\n- Other flows expect a user-generated Personal Access Token. This has access to update _all_ of your public repos and requires you to generate and store it. It might get abused by a vulnerable or malicious Action. It is _less_ secure.\n\n\n## Documentation\n\u003e How to install and run locally and deploy on GH Pages\n\n\u003cdiv align=\"center\"\u003e\n\n[![View - Documentation](https://img.shields.io/badge/View-Documentation-blue?style=for-the-badge)](/docs/)\n\n\u003c/div\u003e\n\n\n## License\n\n- Released under [MIT](/LICENSE) by [@MichaelCurrin](https://github.com/MichaelCurrin).\n- Feel free to modify and reuse this project. You are required to include the license when using this code. Copy `LICENSE` to `LICENSE-source` and then modify `LICENSE` with your own name.\n- Please link back to this repo.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelcurrin%2Fjekyll-actions-quickstart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichaelcurrin%2Fjekyll-actions-quickstart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelcurrin%2Fjekyll-actions-quickstart/lists"}