/gatsby-starter-minimal-blog-lekoarts-unofficial

Unofficial starter site for @lekoarts/gatsby-theme-minimal-blog

Primary LanguageJavaScriptMIT LicenseMIT

LekoArts’ Minimal Blog — Unofficial Starter

This is the “unofficial” starter site for @lekoarts/gatsby-theme-minimal-blog that adds modifications to the Blog page.

Comparison between original theme and this starter site

More information about the theme:

💡 If you have never used Gatsby before, head to their quick start guide or beginner-friendly tutorials. If you are familiar with Gatsby but not familiar with themes, see their Themes reference guide.

Installation

Use this starter to create a new site in the directory you specify.

# create a new site at "YOUR-SITE-DIRECTORY"
gatsby new YOUR-SITE-DIRECTORY ekafyi/gatsby-starter-minimal-blog-lekoarts-unofficial

# go to your directory
cd YOUR-SITE-DIRECTORY

# start your site
gatsby develop

If adding to an existing site, follow the regular theme installation instruction, then copy this starter’s src directory content to your site’s src directory.

Note: If you encounter ERROR #85923 GRAPHQL, run SHARP_IGNORE_GLOBAL_LIBVIPS=true yarn in your directory as discussed in this comment.

Usage

See complete usage instructions and examples here.

As with the original theme/starter site, you don’t have to modify any code—unless you want to. You can add your content right away (by default in content directory), update your site metadata and other options in gatsby-config.js, and you’re good to go.

Shadowed Components

I created this starter site with two modifications to the original theme:

  1. Group posts by year in the “Blog” page
  2. Display the list of tags in the Blog and Tag pages

Thanks to Gatsby’s “shadowing” feature, I can do it by adding relevant component files in this site’s src/@lekoarts/gatsby-theme-minimal-blog directory rather than fork the theme and edit its files directly.

💡 To learn more about shadowing, go to Shadowing in Gatsby Themes.

Other Notes

  • I leave everything else identical to the original starter site except one extra post dated this year.
  • I don’t use TypeScript here, but I leave the original typing commented out so you can easily enable it.