Feature: Enable Full Blog Post Support & Migrate to Netlify for Enhanced Deployment (#2)

* add gitignore

* add distill style blog

* update readme

* add workflow to test

* test pr

* remove a test

* fixing the workflow

* fixing the workflow

* fixing the workflow

* fixing the workflow

* fix workflow

* mistakenly overwritten

* fixing the config

* update about sidebar.

* sync the sidebar manually for now

* try to use a explict netlify toml

* simplify the actions

* typo

* fixed the herf check for scrolly

* cache busting

* make sure we are using static-assets folder

* just ignore problematic links

* typo

* Commit a few bug fixes.

* Fix side bar navigation.

* probably have one blog post working

* add badge.

Author: hunterhector

.github/workflows/jekyll-build-and-deploy.yml

@@ -1,6 +1,7 @@
 # This workflow builds your Jekyll site and deploys it to GitHub Pages.
-# It handles both the main site deployment (from 'main' branch)
-# and temporary Pull Request preview deployments.
+# It handles only the main site deployment (from 'main' branch)
+# and manual deployments via workflow_dispatch.
+# PR preview logic has been removed.
 
 name: Jekyll Build and Deploy
 
@@ -10,30 +11,18 @@ on:
   push:
     branches:
       - main
-  # Triggers the workflow on pull request events (for PR previews)
-  pull_request:
-    branches:
-      - main # PRs targeting the main branch
   # Allows you to run this workflow manually from the Actions tab in GitHub.
   workflow_dispatch:
     inputs:
       target_ref:
-        description: 'Branch name (e.g., feature/my-branch) or PR number (e.g., 123) to build/deploy. Leave empty to use the current branch.'
+        description: 'Branch name (e.g., feature/my-branch) to build/deploy. Leave empty to use the current branch (main).'
         required: false
         type: string
-        # Removed: default: ${{ github.ref_name }} - This caused the "github not found" error
-      cleanup_only:
-        description: 'Set to true to only perform cleanup, skipping build/deploy.'
-        required: false
-        type: boolean
-        default: false
 
 # Define jobs
 jobs:
   # Job to perform the build and deploy
   deploy_site:
-    # Only run if cleanup_only is not true
-    if: github.event_name != 'workflow_dispatch' || github.event.inputs.cleanup_only == false
     runs-on: ubuntu-latest
 
     permissions:
@@ -50,21 +39,16 @@ jobs:
         id: determine_ref
         run: |
           # Logic to determine the correct ref to checkout based on event type and inputs
-          # For pull_request event, checkout the head ref of the PR
           # For push event, checkout the main branch
           # For workflow_dispatch:
-          #   If target_ref is a PR number (e.g., "123"), checkout 'refs/pull/123/merge'
-          #   Else (if target_ref is a branch name or empty), checkout that ref
-          if [[ "${{ github.event_name }}" == "pull_request" ]]; then
-            echo "CHECKOUT_REF=${{ github.event.pull_request.head.ref }}" >> $GITHUB_OUTPUT
-          elif [[ "${{ github.event_name }}" == "push" ]]; then
+          #   If target_ref is empty, use the current branch (main)
+          #   Else, checkout the specified branch name
+          if [[ "${{ github.event_name }}" == "push" ]]; then
             echo "CHECKOUT_REF=${{ github.ref }}" >> $GITHUB_OUTPUT
           elif [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
             INPUT_REF="${{ github.event.inputs.target_ref }}"
             if [[ -z "$INPUT_REF" ]]; then # If target_ref is empty, use the current branch
               echo "CHECKOUT_REF=${{ github.ref }}" >> $GITHUB_OUTPUT # Use github.ref for the actual branch ref
-            elif [[ "$INPUT_REF" =~ ^[0-9]+$ ]]; then # Check if input is a number (PR number)
-              echo "CHECKOUT_REF=refs/pull/${INPUT_REF}/merge" >> $GITHUB_OUTPUT
             else # Assume it's a branch name
               echo "CHECKOUT_REF=refs/heads/${INPUT_REF}" >> $GITHUB_OUTPUT
             fi
@@ -86,18 +70,16 @@ jobs:
       - name: Install Jekyll dependencies
         run: bundle install
 
-      - name: Build Jekyll site
-        # When GitHub Pages is configured to use GitHub Actions,
-        # 'actions/configure-pages' and 'actions/deploy-pages'
-        # automatically handle the baseurl for PR previews.
-        # For the main branch deployment, Jekyll will correctly assume root.
-        run: bundle exec jekyll build --trace
-
       - name: Setup Pages
         # This action configures the GitHub Pages environment for deployment.
         # It sets up necessary environment variables like GITHUB_PAGES_URL.
+        id: pages_setup # Added an ID to access its outputs
         uses: actions/configure-pages@v3
 
+      - name: Build Jekyll site
+        # CRITICAL FIX: Explicitly pass the baseurl to Jekyll build using the output from Setup Pages
+        run: bundle exec jekyll build --trace --baseurl "${{ steps.pages_setup.outputs.base_url }}"
+
       - name: Upload artifact
         # Uploads the '_site' directory (your built Jekyll site) as an artifact.
         # This artifact will then be used by the deploy-pages action.
@@ -110,36 +92,3 @@ jobs:
         # The 'id' allows us to reference its outputs, like the page_url.
         id: deployment
         uses: actions/deploy-pages@v4
-
-  # Job to perform cleanup for specific manual deployments (not automatically cleaned up by GitHub)
-  cleanup_deployment:
-    # Only run if cleanup_only is true and a target_ref is provided
-    if: github.event_name == 'workflow_dispatch' && github.event.inputs.cleanup_only == true && github.event.inputs.target_ref
-    runs-on: ubuntu-latest
-
-    permissions:
-      deployments: write # Needed for deleting deployments via the API
-
-    steps:
-      - name: Determine Cleanup Reference
-        id: determine_cleanup_ref
-        run: |
-          CLEANUP_INPUT="${{ github.event.inputs.target_ref }}"
-          if [[ "$CLEANUP_INPUT" =~ ^[0-9]+$ ]]; then
-            # Input is a PR number, cleanup target is the merge ref
-            CLEANUP_REF="refs/pull/${CLEANUP_INPUT}/merge"
-          else
-            # Input is a branch name, cleanup target is the head ref
-            CLEANUP_REF="refs/heads/${CLEANUP_INPUT}"
-          fi
-          echo "CLEANUP_REF=$CLEANUP_REF" >> $GITHUB_OUTPUT
-          echo "Determined cleanup reference: $CLEANUP_REF"
-
-      - name: Delete GitHub Pages Deployment
-        # This action deletes a GitHub Pages deployment for a specific reference (branch/PR).
-        # It's crucial for cleaning up manual deployments not tied to a PR lifecycle.
-        uses: strumwolf/delete-deployment-environment@v2
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          environment: github-pages # The environment name for GitHub Pages
-          ref: ${{ steps.determine_cleanup_ref.outputs.CLEANUP_REF }} # The branch/PR ref whose deployment you want to delete

.gitignore

@@ -0,0 +1,51 @@
+# Jekyll
+#
+# These are generated files and folders that Jekyll creates during the build process.
+# They should not be committed to your repository.
+_site/
+.jekyll-cache/
+.sass-cache/
+.jekyll-metadata
+*.jekyll-ref
+.jekyll-assets-cache/ # Newer Jekyll versions might use this
+
+# Bundler
+#
+# If you use 'bundle install --path vendor/bundle', this directory contains
+# your Ruby gems and should generally be ignored.
+vendor/bundle/
+
+# Dependencies of the Gemfile.lock
+#
+# While `Gemfile.lock` is often committed to ensure consistent dependency
+# versions across environments, some prefer to ignore it for simple sites
+# or local development. For a Jekyll project that will be deployed (e.g., GitHub Pages),
+# it's generally recommended to *include* Gemfile.lock.
+# If you want to ignore it, uncomment the line below:
+# Gemfile.lock
+
+# Operating System Files
+#
+# macOS specific files
+.DS_Store
+
+# Windows specific files
+Thumbs.db
+ehthumbs.db
+desktop.ini
+
+# Editor/IDE Specific Files
+#
+# These are configuration or temporary files generated by your code editor or IDE.
+.idea/      # IntelliJ IDEA / WebStorm
+.vscode/    # VS Code settings (can be useful to share some settings, but often user-specific)
+*.sublime-project
+*.sublime-workspace
+*.swp       # Vim swap files
+*~          # Temporary files created by some editors (e.g., Emacs)
+
+# Log Files
+*.log
+
+# Other temporary files
+*.tmp

.idea/.gitignore

@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+gem "jekyll", "~> 4.4"
+gem "jekyll-remote-theme"
+gem "jekyll-feed"
+gem "jekyll-sitemap"
+gem "jekyll-seo-tag"
+gem "jekyll-archives" # Add this
+gem "jekyll-paginate-v2" # Add this
+gem "jemoji" # Add this
+# Add other al-folio plugins here if you uncommented them in _config.yml
+