如何搭建个人主页-GitHub / Gitee

发布时间:2022-07-03 阅读 1157

Stata连享会   主页 || 视频 || 推文 || 知乎 || Bilibili 站

温馨提示: 定期 清理浏览器缓存,可以获得最佳浏览体验。

New! lianxh 命令发布了:
随时搜索推文、Stata 资源。安装:
. ssc install lianxh
详情参见帮助文件 (有惊喜):
. help lianxh
连享会新命令:cnssc, ihelp, rdbalance, gitee, installpkg

课程详情 https://gitee.com/lianxh/Course

课程主页 https://gitee.com/lianxh/Course

⛳ Stata 系列推文:

PDF下载 - 推文合集

作者:左祥太 (武汉纺织大学)
邮箱Shutter_Z@outlook.com


目录


1. 网站为什么能被访问?

从一种通俗的非专业角度来看,当访问一个网页时,我们需要对服务器发送请求,随后得到一个响应,最后相应的结果便会呈现在网页上。不难发现,要想自己的网页能够被访问,我们至少得具备两个条件:

  • 网站文件
  • 可供访问的域名

对于第一个条件来说,我们可能需要掌握一些前端的编程知识,至少得学会 HTML 的编写。如果需要进一步对网页进行美化,则需要学习 CSS 与 JS 等的编写。这对非专业人员来说是存在一定挑战的。

对于第二个条件来说,我们需要从一些运营商手中购买域名。虽然也有一些免费的域名,但可能需要应对网站被 DDS 攻击等风险,以及需要付出学习相关领域知识的时间成本。

那么,有没有一种方法,能够做到零成本、维护简单、以及不需要额外设计呢?答案是肯定的,GitHub 以及 Gitee 都为我们提供了相应的 Pages 服务。这意味着,只要我们拿到别人已经做好的样式文件,再放入自己的 Markdown 文件,就能够建立简易的静态网页,从而实现零成本搭建个人主页的需求。

2. 什么是 GitHub/Gitee Pages

GitHub/Gitee Pages 分别是 GitHub 与 Gitee 推出的免费静态网页托管服务,我们可以使用 GitHub 或者 Gitee 托管博客、项目官网等静态网页。它们支持以 Jekyll、Hugo、Hexo 等工具编译而成的静态资源。同时网上也存在着较多的 Jekyll ThemesHexo ThemesHugo Themes 等主题资源。对于轻量的博客需求,我们只需拷贝任意一种自己喜欢的主题,然后上传至自己的仓库,就能够通过 "name.github.io" 或者 "name.gitee.io" 等域名访问自己的博客页面。

3. 搭建自己的 GitHub/Gitee Pages

由于 Gitee 与 GitHub 存在着高度的相似性,所以我们只需要掌握其中一个的使用方式,就能够轻易地上手另一个。然而 Gitee 的监管较为严格,开源项目需要提交审核,Pages 服务需要实名使用,总的来说较为麻烦。所以本文将以 GitHub 为主,演示如何下载 Jekyll 主题并建立自己的主页。

3.1 选择喜欢的主题

首先我们进入 Jekyll Themes,寻找喜欢的 Jekyll 主题。

这里以 "no style, plase" 主题为例,可以看到这款主题十分简洁,没有任何花哨的装饰部分。

从这里开始有两种方式可以实现建立个人主页的目的:一是进入 "Homepage" 将作者的仓库 Fork 到自己的 GitHub 仓库;二是点击 "Download" 下载全部文件后,手动修改 "_post" 中的 Markdown 文件。本文将演示第一种方法的建站方式。

3.2 将作者仓库 Fork 至自己的仓库

在我们点击 "Homepage" 按键后一般会进入到作者的 GitHub 主页,这个时候可以看到如下的画面。

点击上述的 Fork 按钮,随后修改仓库的选项。

点击 Fork 按钮后,我们需要将 Repository name 修改为你当前的 GitHub 用户名加上 ".github.io"。例如我的 GitHub 账号名称是 "ShutterZor",那么就需要将 Repository name 设置为 "ShutterZor.github.io"。虽然在访问网页时可以忽略大小写,但这里的大小写务必请保持一致。值得注意的是,由于我这里已经建立过相应地仓库了,所以会报错,这也意味着一个 GitHub/Gitee 账号有且只能建立一个个人主页。

3.3 修改网页文件

