Update template

Author: jcook3701

.github/workflows/cla.yml

@@ -50,7 +50,7 @@ jobs:
         with:
           signed-commit-message: 'chore: $contributorName has signed the CLA'
           path-to-signatures: 'signatures/version1/cla.json'
-          path-to-document: 'https://github.com/{{ github.repository }}/blob/master/docs/jekyll/_manual/developer-resources/cla.md' # e.g. a CLA or a DCO document
+          path-to-document: 'https://github.com/{{ github.repository }}/blob/master/docs/jekyll/_site/manual/developer-resources/cla.html' # e.g. a CLA or a DCO document
           # branch should not be protected
           branch: 'main'
           allowlist: "{{ cookiecutter.github_username }},github-actions[bot],dependabot[bot],bot*"

.github/workflows/jekyll-gh-pages.yml

@@ -47,12 +47,22 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install Python Tools
+        run: |
+          make install
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: '3.3' # Recommended for Jekyll 4.4 in 2026
           bundler-cache: true # Runs 'bundle install' and caches gems automatically
           working-directory: ./docs/jekyll
+      - name: Install Ruby Packages
+        run: |
+          make ruby-install
       - name: Setup Pages
         uses: actions/configure-pages@v5
       - name: Build with Jekyll site in /docs/jekyll

Makefile

@@ -230,7 +230,7 @@ TOML_FILE_LIST := 	( \
 	)
 # --------------------------------------------------
 .PHONY: \
-	all list-folders venv install \
+	all list-folders venv python-install \
 	pre-commit-init security dependency-check black-formatter-check \
 	black-formatter-fix render-cookiecutter jinja2-lint-check ruff-lint-check \
 	ruff-lint-fix toml-lint-check yaml-lint-check format-check \
@@ -243,7 +243,7 @@ TOML_FILE_LIST := 	( \
 # --------------------------------------------------
 # Default: run lint, typecheck, spellcheck, tests, & docs
 # --------------------------------------------------
-all: install lint-check typecheck spellcheck test build-docs
+all: python-install lint-check typecheck spellcheck test build-docs
 # --------------------------------------------------
 # Make Internal Utilities
 # --------------------------------------------------
@@ -269,7 +269,7 @@ venv:
 	$(AT)$(CREATE_VENV)
 	$(AT)echo "✅ Virtual environment created."
 
-install: venv
+python-install: venv
 	$(AT)echo "📦 Installing project dependencies..."
 	$(AT)$(PIP) install --upgrade pip setuptools wheel
 	# $(AT)$(PIP) install -e $(DEPS)
@@ -333,7 +333,8 @@ render-cookiecutter:
 	$(AT)rm -rf $(RENDERED_COOKIE_DIR)
 	$(AT)$(COOKIECUTTER) . --no-input \
 		--output-dir $(RENDERED_COOKIE_DIR) \
-		--overwrite-if-exists
+		--overwrite-if-exists \
+		--keep-project-on-failure
 
 djlint-lint-check:
 	$(AT)echo "🔍 djlint lint..."
@@ -414,6 +415,9 @@ test:
 # --------------------------------------------------
 # 📚 Documentation (Jekyll + nutrimatic)
 # --------------------------------------------------
+ruby-install:
+	$(MAKE) -C $(JEKYLL_DIR) ruby-install;
+
 jekyll:
 	$(MAKE) -C $(JEKYLL_DIR) all;
 
@@ -479,7 +483,7 @@ git-release:
 # 📢 Release
 # --------------------------------------------------
 pre-commit: test security dependency-check format-fix lint-check spellcheck typecheck
-pre-release: clean install pre-commit build-docs changelog build
+pre-release: clean python-install pre-commit build-docs changelog build
 release: git-release bump-version-patch
 # --------------------------------------------------
 # 🧹 Clean artifacts

docs/cookiecutter_input.json

@@ -25,7 +25,8 @@
             "changelog": false,
             "git-init": false,
             "install": false,
-            "pre-commit-init": false
+            "pre-commit-init": false,
+            "python-install": true
         }
     },
     "_is_sub_template": false,

