Getting Started

1. 环境基于如下包构建： Ruby and Bundler to use Jekyll，环境配置需求参考 Using Jekyll with Bundler。在Ubuntu 或 Win10 WSL Ubuntu 上的软件安装命名如下：

$ sudo apt-get install git-core curl zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev

$ sudo apt-get install ruby ruby-dev ruby2.7 ruby2.7-dev rubygems 

$ sudo gem install jekyll jekyll-gist jekyll-sitemap jekyll-seo-tag jekyll-paginate

Tips: 在 Win10 WSL Ubuntu 上设置环境时，需要切换到 Ubuntu 原始 apt 源，有人反馈国内部分 apt 源软件包安装问题。

2. Installed dependencies in the Gemfile:

$ bundle install 

3. Serve the website (localhost:4000 by default):

$ bundle exec jekyll serve  # alternatively, npm start

Development (Build From Source)

To modify the theme, you will need Grunt. There are numbers of tasks you can find in the Gruntfile.js, includes minifing JavaScript, compiling .less to .css, adding banners to keep the Apache 2.0 license intact, watching for changes, etc.

Yes, they were inherited and are extremely old-fashioned. There is no modularization and transpilation, etc.

Critical Jekyll-related code are located in _include/ and _layouts/. Most of them are Liquid templates.

This theme uses the default code syntax highlighter of jekyll, Rouge, which is compatible with Pygments theme so just pick any pygments theme css (e.g. from here and replace the content of highlight.less.

Interesting to know more? Checkout the full user manual!

User Manual 👉

License

Apache License 2.0. Copyright (c) 2021-present WePDLA

WePDLA Blog is derived from Hux Blog (Apache License) Copyright (c) 2013-2016 Blackrock Digital LLC.

Hux Blog is derived from Clean Blog Jekyll Theme (MIT License) Copyright (c) 2013-2016 Blackrock Digital LLC.