不管是我们直接 Fork 的仓库,还是下载下来的文件,我们都必须弄清楚这几个关键文件:

  • _post 文件夹:这个文件夹主要用来存放自己的博客,注意需要以时间加文章标题命令,例如,"2022-05-28-连享会-个人博客教程","-" 是必须的。这个文件最后显示出来的标题将会是 "2022-05-28 连享会 个人博客教程",即时间之后的 "-" 会被识别为空格;
  • _config.yml 文件:这个文件主要是用来设置一些颜色等,可以用记事本打开,一般不需要着重修改,而且作者也提供了丰富的注释,有助于我们理解代码的含义。以 "no style, please" 主题为例,作者提供了如下解释:

我们需要着重看红框里面的内容,作者说到,如果是通过 GitHub Pages 服务进行建站,需要将本行替换为 "remote_theme: riggraz/no-style-please"。在修改完 _config.yml 文件之后,我们可以等待 5 分钟左右,随后便可以直接通过 "name.github.io" 直接访问网站。如果此时能够进入如下页面,便表示我们已经成功了一大半。

这里意味着我们已经通过 GitHub Pages 服务将个人主页初步搭建成功,但仓库里的文件仍然是作者给出的模板。接下来我们只需要做以下几件事情:

  • 仔细阅读作者提供的说明
  • 更换自己的 Markdown 文件
  • 修改网页布局

该作者在 "_post" 文件夹下的每一篇文章都是一个 ".md" 格式的文件,所以我们只需要把自己的文件替换进去就可以更改网页上所展示的文章 (详情见 3.4 )。仔细阅读作者的 "README.md" 文件就能发现,这一页的布局全部保存在 "_data/menu.yml" 文件中,作者提供的页面布局文件代码如下:

我们仅仅保留需要的部分,并将其简化为如下部分:

到这里为止,我们就完成了网页整体上的修改,接下来是丰富自己的博客文章内容。

3.4 修改推文的 Markdown 文件

我们以作者 "_post" 文件夹下的 "2020-07-07-overview-post.md" 为例 (这一步操作在自己 Fork 的仓库中进行),点击编辑。

接下来我们会进入到一个 Markdown 文件的编辑页面。

在上图的第一到四行中,第三行的 "category: example" 是作者为了实现按类别展示而设置的类别标签,我们可以设置也可以不设置,其余的不要改动。可以发现从第 6 行开始便是 Markdown 文件的正文部分,我们只需要在这部分键入自己的推文即可。

4. 完成建站

在修改完相应地推文后,等待一段时间,重新刷新 "name.github.io" 页面,便可以看到个人主页得到了相应地修改。不仅是对于 jekyll 主题,Pages 服务同样支持 Hexo 与 Hugo 生成的静态网页资源,同理只需要 Fork 别人做好的仓库,然后修改对应的推文即可完成。

5. 相关推文

Note:产生如下推文列表的 Stata 命令为:
lianxh markdown 网站, m
安装最新版 lianxh 命令:
ssc install lianxh, replace

相关课程

免费公开课

最新课程-直播课

专题 嘉宾 直播/回看视频
最新专题 文本分析、机器学习、效率专题、生存分析等
研究设计 连玉君 我的特斯拉-实证研究设计-幻灯片-
面板模型 连玉君 动态面板模型-幻灯片-
面板模型 连玉君 直击面板数据模型 [免费公开课,2小时]
  • Note: 部分课程的资料,PPT 等可以前往 连享会-直播课 主页查看,下载。

课程主页

课程主页

关于我们

  • Stata连享会 由中山大学连玉君老师团队创办,定期分享实证分析经验。
  • 连享会-主页知乎专栏,700+ 推文,实证分析不再抓狂。直播间 有很多视频课程,可以随时观看。
  • 公众号关键词搜索/回复 功能已经上线。大家可以在公众号左下角点击键盘图标,输入简要关键词,以便快速呈现历史推文,获取工具软件和数据下载。常见关键词:课程, 直播, 视频, 客服, 模型设定, 研究设计, stata, plus, 绘图, 编程, 面板, 论文重现, 可视化, RDD, DID, PSM, 合成控制法

连享会小程序:扫一扫,看推文,看视频……

扫码加入连享会微信群,提问交流更方便

✏ 连享会-常见问题解答:
https://gitee.com/lianxh/Course/wikis

New! lianxhsongbl 命令发布了:
随时搜索连享会推文、Stata 资源,安装命令如下:
. ssc install lianxh
使用详情参见帮助文件 (有惊喜):
. help lianxh