Bridgetown documentation template using Tailwind CSS

A Bridgetown documentation site theme, built with Tailwind CSS.

Sponsored By Spinal

Installation

Run this command to add this plugin to your site's Gemfile:

$ bundle add bridgetown-docs-template -g bridgetown_plugins

Requirements

There are a few requirements for this theme to run.

• Tailwind CSS
• Tailwind CSS Typograhpy
• ERB template engine

Minimum frontmatter requirements

The following frontmatter is expected in your collection resources:

• layout: bridgetown_docs_template/layout
• title
• description
• category

If you want to show the “video” or “quick links” section—likely in your docs root, add show_videotour: true and show_quicklinks: true to your root's markdown file.

Add the gem's path in the content array, like so:

content: [
  //…
  "path-to-your-gems"
  //…
]

Configuring views/components

This theme makes heavy use of Bridgetown's components. If you want to make certain tweaks to any part, it's easy to change any component. Just follow this guide.

Optional configuration options

The plugin will automatically use any of the following metadata variables if they are present in your site's _data/site_metadata.yml file.

• name
• email

Contributing

1. Fork it (https://github.com/spinalcms/bridgetown-docs-template/fork)
2. Clone the fork using git clone to your local development machine.
3. Create your feature branch (git checkout -b my-new-feature)
4. Commit your changes (git commit -am 'Add some feature')
5. Push to the branch (git push origin my-new-feature)
6. Create a new Pull Request