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.
In Metalsmith, all of the logic is handled by plugins. You simply chain them together. Since everything is a plugin, the core library is actually just an abstraction for manipulating a directory of files.
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.
Read template files from a directory;Parse files for template placeholders;Prompt user to fill in each placeholder;Render files with aytemplating engine;Write filled-in files to a new directory
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.
Statistics
GitHub Stars
51.0K
GitHub Stars
-
GitHub Stars
-
GitHub Forks
10.2K
GitHub Forks
-
GitHub Forks
-
Stacks
2.0K
Stacks
53
Stacks
1.3K
Followers
1.4K
Followers
66
Followers
1.2K
Votes
230
Votes
19
Votes
206
Pros & Cons
Pros
74
Github pages integration
54
Open source
37
It's slick, customisable and hackerish
24
Easy to deploy
23
Straightforward cms for the hacker mindset
Cons
4
Build time increases exponentially as site grows
2
Lack of developments lately
1
Og doesn't work with postings dynamically
Pros
9
Plugability
4
Easy to install, easy to hack, easy to deploy
2
Really works hard to be simple
1
CI: push to github, auto-deploy to netlifly (free)