Markdown Lazylinks plugin for Bridgetown
A Bridgetown plugin to add support for lazylinks in markdown documents.
Installation
Run this command to add this plugin to your site's Gemfile:
bundle add bridgetown_markdown_lazylinksThen add the initializer to your configuration in config/initializers.rb:
init :bridgetown_markdown_lazylinksOr if there's a bridgetown.automation.rb automation script, you can run that instead for guided setup:
bin/bridgetown apply https://github.com/akarzim/bridgetown_markdown_lazylinksCustomization
You can customize the lazylinks placeholder in this way to use + instead of *:
init :bridgetown_markdown_lazylinks do
basic_placeholder "-"
external_placeholder "@"
endUsage
The plugin will allow you to use * as link references in your markdown
documents where the next [*]: href defines the link. For example, you can
write something like this:
This is my text and [this is my link][*]. I'll define
the url for that link under the paragraph.
[*]: http://brettterpstra.com
I can use [multiple][*] lazy links in [a paragraph][*],
and then just define them in order below it.
[*]: https://gist.github.com/ttscoff/7059952
[*]: http://blog.bignerdranch.com/4044-rock-heads/Since version 0.3.0, we can use + as an external link reference, in the same
way as *, but this will add target="_blank" rel="external" to the resulting
links.
Testing
- Run
bundle exec rake testto run the test suite - Or run
script/cibuildto validate with Rubocop and Minitest together.
Contributing
- Fork it (https://github.com/username/my-awesome-plugin/fork)
- Clone the fork using
git cloneto your local development machine. - Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Thanks to Brett Terpstra and TidBits for the inspiration!