作者如何使用github存储他们的作品

有很多方法可以管理和存储你的写作项目。有些人更喜欢云存储服务(比如Dropbox)或在线编辑器(比如googledocs),而有些人则使用桌面应用程序(比如microsoftword)。我用一种叫做GitHub的东西。...

作者如何使用github存储他们的作品

有很多方法可以管理和存储你的写作项目。有些人更喜欢云存储服务(比如Dropbox)或在线编辑器(比如googledocs),而有些人则使用桌面应用程序(比如microsoftword)。我用一种叫做GitHub的东西。

github:它不仅仅是为了代码

我使用Git和GitHub来存储和访问我所有的写作。Git是一个有效的工具,您可以使用它来跟踪文档更改,而且您还可以超级快速地上传到GitHub。把你的作品下载到第二台或第三台设备上也很简单快捷。

如果您从未听说过GitHub,它是世界上最流行的存储和维护开放源代码的目的地。这听起来像是一个疯狂的地方来主持你的写作,但它不是!毕竟,代码只是一行又一行的文本,就像你的文章、故事或论文一样。

2013年前后,GitHub开始鼓励人们为各种信息创建存储库,而不仅仅是代码。GitHub从来没有真正离开过它的编码根,但是有些人仍然使用它来存储写作和其他非编码项目。例如,一个人用Git和GitHub写一本教学书,而另一个人写一本小说。浏览一下谷歌,你会发现GitHub的各种疯狂用途。

什么是git和github(git and github)?

Git是Linux的Linus Torvalds创建的一个开源程序。Git跟踪文档的更改,使多人远程处理同一文档变得更容易。在技术上讲,它被称为分布式版本控制系统(或分布式VCS)。Git不会以设置的时间间隔任意保存文档的版本。相反,它只在您告诉它时才存储对文档的更改。

您的文档形成一个存储库(或repo),这只是您的项目文件夹的一个花哨的术语。例如,如果您使用Git来管理Windows中的Documents文件夹(但不要这样做),它将是一个存储库。

当您将对文档的更改存储在Git中时,它被称为“提交”,提交只是您最近对文档所做更改的记录。每个提交都分配了一长串数字和字母作为其ID。

如果通过ID调用过去的commit,则不会像在Word的文档历史记录中那样看到整个项目。您只能在提交时看到最近的更改。然而,这并不意味着整个项目没有记录。你可以从一个项目文件夹中删除你所有的文章,但仍然可以通过一些git命令获得最新的版本。你甚至可以回头看看这个项目一周前,或者六个月前的样子。

您还可以在每个提交中包含消息,这非常有用。例如,如果您写了一些东西,但不确定是否要保留它,只需执行一个提交。然后,即使稍后从项目中删除该节,该节仍会保留在提交历史记录中。

Git在命令行上工作得最好,这是一个很大的优势,但也有它的缺点。命令行可以创建提交和上载更改。但是,如果您想查看提交历史记录,这并不理想。

这就是许多人喜欢GitHub的原因,GitHub是一种流行的在线服务,为Git存储库提供web界面。在GitHub上,您可以轻松地查看过去的提交,也可以将您编写的内容下载到多台pc上。

Git和GitHub结合在一起,让我可以在粒度级别控制我的版本历史。在任何一台可以运行Bash命令行的PC上写东西都很容易,这些命令行现在包括Windows、Mac、Linux和Chrome操作系统。

纯文本文件使事情变得简单

Git和GitHub在几乎任何文件类型上都可以进行提交来进行编写,尽管它最适合纯文本。如果您用microsoftword编写,它可以工作,但是您将无法在命令行或GitHub中看到您过去的提交。相反,您必须在命令行上调用过去的提交(称为“签出”),然后打开Word文件。然后,Word文件看起来与最初提交时一样,您可以使用另一个快速命令返回到当前版本。

如果你用Scrivener,那也行。Scrivener将文件保存为文本,因此它还显示GitHub和命令行上过去的提交。但是Scrivener也保存了对程序很重要的数据,而不是对您。在每一次提交中,你都会收到很多垃圾,让你很难阅读。

我使用纯文本文件,因为这就是将单词串在一起所需的全部内容,尤其是在最初的几篇草稿中。

git入门

让我们进入这一切如何工作的技术细节。我们将从PC开始,然后使用GitHub进入云计算。

要开始,您需要在macOS或Linux上安装终端程序。如果你的电脑运行Windows10,你必须通过WindowsSubsystem for Linux(WSL)安装Ubuntu或其他Linux发行版,这非常简单。您可以查看我们关于如何在Windows10上安装LinuxBashshell的教程。或者,如果您使用的是旧版本的Windows,那么可以使用Cygwin获得bashshell。

打开终端并导航到要用作Git存储库的文件夹。出于我们的目的,假设在Documents文件夹中有一个名为“MyNovel”的文件夹。请注意,我们的Git repo的单词之间没有空格。如果您这样做的话,您的生活会变得更轻松,因为Bash不喜欢空格,处理它们会让人困惑。

接下来,导航到终端中的MyNovel文件夹。要在Windows 10中执行此操作,命令为:

cd /mnt/c/Users/[YourUserName]/Documents/MyNovel

任何与保存在Windows中的文件交互的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”。要保存更改,我们必须让Git跟踪这些文件。为此,请键入:

git add .

句点告诉Git监视文件夹中所有未跟踪的文件(即您要为其创建历史记录的文件)。这个命令还告诉Git准备任何当前跟踪的已经更改的文件。这个过程称为提交暂存文件。

就我们的目的而言,登台并不那么重要,但它是有用的。如果您对第2章和第3章进行了更改,但只想提交第2章中的更改,那么您可以将第2章设置为:

git add Chapter2.doc

这告诉Git您想让第2章中的更改准备好提交,而不是第3章。

现在,是第一次提交的时候了:

Git commit -m "This is my first commit."

“-m”被称为一个标志,它告诉Git您要对一条消息进行commit和tack,您可以在引号之间看到这条消息。我喜欢使用我的提交消息来标记字数。我还使用它们来记录特殊的信息,比如:“这个承诺包括对acmewidgets的CEO的采访。”

如果我在写一个故事,我可能会包含这样一条消息:“这个提交有一个新的场景,狗逃跑了。”有用的消息使以后更容易找到你的提交。

现在我们已经开始跟踪我们的文档,是时候用GitHub将我们的写作放到云端了。我使用GitHub作为一个额外的备份,一个查看文档更改的可靠地方,以及在多台pc**问我的东西的方法。

github入门

首先,您需要在GitHub上注册一个免费帐户(创建私有存储库不需要付费帐户)。但是,您最多只能与三个人合作进行私人回购。如果你有一个5人或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

现在,回到桌面和我们喜爱的命令行。

将桌面存储库推到云端

第一次将repo连接到GitHub时,必须使用一些专门的命令。第一个是:

git remote add origin https://github.com/[Your GitHub User Name]/MyNovel.git

这告诉Git一个远程存储库是“MyNovel”的来源,然后URL将Git指向这个远程来源。别太在意“起源”这个词,这只是个惯例。如果你想让它更简单,你可以称之为“fluffy”,因为它是使用Git最常见的方式。

当你用Git上传新的更改时,它被称为“推送”。当你下载更改时,它被称为“拉送”或“获取”。现在,是时候把你的第一次提交推送到GitHub了。以下是您要做的:

git push -u origin master

系统将提示您键入GitHub用户名和密码。如果您键入正确的凭据,所有内容都将上载,您就可以开始了。

如果您希望GitHub上传更安全,可以使用SSH密钥。这允许您使用单一密码上传SSH密钥,因此您不必每次都键入完整的GitHub凭据。另外,只有拥有SSH密钥的人才能上传文件更改。

如果您想要更多关于SSH密钥的信息,GitHub提供了关于如何使用它们的完整说明。您还可以在PC上保存Git凭据。

就这样!现在,当您要提交对文件的更改时,可以使用以下三个简短的命令(在导航到“MyNovel”文件夹之后):

git add .

翻译:“嘿,Git阶段用于提交所有未跟踪的文件,以及对已跟踪文件的新更改。”

git commit -m "1,000 words on the new iPhone review."

翻译:“嘿,吉特,把这些更改和这条消息一起保存。”

git push origin master

翻译:“嘿,Git,把我在这台电脑上的主副本的修改上传到GitHub上这个项目的原始版本。”

git和github奖励提示

基本上就是这样,但这里有一些额外的技巧可以让您更好地使用Git和GitHub:

查看过去的提交

要查看过去的提交,请转到GitHub上的MyNovel存储库。在主页顶部的“代码”选项卡下,您会看到一个部分,上面写着“[X]提交”

单击它,您将看到所有提交的列表。单击你想要的提交,你就会看到你的文本(如果你是用纯文本而不是Word输入的话)。创建提交时,所有以绿色突出显示的内容都是新文本;所有以红色突出显示的内容都被删除。

使用pull命令

在不同的机器上获取新的存储库很容易。只需导航到要在新机器上保存回购的位置,例如cd~/Documents。然后,键入:

git pull https://github.com/[Your GitHub User Name]/MyNovel.git

如果出现提示,请键入您的凭据,几秒钟后,您就可以开始了。现在,提交新的更改,然后通过git push origin master将它们发送回GitHub。当你回到你通常工作的电脑,只要打开命令行,导航到你的项目文件夹,然后输入gitpull。新的更改将被下载,就像你的写作项目在你的设备上是最新的一样。

