CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

Personal academic blog and research notes site for Tingde Liu, built with Jekyll (~4.3) using a custom jekyll-now-based theme. Hosted at https://tingdeliu.github.io. Content is primarily Chinese-language research survey posts on VLN, VLA, and robotics AI.

Development Commands

Serve locally:

ruby -S bundle exec jekyll serve

Accessible at http://127.0.0.1:4000/

Build:

bundle exec jekyll build

Install dependencies:

bundle install

Site Architecture

This is a custom jekyll-now theme (not Chirpy). Key configuration in _config.yml:

  • Permalink: /:title/ (post URL is based on slug, not path)
  • Paginate: 10 posts per page, paginate path /page:num/
  • Markdown: kramdown + MathJax + Rouge syntax highlighting
  • Plugins: jekyll-sitemap, jekyll-feed, jekyll-paginate, jekyll-seo-tag
  • Site URL: https://tingdeliu.github.io, baseurl is empty

Navigation tabs (defined in _config.yml under navigation:): Home, Archive, Tags, About.

Theme layout chain: _layouts/default.html → _layouts/post.html or _layouts/page.html. Components are in _includes/ (nav, footer, head, toc, gitalk, disqus, backtotop, svg-icons).

Content Structure

Blog posts (_posts/): Only 3 posts exist. Filename format: YYYY-MM-DD-title.md.

Images (images/): Stores post images AND paper summary markdown files (named paper-summary-*.md). These summaries are generated by the paper-summary skill and referenced from posts.

Static pages: about.md, archive/, home/, tags/ — these render using layout: page.

Blog Post Front Matter

---
layout: post
title: "Post Title"
date:   YYYY-MM-DD
tags: [tag1, tag2]
comments: true
author: Tingde Liu
toc: true
excerpt: "Brief description shown in post list"
---

The excerpt separator is <!-- more --> (configured in _config.yml).

Markdown Conventions

Image insertion (used in all existing posts):

<div align="center">
  <img src="/images/filename.png" width="80%" />
<figcaption>Caption text</figcaption>
</div>

Math: Inline $...$, block $$...$$ (MathJax).

Table of contents: Add * 目录\n{:toc} after front matter to auto-generate TOC from headings.

Deployment

GitHub Actions (.github/workflows/) deploys to GitHub Pages automatically on push to main. No manual deployment needed.

Social/Comments Configuration

  • Comments via Gitalk (requires GitHub OAuth App — clientID/clientSecret in _config.yml are blank)
  • Footer social links configured under footer-links: in _config.yml
  • Google Analytics ID field exists but is blank