在 GitHub 上使用 Markdown 创建数字简历

八月初，我在推特上宣布正在寻找下一份工作。我的推文附上了我的电子简历链接，从那以后，我收到了很多关于如何制作这份简历的问题。所以，这里就写个简短的指南！

本指南基于我 2017 年在 Twitter 上看到的一条帖子。很遗憾，我不记得是谁发的帖子了……但如果你就是发帖人，请知道我真的非常感谢你！

⚠️ 先决条件：

• GitHub 帐户
• 轻松驾驭Markdown

✅ 步骤：

1. 在 GitHub 上创建一个新的公共仓库
2. 为您的仓库启用 GitHub Pages
3. 为您的简历选择一个主题（设计模板）。
4. 请使用 Markdown 格式撰写简历。
5. 尽情享受💅🏼
6. 可选：设置自定义域名
7. 请给我看看你的简历💌

在 GitHub 上创建一个新的公共仓库

我们制作电子简历所需的一切都将存储在 GitHub 上的一个代码库中。 

首先，创建一个不带模板的新仓库。

选择一个名字（我给我的名字取为cv），如果需要，可以添加描述。确保它是公开的。

这份电子简历将托管在 GitHub Pages 上，这需要您的存储库是公开的。

最后，不要用任何东西对其进行初始化。

虽然你不需要导入现有的代码库，但从一个完全空白的代码库开始可以简化整个过程。稍后你就会明白为什么了！

为您的仓库启用 GitHub Pages

您的电子简历将托管在GitHub Pages上。GitHub Pages 允许您直接从 GitHub 代码库托管个人页面和项目页面。它的优点在于免费，并且所有功能都内置于 GitHub 中，因此无需额外的帐户或复杂的构建流程。

要为您的简历启用 GitHub Pages，请转到您的存储库的设置页面。

向下滚动直到找到GitHub Pages 部分。这里有两个子部分：源代码和主题选择器。

在“来源”下方，应该显示“GitHub Pages 目前已禁用。您必须先向仓库添加内容，才能发布 GitHub Pages 站点。”因为您的仓库为空，所以没有分支，也无法选择来源。没关系！我们马上会处理这个问题。

您需要的子版块是“主题选择器”。在这里，您可以为您的网站选择一个设计模板。之后，系统会创建一个gh-pages分支，并从该分支发布使用您选择的主题的网站。 

所有选项都是Jekyll主题。如果您不了解 Jekyll，没关系。本指南将引导您完成必要的配置。说实话，除了 GitHub Pages 模板之外，我对 Jekyll 的工作原理一无所知。

为您的简历选择一个主题（设计模板）。

简历的目的是让未来的雇主了解你是怎样的人——所以选择一个能代表你的主题！在本指南中，我们将继续以“极简”主题为例，因为这是我自己简历所使用的主题。

选择主题后，系统会提示您编辑一个新index.md文件。 

在你深入探讨之前，有一些背景事情你应该了解……

• gh-pages（如前所述）创建了一个新的分支。
• 文件index.md已创建。 
• Jekyll主题设置为“Minimal”。

GitHub Pages 会创建一个名为 `.temfile` 的文件来确认您的主题选择_config.yml。默认情况下，该文件仅包含一个theme字段，用于记录您的选择。 

_config.yml如果您选择“极简”主题，界面将如下所示：

theme: jekyll-theme-minimal

我的简历中还添加了title以下description字段：

theme: jekyll-theme-minimal
title: 💻✒️📄🌟
description: Carolyn Stransky's CV

您可以在Jekyll 文档中查看所有配置选项。

请使用 Markdown 格式撰写简历。

好了，回到生成的文件。你的简历内容将全部放在这里。

首先，你应该将该index.md文件重命名为README.md. 。这并非强制要求，但将其作为 README 文件可以让其他人在访问你的代码仓库时立即看到你的简历内容。如果你决定将简历仓库固定到你的 GitHub 个人资料页面，这一点尤其有用。

如果没有index.md指定，您的 README 文件将自动与 GitHub Pages 配合使用 - 无需额外配置。

然后，你就可以写简历了✍🏻

您可以使用 Markdown 编写和设置内容样式，然后它会根据您选择的主题进行渲染。

想要了解如何有效地展示你的技能，我推荐莫妮卡·伦特的文章：《7个软件开发人员简历技巧，助你脱颖而出》。如果你想学习如何使用Markdown排版内容，也可以看看我的电子简历。 

满意后，将更改提交到gh-pages分支。 

尽情享用您的全新电子简历吧！

可能需要几分钟才能生效——但你全新的电子简历现在应该已经可以在网上看到了🎉

大多数情况下，您的网页将托管在以下网址：

<github-username>.github.io/<repository-name>

您始终可以通过返回存储库设置中的 GitHub Pages 部分来确认您的简历是否已发布以及 URL 是什么。

如果你的电子简历在提交更改并等待几分钟后没有更新，请尝试进行强制刷新。

可选：设置自定义域名

自定义域名可以让你的简历脱颖而出——或者，你也可以将你的电子简历用作个人网站。

诚然，我从未为我的简历设置过自定义域名，但GitHub 文档中有关于如何操作的分步说明。 

如果你不确定在哪里注册域名，我推荐Namecheap。

请给我看看你的简历

如果你按照本指南制作了电子简历，我很想看看！请在推特上发链接给我@carolstran 💖

您觉得这篇文章有用吗？如果觉得有用，请考虑请我喝杯咖啡，这样我才能继续写这样的文章☕️