Improve repository: Add deployment automation, documentation, and acc…

.github/workflows/jekyll.yml

@@ -0,0 +1,62 @@
+name: Build and Deploy Jekyll Site
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  pull_request:
+    branches:
+      - main
+      - master
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+          bundler-cache: true
+
+      - name: Build Jekyll site
+        run: bundle exec jekyll build
+
+      - name: Run tests (if any)
+        run: |
+          if [ -f Rakefile ]; then bundle exec rake; fi
+        continue-on-error: true
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: site
+          path: _site/
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master')
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+          bundler-cache: true
+
+      - name: Build Jekyll site
+        run: bundle exec jekyll build
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./_site
+          cname: sinannaseel.github.io

.gitignore

@@ -0,0 +1,55 @@
+# Jekyll
+_site/
+.jekyll-cache/
+.jekyll-metadata
+
+# Ruby
+.bundle/
+.ruby-version
+.ruby-gemset
+
+# Dependencies
+vendor/
+Gemfile.lock
+
+# IDE & Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Build artifacts
+*.o
+*.pyc
+__pycache__/
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Temporary files
+*.tmp
+*.temp
+.sass-cache/
+
+# Mac
+.AppleDouble
+.LSOverride
+._*
+
+# Windows
+ehthumbs.db
+Desktop.ini

404.md

@@ -0,0 +1,37 @@
+---
+layout: default
+title: Page Not Found
+permalink: /404.html
+---
+
+<div style="text-align: center; padding: 4rem 2rem;">
+  <h1 style="font-size: 3rem; margin-bottom: 1rem;">404</h1>
+  <h2>Page Not Found</h2>
+  <p style="font-size: 1.1rem; color: var(--text-secondary); margin: 2rem 0;">
+    Sorry, the page you're looking for doesn't exist or has been moved.
+  </p>
+
+  <div style="margin: 2rem 0;">
+    <a href="/" style="display: inline-block; padding: 0.75rem 1.5rem; background: var(--accent); color: var(--bg-primary); text-decoration: none; border-radius: 4px; font-weight: 500; transition: background 0.2s;">
+      Return Home
+    </a>
+  </div>
+
+  <hr style="margin: 3rem 0; border: none; border-top: 1px solid var(--border);">
+
+  <h3>Helpful Links</h3>
+  <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; margin: 2rem 0; max-width: 600px; margin-left: auto; margin-right: auto;">
+    <a href="/research" style="padding: 1rem; border: 1px solid var(--border); border-radius: 4px; text-decoration: none; color: var(--accent); transition: all 0.2s;">
+      Research
+    </a>
+    <a href="/guides" style="padding: 1rem; border: 1px solid var(--border); border-radius: 4px; text-decoration: none; color: var(--accent); transition: all 0.2s;">
+      Guides
+    </a>
+    <a href="/notes" style="padding: 1rem; border: 1px solid var(--border); border-radius: 4px; text-decoration: none; color: var(--accent); transition: all 0.2s;">
+      Notes
+    </a>
+    <a href="/publications" style="padding: 1rem; border: 1px solid var(--border); border-radius: 4px; text-decoration: none; color: var(--accent); transition: all 0.2s;">
+      Publications
+    </a>
+  </div>
+</div>

Gemfile

@@ -7,4 +7,5 @@ gem "webrick", "~> 1.8"
 group :jekyll_plugins do
   gem "jekyll-feed", "~> 0.12"
   gem "jekyll-seo-tag", "~> 2.8"
+  gem "jekyll-sitemap", "~> 1.4"
 end

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Naseel Sinan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.