Vuepress migration

[nliautaud]

Pros :

• Oriented towards documentation
• Localization may be easiest to implement
• Quicker build and dev refresh
• Vue / Components / Node ecosystem
• Static + PWA

---

https://github.com/nliautaud/nppmanuel/tree/vuepress

• Working implementation with default theme and overrides
• Custom composants for plugins and pages lists
• Auto sidebar listings
• Travic CI

---

Blocking issues :

• SEO / no pretty URLs : routes foo/bar.md are translated to foo/bar.html and not foo/bar, breaking existing URLs. The only hack is to place every page into its own subdirectory foo/bar/index.md, which isn't practical at all for writing.
  See Allow devServer to serve cleanURL vuejs/vuepress#603 / [Feature request] Cleaner and friendlier URLs vuejs/vuepress#608 / ✨ Remove '.html' extension from URLs vuejs/vuepress#1060
• SEO / no localized URLs : routes for related translated pages have to be identical (so, logically always in english). Current french routes would be broken. See [Feature request] Localized pages routes vuejs/vuepress#673 https://blog.davidpaternina.com/choosing-a-static-site-generator/#-the-not-so-good--3
• Locales organization : Localized content can't be fully isolated in subdirectories, which makes a mess.
  See [feature request] The file path & route of default language and others should be flat vuejs/vuepress#363
• Don't work locally / Relative urls : when built, assets and pages links are absolute, prefixed with \, so the documentation cannot be read locally from the filesystem, and thus cannot be downloaded/embedded as local doc.
  See Build with Relative URLs vuejs/vuepress#796 / Generated site does not work with local file:// access vuejs/vuepress#387 (comment) / Theme error building a site and sometimes even showing VuePress site vuejs/vuepress#575 / SSR will always add a '/' before assets url even if the publicPath is empty vuejs/vue#8167