While working on YETUS-856, I determined that our version of Middleman
doesn’t actually seem to fully honor the markdown spec. Now, YETUS-307
(upgrade to Middleman v4) has been hanging around for a while. So I thought
sure, let’s see what it does… well… I figured out the source of the generation
problems: v4 has changed how it handles file extensions.
In v3:
foo.md -> foo/index.html
In v4:
foo.md -> foo
foo.md.html -> foo.html
So it looks like in order to upgrade, we pretty much need to rework the
entire website. If that’s the case, then it may be worth our while to look at
alternatives.
Since we’re already in maven territory, it may be worthwhile to just
make the jump to maven site (and https://github.com/devacfr/reflow-maven-skin —
a fork of the original reflow-maven-skin — looks promising with a few mods).
But there are a lot of other generators out there.
Thoughts?
