summaryrefslogtreecommitdiff
path: root/content/notes/static-sites-and-maintenance.md
diff options
context:
space:
mode:
authortanaka takashi <isazaka@gmail.com>2026-08-22 00:18:56 +0900
committertanaka takashi <isazaka@gmail.com>2026-08-22 00:19:26 +0900
commit9f2fb3bda733c32995c008bd0f40365e43c348da (patch)
tree663a6b48ec83b2b6ba2c998dcfed89e0bb29f172 /content/notes/static-sites-and-maintenance.md
parent31b19ee74469c23633bbea4e021d91ddd8c34e3a (diff)
feat: Zolaで「たかしの記録」を構築
Specifications.mdとDesign.mdを実装の基準として、個人アーカイブサイトをZola 0.23.3向けに構築する。 - Home、Notes、Software、About、Tagsの情報設計と専用URLを追加 - Notesの年別アーカイブ、タグ分類、目次、脚注、参考文献、更新日表示を実装 - Softwareの一覧・詳細、cgit/GitHub情報、Notesとの明示的な相互参照を実装 - Tera 2 componentによる再帰TOCと共通partialsを追加 - Minimal Editorial ArchiveのSCSS、レスポンシブ表示、アクセシビリティ対応を追加 - OS設定とlocalStorageに対応するLight/Darkテーマ切替を外部JavaScriptで実装 - Atom/RSS、sitemap、robots.txt、404、favicon、syntax highlightingを設定 - メールアドレスをzola.tomlへ一元化し、AboutとFooterから参照 - 表示名・内部ディレクトリ・変数・URLをSoftware/softwareへ統一 - public/をGit管理対象外とし、外部CDNやNode.js依存を導入しない - zola checkおよびzola buildの成功を確認
Diffstat (limited to 'content/notes/static-sites-and-maintenance.md')
-rw-r--r--content/notes/static-sites-and-maintenance.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/content/notes/static-sites-and-maintenance.md b/content/notes/static-sites-and-maintenance.md
new file mode 100644
index 0000000..10fcd7d
--- /dev/null
+++ b/content/notes/static-sites-and-maintenance.md
@@ -0,0 +1,46 @@
++++
+title = "静的サイトと長期的な保守"
+description = "仕組みを小さく保つことが、長く書き続けるためにどう役立つか。"
+date = 2026-08-21
+updated = 2026-08-22
+
+[taxonomies]
+tags = ["情報工学", "Web"]
+
+[extra]
+related_software = [
+ "software/archive-site/index.md",
+]
++++
+
+個人サイトの目的は、必ずしも最新の機能を提供することではありません。文章を残し、必要なときに読み返せることが中心なら、静的な構成は今もよく合います。
+
+## 保守する対象を減らす
+
+動的な仕組みを採用すると、アプリケーションだけでなく、実行環境やデータベースも保守対象になります。静的サイトでは、公開環境に置くものを生成済みのHTMLとCSSへ限定できます。
+
+```text
+Markdown → Zola → HTML / CSS / JS
+```
+
+構成を小さくすることは、機能を諦めることではありません。目的に必要な部分を見極め、理解できる範囲に留める判断です[^small].
+
+### 更新の手順
+
+記事を書くときの流れも単純です。
+
+1. Markdownを追加する
+2. `zola check`で内部リンクを確認する
+3. `zola build`で静的ファイルを生成する
+4. 生成物だけを配信する
+
+## 読む時間を中心に置く
+
+長く残す文章では、画面の動きより、行長や余白、リンクの見分けやすさが重要です。このサイトでは[Archive Site](@/software/archive-site/index.md)の設計を通して、その考え方を試しています。
+
+## 参考文献
+
+1. Zola, *Documentation*.
+2. W3C, *Web Content Accessibility Guidelines (WCAG)*.
+
+[^small]: ここでいう「小さい」は、ファイル数ではなく、運用時に理解すべき境界が少ないことを指します。