forked from
quillmatiq.com/augment
Fork of Chiri for Astro for my blog
1---
2title: 'Theme Guide'
3pubDate: '2025-07-10'
4---
5
6Chiri is a minimal blog theme built with [Astro](https://astro.build), offering customization options while preserving its clean aesthetic.
7
8---
9
10## Basic Commands
11
12- `pnpm new <title>` - Create a new post (use `_title` for drafts)
13- `pnpm update-theme` - Update the theme to the latest version
14
15## Main Files & Directories
16
17- `src/content/about/about.md` - Edit the about section of the index page. Leave it empty if you don't want any content.
18- `src/content/posts/` - All blog posts are stored here
19- `src/config.ts` - Configure main site info and settings
20
21```ts
22// Site Info
23site: {
24 website: 'https://chiri.the3ash.com/', // Site domain
25 title: 'CHIRI', // Site title
26 author: '3ASH', // Author name
27 description: 'Minimal blog built by Astro', // Site description
28 language: 'en-US' // Default language
29},
30```
31
32```ts
33// General Settings
34general: {
35 contentWidth: '35rem', // Content area width
36 centeredLayout: true, // Use centered layout (false for left-aligned)
37 themeToggle: false, // Show theme toggle button (uses system theme by default)
38 postListDottedDivider: false, // Show dotted divider in post list
39 footer: true, // Show footer
40 fadeAnimation: true // Enable fade animations
41},
42```
43
44```ts
45// Date Settings
46date: {
47 dateFormat: 'YYYY-MM-DD', // Date format: YYYY-MM-DD, MM-DD-YYYY, DD-MM-YYYY, MONTH DAY YYYY, DAY MONTH YYYY
48 dateSeparator: '.', // Date separator: . - / (except for MONTH DAY YYYY and DAY MONTH YYYY)
49 dateOnRight: true // Date position in post list (true for right, false for left)
50},
51```
52
53```ts
54// Post Settings
55post: {
56 readingTime: false, // Show reading time in posts
57 toc: true, // Show table of contents (when there is enough page width)
58 imageViewer: true, // Enable image viewer
59 copyCode: true, // Enable copy button in code blocks
60 linkCard: true // Enable link card
61}
62```
63
64## Post Frontmatter
65
66Only `title` and `pubDate` are required fields
67
68```ts
69---
70title: 'Post Title'
71pubDate: '2025-07-10'
72---
73```
74
75## Syntax Highlighting
76
77You can configure the theme via `shikiConfig` in `astro.config.ts`.
78
79More details: [Syntax Highlighting | Astro Docs](https://docs.astro.build/en/guides/syntax-highlighting/)
80
81```ts
82import { defineConfig } from 'astro/config'
83
84export default defineConfig({
85 markdown: {
86 shikiConfig: {
87 light: 'github-light',
88 dark: 'github-dark',
89 wrap: false
90 }
91 }
92})
93```
94
95---
96
97## Preview of Some Features
98
99
100
101
102
103
104
105
106
107
108
109