This is the blog source files presented at https://jiezheng.org.
Consider not to include stop words to keep URL simple and short. Please read What are stop words?
The site is using Jekyll for generation.
I use MacPorts on Macbook with customized installation path.
Set GEM_HOME
in your .bash_profile
. This could help you from messing up
your global lib, also provide easy version management.
export GEM_HOME=/usr/local/ruby/gems/2.7.0
$ /usr/local/MacPorts/bin/gem2.7 install jekyll
$ /usr/local/ruby/gems/2.7.0/bin/jekyll new --skip-bundle jekyll-sample
Tip
|
The --skip-bundle option prevent automatic bundling after generation.
|
Change to the generated site directory, then
$ /usr/local/MacPorts/bin/bundle2.7 install
$ /usr/local/ruby/gems/2.7.0/bin/jekyll server
After start server, go to http://127.0.0.1:4000/ in Browser.
AsciiDoc is a concise and comprehensive authoring format. AsciiDoctor is a fast implementation of it. jekyll-asciidoc plugin adds AsciiDoc support to Jekyll.
Add the following snippet to Gemfile.
# asciidoctor for AsciiDoc gem 'asciidoctor', '~> 2.0', '>= 2.0.18' gem 'slim', '~> 5.1', '>= 5.1.1' # Pygments for syntax highlighting gem 'pygments.rb', '~> 2.3', '>= 2.3.1' group :jekyll_plugins do gem 'jekyll-asciidoc', '~> 3.0' end
Create a directory _templates
in your site to store your templates.
Find additional examples of custom templates in the
asciidoctor-backends repository.
AsciiDoctor provides several converters. For site just refer to html5 in slim directory.