Fix GitHub Pages build: proper theme config and workflow

- Switch from remote_theme to theme: just-the-docs (gem-based)
- Add jekyll and jekyll-include-cache to Gemfile
- Fix workflow step ID for configure-pages
- Remove bundler-cache (no lock file), use bundle install
- Remove conflicting collections config
- Add Jekyll build artifacts to .gitignore

Author: momenbasel

.github/workflows/pages.yml

@@ -20,17 +20,24 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+
       - name: Setup Pages
+        id: pages
         uses: actions/configure-pages@v5
+
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: '3.3'
-          bundler-cache: true
+
+      - name: Install dependencies
+        run: bundle install
+
       - name: Build with Jekyll
         run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
         env:
           JEKYLL_ENV: production
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
 

.gitignore

@@ -12,6 +12,10 @@ Thumbs.db
 # Build artifacts
 node_modules/
 __pycache__/
+_site/
+.jekyll-cache/
+.jekyll-metadata
+vendor/
 
 # Sensitive
 *.ovpn

Gemfile

@@ -1,4 +1,5 @@
 source "https://rubygems.org"
 
-gem "jekyll-remote-theme"
-gem "just-the-docs"
+gem "jekyll", "~> 4.3"
+gem "just-the-docs", "0.10.0"
+gem "jekyll-include-cache"

_config.yml

@@ -3,7 +3,7 @@ description: "The most comprehensive Hack The Box writeup collection - 500+ mach
 url: "https://momenbasel.github.io"
 baseurl: "/htb-writeups"
 
-remote_theme: just-the-docs/just-the-docs@v0.10.0
+theme: just-the-docs
 
 color_scheme: dark
 
@@ -20,6 +20,9 @@ search.button: true
 
 heading_anchors: true
 
+plugins:
+  - jekyll-include-cache
+
 aux_links:
   "GitHub":
     - "https://github.com/momenbasel/htb-writeups"
@@ -33,17 +36,6 @@ back_to_top_text: "Back to top"
 
 footer_content: 'Copyright &copy; 2026 <a href="https://github.com/momenbasel">Moamen Basel</a>. Distributed under the <a href="https://github.com/momenbasel/htb-writeups/blob/main/LICENSE">MIT License</a>.'
 
-ga_tracking:
-ga_tracking_anonymize_ip: true
-
-compress_html:
-  clippings: all
-  comments: all
-  endings: all
-  startings: []
-  blanklines: false
-  profile: false
-
 callouts:
   warning:
     title: Warning
@@ -58,41 +50,18 @@ callouts:
 # Exclude files from the site
 exclude:
   - "0xdf-htb-machines.json"
+  - "0xdf-htb-machines.md"
   - "ippsec-video-index.json"
+  - "ippsec-video-index.md"
   - ".markdownlint.json"
   - "CONTRIBUTING.md"
   - "templates/"
   - "node_modules/"
   - "Gemfile"
   - "Gemfile.lock"
 
-# Include dotfiles
-include:
-  - ".github"
-
-# Collections for better organization
-collections:
-  machines:
-    output: true
-    permalink: /machines/:path/
-
 defaults:
   - scope:
       path: ""
     values:
       layout: default
-  - scope:
-      path: "machines"
-    values:
-      layout: default
-      parent: Machines
-  - scope:
-      path: "challenges"
-    values:
-      layout: default
-      parent: Challenges
-  - scope:
-      path: "resources"
-    values:
-      layout: default
-      parent: Resources