senju.devブログ投稿ガイド

はじめに

senju.devのブログは、千住エリアの技術者コミュニティメンバーが知見を共有するためのプラットフォームです。 GitHub Pull Requestを使った投稿フローにより、エンジニアにとって馴染みのある方法で記事を投稿できます。

投稿の流れ（3ステップ）

ステップ1: GitHubでブランチを作成

1. senju.devのGitHubリポジトリにアクセス
2. 「Fork」ボタンをクリックして、自分のアカウントにリポジトリをフォーク
3. フォークしたリポジトリで新しいブランチを作成（例: add-my-article）

ステップ2: 記事ファイルを作成

1. app/routes/posts/ディレクトリに移動
2. 「Create new file」ボタンをクリック
3. ファイル名をyour-article-title.mdxの形式で入力（例: react-hooks-tips.mdx）
4. 以下のテンプレートをコピーして内容を編集：

---
title: 記事のタイトル
date: 2025-07-12
excerpt: 記事の概要（SNSシェア時などに表示されます）
tags:
  - React
  - JavaScript
author: あなたの名前
published: true
---

# 記事のタイトル

## はじめに

ここに記事の導入を書きます。

## 本文

### 見出し3

本文の内容を書きます。

```javascript
// コードブロックの例
function hello() {
  console.log("Hello, senju.dev!");
}
```

## まとめ

記事のまとめを書きます。

ステップ3: Pull Requestを作成

1. ファイルを保存（「Commit new file」ボタン）
2. 本家リポジトリに対してPull Requestを作成
3. PRのタイトルと説明を記入して送信

記事を書く際のポイント

frontmatter（メタデータ）の書き方

• title: 記事のタイトル（必須）
• date: 投稿日（YYYY-MM-DD形式、必須）
• excerpt: 記事の概要（100文字程度推奨）
• tags: 関連するタグ（配列形式）
• author: 著者名（必須）
• published: 公開状態（true/false、デフォルトはtrue）

Markdownの書き方

• 見出し: #、##、###を使用
• 強調: **太字**、*斜体*
• リンク: [テキスト](URL)
• 画像: ![代替テキスト](画像URL)
• コード: バッククォート3つで囲む（言語名を指定可能）
• 引用: >を行頭に付ける

投稿可能な内容

以下のような内容を歓迎しています：

• 技術的なTipsやハウツー
• 勉強会やイベントのレポート
• 個人プロジェクトの紹介
• 新しい技術の試用レポート
• 千住エリアならではの開発環境の紹介
• コミュニティ活動の報告

レビュープロセス

Pull Requestを作成すると、コミュニティメンバーがレビューを行います。 技術的な正確性や読みやすさについてフィードバックを受けることができます。

• 誤字脱字のチェック
• 技術的な内容の確認
• コードサンプルの動作確認
• 記事構成のアドバイス

よくある質問

Q: 画像はどうやって追加しますか？

画像はpublic/images/posts/ディレクトリに配置し、 相対パスで参照してください。GitHubのIssueに画像をドラッグ&ドロップして 生成されるURLを使用することもできます。

Q: 下書きを保存したい場合は？

frontmatterのpublished: falseを設定すると、 記事は非公開状態になります。準備ができたらtrueに変更してください。

Q: 記事を修正したい場合は？

既存の記事を編集する場合も、同様にPull Requestを作成してください。 GitHubの編集機能を使って直接ファイルを編集できます。

サポート

投稿方法について不明な点がある場合は、GitHubのIssueでお気軽にご質問ください。