Skip to content

SarahRogue81/asciidoc_converter

Repository files navigation

asciidoc_converter plugin for Bridgetown

a Bridgetown plugin to convert AsciiDoc files to HTML using asciidoctor. it also loads Front Matter from the AsciiDoc file - so you can write:

= My AsciiDoc Post
:layout: post
:author: me
:description: awesome description

this is my awesome post

note that the Front Matter doesn’t have a blank line at the top - this is important and an AsciiDoc rule besides

Installation

run this command to add this plugin to your site’s Gemfile:

bundle add asciidoc_converter

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

init :asciidoc_converter

Usage

the plugin will convert AsciiDoc files to HTML during the build process

Contributing

  1. fork it (https://github.com/SarahRogue/asciidoc_converter/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

About

adds AsciiDoc support to Bridgetown static websites - it loads the Front Matter and also does the conversion to HTML

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages