Skip to content

Latest commit

 

History

History
110 lines (91 loc) · 2.83 KB

jekyll-cheat-sheet.md

File metadata and controls

110 lines (91 loc) · 2.83 KB
Raw

jekyll cheat sheet

translate yaml/markdown/liquid to html pages Transform your plain text into static websites and blogs.

Other static sites generators, blogging tool

Template language Liquid

Templates for dynamic web page creation

How to start with Jekyll

git clone https://github.com/sharu725/online-cv.git
cd online-cv
# Start Jekyll like: docker run ...
x-www-browser localhost:9090

Start Jekyll

Manual installation

sudo apt install bundler jekyll
bundle add webrick

### check versions 
ruby --version
# ruby 3.1.1p18
gem --version
# 3.3.25

Docker container start

DOCKER_IMG_NAME=jekyll/jekyll
DOCKER_IMG_TAG=3.8
# DOCKER_IMG_TAG=3.9.3
# DOCKER_IMG_TAG=latest
DOCKER_JEKYLL=jekyll

# start server with caching gem's
docker run --rm --name $DOCKER_JEKYLL --volume="$PWD:/srv/jekyll:Z" --volume="$PWD/vendor/bundle:/usr/local/bundle:Z" --publish [::1]:4000:4000 $DOCKER_IMG_NAME:$DOCKER_IMG_TAG jekyll serve --force_polling
# connect to running container 
# docker exec -it `docker ps | grep jekyll/jekyll | awk '{print $1}'` /bin/sh
x-www-browser http://localhost:4000


wkhtmltopdf

docker-compose start

version: "2"
services:
  jekyll:
      image: jekyll/jekyll:3.9.3
      command: jekyll serve --force_polling
      ports:
          - 4000:4000
      volumes:
          - .:/srv/jekyll
          - ./vendor/bundle:/usr/local/bundle
      environment:
        JEKYLL_UID: 1001
        JEKYLL_GID: 1001

jekyll commands

# create new source folder
jekyll new my-cv

# build web pages
jekyll build

# bundle exec jekyll serve
jekyll serve
jekyll serve --force_polling --livereload
x-www-browser localhost:4000

possible issues

  • `require': cannot load such file -- webrick
# gem install webrick # didn't work
bundle add webrick
bundle exec jekyll serve