Skip to content

Commit 39e86db

Browse files
committed
Update about.md
1 parent 7e6db5d commit 39e86db

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

sample_site/about.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,20 +10,20 @@ GitHub's Actions functionality as a build and deploy pipeline for a Jekyll site
1010
Here are the main differences between GitHub Pages when using Actions or not.
1111

1212
- Jekyll version
13-
- GitHub Pages normally pins you at `3.8.5`.
14-
- Actions lets you specify and use a version such as `4.0.0` in your `Gemfile`.
13+
- The GitHub Pages environment limits us to using Jekyll `3.9`.
14+
- Actions let you use a version in your Gemfile, such as Jekyll `4.2`.
1515
- Plugins
1616
- GitHub Pages limits you to a set of supported [gem versions](https://pages.github.com/versions/), so you cannot use plugins or versions outside of this. You can only specify whether a config is used by using `plugins` field in the config.
1717
- Actions lets you choose any plugin - whether your own or someone else's.
1818
- Themes
1919
- GitHub Pages normally limits you to these [Themes](https://pages.github.com/themes/) at certain versions. Though, GitHub Pages does also let you use the `remote_theme` parameter through the supported [benbalter/jekyll-remote-theme](https://github.com/benbalter/jekyll-remote-theme) plugin.
20-
- Actions lets you choose any theme - whether your own or someone else's.
20+
- Actions lets you choose any theme - whether your own or by someone else.
2121
- Workflow
2222
- GitHub Pages gives you limited output and error messages when running a build and check that everything built okay.
2323
- With Actions, you specify a workflow file, do a build in a container and see verbose logged steps and errors. You can combine multiple actions or how secrets are used as environment variables. And you can add extra steps like calling an API at build time using a Ruby plugin. You can even compile a ReactJS site and use other non-Jekyll options if you find the right Action on the Marketplace.
2424
- Build destination
2525
- GitHub Pages builds to a `_site` or similar build location which you never get to see directly. You can mirror it by building locally of course.
26-
- Using Actions, you can build to a different branch (`gh-pages` if you are on `master`) or even another repo. Choose one of these two is **essential** since, when using Actions, GitHub Pages needs target folder to serve and this should be in version control. This means you
26+
- Using Actions, you can build to a different branch like `gh-pages`. You can even output to your content another repo. When using GH Pages alone, you just needed one branch like `master` or `main`, without worrying about a `gh-pages` branch.
2727

2828

2929
## Notes
@@ -32,4 +32,4 @@ Even if a plugin or themes written for Jekyll 3 installs and runs without error
3232

3333
See the [Upgrading from 3x to 4x](https://jekyllrb.com/docs/upgrading/3-to-4/) guide to see what changes there are.
3434

35-
See also issue [#651](https://github.com/github/pages-gem/issues/651) on the Pages Gem which deals with adding Jekyll 4 support to GitHub Pages.
35+
See also issue [#651](https://github.com/github/pages-gem/issues/651) on the Pages Gem repo, which deals with adding Jekyll 4 support to GitHub Pages. This is complex to implement, so don't expect it soon.

0 commit comments

Comments
 (0)