Git Product home page Git Product logo

gatsby-theme-glossary's Introduction

gatsby-theme-glossary

A minimalist Gatsby Theme for a glossary built with MDX and Theme UI.

Get up and running in seconds with a beautiful glossary so you can do what's more important: define terminology.

image

Features

  • ๐Ÿ“‘ MDX files per letter
  • ๐ŸŽจ Theme UI-based theming
  • ๐Ÿ“ฑ Mobile friendly

Directory structure

glossary
โ”œโ”€โ”€ a.mdx
โ”œโ”€โ”€ b.mdx
โ”œโ”€โ”€ ...
โ””โ”€โ”€ z.mdx

Installation

yarn add gatsby-theme-glossary

Install as a starter

Name Command
Base gatsby new johno/gatsby-starter-glossary

Usage

// gatsby-config.js
module.exports = {
  plugins: [
    'gatsby-theme-glossary'
  ]
}

Options

Name Default Description
contentPath glossary Path to directory of glossary files
basePath glossary Path to render the glossary page

Customizing

The glossary itself can be customized in a few ways. You can change the description text, the layout, and even the theme.

Description

You can optionally include a description under the glossary title that can introduce/describe the glossary that will follow below. You can achieve this by shadowing the description.mdx file:

src/gatsby-theme-glossary/description.mdx

## Hey!

This is a custom description of my glossary.

Layout

gatsby-theme-glossary doesn't use a layout because it's intended that you shadow the layout component with your own so that it's properly embedded in your site.

// src/gatsby-theme-glossary/components/layout.js
export { default } from '../../components/layout'

Theme

This theme uses Theme UI so you can read about how to customize the theme in the official docs.

License

MIT

gatsby-theme-glossary's People

Contributors

johno avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.