You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The official docs state that this gem/plugin is a default plugin that cannot be disabled. However, it doesn't appear to work at all when deployed to github or locally.
From the README.md:
What it does
Let's say you have a link like this in a Markdown file: [foo](bar.md)
While that would render as a valid link on GitHub.com, it would not be a valid link on Pages.
Instead, this plugin converts that link to: [foo](bar.html)
It's supposed to make relative markdown links work without modification when deployed to gh-pages. Some of the things that could be handled by this plugin are currently being handled by the docs gulp task.
foo.md and the adjacent bar.md are converted to foo/index.html and bar/index.html respectively by the Jekyll build process.
A relative link in foo.md must refer to bar/index.html by ../../bar thus the normal ../bar.md and/or simply bar.md must be converted for links to work properly.
TL;DR
This link conversion process adds some (would be) unnecessary complexity to current build scripts. It would be better if we could get this plugin to work to simplify things.
The official docs state that this gem/plugin is a default plugin that cannot be disabled. However, it doesn't appear to work at all when deployed to github or locally.
From the README.md:
It's supposed to make relative markdown links work without modification when deployed to gh-pages. Some of the things that could be handled by this plugin are currently being handled by the docs gulp task.
foo.md
and the adjacentbar.md
are converted tofoo/index.html
andbar/index.html
respectively by the Jekyll build process.A relative link in
foo.md
must refer tobar/index.html
by../../bar
thus the normal../bar.md
and/or simplybar.md
must be converted for links to work properly.TL;DR
This link conversion process adds some (would be) unnecessary complexity to current build scripts. It would be better if we could get this plugin to work to simplify things.
Relevant Issues:
The text was updated successfully, but these errors were encountered: