My goal is to find a way to adapt/co-opt Hugo templates into an .NET driven static site generator.
Right now the two main candidates are Statiq and Fornax
- What dependencies does it require? (npm, netfx, dotnet-core)
- Does it seem to be maintained?
- Does it have a good update story?
- How easy is it to get started? (good tutorial, templating)
- Can I change the structure easily to fit the divio structure?
- Does it support search? Is the search useful?
- Does it handle versioning?
- Does it show which git-tag/version this documenation was generated for?
- Does it handle multi-lingual?
- Does it handle hot reloading of markdown->html?
- Can it generate pages from XML Doc comments?
- Which language(s) does it support? (C#, F#, VB)
- Can it hotload changes from doc comments?
- Does it put a github link on the type/method/function to where the code is?
- Does it handle tags like exception, example, see, returns, params, summary, remarks?
- Does it handle obsolete, requirequalifiedaccess or other attributes?
- Can it easily pull in project metadata like CHANGELOG, README, LICENSE, etc?
- Does it let a user fix problems with documentation easily (having a link to the markdown file)?
- Does it support multiple css templates (light/dark mode)?
- Just markdown
- Markdown + supporting tools
- Full tools