amaharacya.one/README.md
2025-09-26 19:50:03 +08:00

45 lines
1,019 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# amaharacya.one
## 基本流程
1. 克隆此倉庫
- `git clone --recursive https://git.amaharacya.one/amainait/amaharacya.one.git`
2. 選擇 SSG 引擎
- [dummy-ssg](https://codeberg.org/haydenwu/dummy-ssg): 準備依賴: `apt install php-cli php-mbstring php-xml`
<!-- - omnisrv: 即將推出 -->
3. 構建靜態頁面
- `./mk.sh`
- 結果置於 `out` 目錄。
4. 伺服
- `python3 -m http.server -d out`
- 正式部署請使用更好的靜態檔案伺服器。
## 小技巧
新頁面放在 `src/pages`
PHP 模板在 `tpl/*.php`
一級標題在 `/page` 頁面自動列出。
與 dummy-ssg 不同Markdown 文檔頭部使用簡易鍵值對,而非 JSON:
```
---
title Building Website
lang en-US
---
# About How to Build a Website
...
```
## 授權
Copyright © 2025 [Amahara Oyama](https://www.amaharacya.one/) & [Nait](https://unseen-site.fun/).
除非另有宣告,所有原始碼以 [MIT/Expat 協議](./LICENSE)釋出,所有頁面內容以 [CC-BY-4.0 協議](./CC-BY-4.0)釋出。