Add Gram Newton-Schulz Blog

Add Gram Newton-Schulz Blog

Author: JackCharlesZhang

.github/agents/customize.agent.md

@@ -412,13 +412,15 @@ Always guide users to test changes locally before pushing to GitHub:
 3. **Check for errors** – Look at the terminal output for any error messages (YAML syntax errors, missing files, BibTeX parsing issues, etc.).
 
 4. **Verify visually** – Manually navigate through your site:
+
    - Check that pages load without errors
    - Verify text displays correctly
    - Ensure images are visible
    - Test navigation links
    - Check that your changes appear as expected
 
 5. **Test on different pages** – If you modified:
+
    - `_config.yml` – Check the entire site (affects global settings)
    - Blog posts – Check the blog page and individual post
    - Publications – Check the publications page
@@ -502,6 +504,7 @@ Help users avoid these frequent errors:
 ## Boundaries
 
 - ✅ **Always do:**
+
   - Modify configuration files (`_config.yml`, `_data/*.yml`)
   - Create/edit content files (posts, pages, projects, news)
   - Update BibTeX bibliography
@@ -511,6 +514,7 @@ Help users avoid these frequent errors:
   - Reference official documentation when helpful
 
 - ⚠️ **Ask first:**
+
   - Major structural changes to the template
   - Removing core functionality or pages
   - Modifying GitHub Actions workflows
@@ -566,17 +570,21 @@ Help users avoid these frequent errors:
 When users reference issues or discussions:
 
 1. **Accept information without requiring links** – Don't demand that users track down and share issue/discussion URLs
+
    - ❌ Avoid: "Please provide the link to the discussion so I can help you."
    - ✅ Do this: "Let me help based on what you've described. If you remember any details from the discussion, that would be helpful."
 
 2. **Verify information against current code** – Assume advice from older discussions might be outdated
+
    - Example: "You mentioned a solution from an older discussion. Let me check if that still applies with the current version..."
    - Be prepared to offer updated guidance if the codebase has changed
 
 3. **Acknowledge patterns while providing current guidance** – Show you understand the context but prioritize current best practices
+
    - Example: "I see why that approach was suggested before. With our current code, here's the recommended way to do this..."
 
 4. **Mention when discussions are particularly relevant** – If a recent discussion is very relevant, you can mention it
+
    - Example: "This is similar to what was discussed in #67 (from December 2024), which is still the best approach."
 
 5. **Suggest sharing solutions** – If a user's question or your solution would help the community, encourage them to update or create discussions

.github/agents/docs.agent.md

@@ -190,6 +190,7 @@ to process your files located in `_layouts/` and `_includes/`.
 ## Boundaries
 
 - ✅ **Always do:**
+
   - Update documentation files (`*.md` in root directory)
   - Keep documentation in sync with actual code and configuration
   - Use existing documentation style and structure (or improve it with patterns from this agent)
