Me and a lot of colleagues have done documentation collaboratively with https://hackmd.io/ which also comes as an open source fork as https://hedgedoc.org/. The first has commenting function, the latter hasn't. Both make it easy to do doc sprints synchronously which means everybody is on the phone at the same time and write down documentation. As you do this with Markdown you can use your writing with https://squidfunk.github.io/mkdocs-material/ e.g. which is a static site generator running on Python and build beautiful documentation from Markdown files. If you want to build with https://gohugo.io/ I recommend https://www.docsy.dev/ theme.
We do scholarly writing and documentation with GitLab which we host on-premise. GitHub and GitLab come with sophisticated workflows for commenting and quality assurance if you learn to branch and merge which is for a lot of folks a steep learning curve. To onboard colleagues I recommend starting with HedgeDoc first and then migrate to more advanced workflows with Git(Lab|Hub).
Hi everyone, I'm trying to decide which front-end tool, that will likely use server-side rendering (SSR), in hopes it'll be faster. The end-user will upload a document and they see text output on their screen (like SaaS or microservice). I read that Gatsby can also do SSR. Also want to add a headless CMS that is easy to use.
As a Frontend Developer I wanted something simple to generate static websites with technology I am familiar with. GatsbyJS was in the stack I am familiar with, does not need any other languages / package managers and allows quick content deployment in pure HTML or Markdown (what you prefer for a project). It also does not require you to understand a theming engine if you need a custom design.
Think of Jekyll as a file-based CMS, without all the complexity. Jekyll takes your content, renders Markdown and Liquid templates, and spits out a complete, static website ready to be served by Apache, Nginx or another web server. Jekyll is the engine behind GitHub Pages, which you can use to host sites right from your GitHub repositories.
Punch allows you to use boilerplates to quickly setup a site, write minimal templates with Mustache, and create flexible site structures with inheritable layouts and partials.
Hugo is a static site generator written in Go. It is optimized for speed, easy use and configurability. Hugo takes a directory with content and templates and renders them into a full html website. Hugo makes use of markdown files with front matter for meta data.
Simple - No more databases, comment moderation, or pesky updates to install—just your content.;Static - Markdown (or Textile), Liquid, HTML & CSS go in. Static sites come out ready for deployment.;Blog-aware - Permalinks, categories, pages, posts, and custom layouts are all first-class citizens here.
-
Run Anywhere - Hugo is quite possibly the easiest to install software you've ever used, simply download and run. Hugo doesn't depend on administrative privileges, databases, runtimes, interpreters or external libraries. Sites built with Hugo can be deployed on S3, Github Pages, Dropbox or any web host.;Fast & Powerful - Hugo is written for speed and performance. Great care has been taken to ensure that Hugo build time is as short as possible. We're talking milliseconds to build your entire site for most setups.; Flexible - Hugo is designed to work how you do. Organize your content however you want with any URL structure. Declare your own content types. Define your own meta data in YAML, TOML or JSON.
