The current website http://scalameta.org/scalafmt/ is built with scalatex (http://www.lihaoyi.com/Scalatex/). While I've personally found scalatex to be pretty great, the unorthodox markup language is a barrier for contributors. I would love to migrate the website to something tut + markdown based.
Copy-paste from #1144
I've tried hugo, gitbook, docusaurus, jekyll, ornate, doxidize, sphinx, read the docs, mkdocs but struggled to get
github-flavored markdown
mobile friendly
always accessible sidebar to jump between pages
always accessible TOC for open page
search (either generated in site or algolia is fine too)
"edit on github" links
anchor refs to headers for easy "click and share link to section"
template variable splicing to insert dynamic strings like project version (for copy-paste friendly installation instructions).
I can configure tut integration and publish to ghpages with mostly anything, and also port the existing scalatex pages to markdown + tut. My failure is a bigger sign of my experience with html/css than lack of functionality in those site generators 😅
The current website http://scalameta.org/scalafmt/ is built with scalatex (http://www.lihaoyi.com/Scalatex/). While I've personally found scalatex to be pretty great, the unorthodox markup language is a barrier for contributors. I would love to migrate the website to something tut + markdown based.
Copy-paste from #1144
I've tried hugo, gitbook, docusaurus, jekyll, ornate, doxidize, sphinx, read the docs, mkdocs but struggled to get
@hl.ref
in http://www.lihaoyi.com/Scalatex/#Highlighter (ideally with link to original file on github)I can configure tut integration and publish to ghpages with mostly anything, and also port the existing scalatex pages to markdown + tut. My failure is a bigger sign of my experience with html/css than lack of functionality in those site generators 😅