kfarleigh / rainymood.github.io

Jan Meppe's personal blog

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Janmeppe.com

This repository contains the code, text, and assets of my personal blog which you can find here at www.janmeppe.com.

Installation

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.

Running the blog (Mac)

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:

Running the blog (Windows)

Run the blog with

bundle exec jekyll serve --livereload -o --drafts --future

Writing posts

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.

Changing the styling

Edit assets\css\main.scss

Docs

I have some docs that I keep in the docs/ folder. Run and autobuild with:

sphinx-autobuild docs docs/_build/html

FAQ

Some common issues and solutions can be found in FAQ.md.

Resources

Kanban board

https://trello.com/b/Re16gCSo/janmeppecom

Tail for cat readme.md

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

About

Jan Meppe's personal blog


Languages

Language:Python 49.6%Language:SCSS 23.9%Language:HTML 23.0%Language:Ruby 3.4%