đź”— Bridgetown Internal Markdown links
This plugin allows you to write paths in your markdown similar to how you can within liquid, serbea or erb template files, like so:
[Check out the docs](_pages/docs.erb)
Instead of:
[Check out the docs](/docs/)
(and do a find/replace throughout your site, if the slug changes for that page).
This plugin uses Bridgetown's url_for() helper in the background.
Installation
Run this command to add this plugin to your site's Gemfile:
bundle add bridgetown_internal_markdown_linksThen add the initializer to your configuration in config/initializers.rb:
init :bridgetown_internal_markdown_linksUsage
Link parsing is opt-in per collection.
Configuration
Add the following in your config/initializers.rb:
config.internal_markdown_links.collections = ["posts", "docs"]Parsing of internal links is now happening for the collections “posts” and “docs”.
Disable per file
Set internal_markdown_links: false in the frontmatter.
Testing (TBD)
- Run
bundle exec rake testto run the test suite - Or run
script/cibuildto validate with Rubocop and Minitest together.
Sponsored By Spinal
Contributing
- Fork it (https://github.com/SpinalCMS/bridgetown-internal-markdown-links/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