ソフトウェア - SmartGitのソースを表示

== 概要 ==
SmartGitは、非商用の場合は無償で使用できるが、商用で使用する場合は有償(最初の30日間は無料)となる。<br>
<br><br>

== SmartGitのUI ==
SmartGitのUIを下図に示す。<br>
[[ファイル:SmartGit 1.jpg|フレームなし|中央]]
<br>
===== リポジトリをSmartGitに登録 =====
リポジトリが既にローカルに存在する場合、メニューバーの[Repository] - [Add or Create...]を選択して、リポジトリがあるディレクトリを選択する。<br>
<br>
===== リモートリポジトリのクローン =====
登録するリポジトリがローカルに存在しない場合、リモート先のリポジトリからクローンする。<br>
<br>
メニューバー[Repository] - [Clone]を選択する。<br>
[Remote repository]チェックボックスまたは[Local repository]チェックボックスにチェックを入力する。<br>
次に、[Repository URL:]または[Local Directory:]を以下のようにして選択する。<br>
 # Remote repository
 https://github.com/xxxxx/yyyyy
 または
 ssh://<ユーザ名>@<ホスト名またはIPアドレス>:<ポート番号>/path/to/repository
 など
 
 # Local repository
 /home/ユーザ名/xxxxx/yyyyy
 ~/xxxxx/yyyyy
 または
 C:\xxxxx\yyyyy
 など
<br>
===== コミット =====
コミットするファイルを上図の[Files]項目から選択して、タスクメニューの[Commit]ボタンを押下する。<br>
[Commit]画面が表示されるのでコミットメッセージを入力して、[Commit]ボタンを押下する。<br>
即座にリモート先に反映する場合は、[Commit & Push]ボタンを押下する。<br>
<br>
===== プル =====
リモートリポジトリに変更がある場合、その変更をローカルリポジトリに反映する場合は、タスクメニューの[Pull]ボタンを押下する。<br>
または、メニューバー[Remote] - [Pull...]を選択する。<br>
[Pull]画面が表示されるので、[Fetch from:]項目にプルするブランチを入力して、[Pull]ボタンを押下する。<br>
<br>
===== ブランチの追加 =====
新たなブランチをHEADに追加する場合は、メニューバーにある[Branch] - [Add Branch...]を選択する。<br>
[Add Branch]画面が表示されるので、[Branch:]項目にブランチ名を入力して、[Add Branch]ボタンを押下する。<br>
<br>
===== ブランチの切り替え =====
ブランチをチェックアウト(切り替え)する場合は、メイン画面左下にある[Branches]で、チェックアウトするブランチを選択してダブルクリックする。<br>
[Checkout Branch]メッセージが表示されるので、[Checkout]ボタンを押下する。<br>
<br>
===== マージ =====
developブランチの内容をmasterにマージする場合、masterをチェックアウトして以下の操作を行う。<br>
# SmartGitのタスクメニュー[Merge]ボタンを押下する。<br>developブランチのコミットが表示されていない場合は、メニューバー[Branches]ボタンを押下して、ローカルにあるブランチを全て表示させるようにチェックを入力する。<br>
# 次に、masterブランチよりもコミットが進んでいるdevelopブランチをmasterにマージする。<br>対象のコミットを選択して、[Create Merge-Commit]ボタンを押下する。<br>
<br>
===== コミットログの確認 =====
以前のコミットやマージを確認、または、プログラムが正常に動作しなくなった場合は以前のコミットを参照してどこを変更したか等を参照することができる。<br>
コミットログの確認は、メイン画面右上にある[Log]ボタンを押下する。<br>
<br>
ここでは、過去のコミットに戻すこともできるが、頻繁に戻すことはないので省略する。<br>
<br><br>

== SmartGitの設定 ==
SmartGitのメニューバー[Edit] - [Preferences] - [Tools]にて、Diffツールを設定することができる。(Kdiff3等を設定するとよい)<br>
また、ファイラ、ターミナルにおいても、詳細な設定ができる。<br>
<br><br>

