mewli.st — リポジトリ向けガイド

mewli.st — リポジトリ向けガイド

mewlist 個人サイト兼技術ブログ。Jekyll 製で GitHub Pages にデプロイされる（CNAME: mewli.st）。記事執筆と予稿（下書き）作成が本リポジトリの主な作業。

サイト構成

  • ブログエンジン: Jekyll 3.10 + Bundler（GitHub Pages 互換）
  • テーマ: remote theme chrisrhymes/bulma-clean-theme@v0.14.0（_config.yml で指定）
  • 言語: 日本語 (lang: ja)
  • ページネーション: 5 件 / /blog/page:num
  • パーマリンク: pretty
  • カスタムレイアウト: _layouts/default.html のみ。他は remote theme 由来
  • カスタム includes: _includes/{footer,google-analytics,latest-posts,share-buttons}.html

ディレクトリ

_posts/         # 記事本体 (YYYY-MM-DD-slug.md)
_layouts/       # default.html のみ
_includes/      # カスタム部分テンプレ
_data/          # navigation.yml（ヘッダのリンク）
img/            # 記事画像。hero 画像は img/hero/
assets/css/     # カスタム CSS
blog/index.html # ブログ一覧ページ
about.md, index.md, 404.html
memory-bank/    # プロジェクト経緯メモ（後述）

記事の書き方

ファイル

  • 配置: _posts/YYYY-MM-DD-<英小文字スラッグ>.md
  • 改行コード: 既存記事は CRLF（Windows）。Git が LF に正規化する旨の警告は無視可
  • 文字コード: UTF-8

Front Matter（既存記事に倣う）

---
layout: post
author: mewlist
title:  "記事タイトル（日本語、ダブルクォート）"
date:   2026-05-13 18:00:00 +0900
categories: development
description: "OGP / 一覧用の 1〜2 文の要約"
image: '/img/foo.png'        # サムネ
hero_image: '/img/hero/xxx.jpg'  # ページ上部の大きな画像
published: false             # 予稿は false、公開時に true
# canonical_url: https://mewli.st/
---
  • 予稿（下書き）は 必ず published: false にする。公開可否は本人が判断する
  • image と hero_image は同じでも別でも可。横長の hero がなければ img/queue.png のような図版を流用している例もある
  • 日付は +0900 の JST で記述

本文の構成パターン（過去記事から）

  1. 導入（テーマ提起、Doinject 等の対象ライブラリ紹介とリポジトリリンク）
  2. 課題の詳細（Unity 標準だけでは難しい点など）
  3. 解決策（対象機能の紹介）
  4. C# コード例（csharp ``` でシンタックスハイライト）
  5. 解説・注意点
  6. まとめ

見出しは # を記事タイトル、## をセクション、### をサブセクションに使用。タイトルは Front Matter にも記載するが本文冒頭にも # で書く例がある（例: 2025-04-06 記事）。

画像

  • 通常画像は img/ 配下に置き、/img/foo.png で参照
  • hero 画像は img/hero/ に集約。既存ファイルを流用可（風景写真ストックあり）
  • 新規画像生成は今のところ手段なし — 既存画像の再利用か、ユーザーに用意してもらう前提で進める

ローカルプレビュー

bundle install              # 初回のみ
bundle exec jekyll serve    # http://localhost:4000

Windows で動かす前提（wdm, tzinfo-data が Gemfile に入っている）。

公開フロー

  1. _posts/ に新規 md を作る（published: false）
  2. ローカルで bundle exec jekyll serve で確認
  3. published: true にして commit & push（GitHub Pages が自動ビルド）
  4. push は 必ずユーザーの明示的な指示があってから。勝手に push しない

memory-bank/ について

memory-bank/ 配下に projectbrief.md / productContext.md / systemPatterns.md / techContext.md / activeContext.md / progress.md がある（Cline の Memory Bank パターン）。これは 過去の編集セッションで蓄積されたプロジェクト経緯メモ であり、Claude Code のメモリ機構（~/.claude/.../MEMORY.md）とは別物。

  • 記事ネタや過去の検討事項は memory-bank/progress.md や activeContext.md に残っている。新規記事の方向性を相談された時はここを先に参照する
  • 内容が古くなっていたら、当該ファイルを更新するかユーザーに確認する

執筆作業の進め方（このリポジトリでの規約）

  • 予稿依頼を受けたら、まず構成案を提示してユーザーに合意を取る。書き始める前に方向性を確認する
  • コードサンプルは Unity / C# を前提。動作未確認のコードを載せる場合はその旨を明記する
  • published: true への切り替えは ユーザー指示があった時のみ。勝手に公開状態にしない
  • commit / push は明示的に依頼されてから行う