在github中有很多博客项目,基本上都是以jekyll为模板,然后在做了很多定制,已经有大神制作了非常棒的模板,而且项目代码也是公开免费的,我们可以将代码fork到自己的代码仓库中,修改之后作为个人的博客系统使用。
前言
搭建个人的博客系统,首先需要注册github帐号,并fork相关的项目代码,同时需要利用git工具将代码clone到本地,进行代码的修改。我们可以使用微软公司推出的vscode工具来修改代码和编辑博文,vscode中可以集成git、markdown、图床等插件,我们以后编写、发表博文,配置博客项目,都可以在vscode这一个工具中进行。当配置完成,或写完一篇博客时,如果直接上传到github上的博客系统,后续有修改时将会带来大量的commit操作,因此,我们需要一个本地环境jekyll来预览我们的博客系统效果。
总之,搭建个人的博客系统,大体上需要以下的步骤:
- 注册github帐号并fork博客系统项目代码
- 安装git工具并clone项目到本地
- 安装本地jekyll环境并预览项目
- 安装vscode工具并配置插件
- 修改博客项目配置并预览效果
- 推送最终的配置和博文到github
所需要的工具及功能如下:
- git:下载、上传项目代码
- vscode:修改代码,编写博客
- jekyll:预览本地项目效果
如果无法从官方下载对应的软件,可以从我的网盘下载:链接: https://pan.baidu.com/s/1PyBArQ5RlcKPIEdchigJcw 提取码: wnwy
一、注册github帐号并fork博客项目代码
首先我们需要注册一个github的帐号(注册地址:https://github.com/),然后fork博客系统的项目代码到自己的github代码仓库中,这样我们就可以以自己的项目为基础,修改代码,上传自己的博文。如何修改代码,及如何写作博文,在后续的步骤中会有详细的介绍。
按照注册要求,填写对应的用户名、密码、邮箱等信息,并通过邮箱激活注册即可,具体的注册过程略。
注册好github帐号之后,访问公开的博客项目,这里我推荐使用黄玄的模板(https://github.com/Huxpro/huxpro.github.io),里边集成了很多实用的功能,比如自定义域名、侧边栏、标签、评论等。我们只需对配置文件中的内容进行简单修改就可以使用了。
访问到该博客项目后,点击右上角的“fork”按钮,将自动将项目代码fork到自己的github代码仓库中。
然后进入fork过来的项目,点击“settings”,修改项目的名称。名称的格式是 username.github.io 。注意这里的username是登录之后显示的名字,不是登录的用户名。之后等待几分钟,github将会自动创建好博客系统,并且可以通过https://username.github.io 来访问。
例如我的博客的访问地址就是:https://pekinglone.github.io/
二、本地安装git工具并clone项目到本地
项目代码是在github中,我们需要下载到本地进行修改,同时我们编写的博客文章也是需要上传到github上的,因此在本地需要安装git工具。
首先需要从git的官方网站下载git:https://git-scm.com/
-
执行安装
然后,在执行默认安装,最终可以在任意的文件夹中点击右键然后可以打开git的命令行即可。本地安装好git工具,后续可以在vscode中使用git。
-
配置git全局变量
安装好git之后,在任意的文件中,点右键打开git bash命令行,在其中执行如下命令,配置本地的用户和邮箱。git config --global user.name "your name" git config --global user.email "your@email.com"
-
配置访问github的ssh-key
在git bash命令行中执行ssh-keygen命令,并按三次回车,生成ssh key的公钥和私钥。ssh-keygen -t rsa -C "your@email.com"