本文介绍如何利用Jekyll创建一个静态站点,并托管到GitHub Pages上。
JeKyll
JeKyll是一个基于Ruby的博客类静态网站生成器。
Jekyll是一个简单,可扩展的静态站点生成器。您可以使用自己喜欢的标记语言编写文本,然后通过布局来创建静态网站。在整个过程中,您可以调整网站URL的显示方式,布局中显示的数据等
基于JeKyll创建静态网站
-
安装Ruby开发环境 (以macOS 为例) macOS Mojave 10.14 可省略以下安装步骤
1.1 安装Homebrew和Ruby
# Install Homebrew /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" brew install ruby
1.2 导出Ruby环境变量
echo 'export PATH=/usr/local/opt/ruby/bin:$PATH' >> ~/.zshrc
1.3 检查Ruby是否安装成功
which ruby /usr/local/opt/ruby/bin/ruby ruby -v ruby 2.6.0p0 (2018-12-25 revision 66547) [x86_64-darwin18]
-
安装打包器和jekyll
gem install --user-install bundler jekyll
-
创建一个新的Jekyll网站
jekyll new myblog
若提示 command not found: jekyll ,需要把gem路径配置到PATH里面
-
编译网站并启动本地服务
cd myblog bundle exec jekyll serve
访问http://localhost:4000/查看效果
GitHub Pages
GitHub Pages是直接从GitHub仓库托管的个人网站和项目网站。
基于GitHub Pages托管网站
-
创建一个仓库
前往GitHUb创建一个新的仓库,仓库名称为username.github.io,其中username是你的GitHub用户名或者组织名称。 -
克隆仓库
把步骤一创建的仓库克隆到本地。git clone https://github.com/username/username.github.io
-
创建第一个页面
进入项目目录,新建一个index.html的文件。cd username.github.io echo "Hello World" > index.html
-
推送到远程仓库
增加、提交和推送你的更改git add --all git commit -m "初始提交" git push -u origin master
-
你已经成功完成
访问https://username.github.io查看效果
整合部署
将Jekyll生成的静态网站复制到username.github.io仓库并提交推送到GitHub
cp -r myblog/** username.github.io
后面直接修改仓库文件,用Jekyll编译提交即可。
网友评论