== SmartGitの使用方法 ==
SmartGitの全メニューを記載する。<br>
<br>
===== Repository =====
* Add or Create
*: 新規または既存リポジトリを追加する。
<br>
* Clone
*: リモートリポジトリまたはローカルリポジトリを複製する。
<br>
* Close
*: 開いているリポジトリを閉じる。
<br>
* Add Group
*: リポジトリグループを作成する。(Visual Studioのソリューションのようなもの)
<br>
* Settings
*: リポジトリを設定する。
<br>
* Exit
*: SmartGitを終了する。
<br> 
===== Edit =====
* Filter Files
*: Filesに表示するファイルのフィルタリングができる。(*によるワイルドカード指定が可能)
<br>
* Select Commitable Files
*: 選択中フォルダ内で、コミット可能なファイルをすべて選択する。
*: 編集中のファイルが無ければ、何もしない。
<br>
* Select Directory
*: ファイルを選択しているとき、その親ディレクトリを選択する。
<br>
* Copy Name
*: 作成中
<br>
* Copy Path
*: 作成中
<br>
* Copy Relative Path
*: 作成中
<br>
* Copy Message
*: 作成中
<br>
* Copy ID
*: 作成中
<br>
* Clear Output
*: Outputビューの内容をクリアする。
<br>
* Customize
*: ショートカットキーおよびツールバーのアイコンをカスタマイズする。
<br>
* Preferences
*: SmartGitの設定を行う。
<br>
===== Remote =====
* Pull
*: リポジトリからPullまたはFetchする。
*: Pullはfetch + mergeだが、普通にマージするかrebaseするか選択できる。
<br>
* Synchronize
*: ローカルファイルのPushおよびリモートリポジトリからのPullを一括して行う。
<br>
* Push
*: 現在のブランチをリモートリポジトリにPushする。
<br>
* Push To
*: 特定のブランチ／ポイントのPushや、Force Pushを行う。
<br>
* Add
*: リモートリポジトリを追加する。
<br>
* Fetch More
*: リモートリポジトリからFetchを行う。
<br>
* Rename
*: 作成中
<br>
* Delete
*: 作成中
<br>
* Submodule
*: 作成中
<br>
* Properties
*: リモートリポジトリのURLを変更する。
<br>
===== Local =====
* Stage
*: 選択したフォルダ内で、未ステージ状態のファイルをステージに上げる。
<br>
* Unstage
*: Stageの逆。
<br>
* Index Editor
*: ファイル選択時、Index Editorを表示する。
<br>
* Ignore
*: 作成中
<br>
* Rename
*: 作成中
<br>
* Toggle 'Assume Changed'
*: ファイルの'assume-unchaned'フラグを反転(トグル)する。このフラグは、そのファイルを無視したい時に使用する。
*: もし、ローカルでファイルが変更されていても、それは無視される。
*: 例えば、リモートリポジトリからPullした時、ローカルファイルの変更内容が上書きされることを意味する。
<br>
* Toggle 'Skip Worktree'
*: ファイルの'skip-worktree'フラグを反転(トグル)する。このフラグは、そのファイルを無視したい時に使用する。
*: もし、ローカルでファイルが変更されていれば、それは無視されない。
<br>
* Resolve
*: Conflictが発生した時、それを解消する。
<br>
* Commit
*: リポジトリにCommitを行う。
*: 直前のコミットを取り消して、今回のコミットで上書きすることもできる。
<br>
* Undo Last Commit
*: 作成中
<br>
* Edit Last Commit Message
*: 作成中
<br>
* Discard
*: ローカルで変更した内容を破棄して、HEADまたはIndexの状態まで戻す。
<br>
* HEAD
*: リポジトリの内容まで全て戻す。
<br>
* Index
*: ローカルでaddしたファイルはそのままで、リポジトリにあるファイルの変更分のみ戻す。
<br>
* Remove
*: 対象のファイルをトラック対象から外す。
<br>
* Delete
*: 対象のファイルをローカルシステムから削除する。
<br>
* Reset
*: git resetを行う。
*: 通常、ローカルで変更した内容を戻す時はresetを使用するが、
*: SmartGitでは前述したようにDiscardコマンドがあるので、こちらのResetはもっと特殊な用途で使用する。
<br>
* Squash Commits
*: ローカルリポジトリ上での複数のコミットを1つにまとめる。
*: <br>
*: まず、Outgoingビュー上で複数のコミットを選択する。(Outgoingビューは、まだリモートにPushしていないコミットの一覧を表示する)
*: ここで、メニューからSquash Commitsを選択すると、コミットメッセージを入力するダイアログが表示されるので、メッセージを入力してSquash Commitsする。
*: すると、その複数のコミットが1つにまとめられる。
*: <br>
*: 条件として、選択する複数のコミットは連続したコミットである必要がある。
*: つまり、A -> B -> Cというコミットが存在する場合、AとCを選択してSquashすることはできない。
*: <br>
*: Squash Commitsを使えば、ローカルでこまめにコミットしていても、リモートにPushする前にそのコミットを1つにまとめれば、
*: 最終的に残るコミットが1つになるので、見やすいコミット履歴を保つことができる。
<br>
* Save Stash
*: 現在の状態をStashとして保存した後、HEADの状態までrevertする。
*: Stashした内容は、BranchesビューのStashesから確認できる。
** Stashメッセージ
** untracked fileを含めるか
** Stash後、revertをしないでそのままにするか
<br>
* Apply Stash
*: 保存されたStashの状態まで戻す。
*: その後、Stashを破棄するかそのまま残すか選択できる。
<br>
* Drop Stash
*: Stashを破棄する。
<br>
* Clean Up
*: 作成中
<br>
===== Branch =====
* Git-Flow
*: 作成中
* Check Out
*: 作成中
* Merge
*: 作成中
* Cherry-Pick
*: 作成中
* Revert
*: Revert処理を行う。
*: Revertとは、特定のコミットで行われた全ての変更を元に戻す新しいコミットを生成して、それを現在のブランチに適用するコマンドである。
*: A -> B -> C -> D
*: 上記のようなコミットの履歴がある場合、Dコミットで行った変更を取り消したい場合があるとする。
*: この時、取り消す対象となるコミットを選択して、Revertコマンドを実行すると、以下のコミット履歴となる。
*: D'コミットは、Dコミットの内容を完全に打ち消しているので、D'コミットの内容はCコミットと同じ内容となる。
*: A -> B -> C -> D -> D'
* Rebase
*: Rebase処理を行う。
** Rebase HEAD to
**: 現在のブランチの最新コミット(関連コミットも含む)を、選択したコミットに適用する。
** Rebase to HEAD
**: 選択したコミット(関連コミットも含む)の内容を、現在のブランチの先端に適用する。
* Add Branch
*: 新たなブランチを作成する。
* Add Tag
*: 現在のブランチにタグを作成する。
* Rename
*: 作成中
* Delete
*: 作成中
* Set Tracked Branch
*: 現在のブランチに、追跡ブランチを設定する。
*: 通常は、リモートブランチをローカルにチェックアウトする時に、自動的に追跡ブランチが作成されるが、ここでは手動で追跡ブランチを設定できる。
* Stop Tracking
*: 追跡ブランチを解除する。
<br>
===== Query =====
* Open
*: 選択しているディレクトリやファイルを開く。
* Show Changes
*: 選択したファイルのHEADからの変更内容を表示する。
* Conflict Solver
*: ファイルの衝突を解消するウィンドウを開く。
* Log
*: 選択したファイルのGitログを表示する。
*: ブランチを選択している場合、ルートディレクトリのGitログを表示する。
* Blame
*: 選択したファイルのBlameを表示する。
*: Blameとは、ファイルの各行がどのコミットで変更されたのかを一覧で表示するものである。
*: これは、バグ混入の時期や犯人を探すのが主な目的である。
<br>
===== Changes =====
* Reload
*: 作成中
* Undo
*: 作成中
* HEAD vs. Index
*: HEADとIndexの内容を比較する。
* Index vs. Working Tree
*: Indexとワーキングツリーの内容を比較する。
* Previous Change
*: 前の変更を表示する。
* Next Change
*: 次の変更を表示する。
* Ignore Whitespace for Line Comparison
*: 空白を無視して比較する。
* Ignore Case Change for Line Comparison
*: 大小文字の違いを無視して比較する。
* Settings
*: 比較モードの詳細を設定する。
<br>
===== Tools =====
* Open File
*: 作成中
* Open in Explorer
*: 作成中
* Open in Terminal
*: 作成中
* Reveal in Explorer
*: 作成中
* Open Git-Shell
*: 作成中
* Set Excutable Tag
*: 作成中
* Unset Excutable Tag
*: 作成中
* Apply Patch
*: 作成中
<br>
===== Window =====
* Repositories
*: Gitリポジトリを管理するウィンドウである。
*: 複数のリポジトリを管理できるが、カレントリポジトリは常に1つだけ選択される。
*: また、EclipseのWorking Setsのように、複数のリポジトリをグルーピングして管理できる。
* Branches
*: カレントリポジトリの全ブランチを表示する。その他にも、以下のものが表示される。
*: ウィンドウ内では、ブランチ名のインクリメンタルサーチが可能である。大量のブランチを扱う時、この機能が大変便利である。
** ローカルブランチ一覧
** リモートブランチ一覧
** タグ一覧
** Stash一覧
* Files
*: Repositoriesで選択したディレクトリ内にあるファイルから、フィルタリングした結果をリストアップするビューである。
* nnn files hidden
*: フィルタリングされて非表示になっているファイル数を表示する。
* File Filter
*: フィルタリングする文字列を指定する。
*: 通常は、*等でワイルドカードが指定可能であるが、正規表現での指定もできる。
*: また、指定した文字列はパターンとして保存することができる。
* Files from Subdirectories
*: Repositoriesで選択したフォルダのサブフォルダまで全て表示対象とする。(初期設定では無効化されている)
* Show Unchanged Files
*: 変更が無いファイルも表示対象とする。(初期設定では無効化されている)
* Show Unversioned Files
*: バージョン管理されていないファイル(例えば、新規作成ファイル等)も表示対象とする。(初期設定では有効化されている)
* Show Staged Files
*: ステージに上がっているファイルを表示対象とする。(初期設定では有効化されている)
* Show Ignored/Skipped Files
*: .gitignoreファイルによって無視されたファイルも表示対象とする。(初期設定では無効化されている)
* Show Assume Unchanged Files
*: 'assume-unchaned'フラグが付与されたファイルも表示対象とする。
*: このフラグは、Gitで管理されているが一時的にそのファイルを無視したい時に使用する。(初期設定では無効化されている)
<br><br>

__FORCETOC__
[[カテゴリ:Git]]