No Regrets.

热乎乎的经验教大家怎么搭建自己的个人博客

Posted on By Marin



前期准备


  前期准备主要有两点,1、创建你自己的github项目;2、在本机安装好你的git。


github项目的创建


  首先登陆到你的github,点击右上角的加号,点击new repository进行新仓库的创建;

        

  之后需要主要仓库的命名,命名规则为:你的github名(如:itmanmzt).github.io,description可以随意填写,范围权限我们一般选择public,这样子别人也可以看到我们的项目,填写完毕之后点击create repository就创建好了。




git的下载


  git的下载和安装和普通的软件安装没有太大的区别,只需要选择和自己的操作系统匹配的版本即可,这里给大家git下载链接



使用git在本地创建一个本地仓库并连接到GitHub的仓库


  • 方式一:图形化界面直接创建一个文件夹作为本地仓库,右键点击Git Bash Here,进入命令行窗口,输入git init进行初始化,这个时候你回到文件夹设置为显示隐藏文件,你会发现有一个.git的隐藏文件,这时候说明初始化成功了。

    step1
step1


step2

step2


step3

step3


step4

step4




  • 方式二:命令行界面可以通过命令:mkdir /路径/文件夹名的方式创建文件夹,然后通过cd /路径/文件夹名进入到这个文件夹中,然后执行git init执行初始化。

    mkdir /g:/my repository
    cd /g:/my repository
    git init
    



      然后就是和GitHub建立连接。

  • 第一步:获取SSH Key,在本地仓库点击右键点击Git GUI Here,点击Help,点击show SSH Key,然后复制该字符串。

    step1
step1


step2

step2


step3

step3




  • 第二步:点击你GitHub的全局settings,点击SSH and GPG keys,点击New SSH key,粘贴你刚才复制的字符串,然后点击添加即可。

    step1
step1


step2

step2


step3

step3


step4

step4


step5

step5




  • 第三步:通过命令行进行用户配置

    git config –global user.name //name为你的Github用户名
    git config –global user.email //email为你的Github邮箱地址
    



  • 第四步:在本地仓库创建一个README.md文件,作为一个项目说明文件,里面可以用文字介绍你的项目,然后通过命令行执行下面命令,SSH地址可以在GitHub对应的项目中找到。

    git add README.md //将要提交的文件添加到暂存区
    git commit -m "提交说明" //将文件从暂存器提交到仓库,-m后面的内容是备注,可以区分不同提交的内容
    git remote add origin git@github.com:itmanmzt/test.git //通过SSH地址和GitHub建立连接
    git push -u origin master //将本地仓库提交到远程
    






      到了这里我们就完成了仓库的创建和连接,nice!



使用jekyll来搭建博客


  jekyll是一个简单的免费的Blog生成工具,将纯文本转化为静态网站和博客;由于咱们的GitHub Pages生成的是静态页面,每次更新博客都需要手动更改HTML,这就使得每次写博客都变得很麻烦,而用了这个工具以后,它会根据预先设置好的格式来生成博客内容,你就无需关心html代码,只需要把重心放在博客的写作上。

  我们先进入jekyll的官网看看安装步骤,jekyll中文官网 通过文档我们知道在安装jekyll之前需要先安装ruby和rubygem。

step1

step1


step2

step2



排坑时刻


  根据我安装jekyll的经验,我发现网上的很多教程都是错误的,安装完ruby和对应的devkit之后,虽然能检测到ruby和gem在本机上的安装版本,但在安装jekyll的时候却会因为gem的某些原因报错,报错内容如下:

ERROR:  Error installing jekyll:
    ERROR: Failed to build gem native extension.

    current directory: /var/lib/gems/2.3.0/gems/ffi-1.9.18/ext/ffi_c
/usr/bin/ruby2.3 -r ./siteconf20170316-3892-175h62n.rb extconf.rb
mkmf.rb can't find header files for ruby at /usr/lib/ruby/include/ruby.h

extconf failed, exit code 1

Gem files will remain installed in /var/lib/gems/2.3.0/gems/ffi-1.9.18 for inspection.
Results logged to /var/lib/gems/2.3.0/extensions/x86_64-linux/2.3.0/ffi-1.9.18/gem_make.out


  经过我在window和Linux系统上的各种尝试,虽然不清楚出现这个错误的原因是什么以及怎么解决这个错误问题,但我发现可以通过更换ruby的版本来解决这个问题,通过下载安装ruby2.3版本,这是下载链接,并且接下来具体的安装步骤在这里我就引用正确的解决方法的文章


使用主题搭建个人博客


  • 第一步:去JekyllThemes下载一个自己喜欢的模板 。
  • 第二步:按照之前的步骤把下载好的模板上传到自己的Github仓库中 。
  • 第三步:在_posts文件夹中放入自己写好的博客,文件名必须是日期-标题名,例如:2016-10-25-我的第一篇博客 。
  • 第四步:上传博客到Github中即可访问自己的博客。




有Marin的地方就有你的收获