Install Jekyll on macOS and deploy your static website to GitHub Pages (opens in new tab)

(desiredpersona.com)

2 pointsdesiredpersona9y ago6 comments

6 comments

Don't do this unless you are a Jekyll developer. You don't need to install Jekyll on your Mac to test your website locally. Use Docker instead. There is a learning curve, but you can use your Docker skills for much more than just testing a static website.

Briefly, you need to (1) download and install Docker Community Edition for Mac, (2) create a DockerHub account and download a Docker image that's configured to run the GitHub Pages software, and (3) learn how to create a container and communicate with it. This is all documented online. Contact me if you need help.

desiredpersonaOP9y ago

Craig I have to disagree with you.

The official Jekyll docs recommend the best way to install Jekyll is via RubyGems. I have covered everything here for someone getting started with a Jekyll blog, all the necessary Git commands and steps to deploy to Github Pages. No need to manage containers, servers or databases.

Saying "Don't do this" is a little harsh as knowledge of Docker is really not necessary. Using Docker is more of a personal choice thats suits your workflow.

chmaynard9y ago

My advice is the result of wasting many hours installing, re-installing, and trying to update and tweak Ruby and Python software on my Mac, just to test various static websites. I learned nothing useful by doing this, and I'm trying to discourage others from making the same mistake.

1 more reply

j / k navigate · click thread line to collapse

6 comments

chmaynard9y ago

desiredpersonaOP9y ago

Craig I have to disagree with you.

Saying "Don't do this" is a little harsh as knowledge of Docker is really not necessary. Using Docker is more of a personal choice thats suits your workflow.

chmaynard9y ago

1 more reply

j / k navigate · click thread line to collapse