【iOS × GitHub】README.mdの書き方!アプリ個人開発

【iOS × GitHub】README.mdの書き方!アプリ個人開発

この記事からわかること

  • GitHubREADME.md書き方使い方とは
  • マークアップ記法とは?
  • iOSアプリ開発での利用方法
  • 個人開発アプリの概要書くべきこと
  • プレビュー確認する方法

index

[open]

\ アプリをリリースしました /

みんなの誕生日

友達や家族の誕生日をメモ!通知も届く-みんなの誕生日-

posted withアプリーチ

参考文献: GitHub:README.md

GitHub:README.mdとは?

ソースコードを公開するためのツールとしても使用されるGitHubにおいて、リポジトリごとの説明や概要、使い方、ライセンスなどを記述するのが「README.md」の役割です。

中身はシンプルなテキストファイルでありMarkdown記法を用いて記述されます。拡張子の「.md」はMarkdownの略称のようです。

またGitHubではリポジトリだけでなく、自身のプロフィールに関してもREADME.mdを用意できるので自己紹介に利用できます。

【iOS × GitHub】README.mdの書き方!アプリ個人開発

含めること

  1. 概要/説明
  2. 使い方
  3. ヘルプ
  4. ライセンス
  5. 作成者
  6. etc..

Markdown記法とは?

Markdown記法とは文書の書式設定やスタイルを指定するための軽量マークアップ言語の1つです。テキストに任意のマークアップを追加することで、簡単に文書を変換することができます。例えば、タイトルを作成するには、先頭に#を、リスト作成は行頭にハイフン(-)や数字を付けます。

# タイトル
## 小見出し
### 見出し3

- リスト1
- リスト2
- リスト3

1. 数字付きリスト1
2. 数字付きリスト2
3. 数字付きリスト3

**太字**、*斜体*、~~取り消し線~~

以下 区切り線
--- 
___
***

```
function test() {
  console.log("notice the blank line before this function?");
}
```

[リンクのテキスト](http://example.com)

>>>>>>Hello World

配置場所

配置する場所に厳密なルールはないようですがルートディレクトリへの配置が推奨されています。とりあえずプロジェクトを利用する際に読んでもらいたいものなので見つけやすい位置への配置がおすすめです。

GitHubではREADME.mdがルートディレクトリにあると以下のように自動で表示されるになっています。

【iOS × GitHub】README.mdの書き方!アプリ個人開発

GitHub:Swift

Xcodeから作成する方法

Xcodeから「README.md」を追加するにはXcodeの上部メニューから「File」 > 「New」 > 「File...」をクリックし、「Documentation」>「Empty」を選択し、ファイル名を「README.md」にします。

【iOS × GitHub】README.mdの書き方!アプリ個人開発

すると以下のように追加されるのであとは、中身を記述していくだけです。

【iOS × GitHub】README.mdの書き方!アプリ個人開発

GitHubから作成する方法

GitHubから作成するには新しいリポジトリを作成する際に「Add a README file」にチェックを入れることで自動的に生成されます。

GitHubからリモートリポジトリを作成する手順

すでにリポジトリを作成していた場合はリポジトリの「Code」タブに表示されている「Add a README」をクリックすることで追加できます。

GitHubにSwiftで作成したプロジェクトのソースコードをアップロードする

ですがこの方法ではXcodeでのコミットとリモートリポジトリのコミットに齟齬が生まれてしまうのでもうpushしない場合のみに使える方法かもしれません。

iOSアプリ個人開発で書くべきこと

iOSアプリを個人開発してGitHubにポートフォリオとして載せる際にはREADME.mdを作成しておくことをおすすめします。

個人的に使用しているフォーマット

# アプリ名
## 環境

- Language:Swift
- Version:5.7.1
- Xcode:13.4
- URL:[App Store](http://example.com) 
- Architecture:MVVM

### ライブラリ

1. Cocoa Pods
2. Realm Swift
3. Firebase Analytics

## アプリの概要

## アプリの使い方

## 開発したきっかけ

## 使用した技術

## リファレンス

プレビューを確認する方法

READMEファイルを作成して実際のプレビューがどのようになるかを確認するにはVS CodeCmd + Kを押したあとにvを押すことでMarkdown貴方のファイルのプレビューを表示させることができます。

【iOS × GitHub】README.mdの書き方!アプリ個人開発

まだまだ勉強中ですので間違っている点や至らぬ点がありましたら教えていただけると助かります。

ご覧いただきありがとうございました。

searchbox

スポンサー

ProFile

ame

趣味:読書,プログラミング学習,サイト制作,ブログ

IT嫌いを克服するためにITパスを取得しようと勉強してからサイト制作が趣味に変わりました笑
今はCMSを使わずこのサイトを完全自作でサイト運営中〜

New Article

index