From 9f2fb3bda733c32995c008bd0f40365e43c348da Mon Sep 17 00:00:00 2001 From: tanaka takashi Date: Sat, 22 Aug 2026 00:18:56 +0900 Subject: feat: Zolaで「たかしの記録」を構築 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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の成功を確認 --- content/_index.md | 4 +++ content/about.md | 26 +++++++++++++++ content/notes/_index.md | 9 ++++++ content/notes/reading-and-questions.md | 12 +++++++ content/notes/static-sites-and-maintenance.md | 46 +++++++++++++++++++++++++++ content/software/_index.md | 9 ++++++ content/software/archive-site/index.md | 36 +++++++++++++++++++++ content/software/archive-site/screenshot.svg | 17 ++++++++++ content/software/content-notes.md | 23 ++++++++++++++ 9 files changed, 182 insertions(+) create mode 100644 content/_index.md create mode 100644 content/about.md create mode 100644 content/notes/_index.md create mode 100644 content/notes/reading-and-questions.md create mode 100644 content/notes/static-sites-and-maintenance.md create mode 100644 content/software/_index.md create mode 100644 content/software/archive-site/index.md create mode 100644 content/software/archive-site/screenshot.svg create mode 100644 content/software/content-notes.md (limited to 'content') 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 @@ + + archive-siteの画面構成例 + ヘッダー、Notes一覧、Software一覧を罫線で整理した画面。 + + + + + + + + + + + + + + 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を採用しました。検索や分類を内部データベースへ閉じ込めず、通常のファイル操作でも扱えることを優先しています。 -- cgit v1.2.3