how to setup Gatsby blog quickly

gatsby_setup_cheatsheet.md

How to setup Gatsby blog

0. target: src code maintained in master branch and the generated blog content stays in gh-pages branch.

1. global config: $HOME/.config/gatsby/config.json:

   • add this if you prefer yarn|npm:

     "cli": {
             "packageManager": "yarn"
     } 
     

2. gatsby-config.js:

   • add pathPrefix: "/", to the top within module.exports.
   • update everything of siteMetadata.
   • update trackingId for gatsby-plugin-google-analytics.
   • add gatsby-plugin-facebook-analytics if needed.
   • add gatsby-plugin-baidu-tongji if needed.
   • update gatsby-plugin-manifest for names and icon and more needed.

3. packages.json:

   • add gh-pages to devDependencies.
   • update dependencies version.
   • add a self-defined deploy to scripts such as "deploy": "gitgit \"update\" && gatsby build --prefix-paths && gh-pages -d public".

4. content:

   • update content/assets/logo.png.
   • update content/assets/logo_transparent.png.
   • update content/assets/profile-pic.png.
   • the most important: add your blogging content to content/blog/.

5. static:

   • add CNAME: add the subdomain as the content.
   • update favicon.ico.

6. update src/ wherever possible such as index, bio, layout, blog-post files.

7. generated folders:

   • public/