vlambda博客
学习文章列表

    你应该写博客

fast.ai 的联合创始人 Rachel Thomas 在她的文章《Why you (yes, you) should blog》中说过：

我给年轻人的最好建议是早点开始写博客。以下是一些写博客的理由：

它就像一份简历，只会让你得到更好的机会。我知道有几个人在博客上发了帖子，结果得到了工作机会！

• 帮助你学习。对知识进行回顾总结总是可以帮助我整理自己的想法，检验你是否理解某事的一个标准是你是否能向别人解释它。写一篇博文是一个很好的方法。
  

• 我通过博客收到了参加会议的邀请，也收到了发表演讲的邀请。因为写了一篇关于 TensorFlow 的博文，我被邀请参加 TensorFlow 开发峰会，这真是太棒了！
  

• 认识新朋友。我见过几个回复了我的博客的人。
  

• 节省时间。任何时候，如果你通过电子邮件多次回答一个问题，你都应该把它变成一篇博客文章，这样下次有人问你的时候，你就更容易分享了。
  

也许她最重要的建议是：「你最有能力帮助落后一步的人们。许多专家已经忘记了作为一个初学者的感觉，也忘记了为什么当你第一次听到这个话题时很难理解，但是这些知识在你的脑海里仍然是新鲜的。你的背景、风格和知识水平会给你的写作带来不同的变化。」

不幸的是，在写博客的时候，你似乎必须做出一个决定：要么使用一个让博客变得简单的平台，让你和你的读者关注广告、付费墙和收费，要么花几个小时建立自己的主机，花几个星期学习各种复杂的细节。也许「自己动手」的最大好处是，你真正拥有自己的帖子，而不是由服务提供商突发奇想，决定如何在未来用你的内容盈利。

然而，事实证明，你可以两者兼顾！你可以在一个叫做 GitHub Pages 的平台上托管（https://pages.github.com/），这个平台是免费的，没有广告或付费墙，并且以一种标准的方式提供你的数据，这样你就可以随时将你的博客移动到另一个主机上。但是，我看到的所有使用 GitHub 页面的方法都需要了解命令行和一些只有软件开发人员才可能熟悉的神秘工具。例如，GitHub 自身关于建立博客的文档需要安装 Ruby 编程语言、使用 git 命令行工具、复制版本号等等，总共需要 17 个步骤！

我们策划了一个简单的方法，允许你使用一个完全基于浏览器的界面来满足你所有的博客需求。你将在大约五分钟内启动并运行你的新博客。它不需要花费任何费用，而且在将来，如果你愿意的话，你可以很容易地添加你自己的自定义域。下面是如何使用我们创建的名为 fast_template 的模板来完成这项工作的。

    创建存储库

你需要在 GitHub 上有一个帐户。所以，如果你还没有帐户，现在就创建一个帐户。请确保你已登录。通常，软件开发人员使用 GitHub 编写代码，他们使用复杂的命令行工具来处理代码。但我将向你展示一种完全不使用命令行的方法！

访问以下网址进行创建 https://github.com/fastai/fast_template/generate 。这将允许你创建一个地方来存储你的博客，称为「存储库」。你将看到下面的界面，你必须使用下面的格式输入存储库名称，即在 GitHub 使用的用户名，后跟「.GitHub.io」。

重要提示：请注意，如果不使用 username.github.io 作为名称，它将不起作用！

一旦你输入了这些内容和任何你喜欢的描述，请单击「create repository from template」。请注意，除非付费，否则你需要将存储库「公开」。但是，既然你正在创建一个想让其他人阅读的博客，希望公开底层文件对你来说没有问题。

    设置主页

当读者第一次来到你的博客时，他们首先会看到一个名为「index.md」的文件的内容。这是一个标记文件。标记是创建格式化文本（如项目符号、斜体、超链接等）的一种强大而简单的方法。它被广泛使用，包括 Jupyter notebook 的所有格式，GitHub 站点的几乎每个部分，以及互联网上的许多其他地方。要创建标记文字，只需键入普通英语即可。但是你可以添加一些特殊的字符来添加特殊的行为。例如，如果在单词或短语周围键入* 字符，则会将其改为斜体。我们现在就试试。