docs/jekyll/Makefile

@@ -41,17 +41,23 @@ PUBLISHDIR ?=
 # --------------------------------------------------
 # 📘 Documentation (Sphinx + Jekyll)
 # --------------------------------------------------
+RUBY_INSTALL := bundle install
 JEKYLL_BUILD := bundle exec jekyll build --quiet
 JEKYLL_CLEAN := bundle exec jekyll clean
 JEKYLL_SERVE := bundle exec jekyll serve
 # --------------------------------------------------
-.PHONY: all jekyll jekyll-serve build run clean help
+.PHONY: all ruby-install jekyll jekyll-serve build run clean help
 # --------------------------------------------------
 # Default:
 # --------------------------------------------------
 all: build
 # --------------------------------------------------
-# 📘 Documentation (Jekyll)
+# ♦️ Ruby
+# --------------------------------------------------
+ruby-install:
+	$(AT)$(RUBY_INSTALL)
+# --------------------------------------------------
+# 📚 Documentation (Jekyll)
 # --------------------------------------------------
 jekyll:
 	$(AT)echo "🔨 Building Jekyll site 📘..."
@@ -80,6 +86,7 @@ help:
 	$(AT)echo "   version: $(PACKAGE_VERSION)"
 	$(AT)echo ""
 	$(AT)echo "Usage:"
+	$(AT)echo "  make ruby-install           Installs Gemfile packages."
 	$(AT)echo "  make build                  Generate Jekyll documentation"
 	$(AT)echo "  make run                    Serve Jekyll site locally"
 	$(AT)echo "  make clean                  Clean Jekyll build artifacts"

docs/jekyll/_manual/contribute/create-feature-request.md

@@ -54,6 +54,6 @@ After submitting your feature request, monitor the discussion. Answer questions
 
 ## Contributing the feature yourself
 
-If you want to implement the feature yourself, feel free to create a pull request following the [pull request guidelines]({% link create-pull-request.md %}).
+If you want to implement the feature yourself, feel free to create a pull request following the [pull request guidelines]({% link _manual/contribute/create-pull-request.md %}).
 
 We welcome community contributions and appreciate your help making github-docs-cookiecutter better!

docs/jekyll/_manual/contribute/create-pull-request.md

@@ -14,5 +14,5 @@ Every contribution to github-docs-cookiecutter's software begins with a [pull re
 We know you're excited to create your first pull request. Before we get started, read these resources first:
 
 - Get started [contributing to github-docs-cookiecutter]({{ site.repo_url }}/CONTRIBUTING.md).
-- Make sure your code follows the relevant [style guides]({% link style-guides/index.md %}).
-- It's recommended you [set up precommit hooks]({% link developer-guide.md %}) to auto-format when you commit.
+- Make sure your code follows the relevant [style guides]({% link _manual/contribute/style-guides/index.md %}).
+- It's recommended you [set up precommit hooks]({% link _manual/contribute/developer-guide.md %}) to auto-format when you commit.

docs/jekyll/_manual/contribute/index.md

@@ -10,8 +10,8 @@ We're excited that you're considering making a contribution to the github-docs-c
 
 These are some good resources to explore for developers:
 
-[Create a pull request]({% link create-pull-request.md %})
-[Create a feature request]({% link create-feature-request.md %})
-[Developer guide]({% link developer-guide.md %})
-[Merge a pull request]({% link merge-pull-request.md %})
+[Create a pull request]({% link _manual/contribute/create-pull-request.md %})
+[Create a feature request]({% link _manual/contribute/create-feature-request.md %})
+[Developer guide]({% link _manual/contribute/developer-guide.md %})
+[Merge a pull request]({% link _manual/contribute/merge-pull-request.md %})
 Find style guides for the github-docs-cookiecutter software project: