最近、ちょっとしたプログラミングコードの断片をクラウドに保存するなら、GitHub Gistが便利と今更ながらに気づきました。
Gistは、こんな感じのコードスニペットをGitHub上で保管することが出来るサービスです。
こういった短いコードでも、バージョン管理できますし、保管しているコードを公開し、ブログなどに埋め込んで見てもらうこともできます(プライベートで保管も可能)。
ただ、Gistは非常に便利なんですが、わざわざブラウザを開いて、コードの保管作業するのは、いささか面倒でした。
なので「普段使っているSublime Textから手軽に投稿できるパッケージはないだろうか…」と探してみたら、そのものズバリのパッケージ「Gist」がありました。
以下では、このパッケージを利用して、Gist上に手軽にコードをアップする方法を説明したいと思います。
目次
主な手順
Sublime TextからGistを利用するのに必要な主な手順はこちらになります。
- Sublime TextにGistパッケージをインストール
- GitHubでGist操作用のトークンを取得
- Gistパッケージにトークンを登録
- GistパッケージからGitHub Gistにコード作成
個人的には、「かなり面倒な設定が必要なんじゃないか?」と思っていましたが、結構簡単にできました。
普段、Sublime Textを利用していて、GitHubにもアカウントを持っている場合は、数分で終わる作業かと思います。
Sublime TextにGistパッケージをインストール
とその前に、Sublime Textの初期設定方法はこちら。
まずは、Sublime Textにパッケージをインストールします。
パッケージをインストールするには、「Preferences」から「Package Control」を開きます。
すると、以下のような画面が表示されるので「Install Package」を選択してください
表示される入力欄に「gist」と入力すると、Gistパッケージが表示されるので選択してインストールします。
これでパッケージのインストールは完了です。
GitHubでGist操作用のトークンを取得
次は、GitHubからGistを操作するためのトークンを取得します。
GitHubアカウントを持っていない場合は、作成する必要があります。
GitHubでトークンを作成するには、GitHubにログインした状態でPersonal access tokensを開きます。
すると、以下のような画面が表示されるので「Generate new token」ボタンを押します。
すると「New personal access token」という画面が表示されるので「Token description」にトークンの説明を入力します。
トークンのスコープ(範囲)である「Select scopes」では、「gist」のみ選択します。
最後に「Generate token」ボタンを押して設定を保存します。
そうすると、GitHubアクセストークンが出力されるので、コピーしておいてください。
Gistパッケージにトークンを登録
次に、Sublime Text側でGistパッケージにトークンを設定します。
設定を開くには「Package Settings→Gist→Settings – User」を開きます。
あとは、ユーザー設定ファイルに以下のように入力して、設定ファイルを保存してください。
{ // あなたのGitHub APIトークン // こちらから取得: https://github.com/condemil/Gist#generating-access-token "token": "取得したトークン", }
GistパッケージからGitHub Gistにコード作成
ここまできたら、あとはSublime TextからGistパッケージを用いてコードを投稿するだけです。
まずは、Sublime Textで新しいファイルを作成し、ファイル名を付けて保存してください。
ファイルを作成したら次はコードを入力します。
全ての入力を終えたら保存します。
Gistパッケージで公開
そして、Gistパッケージで公開作業を行います。
Gistへポストするには、「Tools→Gist→Create Public Gist」を選択します。
すると、Sublime Text下部に「Gist Description」という入力欄が表示されるので、説明文を入力しエンターキーを押してください。
次にファイル名の入力です。特に変更する必要もないと思うのでそのままエンターキーを押してください。
するとこれだけで、Gist上にコードがストックされます。
かなり簡単。
動作確認
あとはGitHub Gistを開いてコードが登録されているかを確認します。
問題なく登録されていました。
個別コード画面では、こんな感じで表示されます。
Gistでは、埋め込み機能も利用できます。
これを用いてWordpressに貼り付けると、こんな感じで表示されます。
まとめ
こんな感じで、Sublime TextからいつでもGistにコードの断片を保管できる環境を作っておくことができます。
このようにすることで、コーディングの最中に「このコードは備忘録として残しておきたい」なんてときに、大した労力をかけずにクラウドに保管しておくことができるようになります。
しかも、GitHub上で一元管理され、その上バージョン管理までできて公開もできるので、仲間内でコードの共有も手軽になるかと思います(※GitHubに上げて問題のないコードの場合)。
というわけで「コードの使い方をすぐ忘れるので、メモを手軽に残したい」とか「保管したカンニングペーパーを広く共有したい」なんて時には、良いかと思います。