要打开该文件，请在 GitHub 中单击其文件名。

要编辑它，请点击屏幕右端的铅笔图标。

你可以添加、编辑或替换看到的文本。单击“preview changes”按钮，查看标记文本在博客上是什么样子的。你添加或更改的行的左侧将显示绿色条。

若要将更改保存到博客，必须滚动到底部并单击「commit changes」绿色按钮。在 GitHub 上，提交意味着将其保存到 GitHub 服务器。

接下来，你应该配置博客的设置。为此，请单击名为「_config.yml」的文件，然后单击「edit」按钮，就像对上面的索引文件所做的那样。更改 title、description 和 GitHub 用户名值。你需要保留冒号前的名称，并在每行的冒号和空格后键入新值。你也可以添加到你的电子邮件和 Twitter 用户名，如果你愿意——但请注意，这些将出现在你的公共博客中。

完成后，像以前对索引文件那样提交更改。然后等一下，GitHub 正在处理你的新博客。然后，你可以在 web 浏览器中打开 URL:username.github.io（将「username」替换为 github 用户名）转到你的博客。这时候可以看看你的博客是不是已经创建好了。

    新建博客文章

现在你已经准备好创建你的第一篇文章了。你所有的帖子都会放在「\u posts」文件夹中。现在点击它，然后点击「create file」按钮。你需要注意按以下格式命名文件：「year-month-day-name.md」，其中 year 是四位数字，month 和 day 是两位数字。「Name」可以是你想要的任何东西，这将帮助你记住这篇文章是关于什么的。「md」扩展用于标记文档。

然后，你可以键入第一篇文章的内容，这里唯一的规则是你文章的第一行必须是标题。这是通过在一行的开头加上「#」创建的，这种方法将创建一个一级标题。你可以使用「###」创建二级标题，使用「####」创建级别三级标题，依此类推。

和以前一样，你可以单击「preview」按钮来查看标记格式的外观。

你需要单击「commit new file」按钮将其保存到 GitHub。

再看看你的博客主页，你会发现已经可以看到这个帖子了！

你还将看到我们提供了一个示例博客文章，你可以继续删除它。如前所述，转到 posts 文件夹，然后单击「2020-01-14-welcome.md」，然后点击最右边的垃圾箱图标。

在 GitHub 中，只有提交或者删除文件才能真正更改内容！因此，单击垃圾箱图标后，向下滚动到底部并提交更改。

通过添加一行标记，你可以在文章中包含图像，如下所示：

![Image description](images/filename.jpg)

要使其正常工作，你需要将图像放在「images」文件夹中。要做到这一点，点击 images 文件夹进入 GitHub，然后点击「upload files」按钮。

    更进一步

如果你想在你的文章中添加一个目录，那么在你希望目录出现的地方添加这两行到你的文章中：

1. TOC{:toc}

你创建的任何标题都将显示在目录中，并自动链接到各个部分。

你还可以在段落中使用 LaTeX 添加数学公式，方法是将它们包含在 $ 字符中，例如：$\sum_n（x）$，它显示为：∑n（x）。或者你可以将它们单独用 $$ 包围在一行中，将它们放在自己的段落中，如下所示：

$$\sum_n (x)$$

它看起来是这样的：

要使 LaTeX math 在你的博客中起作用，你必须更改读取 use_math:in_config.yml 的行，使其读取：

use_math: true

现在你知道如何创建博客了！这就留下了一个问题，那就是该写些什么……Rachel Thomas 在她的文章中提供了一些有用的想法，为更好的博客文章提供了建议，博客网址：https://www.fast.ai/2019/05/13/blogging-advice/ 。

接下来，你还可以多了解 git 相关的内容，它是一个强大的软件工具，可能会让你的生活变得更好！

via：https://www.fast.ai/2020/01/16/fast_template/

封面图来源：https://pixabay.com/images/id-265132/