-
Notifications
You must be signed in to change notification settings - Fork 1
/
beginner-ja.html
92 lines (89 loc) · 5.07 KB
/
beginner-ja.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>はぢめての Vimpr</title>
<link rel="stylesheet" type="text/css" href="index.css">
</head>
<body>
<div id="contents">
<h1>はぢめての Vimpr</h1>
<h2>このドキュメントの目的</h2>
<p>このドキュメントでは「Vimpr に参加したいけどどうすればいいのか、さっぱりわかんない」という人や「github って何？」「リポジトリに push するの、ハジメテなの <span class="warn">♥</span>」という人が、Vimpr に参加するのに必要な手順を箇条書きにしています。</p>
<p>なお、以下の説明は Linux を前提に書かれているので、他の OS を利用されている方は適宜読みかえてください。</p>
<h2>とりあえず push できるようになりましょう</h2>
<p>とりあえず Vimpr のリポジトリに push できるようになるまでの初歩的な手順を以下に箇条書きにします。Vimperator plugin を書く能力はすでにあるものとします。</p>
<p>また、以下の説明では "vimpr" ディレクトリ以下にデフォルトの名称でローカル・リポジトリを作成するものとします。これらを変更する場合は適宜読みかえてください。</p>
<ol style="line-height:1.5em;">
<li>github のアカウントを作成する
<ol>
<li>github のアカウントを取得しましょう。無料プランで充分です。</li>
<li>SSH 公開鍵をつくって github に登録しましょう。</li>
</ol>
</li>
<li>コミット権限の取得
<ol>
<li><a href="http://vimpr.github.com/contactlist-ja.html">組織オーナー</a>にコミット権限を要求します。</li>
</ol>
<li>ローカル・リポジトリの作成
<ol>
<li>console を開きます。</li>
<li>"mkdir vimpr" を実行します。</li>
<li>"cd vimpr" を実行します。</li>
<li>"git clone git@github.com:vimpr/vimperator-plugins.git" を実行します。</li>
<li>SSH 公開鍵を作成する時に設定したパスワードを入力します。</li>
<li>"cd vimperator-plugins" を実行します。</li>
<li>"git pull --rebase" を実行します。</li>
</ol>
</li>
<li>作業する
<ol>
<li>"git checkout -b topic_branch_name" を実行します。</li>
<li>作成した topic branch 上で作業をします。</li>
</ol>
</li>
<li>gitpub 上のリポジトリへの push
<ol>
<li>"git checkout master" を実行します。</li>
<li>"git pull --rebase" を実行します。</li>
<li>"git rebase master topic_branch_name" を実行します。</li>
<li>"git checkout master" を実行します。</li>
<li>"git merge topic_branch_name" を実行します。</li>
<li>"git push" を実行します。<span class="warn">--force オプションは絶対に使ってはいけません</span>。</li>
<li>SSH 公開鍵を作成する時に設定したパスワードを入力します。</li>
</ol>
</li>
<li>後始末
<ol>
<li>"git branch -d topic_branch_name" を実行します。</li>
</ol>
</li>
</ol>
<p>以上で github への登録から github 上のリポジトリに push できるまでの手順の解説は終りです。</p>
<h2>注意事項</h2>
<ul style="line-height:1.5em;">
<li>github 上の branch は fast-forward にすることを厳守してください</li>
<li>繰り返しますが push 時にエラーが発生する場合、<span class="warn">"git push -force" は絶対にやってはいけません。github 上のリポジトリが壊れます。</li>
</ul>
<h2>参考資料</h2>
<dl style="line-height:1.5em;">
<dt class="dt-title">github</dt>
<dd>
<ul>
<li><a href="https://github.com/" class="external">github</a></li>
<li><a href="http://design1.chu.jp/setucocms-pjt/?p=580" class="external">初心者Git日記その五～GitHubにSSH公開鍵登録～</a></li>
</ul>
</dd>
<dt class="dt-title">git</dt>
<dd>
<ul>
<li><a href="git-ja.html">Vimpr でよく使うと思われる git コマンド</a></li>
<li>junio こと git メンテナー<a href="http://www.amazon.co.jp/dp/4798023809" class="external">濱野純さんの入門Git</a> : 超オススメ</li>
<li><a href="http://progit.org/" class="external">Pro Git</a> : Top Page 最下部に各国語訳へのリンクがある</li>
</ul>
</dd>
</dl>
<a href="index.html">to Top Page</a>
</div>
</body>
</html>