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- Site Info
22
23```ts
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- General Settings
39
40```ts
41general: {
42 // Content area width
43 contentWidth: '35rem',
44 // Use centered layout (false for left-aligned)
45 centeredLayout: true,
46 // Show favicon on index page
47 favicon: false,
48 // Show theme toggle button (uses system theme by default)
49 themeToggle: false,
50 // Show footer
51 footer: true,
52 // Enable fade animations
53 fadeAnimation: true
54},
55```
56
57- Date Settings
58
59```ts
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- Post Settings
71
72```ts
73post: {
74 // Show reading time in posts
75 readingTime: false,
76 // Show the 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}
83```
84
85## Post Frontmatter
86
87Only `title` and `pubDate` are required fields
88
89```ts
90---
91title: 'Post Title'
92pubDate: '2025-07-10'
93---
94```
95
96---
97
98## Preview of Some Features
99
100- Theme Toggle
101
102
103
104- Date on Left Side
105
106
107
108- Table of Contents
109
110
111
112- Reading Time
113
114
115
116- Copy Code Button
117
118