Hakyll VS DocFX

Others have mentioned static site generators. I like Hakyll [1] because it can tightly integrate with Pandoc [2] and allows you to develop custom solutions if your needs ever grow. [1]: https://jaspervdj.be/hakyll/ [2]: https://pandoc.org/. - Source: Hacker News / 3 months ago

Honestly, I've had a great experience with Hakyll for static site generation. There's a bit of a learning curve to effectively use the library/framework, but in my opinion the learning curve is much lower than Yesod/Fay. If all you need is to build static website pages, I'd suggest Hakyll. Source: almost 2 years ago

Love SSGs too! Came here to share praise for Hakyll[1], for people with an FP leaning. Predictably, it's not easy to get started, but once you're into it the power of building your own arbitrary content "compilers" (and template extensions etc etc) is pretty impressive. [1] https://jaspervdj.be/hakyll/. - Source: Hacker News / over 2 years ago

Hi there. A friend of mine wanted to publish a blog/site at both French and English. I told him about static generators and Hakyll from u/jaspervdj but the internationalization piece was missing. Of course there are other generators with internationalization but... Well here is one for Hakyll. * Generator source code * Use case and its source code --- If it already exists, ‏‏‎ please hide that fact from me. If not... Source: over 2 years ago

This info is relevant because Hakyll application requires to be complied before it generates the pages, and the compilation process of Haskell is a pretty expensive (computationally saying). Although, the executable is incredible fast, due to great work made by the compiler. This processing cost will be discussed soon. - Source: dev.to / almost 3 years ago

This is a better looking version of what Java and C# have had for a long time (kudos to the author for that!), is that the inspiration for this tool? https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html https://dotnet.github.io/docfx/ I saw the author mentioned in another comment that they found themselves peeping inside type declaration files "too often". While I do often use sites generated... - Source: Hacker News / 5 months ago

Actually, we use it for OptiTune, it's called "docfx" https://dotnet.github.io/docfx/. Source: over 2 years ago

We would really prefer to use a somewhat generic pre-made tool for this (such as DocFX) compared to rolling our own solution. We can roll our own solution... But would prefer not to so that we can minimize development and maintenance overhead. Source: over 2 years ago

I use docfx from microsoft to generate documentation for all my oss libraries. Source: over 2 years ago

My best guess would be that there's a CI/CD pipeline in GitHub that utilizes DocFX to convert the Markdown files to HTML. The constructed HTML files are then placed in an Azure Storage account that configured for Static Website Hosting combined with Azure CDN. Source: over 2 years ago