不要横渡河流

大多数时候,写作不是团队合作,只涉及一个人。因此,本文使用Git的方式不适用于多人项目。具体来说,我们直接对小说的主版本进行了编辑,而不是创建所谓的“分支”。分支是小说的实践版本,您可以在不影响原始主版本的情况下进行更改。这就像你的小说有两个不同的副本同时存在,两个副本都不影响另一个。如果您喜欢实践分支中的更改,可以将它们合并到主版本(或主分支)中。如果你不想那样做,那也没关系。把练习枝扔掉就行了。

分支非常强大,使用它们将是一个项目中有多个编写器的主要工作流。在我看来,独行作者其实不需要使用分支,只要您不在多台PC上同时对主分支进行不同的更改。

例如,您应该在桌面上完成工作,进行提交,然后将更改推送到GitHub。然后到你的笔记本电脑,把所有的新变化下来,然后再做任何进一步的编辑。如果你不这样做,你可能会以Git所说的“冲突”告终,这时Git说,“嘿,GitHub和这台电脑上有不匹配的变化。帮我弄清楚。”

解决冲突是件痛苦的事,所以最好尽可能避免。

一旦你开始使用Git,你就可以学到很多东西,比如分支,fetch和pull的区别,GitHub的pull请求是什么,以及如何处理可怕的冲突。

Git对新手来说可能看起来很复杂,但一旦你掌握了窍门,它就是一个强大的工具,你可以用来管理和存储你的作品。

  • 发表于 2021-04-03 05:21
  • 阅读 ( 170 )
  • 分类:互联网

你可能感兴趣的文章

如何使用github桌面克隆存储库

...储库(如果有),但创建一个新的存储库将显示GitHub桌面如何与GitHub协同工作。 ...

  • 发布于 2021-03-19 02:59
  • 阅读 ( 245 )

如何使用github页面免费托管网站

...GitHub页面就是这样一种选择,在本文中,我们将向您展示如何****GitHub页面托管一个简单的网站。 ...

  • 发布于 2021-03-19 05:27
  • 阅读 ( 219 )

什么是github?基本特征简介

... 如何使用github? ...

  • 发布于 2021-03-26 16:08
  • 阅读 ( 241 )

加入社会化编码潮流,为github存储库做出贡献

...流,分享你的技能,帮助开源世界受益。在本文中,了解如何将代码贡献给GitHub上的存储库或任何托管的git服务。 ...

  • 发布于 2021-03-27 04:33
  • 阅读 ( 222 )

如何在本地和远程删除git中的分支

...常见的策略是为单个bug修复创建一个分支。即使只有一个作者在一个文件中做了一行更改,这也是正确的。 ...

  • 发布于 2021-03-28 02:05
  • 阅读 ( 333 )

如何在github上创建第一个存储库

... 在本教程中,我们将探讨如何创建Github存储库、推送提交、标记发布等等。 ...

  • 发布于 2021-03-28 23:04
  • 阅读 ( 216 )

如何(以及为什么)创建github存储库

...至可以提前发布一个测试版。开源是一件美好的事情。 如何创建github repo 要在GitHub上设置项目,您需要创建一个repo。为此,请登录(或创建)GitHub帐户。登录后,单击标题菜单右侧的“+”图标(可从站点上的任何位置访问)。...

  • 发布于 2021-03-31 12:11
  • 阅读 ( 170 )

如何在linux上使用git安装软件

...并构建它”,却不知道下一步该怎么办?我们将向您展示如何让GitHub上的程序在Linux上运行,即使您是初学者。 组成计算机程序的指令被编写、编辑并保存在文本文件中。然后一个叫做编译器的程序处理这些文件。这将生成程序...

  • 发布于 2021-04-03 08:08
  • 阅读 ( 203 )

github现在是免费的,这很好

...元的私人存储库费用。但是现在如果你有三个或更少的合作者,这些都是免费的。 新的免费课程对学生来说是个福音 GitHub一直有一个免费层,但在过去,这个免费层仅限于公共存储库。如果你是一个有抱负的程序员,想要深入...

  • 发布于 2021-04-04 02:12
  • 阅读 ( 135 )

github是什么,它的用途是什么?

...。您可以通过创建pull请求来实现这一点。原始存储库的作者可以查看您的工作,然后选择是否接受它到正式项目中。无论何时发出pull请求,GitHub都为您和主项目的维护人员提供了一个完美的沟通媒介。 社交网络 GitHub的社交网...

  • 发布于 2021-04-09 04:55
  • 阅读 ( 159 )
qazwsx117877476
qazwsx117877476

0 篇文章

相关推荐