Skip to content

SpinalCMS/bridgetown-docs-template

Repository files navigation

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

You might also be interested in Rails Designer—the first professionally-designed UI components library for Rails.

Installation

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

$ bundle add bridgetown-docs-template -g bridgetown_plugins

Then add the initializer to your configuration in config/initializers.rb:

init :"bridgetown-docs-template"

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 of your Tailwind CSS config, like so:

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

One way this can be achieved without hardcoding paths is as follows:

const execSync = require("child_process").execSync;
const gemPath = execSync("bundle show bridgetown-docs-template", { encoding: "utf-8" }).trim();

module.exports = {
  content: [
    ...,
    gemPath + "/**/*.{html,md,liquid,erb,serb,rb}",
  ],
  ...
}

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

Examples

Related repo's

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