\r\n\r\n
ライティングプロジェクトを管理・保存する方法はたくさんあります。クラウドストレージサービス(Dropboxなど)やオンラインエディター(googledocsなど)を好む人もいれば、デスクトップアプリケーション(microsoftwordなど)を使う人もいます。私はGitHubというものを使っています。
Gitは、文書の変更を記録するのに有効なツールで、GitHubに超高速でアップロードすることも可能です。また、自分の作品を第二、第三のデバイスにダウンロードすることも、素早く簡単にできます。
GitHubは、オープンソースコードを保存・管理するための、世界で最も人気のある場所です。執筆のためのホストとして、とんでもない場所に思えるかもしれませんが、そんなことはありません!結局のところ、コードはあなたの記事、物語、エッセイと同じように、テキストの行に続く行に過ぎないのです。
2013年頃、GitHubはコードだけでなく、あらゆる情報のリポジトリを作成することを奨励し始めました。 GitHubはコーディングのルーツから離れることはありませんでしたが、一部の人々は今でも執筆やその他の非コーディング・プロジェクトの保存に使用しています。例えば、ある人はGitとGitHubを使って教則本を書き、ある人は小説を書く。Googleをブラウズしていると、GitHubのクレイジーな使い方がいろいろと見つかるでしょう。
Gitは、Linuxのリーナス・トーバルズによって作られたオープンソースのプログラムで、文書の変更点を追跡し、複数の人が同じ文書に対して遠隔で作業することを容易にするものです。技術的には分散バージョン管理システム(または分散VCS)として知られているGitは、一定間隔で任意のバージョンのドキュメントを保存することはありません。その代わり、指示されたときだけドキュメントに変更を加えることができます。
ドキュメントは、リポジトリ(またはレポ)を形成します。これは、プロジェクトフォルダーの単なる空想上の用語です。例えば、WindowsのDocumentsフォルダをGitで管理する場合(でも、そんなことはしないでください)、それはリポジトリになります。
Gitでドキュメントへの変更を保存するとき、それは「コミット」と呼ばれ、コミットは単にあなたがドキュメントに行った最も最近の変更の記録です。各コミットには、数字と文字からなる長い文字列がIDとして割り当てられる。
過去のコミットをIDで呼び出すと、Wordの文書履歴のように項目全体が表示されなくなります。コミット時の最新の変更点のみ表示されます。ただし、プロジェクト全体が記録されないということではありません。プロジェクトフォルダからすべての投稿を削除しても、いくつかのgitコマンドで最新版を取得することができます。1週間前、半年前にさかのぼって、プロジェクトがどのようなものであったかを確認することもできます。
また、各コミットにはメッセージを入れることができ、とても便利です。例えば、何かを書いたが、それを残しておくかどうかわからない場合、単にコミットを実行すればよい。このセクションは、後でプロジェクトから削除されたとしても、コミット履歴に残ります。
Gitはコマンドライン上で最もよく動作し、これは大きな利点ですが、欠点もあります。コマンドラインでは、コミットを作成したり、変更をアップロードしたりすることができます。しかし、コミット履歴を見たい場合には、これは理想的ではありません。
そのため、多くの人がGitHubを愛用しています。GitHubは、Gitリポジトリへのウェブインタフェースを提供する人気のオンライン・サービスです。GitHubでは、過去のコミットを簡単に見ることができ、また自分が書いたコンテンツを複数のPCにダウンロードすることも可能です。
GitとGitHubを組み合わせることで、バージョン履歴をきめ細かく管理できるようになりました。現在、Windows、Mac、Linux、ChromeのOSを含む、Bashコマンドラインが実行できるPCであれば、簡単に書くことができます。
GitとGitHubは、プレーンテキストに最も適していますが、ほとんどすべてのファイルタイプにコミットして書くことができます。microsoftwordで書いても動作しますが、コマンドラインやGitHubで過去のコミットを確認することはできません。その代わり、コマンドラインで過去のコミットを呼び出してから(「チェックアウト」といいます)、Wordファイルを開く必要があります。その後、Wordファイルは元のコミットと同じように表示され、別のクイックコマンドで現在のバージョンに戻ることができます。
ファイルをテキストで保存するScrivenerを使えば、GitHubやコマンドラインでの過去のコミットも表示されるので、それでいいんです。しかし、Scrivenerは、あなたではなく、プログラムにとって重要なデータも保存しています。どのコミットでも、ジャンクが多くて読みにくいんですよね。
プレーンテキストファイルを使うのは、特に最初の数回の原稿では、それだけで言葉をつなぎ合わせることができるからです。
まずはPCから始めて、GitHubを使ったクラウドに移行していきます。
はじめに、macOSまたはLinuxにTerminalプログラムをインストールする必要があります。Windows 10を搭載したパソコンの場合、WindowsSubsystem for Linux(WSL)経由でUbuntuや他のLinuxディストリビューションをインストールする必要がありますが、これは非常に簡単です。Windows 10にLinuxBashshellをインストールする方法については、チュートリアルをご覧ください。また、古いバージョンのWindowsを使用している場合は、Cygwinを使用してbashshellを取得することができます。
ターミナルを開き、Git リポジトリとして使用するフォルダに移動します。ここでは、「ドキュメント」フォルダの中に「MyNovel」というフォルダがあると仮定します。なお、Gitレポでは単語と単語の間にスペースは入っていません。バッシュはスペースが嫌いで、スペースを扱うと混乱することがあるので、これをやっておくと生活が楽になるはずです。
次に、ターミナルでMyNovelフォルダに移動します。Windows 10でこれを行う場合、コマンドは次のようになります。
cd /mnt/c/Users/[YourUserName]/Documents/MyNovelWindows に保存されているファイルを操作する WSL コマンドは、/mnt/ を使用する必要があります。また、小文字の "c "は、今いるドライブを示していることに注意してください。ファイルが "D:/"ドライブにある場合は、/D/を使用します。
macOSやLinuxの場合は、もっとシンプルなコマンドになります。
cd ~/Documents/MyNovelここからは、注文の仕方も同じです。
ここで、MyNovel フォルダを Git リポジトリとして初期化する必要があります。このコマンドは、新しい小説を書き始めたばかりでも、すでにいくつかのファイルを保存している場合でも有効です。
git initこれで、あなたのフォルダはGitリポジトリになりました。
ls -aこのコマンドは、隠し項目を含む、現在のフォルダーのすべての内容をリストアップするようコンピューターに要求します。一番上に".git "というものが表示されているはずです(ピリオドに注意)。隠しフォルダ「.git」は、ドキュメントのバージョン履歴を保存する場所です。これを開く必要はありませんが、あるに越したことはありません。
最初のコミットを行う前に、Gitはあなたの名前とメールアドレスを知りたがっています。 Gitはこの情報を使って誰がコミットを行ったのかを特定し、その情報はコミットログに含まれます。作家は単独で行動することが多いので、実用上は重要ではありませんが、それでもGitは必要なのです。
電子メールとアドレスを設定するには、次のようにします。
git config --global user.email "[Your email]" git config --global user.name "[Your name]"それでは、最初の投稿です。
MyNovel "フォルダに "Chapter1"、"Chapter2"、"Chapter3 "という3つのドキュメントがあるとします。第3章」です。変更を保存するために、Gitにこれらのファイルを追跡させる必要があります。これを行うには、次のように入力します。
git add .period は、Git にフォルダ内のすべての追跡されていないファイル (つまり履歴を作成したいファイル) を監視するように指示します。このコマンドは、現在追跡しているファイルのうち変更があったものを準備するようGitに指示します。この作業をステージングファイルをコミットするといいます。
私たちの目的では、搭乗はそれほど重要ではありませんが、便利です。第2章と第3章に変更を加えたが、第2章の変更のみをコミットしたい場合、第2章を
git add Chapter2.docこれは、第3章ではなく第2章の変更をコミットできるようにしたいことをGitに伝えるものです。
さて、いよいよ初投稿です。
Git commit -m "This is my first commit."m "は、Gitにコミットしてメッセージを取り組むことを伝えるフラグとして知られており、引用符の間に表示されます。私はコミットメッセージを使ってワード数をマークするのが好きです。また、「このコミットには、アクメウィジェットのCEOのインタビューが含まれています」というような特別なメッセージを録音するのにも使っています。
物語であれば、"この投稿には犬が逃げるシーンが新たに加わりました "というようなメッセージを入れることもありますね。便利なメッセージは、後で投稿を見つけるのが簡単になります。
ドキュメントの管理を始めたので、次は GitHub を使って文章をクラウドに取り込みましょう。私はGitHubを、追加のバックアップ、自分のドキュメントの変更を確認できる信頼できる場所、複数のpc**で自分のものを依頼する方法として利用しています。
まず、GitHubに無料アカウントを登録します(プライベートリポジトリを作成するための有料アカウントは不要です)。ただし、プライベートレポでは最大3名までしか作業できません。5人以上のチームで記事を書く場合は、Proアカウント(本記事では月額7ドル)に登録する必要があります。
アカウントを作成したら、新しいレポを作りましょう。アカウントにログインして、https://github.com/new。
まず必要なのは、リポジトリの名前です。PC上のフォルダと同じ名前でもかまいません。リポジトリ名 "に "MyNovel "と入力します。
説明文」は任意ですが、私は好きで使っています。少年と少女と彼らの犬についての私の素晴らしい新しい小説」のようなものを入力することができます。
次に、「Private」ラジオボタンを選択し、「Initialize this repository with a README」チェックボックスはチェックしないでください。私たちはすでにコンピュータにリポジトリを持っているので、これを実行する必要はありません。今、READMEファイルを作るとしたら、もっと大変なことになりますよ。
次に、「リポジトリの作成」をクリックし、「クイックセットアップ、以前に行ったことがある場合」で、URLをコピーしてください。
https://github.com/[Your GitHub User Name]/MyNovel.gitさて、デスクトップとお気に入りのコマンドラインに戻りましょう。
初めてレポを GitHub に接続するときは、いくつかの特殊なコマンドを使う必要があります。
git remote add origin https://github.com/[Your GitHub User Name]/MyNovel.gitこれは、リモートリポジトリが "MyNovel" のソースであることを Git に伝え、URL が Git にそのリモートソースを指し示すというものです。起源」という言葉はあまり気にしないでください、単なる慣習です。もっとシンプルにするなら、Gitの最も一般的な使い方である "fluffy "と呼ぶことができます。
Gitで新しい変更をアップロードするとき、それは「プッシュ」と呼ばれます。変更をダウンロードすることを「プル」または「フェッチ」と呼びます。さて、いよいよ最初のコミットを GitHub にプッシュします。ここで、必要なことを説明します。
git push -u origin masterGitHub のユーザー名とパスワードを入力する画面が表示されます。正しい情報を入力すると、すべてがアップロードされ、準備が整います。
GitHubのアップロードをより安全に行いたい場合は、SSHキーを使用することができます。これにより、単一のパスワードを使って SSH キーをアップロードできるようになり、毎回 GitHub の完全な認証情報を入力する必要がなくなります。また、ファイルの変更をアップロードできるのは、SSHキーを持つ人のみです。
SSH鍵についてもっと詳しく知りたい場合は、GitHubで使い方を完全に説明しています。また、Gitの認証情報をPCに保存しておくこともできます。
それだ!さて、ファイルへの変更をコミットしたいときは、次の3つの短いコマンドを使います(「MyNovel」フォルダに移動した後)。
git add .翻訳:"おい、Gitフェーズは、トラックされたファイルへの新しい変更と同様に、トラックされていないすべてのファイルをコミットするために使われるんだぞ"。
git commit -m "1,000 words on the new iPhone review."訳:「おい、キット、このメッセージと一緒にその変更も保存しておけよ」。
git push origin master翻訳すると、"Hey Git, upload the changes to my master copy on this computer to the original version of this project on GitHub. "となります。
基本的にはこれで終わりですが、GitとGitHubをより使いこなすための追加のヒントをいくつか紹介します。
過去のコミットを見るには、GitHubのMyNovelリポジトリに移動してください。ホームページの上部にある「コード」タブの下に、"[X] commits" という項目があります。
クリックすると、すべての投稿作品のリストが表示されます。必要な投稿をクリックすると、あなたの文章が表示されます(Wordではなく、プレーンテキストで入力した場合)。投稿を作成する際、緑色でハイライトされているものは新しいテキスト、赤色でハイライトされているものは削除されたテキストです。
別のマシンで新しいリポジトリを取得するのは簡単です。新しいマシンでレポを保存したい場所に移動してください(例:cd~/Documents)。
git pull https://github.com/[Your GitHub User Name]/MyNovel.gitプロンプトが表示されたら、認証情報を入力すると、数秒後に使用できるようになります。新しい変更をコミットして、git push origin master で GitHub に送り返します。普段使っているコンピュータに戻ったら、コマンドラインを開いてプロジェクトフォルダに移動し、gitpull と入力すれば、まるで自分のデバイスでプロジェクトを最新にしたかのように新しい変更がダウンロードされます。
ほとんどの場合、ライティングはチームワークではなく、一人だけで行うものです。したがって、この記事のGitの使い方は、複数人のプロジェクトには当てはまりません。具体的には、いわゆる「枝」を作らず、本編を直接編集しています。ブランチとは、元のマスター版に影響を与えることなく変更できる、小説の実用的なバージョンのことです。これは、あなたの小説のコピーが2つ同時に存在し、どちらももう一方に影響を与えないようなものです。practiceブランチの変更が気に入ったら、masterバージョン(またはmasterブランチ)にマージすることができます。それが嫌なら、それでいいんです。練習用ブランチをなくせばいいんだよ。
ブランチは非常に強力で、プロジェクトに複数のライターがいる場合は、ブランチを使うのが主なワークフローになるでしょう。私見では、ソロの作者は、複数のPCで同時にmasterブランチに異なる変更を加えない限り、ブランチを使う必要はあまりないのではないかと思います。
たとえば、デスクトップで作業を終えてコミットし、変更を GitHub にプッシュします。その後ラップトップに移動して、新しい変更をすべて書き留めてから、さらに編集を行うようにします。そうしないと、Gitが言うところの「コンフリクト」が発生してしまいます。「GitHubとこのコンピューター上の変更の間にミスマッチがあります。解き明かすのを手伝ってくれ"
紛争解決は痛みを伴うので、できれば避けたいものです。
Git を使い始めると、ブランチやフェッチとプルの違い、GitHub のプルリクエストとは何か、そして恐るべきコンフリクトへの対処法など、多くのことを学ぶことができます。
Gitは素人には複雑に見えるかもしれませんが、一度コツをつかめば、自分の仕事を管理・保存するのに使える強力なツールです。