summaryrefslogtreecommitdiff
path: root/content
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
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')
-rw-r--r--content/_index.md4
-rw-r--r--content/about.md26
-rw-r--r--content/notes/_index.md9
-rw-r--r--content/notes/reading-and-questions.md12
-rw-r--r--content/notes/static-sites-and-maintenance.md46
-rw-r--r--content/software/_index.md9
-rw-r--r--content/software/archive-site/index.md36
-rw-r--r--content/software/archive-site/screenshot.svg17
-rw-r--r--content/software/content-notes.md23
9 files changed, 182 insertions, 0 deletions
diff --git a/content/_index.md b/content/_index.md
new file mode 100644
index 0000000..7db2929
--- /dev/null
+++ b/content/_index.md
@@ -0,0 +1,4 @@
++++
+title = "たかしの記録"
+description = "日々考えたこととか思ったことを記録します"
++++
diff --git a/content/about.md b/content/about.md
new file mode 100644
index 0000000..b0f203c
--- /dev/null
+++ b/content/about.md
@@ -0,0 +1,26 @@
++++
+title = "About"
+template = "page.html"
++++
+
+## 名前
+
+たかし。ソフトウェアを作り、本を読み、考えたことを記録しています。
+
+## このサイトについて
+
+「たかしの記録」は、日々考えたこと、感じたこと、調べたことと、作成したソフトウェアを長く保存するための個人アーカイブです。更新の速さよりも、あとから読み返せることを大切にしています。
+
+## 関心分野
+
+- 情報工学とソフトウェア
+- 論理学
+- マルクス、資本論、政治経済
+- 地球環境
+- 読書を通じた考察
+
+## 連絡先
+
+[{{ config.extra.mail }}](mailto:{{ config.extra.mail }})
+
+掲載内容は初期サンプルです。公開時に、プロフィールと連絡先を実際の情報へ差し替えてください。
diff --git a/content/notes/_index.md b/content/notes/_index.md
new file mode 100644
index 0000000..3e6bb92
--- /dev/null
+++ b/content/notes/_index.md
@@ -0,0 +1,9 @@
++++
+title = "Notes"
+description = "考えたこと、感じたこと、調べたことの記録。"
+sort_by = "date"
+template = "notes/section.html"
+page_template = "notes/page.html"
++++
+
+分野を固定せず、文章として残したいものをまとめています。
diff --git a/content/notes/reading-and-questions.md b/content/notes/reading-and-questions.md
new file mode 100644
index 0000000..6f67c0c
--- /dev/null
+++ b/content/notes/reading-and-questions.md
@@ -0,0 +1,12 @@
++++
+title = "読書の途中にある問いを残す"
+description = "結論だけでなく、読んでいる途中の問いを記録することについて。"
+date = 2025-11-03
+
+[taxonomies]
+tags = ["読書", "論理学"]
++++
+
+本を読んだあとに結論だけを書こうとすると、文章を残す機会を逃すことがあります。理解できなかった箇所や、別の文章とのつながりも、その時点での大切な記録です。
+
+問いを未完成のまま残しておけば、次に同じ主題へ戻ったときの出発点になります。
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]: ここでいう「小さい」は、ファイル数ではなく、運用時に理解すべき境界が少ないことを指します。
diff --git a/content/software/_index.md b/content/software/_index.md
new file mode 100644
index 0000000..d7e092e
--- /dev/null
+++ b/content/software/_index.md
@@ -0,0 +1,9 @@
++++
+title = "Software"
+description = "作成したソフトウェアと、その背景や過程。"
+sort_by = "date"
+template = "software/section.html"
+page_template = "software/page.html"
++++
+
+ソースコードの正本は自前のcgitで公開し、ここでは人間向けの説明を記録します。
diff --git a/content/software/archive-site/index.md b/content/software/archive-site/index.md
new file mode 100644
index 0000000..ef83fe1
--- /dev/null
+++ b/content/software/archive-site/index.md
@@ -0,0 +1,36 @@
++++
+title = "archive-site"
+description = "文章とソフトウェアを長く残すためのZolaサイト。"
+date = 2026-08-21
+include_in_feeds = false
+
+[extra]
+language = ["Zola", "Tera", "SCSS"]
+license = "MIT"
+source = "https://git.takashi-2521.com/archive-site/"
+github_mirror = "https://github.com/takashi-2521/archive-site"
+related_notes = [
+ "notes/static-sites-and-maintenance.md",
+]
++++
+
+## 概要
+
+NotesとSoftwareを中心に、文章と制作物を長期的に保存するための静的サイトです。
+
+![archive-siteの画面構成例](screenshot.svg)
+
+## 作った背景
+
+断片的なメモとソースコードの間にある、設計意図や調査の過程を一か所に残すために作りました。更新頻度が低くても自然に見える、索引としての情報構造を重視しています。
+
+## 開発の過程
+
+ZolaのSection、Page、Taxonomyをそのまま用い、独自のコンテンツ管理層を作らない方針にしました。表示はTera、スタイルはSCSS、テーマ切替だけを小さなJavaScriptで担当します。
+
+## 特徴
+
+- 年別のNotesアーカイブ
+- タグによる横断的な分類
+- NotesとSoftwareの明示的な関連付け
+- JavaScriptなしでも読める本文とナビゲーション
diff --git a/content/software/archive-site/screenshot.svg b/content/software/archive-site/screenshot.svg
new file mode 100644
index 0000000..18b05c5
--- /dev/null
+++ b/content/software/archive-site/screenshot.svg
@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 540" role="img" aria-labelledby="title desc">
+ <title id="title">archive-siteの画面構成例</title>
+ <desc id="desc">ヘッダー、Notes一覧、Software一覧を罫線で整理した画面。</desc>
+ <rect width="960" height="540" fill="#f6f5f1"/>
+ <rect x="72" y="54" width="816" height="46" fill="none" stroke="#d6d8da"/>
+ <rect x="72" y="144" width="500" height="28" fill="#202124"/>
+ <rect x="72" y="194" width="620" height="12" fill="#aeb2b5"/>
+ <rect x="72" y="246" width="816" height="1" fill="#d6d8da"/>
+ <rect x="72" y="280" width="104" height="18" fill="#315f82"/>
+ <rect x="72" y="326" width="816" height="1" fill="#d6d8da"/>
+ <rect x="72" y="348" width="104" height="12" fill="#aeb2b5"/>
+ <rect x="220" y="344" width="420" height="20" fill="#202124"/>
+ <rect x="72" y="392" width="816" height="1" fill="#d6d8da"/>
+ <rect x="72" y="414" width="104" height="12" fill="#aeb2b5"/>
+ <rect x="220" y="410" width="350" height="20" fill="#202124"/>
+ <rect x="72" y="458" width="816" height="1" fill="#d6d8da"/>
+</svg>
diff --git a/content/software/content-notes.md b/content/software/content-notes.md
new file mode 100644
index 0000000..0d5f6df
--- /dev/null
+++ b/content/software/content-notes.md
@@ -0,0 +1,23 @@
++++
+title = "content-notes"
+description = "Markdownだけで考えの断片を整理する小さな道具。"
+date = 2025-10-18
+include_in_feeds = false
+
+[extra]
+language = ["Rust"]
+license = "MIT"
+source = "https://git.takashi-2521.com/content-notes/"
++++
+
+## 概要
+
+短いメモに日付と題名を付け、単純なディレクトリへ保存するためのコマンドラインツールです。
+
+## 作った背景
+
+思いついたことを残す前に保存場所や形式で迷わないよう、操作を限定した道具が必要でした。
+
+## 開発の過程
+
+保存形式には可搬性の高いMarkdownを採用しました。検索や分類を内部データベースへ閉じ込めず、通常のファイル操作でも扱えることを優先しています。