piotr-s-brainhub-gatsby-docs-kit

Easy to Maintain Markdown/React Documentation Static Websites

Usage no npm install needed!

<script type="module">
  import piotrSBrainhubGatsbyDocsKit from 'https://cdn.skypack.dev/piotr-s-brainhub-gatsby-docs-kit';
</script>

README

Gatsby Docs Kit

npm npm

Easy to Maintain Markdown/React Documentation Static Websites

Gatsby Docs Kit is a set of tools, extending Gatsby to generate gorgeous documentation static website. Documentation source files are written in Markdown or as React components and configured with a single YAML/JSON5 configuration file.

Features

  • Write in Markdown - Save time and focus on your project's documentation content. Simply write docs with Markdown and Gatsby will generate a set of static html files ready to serve.
  • Customize with Gatsby and React - Need something extra? Just create React component and voilà. You can do anything. Meanwhile Gatsby’s rich data plugin ecosystem will let you bring data from one or many other sources.
  • Preview as you work - As you edit content, you see the resulting UI change in your local development environment browser without refreshing the page.
  • Static Progressive Web Apps - Gatsby.js builds the fastest possible website. You get code and data splitting out-of-the-box. Gatsby loads only the critical HTML, CSS, data, and JavaScript so your site loads as fast as possible. Once loaded, Gatsby prefetches resources for other pages so clicking around the site feels incredibly fast.
  • Host anywhere - Gatsby Docs Kit builds completely static HTML sites that you can host on GitHub pages, Netlify, or anywhere else you choose

Try it out

Ensure you have the latest version of Node installed. We also recommend you install Yarn as well.

Clone starter repository:

git clone git@github.com:brainhubeu/gatsby-docs-kit-starter.git docs-www && cd docs-www && rm -rf .git

Then run:

yarn install

Seed documentation (if you do not have any yet):

yarn seed

Run the local webserver via yarn develop;

The example site is available at http://localhost:8000. You should see the example site loaded in your web browser. Also visit http://localhost:8000/___graphql to explore your site's GraphQL data and schema.

Then go to ../docs to edit and write awesome docs!.

Deploy

Ready to go? Want to deploy documentation to github pages? Run following command inside docs-www directory:

yarn deploy:gh