跳转至

Jekyll


Jekyll Themes

Install & Config on Ubuntu

  • Install all prerequisites (https://jekyllrb.com/docs/installation/ubuntu/)

    Bash
    sudo apt-get install ruby-full build-essential zlib1g-dev
    
    echo '# Install Ruby Gems to ~/tools/gems' >> ~/.bashrc
    echo 'export GEM_HOME="$HOME/tools/gems"' >> ~/.bashrc
    echo 'export PATH="$HOME/tools/gems/bin:$PATH"' >> ~/.bashrc
    source ~/.bashrc
    

  • Ruby 国内镜像源 (https://blog.hyperzsb.tech/ruby-mirror-source/)

    Bash
    gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
    gem sources --clear-all
    gem sources --update
    gem sources -l
    

  • Install the jekyll and bundler gems

    Bash
    gem install jekyll bundler
    

  • generate or update Gemfile.lock

    Bash
    # delete Gemfile.lock
    bundle install
    

  • run in your project dir:

    Bash
    jekyll serve --no-watch
    # or
    bundle exec jekyll serve --no-watch
    

HOW TO RELEASE

Preparation

  • assets/css/main.scss use configurable skin

  • update CHANGELOG.md

  • update version (jekyll-text-theme.gemspec, package.json, _includes/scripts/variables.html)

Publishing

  • run npm run gem-build to build gem
  • run npm run gem-push to publish gem to rubygems.org
  • run git add . && git commit -m "release: vx.x.x" to make a release commit
  • run git tag vx.x.x to add a tag
  • run git push && git push origin vx.x.x to push
  • edit release on github.com