jekyll-TeXt-theme

起初是想找博客模板,后面偶然看到这个开源项目。简洁明了,注重文字,关键还支持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原址:

kitian616/jekyll-TeXt-theme: 💎 🐳 A super customizable Jekyll theme for personal site, team site, blog, project, documentation, etc. (github.com)

官方文档:

快速开始 - 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/)