起初是想找博客模板,后面偶然看到这个开源项目。简洁明了,注重文字,关键还支持Markdown,我十分喜爱。
正巧也想做个计算机足球队的介绍网站,不如凑合着用用看。接下来是食用攻略。
一、开始
下载项目
git clone https://github.com/kitian616/jekyll-TeXt-theme.git
或从github页面下载zip包
源码上传服务器
二、环境搭建(ubuntu20.04)
安装 Ruby 和其他前置:
sudo apt-get install ruby-full build-essential zlib1g-dev
给rubyGem换源
gem sources --add https://mirrors.tuna.tsinghua.edu.cn/rubygems/ --remove https://rubygems.org/
bundle换源
bundle config mirror.https://rubygems.org https://mirrors.tuna.tsinghua.edu.cn/rubygems
避免以根用户身份安装 RubyGems 软件包(称为 gem)。相反 为您的用户帐户设置 gem 安装目录。以下 命令将环境变量添加到您的文件中以进行配置 GEM 安装路径:
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
安装 Jekyll 和 Bundler:
gem install jekyll bundler
安装项目依赖包
bundle install --path vendor/bundle
其实 bundle install 也可以
三、开发与编译
如果是远程服务器,可以用vscode的Remote-SSH插件远程连接工作文件夹
开发预览,http://localhost:4000/ 预览网站。
bundle exec jekyll serve
编译,生成 _site 文件夹,即目标文件
JEKYLL_ENV=production bundle exec jekyll build
四、配置 nginx
安装nginx
apt install nginx
修改配置文件
vim /etc/nginx/sites-enabled/default
修改 root 为 _site 所在的绝对路径,以下为个人例子
root /var/www/uscsocteam.com
五、添加Markdown文章
把Markdown文件丢到源码目录的 _posts 文件夹里,命名格式要求如下
年-月-日-标题.md
Markdown文件需要添加 yaml 头信息,写在最开头,格式如下
---
title: 标题
tags:
- tag1
- tag2
---
编译后,会生成对应的 html 文件,可以写一个 update.sh 文件用于更新文章
JEKYLL_ENV=production bundle exec jekyll build
rsync -avz /root/github/jekyll-TeXt-theme/_site/ /var/www/uscsocteam.com/
rsync 用于同步两个文件夹
运行 .sh 文件
bash update.sh
相关链接
github原址:
官方文档:
快速开始 - TeXt Theme (kitian616.github.io)
ruby换源:
Ruby gem,bundler默认源替换为国内镜像,可解决bundler install卡住等问题 - Geuni’s Blog
Jekyll:
[Installation | Jekyll • Simple, blog-aware, static sites (jekyllrb.com)](https://jekyllrb.com/docs/installation/) |
下篇图片测试