Empowerment Society X

貢献ガイド

Empowerment Society X (ESX) への貢献ガイド

ESX プロジェクトへの貢献に興味をお持ちいただき、誠にありがとうございます！

Empowerment Society X は、特定の政策や思想を推進する場ではなく、多様な背景を持つ人たちが安心して経験やアイデアを共有できるオープンフォーラムを目指しています。誰かの視点を補完したり、議論の種を提供したりすることで、読み手と書き手が互いに学び合える環境を一緒につくっていきましょう。

誤字脱字の修正といった小さな貢献から、新しい記事の執筆、サイトの機能改善に関する提案まで、あらゆる形でのご参加を心から歓迎します。このページでは、具体的な貢献の方法をいくつかご紹介します。

貢献の基本的な流れ

貢献の方法は、あなたの技術的なスキルや、やりたいことに合わせて選ぶことができます。

  1. 簡単な貢献（GitHub不要）: 誤字の報告やアイデアの提案など。
  2. 記事の寄稿（ファイル提出）: Markdown形式で記事を書き、フォームから送る方法。
  3. 本格的な貢献（GitHubを使用）: ご自身でソースコードを編集し、「プルリクエスト」を送る方法。

1. 簡単な貢献（GitHubアカウントは不要です）

GitやGitHubに馴染みがない方でも、気軽に貢献できます。

  • 誤字・脱字の報告: 記事を読んでいて見つけた間違いを教えてください。
  • 記事テーマの提案:「こういったトピックの記事が読みたい」「このテーマについて議論したい」といったアイデアをお寄せください。
  • サイト改善の提案:「文字が小さい」「このボタンが分かりにくい」など、サイトの使い勝手に関するフィードバックも歓迎します。

これらの提案は、サイトに設置されている 記事を寄稿 フォーム、または管理者のSNSなどを通じてお気軽にご連絡ください。

2. 記事の寄稿（Markdownファイルでの提出）

ご自身の知識や意見を記事として発表したい方は、この方法がおすすめです。

執筆の流れ

  1. 記事の作成: お手元のテキストエディタを使い、Markdown形式 (.md) で記事を執筆してください。
    • なぜMarkdown？ 特定のアプリケーション（例: Microsoft Word）に依存しないプレーンテキスト形式のため、誰でも閲覧・編集でき、Webとの親和性が高いためです。
  2. ファイルの提出: サイトの 寄稿フォーム から、作成したMarkdownファイルを添付して送信してください。
  3. 著者名の記載: 記事にはあなたの貢献を記録するため、著者名（ハンドルネーム可）を掲載します。フォームに忘れずにご記入ください。

いただいた記事は、運営チームが内容を確認し、サイトの理念と照らし合わせた上で公開に向けた準備を進めます。

3. 本格的な貢献（GitHubを使ったプルリクエスト）

ご自身でソースコードを直接編集し、変更を提案する最も本格的な方法です。Web開発の経験がある方や、Gitの操作を学びたい方におすすめです。

ステップ1: 準備

まず、変更を加えるための準備をします。

  1. リポジトリをフォーク (Fork)

    • ESXのGitHubリポジトリ にアクセスし、画面右上にある “Fork” ボタンをクリックします。これにより、あなたのGitHubアカウントにリポジトリのコピーが作成されます。

  2. リポジトリをクローン (Clone)

    • フォークした自分のリポジトリを、ローカル環境（あなたのPC）にダウンロードします。ターミナルで以下のコマンドを実行してください。（YOUR_USERNAME の部分はご自身のGitHubユーザー名に置き換えてください）
    git clone https://github.com/YOUR_USERNAME/ESX-hugo.git

  3. 作業ディレクトリへ移動

    cd ESX-hugo

ステップ2: 編集

次に、実際の編集作業を行います。

  1. ブランチを作成 (Create a branch)

    • 変更内容に合わせた名前のブランチを作成します。例えば、タイポ修正なら fix-typo-in-article-title のように、分かりやすい名前をつけましょう。
    git checkout -b fix-typo-in-article-title

  2. ファイルを編集

    • お好きなコードエディタ（VSCodeなど）で、ファイルを編集します。
    • 記事のファイルは content/posts/ ディレクトリにあります。

  3. 変更内容を確認 (Check changes)

    • git status コマンドで変更したファイルを確認し、git diff コマンドで変更内容の詳細を確認します。

  4. 変更をコミット (Commit)

    • 変更内容を記録します。コミットメッセージには、「何を」「なぜ」変更したのかを簡潔に記述してください。
    git add .
git commit -m "Fix: 記事「〇〇」のタイポを修正"

ステップ3: 提案 (プルリクエストの作成)

最後に、あなたの変更をオリジナルのリポジトリに取り込んでもらうよう依頼します。

  1. 変更をプッシュ (Push)

    • ローカルのブランチを、あなたのGitHubリポジトリ（フォークしたもの）にアップロードします。
    git push origin fix-typo-in-article-title

  2. プルリクエストを作成 (Open a Pull Request)

    • あなたのGitHubリポジトリのページに行くと、「Compare & pull request」というボタンが表示されているので、それをクリックします。
    • 変更のタイトルと、変更内容の要約を記述し、“Create pull request” をクリックします。

これであなたの提案がESXの運営チームに通知されます。チームが内容をレビューし、問題がなければマージ（統合）され、あなたの変更が公式サイトに反映されます。

ご不明な点があれば、いつでもお気軽にGitHubのIssueやフォームからご質問ください。 皆さんのご参加を心よりお待ちしています！