From 00d993f8d8cc20b7b0dd746c89fffce214f45327 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Wed, 2 Jul 2025 13:45:26 -0700 Subject: [PATCH 1/9] "Use Actions, not Jekyll" reusable --- data/reusables/pages/actions-is-preferred.md | 2 ++ 1 file changed, 2 insertions(+) create mode 100644 data/reusables/pages/actions-is-preferred.md diff --git a/data/reusables/pages/actions-is-preferred.md b/data/reusables/pages/actions-is-preferred.md new file mode 100644 index 000000000000..f9ab01cbd6b3 --- /dev/null +++ b/data/reusables/pages/actions-is-preferred.md @@ -0,0 +1,2 @@ +>[!NOTE] +>Newer versions of Jekyll are unsupported. {% data variables.product.prodname_actions %} is recommended for most users. Get started at [AUTOTITLE](/actions/get-started/quickstart) \ No newline at end of file From dc5c4ff2a4880eeddeac019de75a8cc56c4b7112 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Thu, 3 Jul 2025 09:29:17 -0700 Subject: [PATCH 2/9] reword --- data/reusables/pages/actions-is-preferred.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/reusables/pages/actions-is-preferred.md b/data/reusables/pages/actions-is-preferred.md index f9ab01cbd6b3..9842c683bc01 100644 --- a/data/reusables/pages/actions-is-preferred.md +++ b/data/reusables/pages/actions-is-preferred.md @@ -1,2 +1,2 @@ >[!NOTE] ->Newer versions of Jekyll are unsupported. {% data variables.product.prodname_actions %} is recommended for most users. Get started at [AUTOTITLE](/actions/get-started/quickstart) \ No newline at end of file +>Newer versions of Jekyll are unsupported. {% data variables.product.prodname_actions %} is the fully supported alternative recommended for most users. Get started at [AUTOTITLE](/actions/get-started/quickstart) \ No newline at end of file From cbc08fa8ecb7694678fe742dd055a654221914e1 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Thu, 3 Jul 2025 09:42:22 -0700 Subject: [PATCH 3/9] Update data/reusables/pages/actions-is-preferred.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- data/reusables/pages/actions-is-preferred.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/reusables/pages/actions-is-preferred.md b/data/reusables/pages/actions-is-preferred.md index 9842c683bc01..4fa190ec5935 100644 --- a/data/reusables/pages/actions-is-preferred.md +++ b/data/reusables/pages/actions-is-preferred.md @@ -1,2 +1,2 @@ >[!NOTE] ->Newer versions of Jekyll are unsupported. {% data variables.product.prodname_actions %} is the fully supported alternative recommended for most users. Get started at [AUTOTITLE](/actions/get-started/quickstart) \ No newline at end of file +>Newer versions of Jekyll are unsupported. {% data variables.product.prodname_actions %} is the fully supported alternative recommended for most users. Get started at [AUTOTITLE](/actions/get-started/quickstart). \ No newline at end of file From f3145e5038fedbd49094963cb3831ea64aa97a01 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Thu, 3 Jul 2025 09:44:59 -0700 Subject: [PATCH 4/9] Update data/reusables/pages/actions-is-preferred.md --- data/reusables/pages/actions-is-preferred.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/reusables/pages/actions-is-preferred.md b/data/reusables/pages/actions-is-preferred.md index 4fa190ec5935..c1198fb2f020 100644 --- a/data/reusables/pages/actions-is-preferred.md +++ b/data/reusables/pages/actions-is-preferred.md @@ -1,2 +1,2 @@ >[!NOTE] ->Newer versions of Jekyll are unsupported. {% data variables.product.prodname_actions %} is the fully supported alternative recommended for most users. Get started at [AUTOTITLE](/actions/get-started/quickstart). \ No newline at end of file +>Newer versions of Jekyll are unsupported. {% data variables.product.prodname_actions %} is the fully supported alternative recommended for most users. Get started at [AUTOTITLE](/actions/get-started/quickstart). From 176fe15c507087eb7148be54d55de27ff2db4071 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Thu, 3 Jul 2025 12:19:32 -0700 Subject: [PATCH 5/9] Update data/reusables/pages/actions-is-preferred.md Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com> --- data/reusables/pages/actions-is-preferred.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/data/reusables/pages/actions-is-preferred.md b/data/reusables/pages/actions-is-preferred.md index c1198fb2f020..5afad9616feb 100644 --- a/data/reusables/pages/actions-is-preferred.md +++ b/data/reusables/pages/actions-is-preferred.md @@ -1,2 +1 @@ ->[!NOTE] ->Newer versions of Jekyll are unsupported. {% data variables.product.prodname_actions %} is the fully supported alternative recommended for most users. Get started at [AUTOTITLE](/actions/get-started/quickstart). +> [!NOTE] While the `github-pages` gem remains supported for some workflows, {% data variables.product.prodname_actions %} is now the recommended approach for deploying and automating Pages sites. From 7dd26f4b9cecfa5793877b9ab801aefc7266af0c Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Tue, 22 Jul 2025 12:21:45 -0700 Subject: [PATCH 6/9] Cleaning up "who can use" --- data/reusables/gated-features/pages.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/data/reusables/gated-features/pages.md b/data/reusables/gated-features/pages.md index 7128d564baa5..ee1a3a1c2c5e 100644 --- a/data/reusables/gated-features/pages.md +++ b/data/reusables/gated-features/pages.md @@ -1,3 +1 @@ {% data variables.product.prodname_pages %} is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_ghe_server %}. {% ifversion fpt or ghec %}{% data reusables.gated-features.more-info %}{% endif %} - -{% ifversion fpt or ghec %}{% data variables.product.prodname_pages %} now uses {% data variables.product.prodname_actions %} to execute the Jekyll build. When using a branch as the source of your build, {% data variables.product.prodname_actions %} must be enabled in your repository if you want to use the built-in Jekyll workflow. Alternatively, if {% data variables.product.prodname_actions %} is unavailable or disabled, adding a `.nojekyll` file to the root of your source branch will bypass the Jekyll build process and deploy the content directly. For more information on enabling {% data variables.product.prodname_actions %}, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository).{% endif %} From b45b506c7971ed0f8f22e187bbfe78eee6a64836 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Tue, 22 Jul 2025 14:22:18 -0700 Subject: [PATCH 7/9] Checking placement/liquid --- .../about-github-pages-and-jekyll.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll.md index ce0a0dc9cb8f..dc4ce9d2142a 100644 --- a/content/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll.md +++ b/content/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll.md @@ -28,6 +28,8 @@ topics: shortTitle: GitHub Pages & Jekyll --- +{% data reusables.pages.actions-is-preferred %} + ## About Jekyll Jekyll is a static site generator with built-in support for {% data variables.product.prodname_pages %} and a simplified build process. Jekyll takes Markdown and HTML files and creates a complete static website based on your choice of layouts. Jekyll supports Markdown and Liquid, a templating language that loads dynamic content on your site. For more information, see [Jekyll](https://jekyllrb.com/). From 75e40b13369062d778ea18191ade1fca2320d038 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Tue, 22 Jul 2025 15:21:52 -0700 Subject: [PATCH 8/9] Adding the reusable --- .../about-jekyll-build-errors-for-github-pages-sites.md | 2 ++ .../adding-a-theme-to-your-github-pages-site-using-jekyll.md | 2 ++ .../adding-content-to-your-github-pages-site-using-jekyll.md | 2 ++ .../creating-a-github-pages-site-with-jekyll.md | 2 ++ ...arkdown-processor-for-your-github-pages-site-using-jekyll.md | 2 ++ .../testing-your-github-pages-site-locally-with-jekyll.md | 2 ++ data/reusables/pages/actions-is-preferred.md | 2 +- 7 files changed, 13 insertions(+), 1 deletion(-) diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md index a5f906b54c01..2c985e9c980f 100644 --- a/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md +++ b/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md @@ -16,6 +16,8 @@ topics: shortTitle: Jekyll build errors for Pages --- +{% data reusables.pages.actions-is-preferred %} + ## About Jekyll build errors If you are publishing from a branch, sometimes {% data variables.product.prodname_pages %} will not attempt to build your site after you push changes to your site's publishing source.{% ifversion fpt or ghec %} diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md index 734b229c3f92..3dc72423a593 100644 --- a/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md +++ b/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md @@ -17,6 +17,8 @@ topics: shortTitle: Add theme to Pages site --- +{% data reusables.pages.actions-is-preferred %} + People with write permissions for a repository can add a theme to a {% data variables.product.prodname_pages %} site using Jekyll. {% data reusables.pages.test-locally %} diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll.md index bcde47780dcc..c3923e7a88af 100644 --- a/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll.md +++ b/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll.md @@ -14,6 +14,8 @@ topics: shortTitle: Add content to Pages site --- +{% data reusables.pages.actions-is-preferred %} + People with write permissions for a repository can add content to a {% data variables.product.prodname_pages %} site using Jekyll. ## About content in Jekyll sites diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md index e2ec5ef6b96e..31a57452e83a 100644 --- a/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md +++ b/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md @@ -15,6 +15,8 @@ topics: shortTitle: Create site with Jekyll --- +{% data reusables.pages.actions-is-preferred %} + {% data reusables.pages.org-owners-can-restrict-pages-creation %} ## Prerequisites diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md index 3fdc3333b721..526231ecd0c8 100644 --- a/content/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md +++ b/content/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md @@ -16,6 +16,8 @@ topics: shortTitle: Set Markdown processor --- +{% data reusables.pages.actions-is-preferred %} + People with write permissions for a repository can set the Markdown processor for a {% data variables.product.prodname_pages %} site. {% data variables.product.prodname_pages %} supports two Markdown processors: [kramdown](http://kramdown.gettalong.org/) and {% data variables.product.github %}'s own Markdown processor, which is used to render [{% data variables.product.prodname_dotcom %} Flavored Markdown (GFM)](https://github.github.com/gfm/) throughout {% data variables.product.github %}. For more information, see [AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github). diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md index 3b7c5c59e707..1824dbdca102 100644 --- a/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md +++ b/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md @@ -16,6 +16,8 @@ topics: shortTitle: Test site locally with Jekyll --- +{% data reusables.pages.actions-is-preferred %} + Anyone with read permissions for a repository can test a {% data variables.product.prodname_pages %} site locally. ## Prerequisites diff --git a/data/reusables/pages/actions-is-preferred.md b/data/reusables/pages/actions-is-preferred.md index 5afad9616feb..1b6333b24994 100644 --- a/data/reusables/pages/actions-is-preferred.md +++ b/data/reusables/pages/actions-is-preferred.md @@ -1 +1 @@ -> [!NOTE] While the `github-pages` gem remains supported for some workflows, {% data variables.product.prodname_actions %} is now the recommended approach for deploying and automating Pages sites. +> [!NOTE] While this `github-pages` gem remains supported for some workflows, {% data variables.product.prodname_actions %} is now the recommended approach for deploying and automating Pages sites. From aa26a999854dc0870460148a81a2898a202344cc Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Tue, 22 Jul 2025 15:40:34 -0700 Subject: [PATCH 9/9] Will this work? --- .../creating-a-github-pages-site-with-jekyll.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md index 31a57452e83a..1d15a347410d 100644 --- a/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md +++ b/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md @@ -15,10 +15,10 @@ topics: shortTitle: Create site with Jekyll --- -{% data reusables.pages.actions-is-preferred %} - {% data reusables.pages.org-owners-can-restrict-pages-creation %} +{% data reusables.pages.actions-is-preferred %} + ## Prerequisites Before you can use Jekyll to create a {% data variables.product.prodname_pages %} site, you must install Jekyll and Git. For more information, see [Installation](https://jekyllrb.com/docs/installation/) in the Jekyll documentation and [AUTOTITLE](/get-started/git-basics/set-up-git).