IGGG Note

Netlify CMS を導入しました

2017-11-14T00:00:00+00:00

これはテスト投稿なので，後でちゃんと書きます！

GitHubのすゝめ

2017-06-19T03:00:00+00:00

GitHub をはじめよう

GitHub はいいぞ。

ということで、GitHub と、ついでに Git について簡単に紹介します。
とはいうものの、一から全部説明してはすごい文量になるので、ある程度(ほとんど)は解説記事へのリンクすることで説明を省きます。

GitHub is 何 ?

GitHub とは，後述するバージョン管理システム Git のためのホスティング Web サービスである。
自分のソースコード群(リポジトリ)を Web 上にアップロードして、公開・管理などができるようになる。
同種のサービスに、Bitbucket や GitLab.com がある。

(個人的な意見だが、GitHub はもはやプログラマにとっての名刺代わりになりつつあると思うので、是非アカウントを作って有効活用してほしい。)

お金は？

Git ではソースコードを含むバージョン管理したいデータ群を リポジトリ と言う。
GitHub のようなホスティングサービスでは、リポジトリは外部へ公開するパブリックリポジトリと公開しないプライベートリポジトリの2種類ある。
そして、GitHub の場合は パブリックリポジトリだけなら無料でいくつでも作ることが出来る。

参照 : Pricing - Git hosting software and tools

プライベートリポジトリを使いたい場合は、月額7ドル(800円弱)払う必要がある。
正直なところ、前述した Bitbucket や GitLab であれば、プライベートリポジトリでさえも無料なため、金銭的にはそれらの方が優れている。
しかし、多くの OSS(オープンソースソフトウェア) が GitHub で管理されており、多くのエンジニアが利用しているため、最低限パブリックリポジトリは GitHub の方がいいだろう。

学生であれば…!

2つもアカウント作るのめんどくさいな、と思っても大丈夫！
なんと GitHub には GitHub Education というものが存在し、これに申請することで学生(大学生・大学院生を含む)であればプライベートリポジトリを無料で作れるようになる(他にも特典はある)。

参照 : Learn to Code with GitHub - GitHub Education

一度申請すると、2年間有効になり、2年後もまだ学生であれば再度申請できる(らしい)。

ちなみに、弊サークルも、コレの組織アカウント版で申請している。

Git is 何 ?

Git とは(リーナス様)が作った、バージョン管理システムである。
バージョン管理システムとは、名前の通り、ソースコードを含むデータのバージョンを管理するためのプログラムである。

ソースコードや Word のテキストをコピーして前の状態(バージョン)を管理した経験はあるだろうか？
それらの(泥臭い)作業を、うまいこと管理できるようなコマンド群が Git である。

詳しくは以下の資料を参考にすると良い。

また、もっと詳しくなりたい場合は「実用 Git」とという本を読むと良いだろう。

コマンドをたたくのには慣れて欲しいが、苦手な人はまず SourceTree という GUI の Git クライアントを使ってみると良いだろう。
少し古いが以下の記事が参考になる。

Gitを視覚的に操作できる「SourceTree」のインストール方法

GitHub に登録

どうやって GitHub に登録するか。

ココからアカウントを作成できる。

よくある Webサービスと同じで、必要なのは email アドレスだけ。
Username は後から変えれない、ユーザーの識別子になる。

直感的な操作でアカウントの作成はできると思うが、不安なら以下を参照してください。

GitHubアカウント作成とリポジトリの作成手順 - Qiita

ちなみに、ここで email アドレスに大学から支給されてるアドレスを使うと、後述する GitHub Education の申請が多少楽になる。
もちろん、ほんのちょっとの手間でなんとでもなるので、好きなアドレスを使えばよい。

GitHub Education の申請

以下の記事を参考に進めてください。

無料でGitHubのprivateリポジトリを作る方法 - Qiita

まぁまぁ古いので齟齬があるかもしれない。

肝になるのは、学生であることの証明。
証明するためには大学から支給されてる email アドレス(ac.jp などで終わるやつ)が必要である。
前述したとおり、そのアドレスで GitHub アカウントを登録していれば、特別なことをしなくても良い。
もし、別のアドレスで登録した場合は、ココから大学のアドレスを追加してください。

ちなみに

個人アカウントを作成すると5つのprivateリポジトリを作成できるPlanに加入することになり、利用期限は2年間となります。

とあるが、2016/5/11 に料金プランの変更があり、これによってプライベートリポジトリを無制限に作れるようになっている。

参照 : Introducing unlimited private repositories · GitHub

更に詳しく

使い方とかは以下を参考にしてください(丸投げ)。

正直、最初っから上記のリンクに飛ばしても良かった(笑)

おしまい

あと、2段階認証をしといた方がいいと思うよ。
それと、GitHub アカウント作って、Slack に投げてくれれば、弊サークルの組織アカウントのメンバーに招待するよ。

イベント紹介

2017-05-20T06:45:00+00:00

イベント紹介(新入生)

新入生用の活動(イベント)紹介です．
- もっと活動の詳細が知りたい方は，slack等で聞いてください．
- ここに載ってない活動もあると思いますので，そのような場合もslack等で聞いてください．
- もしかしたら，こちらとかこちらを見ると，活動の詳細がわかるかも…？

1. Meetup

年に数回，土曜 or 日曜に一日かけて開催される「定期学習報告会」です．
- IGGGの活動(イベント)の中でも代表的な活動(イベント)です．
自分たちが今までやってきたこと＆勉強してきたこと等を発表するためのイベントです．
- 勿論，発表はしなくても全く問題ありません．
大学以外の外部の方の参加が可能なので，外部の方と交流することも出来ます．
過去ののMEETUPはこんな感じだったりこんな感じだったりします．
参加登録はconnpassと呼ばれるサービスで行います．
slackのチャンネル名 … meetup

2.Briefing

年に数回，平日の放課後に開催される「不定期学習報告会」です．
- 大体二～三時間くらいで終わります．
Meetupのとてもゆるいバージョンです．
- 自己紹介とかだけで終わってもかまわないし，発表も2～3分くらいで終わる場合があったりします．
過去ののBriefingはこんな感じだったりこんな感じだったりします．
参加登録はWikiのページで行います．
slackのチャンネル名 … briefing

3.群桐祭(テクノドリームツアー)

年に一回(例年なら10月)開催される，群大の桐生キャンパスの文化祭です．
IGGGではテクノドリームツアーで，自分たちの作成したソフトウェア等を展示しています．
- 展示したソフトウェアを子供たちに遊んでもらったりしています．
過去の群桐祭(テクノドリームツアー)はこんな感じだったりこんな感じだったりします．
- 去年の群桐祭の時のIGGGのHPはここで見れます．
slackのチャンネル名 … guntoh-fes

4.ジャンク祭り(ゴミックマーケット，ゴミケ)

年に一回(例年なら六月)開催される，粗大ごみ(廃品)回収の日のことです．
- 様々な研究室から数世代前の計算機、パーツ等のジャンク品から、化石のようなものが捨てられる日です．
- 一部界隈からは「ゴミックマーケット」とも呼ばれています
捨てられたものの中には再利用できそうな機器があるので，そいつらをIGGG部室に持ち帰って再利用するというのが毎年のお約束となっています．
過去のジャンク祭りはこんな感じだったりこんな感じだったりします．
slackのチャンネル名 … gomike

5.コミックマーケット(コミケ)

あの有名な同人誌即売会です．
「IGGGの部誌を作ってコミケで販売しよう！」という趣旨から参加し始めました．
過去のコミックマーケットはこんな感じだったりこんな感じだったりします．
毎年，slackで執筆者を募っています．是非投稿しましょう！
過去の部誌はここで見れます
slackのチャンネル名 … comiket

IGGG Note の使い方

2017-05-19T13:01:14+00:00

IGGG Note にようこそ！

この記事はこのサイトの部員向けの説明記事です。

IGGG Note は何に使うべきか

基本的には部内向け、特に初心者向けの(頑張って調べればわかるような)簡単な記事を作成してください。
ただ、部内向けと言っても公開されています。
その点は気を付けて書いてください。

記事を書くために必要なこと

IGGG Note は GitHub のパブリックリポジトリで管理されているので、GitHub のアカウントが最低限必要です。

GitHub のアカウントを作るには、公式サイトにアクセスして、Sign Up 押して必要なことがら(希望のアカウントやメールアドレスなど)を入力すればできるはずです。

記事を書く

記事を書くには2つの方法があります。

リポジトリをクローンしてローカル環境で書く方法
GitHub Web UI を使って GitHub の Web サイトから直接書く方法

どのような記事を書くべきかは、README に少し書いてある。

1. リポジトリをクローンしてローカル環境で書く

前者の場合、ある程度 Git が分かる前提で書きます。

リポジトリをクローン
- リポジトリの書き込み権限が無い場合は slack で声をかけるか
- フォークしてから行う
staging ブランチから新しくブランチを作成
- ブランチ名は post/kiji-no-namae
/_post/ 以下に記事のマークダウンファイルを作成
- ファイル名は YYYY-MM-DD-kiji-no-namae.markdown にしてください
- ヘッダーについては後述するが既にあるマークダウンを参照すればわかるかな
記事をマークダウン形式で書く
記事が書けたらコミットしてプッシュ
プルリクエストを作成する
- base ブランチは staging にすること
IGGG部員に見てもらって、誤字などの問題が無ければマージする
ステージング環境にアクセスして確認する
- slack の github-pages チャネルの topic 参照
- 反映されるには少し時間がかかる
問題が無ければ master ブランチへのプルリクを作成
- 問題があれば 4 に戻る
7.同様に確認してもらったらマージして完成

