GHgithubguide.jp

基本操作

GitHubリポジトリとは

GitHubリポジトリの役割、入れるファイル、public/private、README、サイト管理での使い方を整理します。

このサイトはGitHub公式サイトではありません。GitHubの基本的な使い方や、Codex・ChatGPT時代のコード管理を初心者向けに整理する非公式ガイドです。機能・料金・提供状況は変更される可能性があるため、重要な判断ではGitHub公式情報も確認してください。

このページでわかること

最初に結論

GitHubリポジトリとはでは、細かい操作だけでなく、どの情報を公開してよいか、どの変更を履歴に残すかを合わせて確認することが大切です。

初心者向け説明

GitHubリポジトリの役割、入れるファイル、public/private、README、サイト管理での使い方を整理します。 GitHubはコードやHTMLを管理する場所として便利ですが、公開範囲、差分確認、秘密情報の扱いを分けて考えると安全に使いやすくなります。

このページの位置づけ

このページは、githubguide.jp の中で「リポジトリ理解の親ページ」として使います。GitHubを初めて触る人は、まずリポジトリが何を管理する場所なのかを押さえてから、README、branch、commit、Pull Request、public / private、秘密情報の注意へ進むと全体像をつかみやすくなります。

細かい操作手順をすべてこのページだけで覚える必要はありません。ここではリポジトリの考え方を整理し、詳しい内容は関連ページへ進めるようにしています。

向いている使い方

  • 初心者がGitHubの全体像を確認する
  • CodexやChatGPTの作業結果を人間が確認する
  • 静的HTMLサイトや小さなプロジェクトを履歴管理する

注意が必要な使い方

  • 秘密情報や個人情報をリポジトリに入れない
  • 公式・公認と誤解される表現を避ける
  • 本番反映前に公開URLと差分を確認する

CodexやChatGPTと組み合わせる場合

CodexやChatGPTと組み合わせる場合は、目的、対象ファイル、触らないファイル、停止条件、確認URLを先に決めておくと、作業後の確認がしやすくなります。

秘密情報・APIキー・パスワード・個人情報の注意

APIキー、パスワード、秘密鍵、FTP資格情報、DB情報、メール設定、個人情報は、HTML、README、ログ、レポート、GitHubの差分に出さない前提で扱います。

関連ページ

外出先でIssue、Pull Request、通知、レビュー依頼を確認したい場合は、スマホでの確認ポイントをまとめたページもあります。

GitHub Mobileの使い方を見る

FAQ

GitHubのリポジトリとは何ですか？

コードやファイルを管理し、変更履歴を残しながら作業するための場所です。README、branch、commit、Pull Request、Issueなどと組み合わせて使います。

GitHubのリポジトリはファイル置き場と何が違いますか？

単にファイルを置くだけでなく、いつ何を変更したかをcommitで記録し、branchで作業を分け、Pull Requestで確認できます。履歴や差分を見ながら作業できる点が大きな違いです。

GitHubのリポジトリには何を入れればいいですか？

コード、README、ドキュメント、公開してよい設定例などを入れます。ただし、APIキー、パスワード、秘密鍵、.env、DB接続情報、個人情報などは入れないようにします。

public repository と private repository はどう違いますか？

public は誰でも見られる公開リポジトリ、private は見られる人を限定するリポジトリです。ただし、private でも秘密情報を直接入れてよいわけではありません。

CodexでGitHubリポジトリを使う時に注意することは？

対象リポジトリ、branch、変更ファイル、SecretsやAPIキーの有無を確認します。作業後はdiffやPull Requestを見て、意図しない変更がないか確認しましょう。

リポジトリ理解を深めるページ

このカテゴリの親ハブ

関連ページをまとめて確認する場合は、初心者ハブ から読み進められます。

GitHubのリポジトリとは何を管理する場所か

GitHubのリポジトリは、コードやファイルを置くだけの場所ではなく、変更履歴を管理しながら作業を進めるための場所です。README、branch、commit、Pull Request、Issueなどと組み合わせることで、何を変更したか、誰が確認したか、どの状態を公開するかを整理しやすくなります。

一人でHTMLや小さなコードを管理する場合でも、チームで開発する場合でも、リポジトリは「今どの状態なのか」「どこを変えたのか」「公開してよい内容なのか」を確認するための土台になります。Webサイト制作やCodexを使ったコード修正でも、対象リポジトリを間違えないことが大切です。

単なるアップロード先やサーバー全体のバックアップ置き場として使うと、DB、ログ、圧縮バックアップ、秘密情報まで混ざる危険があります。初めてリポジトリを作る時は、何を公開してよいか、どの情報を履歴に残してよいかを先に確認しておくと安全です。

単なるファイル置き場ではない理由

リポジトリでは、commitで変更履歴を残し、branchで作業を分け、Pull Requestで変更内容を確認し、Issueでやることや問題を整理できます。ファイルを置くだけではなく、変更前後の差分を見たり、必要に応じて元に戻す判断をしたりできる点が重要です。

要素役割
READMEリポジトリの目的、使い方、注意点を書く場所
branchmainとは別に作業を分けるための枝
commit何を変更したかを残す履歴の記録
Pull Request変更内容を確認して取り込むための仕組み
Issueやること、問題、相談を整理する場所
.gitignoreGitHubに入れたくないファイルを除外するための設定
SecretsAPIキーなどをコードへ直接書かずに扱うための考え方

public と private の違い

GitHubのリポジトリは、公開範囲によって public と private を選びます。public は誰でも見られる公開リポジトリ、private は見られる人を限定するリポジトリです。ただし、private にすれば何を入れても安全という意味ではありません。共有メンバー、権限、外部連携、トークンの扱いによっては、意図しない共有や漏えいにつながる可能性があります。

初めてリポジトリを作る前に確認すること

リポジトリに入れるものと入れないもの

入れてよいものの例

  • コード
  • README
  • ドキュメント
  • 公開してよい設定例
  • 公開してよいHTML / CSS / JavaScript
  • ライセンス情報

入れない方がよいものの例

  • APIキー
  • パスワード
  • 秘密鍵
  • .env
  • DB接続情報
  • 顧客情報や個人情報
  • 証明書の秘密鍵
  • 本番だけで使う認証情報

特にpublic repositoryでは誰でも見られる前提で確認し、private repositoryでも共有メンバーや権限、外部連携の影響を考えて扱います。

GitHubリポジトリとCodexの関係

CodexやAIを使ってコード修正を進める場合でも、リポジトリの意味を理解しておくと安全です。どのリポジトリを対象にするか、どのbranchで作業するか、差分をどう確認するかを決めてから作業すると、意図しない変更を減らしやすくなります。mainへ直接反映する前に、diffやPull Requestで確認する流れを作ることも大切です。

関連ページ

Codex側の関連ページ

CodexでGitHub作業を進める場合は、公開前確認や差分確認を別ページで整理しておくと安心です。

Codex CLI・IDE・モバイル関連ページ

CodexをChatGPT、GitHub、Copilot、安全確認の文脈で見るための周辺ページです。作業前に、対象ファイル、差分、秘密情報、公開前確認を分けて確認します。

GitHub作業でCodex CLIを使う関連する確認ページへ進みます。GitHub作業でCodex IDEを使う関連する確認ページへ進みます。Codex作業後のPR確認関連する確認ページへ進みます。