Ghost Blog Platform on Github Pages

https://abhijithvijayan.github.io/ghost-blog-demo/

🙋‍♂️ Made by @abhijithvijayan

Donate: PayPal, Patreon

Update: The flexibility of this project allows you to push the static site to any github repo and deploy it with any service like Netlify. I'd recommend connecting the repo to Netlify service and deploy it there. Also, Netlify provides features like Custom Domain free of charges.

Table of Contents

• Requirements
  • 1) Install Major Dependencies
  • 2) Install Other Packages
• Setup
  • 1) Install Ghost
  • 2) Create a new Github repository
  • 3) Deploying to Github Pages
• How to update your blog?

Requirements

1) Install Major Dependencies

Install NodeJS

Install a version that is officially supported by Ghost, preferably latest LTS

curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install -y nodejs

2) Install Other Packages

Install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Install Node.js runtime

Ghost is written in Node.js, so you will need the Node.js runtime.

brew install node
brew install wget
sudo apt-get install build-essential

Initialize npm

npm init

Enter the credentials when asked

• github username in the name field*
• repository name(eg: username.github.io)
• a description*

Leave the other less important fields empty.

Install yarn

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update && sudo apt install yarn

Setup

1) Download and Install Ghost

npm install ghost-cli@latest -g

Change the present working directory

mkdir ghost && cd ghost

Install Ghost

ghost install local --no-start --enable --port 2368

Start Ghost

ghost start

Open browser and navigate to

http://localhost:2368/

Login to Ghost

http://localhost:2368/ghost/

Go to the above link in your browser ans if it doesn't show anything, check the status of the blog with

ghost status

Create an account, read the intial blog post how to edit with Markdown etc.

2) Create your GitHub Pages repo

Create a repo with create-remote-repo CLI

You must use the username/username.github.io naming scheme. The repo name must be lower case even if your username has upper case letters.

npx create-remote-repo username.github.io

# Replace with your username

3) Deploy to GitHub Pages

Create a file named deploy.sh with contents from deploy.sh

Give execute permission

chmod u+x deploy.sh

Deploy with

./deploy.sh

For the initial push, please wait up to 10 minutes until GitHub deploys your subdomain.

All upcoming pushes are much faster and you can see your static ghost blog posts at https://username.github.io

Write new Blog posts

To write new Blog posts or update the existing ones, just start Ghost, edit, then generate and deploy the static pages.

cd ghost
ghost start

Visit

http://localhost:2368/ghost/

Login and write new posts

Deploy with wget

After writing new posts, deploy with wget. Run the deploy.sh script/.

./deploy.sh

Enter the credentials when asked!

Voila! You got yourself a ghost blog on github pages

• Live Version: https://abhijithvijayan.github.io/ghost-blog-demo/
• Demo Repo: https://github.com/abhijithvijayan/ghost-blog-demo
• Custom Theme Repo: https://github.com/abhijithvijayan/Casper-XYZ