技术和相关概念
开始之前,先大致介绍一下用到的技术和相关概念
Github是什么:
GitHub是一个利用Git进行版本控制、专门用于存放软件代码与内容的共享虚拟主机服务,很多人都把它称作程序员的同性交友网站,具体为啥这么叫我也不知道
GitHub Pages是什么？
Github Pages设计的初衷是为托管在GitHub上的项目提供介绍页面,开发者们可以通过GitHub Pages为他们的每一个项目创建一个用于介绍该项目的静态网站,不过由于他的空间免费而且稳定,因此用它搭建一个个人博客网站是再好不过了.
Git是什么？
Git是一个开源的分布式版本控制系统,可以有效、高速的处理从很小到非常大的项目版本管理.它的作用
和Svn类似,就是一个版本控制的工具,用它可以将我们写的代码提交到Github上.
Jekyll是什么？
jekyll是一个简单的免费的Blog生成工具,将纯文本转化为静态网站和博客;由于咱们的GitHub Pages生成的是静态页面,每次更新博客都需要手动更改HTML,这就使得每次写博客都变得很麻烦,而用了这个工具以后,它会根据预先设置好的格式来生成博客内容,你就无需关心html代码,只需要把重心放在博客的写作上.
Liquid是什么?
Liquid是一种模板语言,可以在HTML页面中使用它;而他的作用就是使用标记、对象和过滤器的组合来加载一些动态内容.
系统环境配置：
-
1.安装 git
下载地址 git下载
直接双击下载下来的git安装程序，同node安装，安装完之后右键发现多了两个Git GUI Here 、Git Bash Here，点击后者，然后输入git --version出现版本信息就表明安装成功了。 -
2.注册 github账号
github 官网 github
git 连接github配置：
配置SSH key：
为什么要配置这个呢？因为你提交代码肯定要拥有你的github权限才可以，但是直接使用用户名和密码太不安全了，所以我们使用ssh key来解决本地和服务器的连接问题。
#检查本机已存在的ssh密钥
$ cd ~/. ssh
如果提示：No such file or directory 说明你是第一次使用git。
#生成 ssh key
ssh-keygen -t rsa -C "邮件地址"
生成ssh key
然后连续3次回车，最终会生成一个文件在用户目录下，打开用户目录，找到.ssh\id_rsa.pub文件，记事本打开并复制里面的内容，打开你的github主页，进入个人设置 -> SSH and GPG keys -> New SSH key：
SSH key
将刚复制的内容粘贴到key那里，title随便填，保存。
测试是否成功：
$ ssh -T git@github.com # 注意邮箱地址不用改
如果提示Are you sure you want to continue connecting (yes/no)?，输入yes，然后会看到：
Hi honkerSK! You've successfully authenticated, but GitHub does not provide shell access.
看到这个信息说明SSH已配置成功！如图所示：
测试是否成功
此时你还需要配置：
$ git config --global user.name "你的github用户名" #你的github用户名，非昵称
$ git config --global user.email "xxx@sina.com" #填写你的github注册邮箱
搭建博客过程
1.安装Ruby
ruby官网下载安装：https://www.ruby-lang.org/en/downloads/
安装完成后配置环境变量
在命令提示符中，得到ruby版本号，装成功
$ ruby -v
2.安装RubyGems
官网下载 http://rubygems.org/pages/download
rubygems的github地址
-
2.1 cd到RubyGems目录
-
2.2 执行安装 RubyGems
$ sudo ruby setup.rb
3.用RubyGems安装Jekyll
执行下面的语句安装
$ sudo gem install jekyll
安装结束画面
image
至此jekyll就已经安装完毕了，后续就是个性化的自己设定了。
mac安装Jekyll
mac自带Ruby和RubyGems. 但是ruby setup.rb经常不成功.这里使用homebrew来安装Jekyll. 参看文字 homebrew使用与安装 , 先下载 homebrew
- 用 homebrew 再装一个 ruby, 这样 local 归 local, system 归 system.
brew install ruby
- 安装Jekyll
brew install jekyll
4.Jekyll 搭建博客
可能出现的错误:
错误1
由于RubyGems 镜像服务更换域名, 可能会报一下错误
ERROR: Could not find a valid gem 'nokogiri' (>= 0), here is why:
Unable to download data from https://gems.ruby-china.org/ - bad response Not Found 404 (https://gems.ruby-china.org/specs.4.8.gz)
RubyGems 镜像更换域名为.com后缀
解决:
Ruby China 官网已经说的很明白了, 这里我也写一下
a.更换镜像，尽可能用比较新的 RubyGems 版本，建议 2.6.x 以上。
$ gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
$ gem sources -l
https://gems.ruby-china.com
# 确保只有 gems.ruby-china.com
b.更新gem
$ gem update --system # 这里请翻墙一下
$ gem -v
更新gem镜像成功
错误2
没有执行权限
Fetching: mini_portile2-2.3.0.gem (100%)
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/Gems/2.3.0 directory.
解决1: 执行命令前加 sudo.
比如:以上这个bug是我在 执行 gem install nokogiri出错的, 改为sudo gem install nokogiri 再次执行即可.
解决2:使用homebrew 重新安装一个ruby, 不使用mac自带ruby, 这样所有软件都安装到brew路径中, 不会有权限问题.
(未完....)
网友评论