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
23
24site: {
25 // Site domain
26 website: 'https://astro-chiri.netlify.app/',
27 // Site title
28 title: 'CHIRI',
29 // Author name
30 author: '3ASH',
31 // Site description
32 description: 'Minimal blog built by Astro',
33 // Default language
34 language: 'en-US'
35},
36```
37
38```ts
39// General Settings
40
41general: {
42 // Content area width
43 contentWidth: '35rem',
44 // Use centered layout (false for left-aligned)
45 centeredLayout: true,
46 // Show theme toggle button (uses system theme by default)
47 themeToggle: false,
48 // Show dotted divider in post list
49 postListDottedDivider: false,
50 // Show footer
51 footer: true,
52 // Enable fade animations
53 fadeAnimation: true
54},
55```
56
57```ts
58// Date Settings
59
60date: {
61 // Date format: YYYY-MM-DD, MM-DD-YYYY, DD-MM-YYYY, MONTH DAY YYYY, DAY MONTH YYYY
62 dateFormat: 'YYYY-MM-DD',
63 // Date separator: . - / (except for MONTH DAY YYYY and DAY MONTH YYYY)
64 dateSeparator: '.',
65 // Date position in post list (true for right, false for left)
66 dateOnRight: true
67},
68```
69
70```ts
71// Post Settings
72
73post: {
74 // Show reading time in posts
75 readingTime: false,
76 // Show table of contents (when there is enough page width)
77 toc: true,
78 // Enable image viewer
79 imageViewer: true,
80 // Enable copy button in code blocks
81 copyCode: true,
82 // Enable link card
83 linkCard: true
84}
85```
86
87## Post Frontmatter
88
89Only `title` and `pubDate` are required fields
90
91```ts
92---
93title: 'Post Title'
94pubDate: '2025-07-10'
95---
96```
97
98## Syntax Highlighting
99
100You can configure the theme via `shikiConfig` in `astro.config.ts`.
101
102More details: [Syntax Highlighting | Astro Docs](https://docs.astro.build/en/guides/syntax-highlighting/)
103
104```ts
105import { defineConfig } from 'astro/config'
106
107export default defineConfig({
108 markdown: {
109 shikiConfig: {
110 light: 'github-light',
111 dark: 'github-dark',
112 wrap: false
113 }
114 }
115})
116```
117
118---
119
120## Preview of Some Features
121
122
123
124
125
126
127
128
129
130
131
132