2. GitHub Web UI を使って GitHub の Web サイトから直接書く

少し丁寧に書く

0. リポジトリにアクセスる

ココ

1. 新しいブランチを作る

ブランチを staging にします(ココにアクセスでもいい)。
そしたら、branch のボタンを押して新しいブランチ名を入力して、新しいブランチを作る。
このとき名前は post/kiji-no-namae のように post/ 以下にする。

2. 記事を書く

/_post ディレクトリに移動し、Create new file をクリックして記事用のファイルを作成する。

そしたら、Web エディタが開くので、マークダウン形式で記事を書く。
このとき、ファイル名は YYYY-MM-DD-kiji-no-namae.markdown としてください(拡張子は .md でもいいはず)。

そしたら、このページの下の方に行き、コミットする。

ちなみに、コミットした後に編集したい場合は、_post/ 以下の編集したいファイルをクリックして、鉛筆のマークを押す。
そしたら、前と同じようにエディタが開くので編集する。

既にあるマークダウンを参考にしながら書いてほしい。
ヘッダーについては後述する。

3. staging にプルリクエストを作る

記事が書けたらプルリクエストを作る。

リポジトリのページの Pull request と書かれたタブを押し、右側の New pull request を押す。

ブランチ名に注意してください。

base ブランチ(左)には IGGG/iggg-note の staging ブランチ
compare ブランチ(右)には IGGG/iggg-note の自分が作成したブランチ

プルリクのタイトルには記事のタイトルでも書いて(正直なんでもいい)、下の Create pull request を押す。

そしたら、IGGG部員の何人かに見てもらって、問題が無ければマージします(IGGGの誰かが)。

問題があった場合は、再度編集しなおしてください(プルリクを作る必要は基本的に無い)。

マージされるとステージング環境に反映されます(少し時間がかかる)。
slack の github-pages チャネルの topic 参照するとステージング環境の URL が分かるはずです。

4. master にプルリクエストを作る

ステージング環境に問題が無ければ、今度は master ブランチへのプルリクを作る。
ちなみに、問題があったら、3の編集からやり直してください(ファイルを作り直す必要は無いが、プルリクは作り直す)、

プルリクの作り方は 3. と同じである(ブランチ名だけ気を付けて)。

問題が無ければ 3. 同様にマージするので、それで完成。

3. ちなみに….

このボタンを押すと…

新しいファイルを作るページに飛ぶ

ので、2-2 を行う。
ただ、まだブランチを作ってないので

赤い部分を設定して、ブランチを作ってコミットするようにする。

ヘッダーについて

以下の形式

---
layout: post
title:  IGGG Note の使い方
date:   2017-05-19 22:01:14 +0900
tags: introduction
author: matsubara0507
---

layout: 基本的に post と書いておいて
- Jekyll のビルドの設定だから
title: 記事のタイトル
date: 書いた日付
- 厳密である必要は無い
tags: 記事のタグ
- 空白区切りで複数選択できる
author: 記事を書いたひとの GitHub アカウント名

Q&A

その他、書き方について。
随時、追記していく。

さらに質問があれば slack で聞くか、Issue を立ててください。

画像を使うには？？

画像は /images/ 以下にマークダウンと同じ名前のディレクトリを作って、その中に置いてください。
たとえば、2017-05-19-kiji-no-namae.markdown というファイル名で記事を書いた場合には、 /images/kiji-no-namae/hoge.jpg という感じに画像を置く。

方法1の場合は普通にコミットすればよい。
が、方法2の場合は、少し手間である。
画像をアップロードすることは可能だが、新しくディレクトリを作ることができない。

なので、どうしても方法2で画像を使いたい場合は、Create new file /images/kiji-no-namae/blank みたいな一時的なファイルを作成(作成時にファイル名に / を含ませるとディレクトリができる)し、それから画像をアップロードする。

アップロードは、Upload files というボタンを押せばよい。

おしまい

みんなつかってくれるといいなぁ。

テスト

2017-05-17T01:01:14+00:00

Hello IGGG !!

テストぺーじです！

Theme preview

2017-05-10T11:01:14+00:00

Hello Jekyll!

You’ll find this post in your _posts directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run jekyll serve, which launches a web server and auto-regenerates your site when a file is updated.

To add new posts, simply add a file in the _posts directory that follows the convention YYYY-MM-DD-name-of-post.ext and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.

Jekyll also offers powerful support for code snippets:

def print_hi(name)
  puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.

Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.