How to use

Content creation

MDX

⚠️ You must use frontmatter category & title properties to make your content appear into the tree.

  • title (mandatory)

The title of the file, will be used to display the file name into the side menu tree.

  • category (optional)

Is an array of strings that will correspond to the folder hierarchy where the file will be available.

Theme customization

Theme shadowing is a gatsby feature that allows you to replace any file / component of the theme by your own if you want to.

In making the theme, we purposely made some components explicitly available for shadowing. The intent is to use this feature for maximal customization power - but making the most commonly customized files easily accessible.

Files you probably want to shadow

For minor customization, those files should be sufficient. If the default appeareance already satisfies you, shadowing only those files should do the trick:

  • colors.js

As the name implies, this file contains the colors used to make the documentation: change those and you can easily add your touch to the site, without heavy changes.

  • meta.js

At the moment, only contains the siteName key that you will want to override.

  • tags.js

This file contains all the style used to produce the html tags for your markdown. If you need to customize how the headers, table or anything of this kind are rendered, shadow this file, copy its content and customize !

Files you might shadow

If you need a higher degree of customization, here are the files you will probably have to shadow:

  • themeConfig.js

Contains some global css styles and font rendering settings (family, size).

  • every files of components folder

I extracted most of the dumb components used to produce the UI in this folder so that you can easily find them and override them.