/kushy-blog-gatsby

Blog for Kushy.net using GatsbyJS

Primary LanguageJavaScriptOtherNOASSERTION

Kushy Blog

A blog created with the GatsbyJS framework to generate a static React powered website. It's lightning fast, SEO and PWA friendly, and deploys directly to a CDN like Github Pages or Netlify.

This is a JavaScript alternative to the static site generator solutions written in Go or Ruby. It's also more fleshed out than the Gatsby Starter Blog with features like blog archives, image handling, SEO optimization, and a few more.

Categories

We use a tag based system, but we do have primary categories to store content in (using tags):

Main Content

  • announcements
  • community
  • activism
  • weeducation
  • strains
  • products
  • health
  • science
  • food
  • travel
  • business
  • kushy-list - Top 10/20/etc shops, strains, products, etc.

Developer Section

  • developers
  • tips
  • tools
  • developer-community
  • spotlight

Post Format / Fields

---
title: Deploy a Static React Blog using GatsbyJS and Github
date: "2018-03-21"
section: blog
cover_image: "./bulma-css-framework@1x.jpg"
tags: [ 'design', 'development', 'react', 'github', 'gatsbyjs', 'ssg', 'static site generator' ]
author: Ryo
---

Your post here
  • Section can be blog or project.
  • Tags must be array
  • Body content can include Markdown or HTML.
  • Date must be in YYYY-MM-DD format (add zeros to single digit months/days -- e.g. 2018-01-01)

Plugins

Codepen

To embed Codepen modules, just copy the embed code and remove the JS script that gets imported.

Twitter

Seamlessly embed Tweets into posts by copying the blockquote portion of the embed code to your Markdown file. Don't copy the linked JS file, the plugin handles that automatically.

Manifest

Configure in gatsby-config.js.

RSS Feed

Configure in gatsby-config.js.

Development

Running on GatsbyJS, an SSG that creates static React apps.

  1. npm install
  2. npm run develop

Deployment

Github Pages

We locally build the files, then deploy using an NPM script that updates a specific Git repo branch called gh-pages.

To enable this, just initialize a git repo in the project, commit your changes, and add your Github repo as a remote repo. Make sure to label the remote as origin, otherwise the Gatsby deploy won't know which repo to push to.

Deploy site to origin remote repo:

npm run deploy

Creating or editing content

  1. git pull from remote origin to ensure you have the latest posts and to merge any conflicts.
  2. Add a new folder to src/content/projects or src/content/blog named after your post. This will be converted to the slug of the article -- you don't need to 'kebab-case' your title, but keep the format in mind.
  3. Create a Markdown file in the folder. Make sure to use previous files as a template to include all the appropriate fields (listed above).
  4. Fill out the post, make sure to include a cover image (see next step for handling images)
  5. For any images, include them in the same folder as the post's Markdown and link locally using <img src="./my-image.jpg" />.
  6. Run npm run deploy in the project root to deploy to Github Pages.

Netlify

This site is also capable of deploying on Netlify. Simply login to Netlify, create a new app, and point to this repository. Follow the steps, make sure Netlify is running gatsby build and pointing to the /public directory. This also allows you to use the Netlify CMS, since it requires a server for OAuth2 support and hosting on Netlify allows you re-build on each edit (rather than building from you personal machine and deploying from there).

Credits