amaharacya.one/README.md

amaharacya.one

本網站的主頁。

基本流程

首先，克隆此倉庫：

• git clone https://git.amaharacya.one/amainait/amaharacya.one.git

之後，選擇任一伺服方案：

dummy-ssg

展開閱讀

1. 準備 dummy-ssg 環境

• 準備子模組: git submodule update --init ssg
• 準備依賴: apt install php-cli php-mbstring php-xml
• 對於非 Debian 系統，可直接運行 ./mk.sh，參考錯誤訊息補充缺失的 PHP 依賴。一些發行版的 PHP 自帶 php_mbstring 和 php-xml。

2. 構建靜態頁面

• ./mk.sh
• 結果置於 out 目錄。

3. 伺服

• python3 -m http.server -d out
• 正式部署請使用更好的靜態檔案伺服器。

omnisrv

展開閱讀

1. 準備 omnisrv 程式：

git clone https://codeberg.org/NaitLee/omnisrv.git
cd omnisrv
go build ./bin ./cmd/...
export PATH="$(pwd)/bin:$PATH"

若無法安裝 Go 依賴，可配置 Goproxy。

2. 任選一個使用方式：

cd ../amaharacya.one
omnisrv -site src -addr [::]:8080
omnisrv-ssg -site src -out out
omnisrv-9p -site src -proto unix -addr /tmp/omnisrv

小技巧

新頁面放在 src/page。

PHP 模板在 tpl/*.php；omnisrv 模板在 src/tmpl.html。

一級標題在 /page 頁面自動列出。

與 dummy-ssg 標準不同，資源文件放在 src/assets 並且直接鏈接 (<link href="/assets/..." />)，而非放入 tpl。

同時，倉庫中的 Markdown 文檔頭部使用簡易鍵值對，而非 JSON:

---
title 標題
lang zh-TW
date 2025-09-29
---

# 長標題

正文...

授權

Copyright © 2025 Amahara Oyama & Nait.

除非另有宣告，所有原始碼以 MIT/Expat 協議釋出，所有頁面內容以 CC-BY-4.0 協議釋出。