@@ -199,6 +200,7 @@ to process your files located in `_layouts/` and `_includes/`.
   - Preserve existing table of contents markers (`<!--ts-->` and `<!--te-->`
 
 - ⚠️ **Ask first:**
+
   - Major restructuring of documentation organization
   - Adding entirely new documentation files
   - Changing the documentation format or style guide

ANALYTICS.md

@@ -45,21 +45,25 @@ Google Analytics is free and widely used. It provides detailed insights into vis
 ### Setup Steps
 
 1. **Create a Google Analytics account:**
+
    - Visit [Google Analytics](https://analytics.google.com)
    - Sign in with your Google account
    - Click **Start measuring** → **Create account**
 
 2. **Create a property for your website:**
+
    - Enter your website name and URL
    - Accept terms and continue
    - Choose your timezone and currency
 
 3. **Get your Measurement ID:**
+
    - In the left sidebar, go to **Admin** → **Properties**
    - Click **Data Streams** → **Web** (or your existing stream)
    - Copy the **Measurement ID** (format: `G-XXXXXXXXXX`)
 
 4. **Enable in your site:**
+
    - Open `_config.yml` in your repository
    - Set `enable_google_analytics: true`
    - Add your Measurement ID: `google_analytics: G-XXXXXXXXXX`

CUSTOMIZE.md

@@ -62,7 +62,7 @@ Here we will give you some tips on how to customize the website. One important t
     - [How it works](#how-it-works)
     - [Configuration](#configuration-1)
     - [Disable related posts for a specific post](#disable-related-posts-for-a-specific-post)
-    - [Additional configuration in _config.yml](#additional-configuration-in-_configyml)
+    - [Additional configuration in \_config.yml](#additional-configuration-in-_configyml)
   - [Managing publication display](#managing-publication-display)
   - [Adding a Google Calendar](#adding-a-google-calendar)
     - [Basic usage](#basic-usage)
@@ -272,13 +272,15 @@ Understanding al-folio's technology stack will help you better customize and ext
 ### Backend
 
 - **Jekyll 4.x**: [Jekyll](https://jekyllrb.com/) is a static site generator written in Ruby that transforms your Markdown files and templates into a static website. Jekyll is used to:
+
   - Convert Markdown files to HTML
   - Process Liquid templates
   - Manage collections (posts, projects, news, books, etc.)
   - Generate archives and pagination
   - Minify CSS and JavaScript
 
 - **Ruby Gems** (Jekyll plugins): The project uses several Ruby plugins to extend Jekyll's functionality:
+
   - `classifier-reborn`: Used for categorizing and finding related blog posts
   - `jekyll-archives-v2`: Creates archive pages for posts and collections organized by category, tag, or date
   - `jekyll-feed`: Generates an Atom (RSS-like) feed for your content
@@ -296,6 +298,7 @@ Understanding al-folio's technology stack will help you better customize and ext
 ### Build and Deployment
 
 - **GitHub Actions**: Automated workflows for building, testing, and deploying your site. Workflows are defined in `.github/workflows/`:
+
   - **Deploy**: Automatically builds and deploys your site to GitHub Pages when you push changes to the main branch
   - **Link checking**: Validates that all links in your site are not broken
   - **Code formatting**: Ensures code follows the Prettier code style
@@ -670,6 +673,7 @@ Custom fields (any field name you create) remain as **strings** and require expl
    ```
 
    Your archive pages will be generated at:
+
    - `/books/adaptations/movie/`
    - `/books/adaptations/tv-series/` (slugified from `TV-series`)
    - `/books/adaptations/video-game/` (slugified from `video-game`)
@@ -1080,6 +1084,7 @@ To update a library:
 
 1. Change the `version` number
 2. Obtain the new integrity hash for the updated library version and update the `integrity` field with the new hash. You can:
+
    - Check if the CDN provider (e.g., jsDelivr, cdnjs, unpkg) provides the SRI hash for the file. Many CDN sites display the SRI hash alongside the file URL.
    - Generate the SRI hash yourself using a tool such as [SRI Hash Generator](https://www.srihash.org/) or by running the following command in your terminal:
 
@@ -1089,6 +1094,7 @@ To update a library:
 
      Replace `[FILE_URL]` with the URL of the library file. Then, prefix the result with `sha384-` and use it in the `integrity` field.
      For detailed instructions on updating specific libraries, see the FAQ:
+
      - [How can I update Academicons version](FAQ.md#how-can-i-update-academicons-version-on-the-template)
      - [How can I update Font Awesome version](FAQ.md#how-can-i-update-font-awesome-version-on-the-template)
 
@@ -1386,13 +1392,15 @@ GitHub restricts the default `GITHUB_TOKEN` from triggering other workflows when
 ### How to set up the PAT
 
 1. **Create a Personal Access Token**
+
    - Go to [GitHub Settings > Developer settings > Personal access tokens](https://github.com/settings/tokens).
    - Click "Generate new token" (classic or fine-grained).
    - Grant at least the following permissions:
      - `repo` (for classic tokens if repo is private), `public_repo` (for classic tokens if repo is public) or `contents: read/write` (for fine-grained tokens)
    - Save the token somewhere safe.
 
 2. **Add the PAT as a repository secret**
+
    - Go to your repository on GitHub.
    - Navigate to `Settings` > `Secrets and variables` > `Actions` > `New repository secret`.
    - Name the secret `PAT` (must match the name used in the workflow).

INSTALL.md

@@ -190,12 +190,14 @@ If you need to manually re-deploy your website to GitHub pages, go to Actions, c
 1. [Use this template -> Create a new repository](https://github.com/new?template_name=al-folio&template_owner=alshedivat).
 2. Netlify: **Add new site** -> **Import an existing project** -> **GitHub** and give Netlify access to the repository you just created.
 3. Netlify: In the deploy settings
+
    - Set **Branch to deploy** to `main`
    - **Base directory** is empty
    - Set **Build command** to `sed -i "s/^\(baseurl: \).*$/baseurl:/" _config.yml && bundle exec jekyll build`
    - Set **Publish directory** to `_site`
 
 4. Netlify: Add the following two **environment variables**
+
    - | Key            | Value                                                                                  |
      | -------------- | -------------------------------------------------------------------------------------- |
      | `JEKYLL_ENV`   | `production`                                                                           |

SEO.md

@@ -119,6 +119,7 @@ Open Graph is disabled by default. To enable:
    ```
 
 2. **Create your OG image:**
+
    - Size: 1200x630 pixels
    - Format: PNG or JPG
    - Content: Your name/logo + key info
@@ -285,6 +286,7 @@ Similar to Google Search Console but for Bing search:
    ```
 
 3. **Submit to Google Scholar (optional):**
+
    - Go to [Google Scholar Author Profile](https://scholar.google.com/citations)
    - Create a profile
    - Google will find your papers automatically within weeks

TROUBLESHOOTING.md

@@ -166,6 +166,7 @@ bundle exec jekyll serve --port 5000
    ```
 
 3. **Clear browser cache:**
+
    - Chrome: `Ctrl+Shift+R` (Windows/Linux) or `Cmd+Shift+R` (Mac)
    - Firefox: `Ctrl+F5` (Windows/Linux) or `Cmd+R` (Mac)
    - Or open a private/incognito window
@@ -270,6 +271,7 @@ docker compose run --rm web jekyll build 2>&1 | grep -i bibtex
    ```
 
 2. **Check the file exists:**
+
    - Personal images: `assets/img/`
    - Paper PDFs: `assets/pdf/`
    - Use lowercase filenames, no spaces
@@ -428,16 +430,19 @@ nav:
 If you're stuck:
 
 1. **Check existing documentation:**
+
    - [QUICKSTART.md](QUICKSTART.md) – Get started in 5 minutes
    - [INSTALL.md](INSTALL.md) – Installation and deployment
    - [CUSTOMIZE.md](CUSTOMIZE.md) – Full customization guide
    - [FAQ.md](FAQ.md) – Frequently asked questions
 
 2. **Search for your issue:**
+
    - [GitHub Discussions](https://github.com/alshedivat/al-folio/discussions) – Q&A from community
    - [GitHub Issues](https://github.com/alshedivat/al-folio/issues) – Bug reports and feature requests
 
 3. **Get help from AI:**
+
    - Use the **GitHub Copilot Customization Agent** (requires Copilot subscription) to get step-by-step help
    - See [CUSTOMIZE.md § GitHub Copilot Customization Agent](CUSTOMIZE.md#github-copilot-customization-agent)
 

_config.yml

@@ -85,8 +85,8 @@ bing_site_verification: # out your bing-site-verification ID (Bing Webmaster)
 # Blog
 # -----------------------------------------------------------------------------
 
-blog_name: al-folio # blog_name will be displayed in your blog page
-blog_description: a simple whitespace theme for academics
+blog_name: Blog # blog_name will be displayed in your blog page
+blog_description:
 permalink: /blog/:year/:title/
 lsi: false # produce an index for related posts
 
@@ -123,16 +123,6 @@ disqus_shortname: al-folio # put your disqus shortname
 # you can display them in your blog by adding a link to the RSS feed.
 # Optional: Set default categories and tags for posts from each source.
 external_sources:
-  - name: medium.com
-    rss_url: https://medium.com/@al-folio/feed
-    categories: [external-posts]
-    tags: [medium]
-  - name: Google Blog
-    posts:
-      - url: https://blog.google/technology/ai/google-gemini-update-flash-ai-assistant-io-2024/
-        published_date: 2024-05-14
-    categories: [external-posts]
-    tags: [google]
 
 # -----------------------------------------------------------------------------
 # Newsletter
@@ -265,8 +255,8 @@ jekyll-archives:
   books:
     enabled: [year, tags, categories] # enables year, tag and category archives (remove if you need to disable one of them).
 
-display_tags: ["formatting", "images", "links", "math", "code", "blockquotes"] # these tags will be displayed on the front page of your blog
-display_categories: ["external-services"] # these categories will be displayed on the front page of your blog
+display_tags: [] # these tags will be displayed on the front page of your blog
+display_categories: [] # these categories will be displayed on the front page of your blog
 
 # -----------------------------------------------------------------------------
 # Jekyll Scholar

_pages/blog.md

@@ -2,8 +2,8 @@
 layout: default
 permalink: /blog/
 title: blog
-nav: false
-nav_order: 1
+nav: true
+nav_order: 2
 pagination:
   enabled: true
   collection: posts
@@ -73,7 +73,7 @@ pagination:
 <div class="float-right">
 <i class="fa-solid fa-thumbtack fa-xs"></i>
 </div>
-<h3 class="card-title text-lowercase">{{ post.title }}</h3>
+<h3 class="card-title">{{ post.title }}</h3>
 <p class="card-text">{{ post.description }}</p>
 
                     {% if post.external_source == blank %}

_pages/profiles.md

@@ -4,7 +4,7 @@ permalink: /
 title: people
 description: meet the team
 nav: false
-nav_order: 7
+nav_order: 1
 
 profiles:
   - role: faculty
@@ -35,15 +35,15 @@ profiles:
     image: selfie.jpeg
     name: Wentao Guo
     website: https://wentaoguo.me
- 
+
   - role: phd-student
     image: xinle.png
     name: Xinle Cheng
     website: https://ada-cheng.github.io/
 
   - role: phd-student
     image: IMG_9228.jpg
-    name: Lijie(Derrick) Yang 
+    name: Lijie(Derrick) Yang
     website: https://derrickylj.github.io/
 
   - role: phd-student
@@ -57,8 +57,8 @@ profiles:
 
   - role: phd-student
     image: ZhuoqingSong.jpg
-    name: Zhuoqing Song 
-  
+    name: Zhuoqing Song
+
   - role: phd-student
     image: Mayank.jpg
     name: Mayank Mishra
@@ -89,5 +89,4 @@ profiles:
     linkedin: https://abiralshakya.github.io
 ---
 
-
 We are a research group at [Princeton University](https://www.princeton.edu/) led by professor Tri Dao.