You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: sample_site/about.md
+5-5Lines changed: 5 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -10,20 +10,20 @@ GitHub's Actions functionality as a build and deploy pipeline for a Jekyll site
10
10
Here are the main differences between GitHub Pages when using Actions or not.
11
11
12
12
- 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`.
15
15
- Plugins
16
16
- 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.
17
17
- Actions lets you choose any plugin - whether your own or someone else's.
18
18
- Themes
19
19
- 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.
21
21
- Workflow
22
22
- GitHub Pages gives you limited output and error messages when running a build and check that everything built okay.
23
23
- 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.
24
24
- Build destination
25
25
- 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.
27
27
28
28
29
29
## Notes
@@ -32,4 +32,4 @@ Even if a plugin or themes written for Jekyll 3 installs and runs without error
32
32
33
33
See the [Upgrading from 3x to 4x](https://jekyllrb.com/docs/upgrading/3-to-4/) guide to see what changes there are.
34
34
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