bridgetown-docs-template

A minimal Bridgetown template for a documentation site using Tailwind CSS.


Keywords
bridgetown, bridgetown-plugin, bridgetownrb, docs-site, documentation-template, documentation-theme, tailwindcss, theme
License
MIT
Install
gem install bridgetown-docs-template -v 0.1.0

Documentation

Bridgetown documentation template using Tailwind CSS

A Bridgetown documentation site theme, built with Tailwind CSS.

preview of the Bridgetown documentation theme, built with Tailwind CSS

Sponsored By Spinal

Spinal CMS logo

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.

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