AGENTS.md

Project

This is a personal Jekyll blog for Yuanzhi / 院止, published from this repository to GitHub Pages.

Primary goals:

  • Keep the site simple, fast, readable, and friendly to Chinese long-form writing.
  • Preserve the existing Klise/Jekyll structure unless a change clearly improves the blog.
  • Favor small, focused edits over broad theme rewrites.

Common Commands 

bin/blog new "文章标题"
bin/blog publish "文章标题"
bin/blog preview
bin/blog build

Use bin/blog build before finishing changes. It wraps bundle exec jekyll build.

For local visual checks, run:

bin/blog preview

Then open http://127.0.0.1:4000/.

Writing Workflow

  • Drafts live in _drafts/.
  • Published posts live in _posts/ and use YYYY-MM-DD-title.md.
  • bin/blog new "文章标题" creates a draft with the expected front matter.
  • bin/blog publish "文章标题" moves the matching draft into _posts/ and writes the publish datetime.
  • Before publishing, fill in description, excerpt, and tags when possible.

Typical post front matter:

---
layout: post
title: 文章标题
date: 2026-05-30 12:00:00 +0800
modified:
publisher: 院止
excerpt:
description:
tags: []
comments: false
---

Site Structure

  • _config.yml: site metadata, author profile, Jekyll settings.
  • _layouts/: page, home, post, and default templates.
  • _includes/: navbar, footer, author block, comments, navigation.
  • _sass/klise/: theme styling.
  • _data/menus.yml: navigation links.
  • about.md: personal profile/about page.
  • archive.html: archive and search page.
  • bin/blog: local writing and publishing helper.

Style Guidelines

  • The site language is Chinese first. Avoid leaving template English in visible UI unless it is a proper noun or technical term.
  • Keep typography calm and readable. Check long Chinese titles on mobile-sized screens.
  • Avoid heavy decorative UI; this blog should feel like a focused reading space.
  • When adding UI text, prefer concise labels such as 最新文章, 归档, 关于, and 搜索文章.
  • Do not remove theme attribution in the footer unless the owner explicitly asks.

Safety Notes

  • Do not overwrite existing posts or drafts.
  • Do not delete user content without explicit instruction.
  • Generated files in _site/ are build output; avoid editing them directly.
  • If a change affects layout or styling, verify with a browser preview in addition to bin/blog build.