This repository contains the code, text, and assets of my personal blog which you can find here at www.janmeppe.com.
Clone the repo
git clone https://github.com/Rainymood/rainymood.github.io
Assuming you have a working installation of Ruby, install the bundler
gem install bundler
And install all the gems
bundle install
If this is the first time you are setting up the blog on a new computer. Generate a new Personal Access Token (PAT) here.
Run the blog with
rake build
Usually we would run the blog using bundle exec jekyll serve
or simply build
.
This is a workaround due to a unicode error/bug that I still haven't fixed which you can read more about here:
Run the blog with
bundle exec jekyll serve --livereload -o --drafts --future
Switch to a new branch. For example,
git checkout -b 220520-new-post
Run new-post.py
Input name of title (ctrl + C to cancel): dan harmon writing advice
foldername: 2022-05-20-dan-harmon-writing-advice
filename: 2022-05-20-dan-harmon-writing-advice.md
Successfully created assets\2022-05-20-dan-harmon-writing-advice
Successfully created _posts\2022-05-20-dan-harmon-writing-advice.md
Start writing, push to this branch, once you are done make a PR to the main branch and (squash) merge it in.
Edit assets\css\main.scss
I have some docs that I keep in the docs/
folder. Run and autobuild with:
sphinx-autobuild docs docs/_build/html
Some common issues and solutions can be found in FAQ.md.
- Minimal mistakes (Jekyll theme used)
- Configuration options
- Justin Rummel: I need to figure out how this guy added pictures
https://trello.com/b/Re16gCSo/janmeppecom
I should probably make an alias for this but I'm too lazy so I usually do cat readme.md
and then copy paste this command to start my blog locally.
The --incremental
flag is a lifesaver.
bundle exec jekyll serve --livereload -o --incremental