Nanoc VS decap-cms

When we decided to open-source our blog and docs, we were spoilt for choices. Today there are multiple well-supported and fully-featured frameworks for open-source content creation. Some of the options that we considered were Ghost, Jekyll, Hugo, Nanoc, and Gatsby. There are even more frameworks beyond these, and each tool has its pros and cons. Which one do we recommend? Well, we don’t. The best tool for you is the one that fulfills your requirements.

My websites use a static site generator, that means I have folders of Markdown files and they get converted by this program to HTML. (I'm using nanoc for nearly a decade, but other generators work fine. I like Ruby, so that's why I never tried any of the new JS stuff.) I don't just hit publish on my whole Zettelkasten, but that would work as well if you point your static site generator to your note archive.

Last time I was evaluating static site generators, Dimples and Nanoc both stood out for this recent-updates reason, among other personal criteria.

https://github.com/waferbaby/dimples

https://nanoc.ws/

Following one of the comments in this thread I reviewed two other products in this space - https://www.staticcms.org/ and https://decapcms.org/ - and it looks like the webpages are almost a direct copy of one another, one in dark mode and one in light mode.

I'm a technical product marketer, and I find these type of landing page copying amusing to no end.

Decap CMS, formerly Netlify CMS, is an extensible headless CMS built as a single-page React app. It’s an open source and completely free-to-use option that offers rich-text editing, real-time preview, and drag-and-drop media uploads.

You can look into a Git-based CMS, such as https://github.com/decaporg/decap-cms

These typically are designed to support static site generators.

I found https://decapcms.org/ which seems like an easy to use.

Did you consider https://decapcms.org/ (previously Netlify CMS)? I'm surprised it never really caught on as it seems a good fit for most small Markdown based sites. Looks like Smashing Magazine was using it before they moved to Tina CMS (https://www.smashingmagazine.com/2020/01/migration-from-word...).

Products like [decap CMS](https://github.com/decaporg/decap-cms) try to bridge that gap, but I agree that this space needs to be further developed. In fact I think there needs to be a bunch more work to allow mere mortals to use version control and branch workflows in day to day work.

I've thought of something similar! A git-based flow for a friend's static portfolio site, where he can make text edits and upload images, and the site builds that content with HTML templates.

Not sure how the GitHub markdown editor would feel for the user. It might be really great, even for uploading images.

I was imagining a static admin page, WYSIWYG, that makes git pushes on submit. These were the headless CMSs that seem to be able to accomplish that:

https://www.siteleaf.com/

https://decapcms.org/

And not git based, but similar idea: https://editable.website/

And this is what the admin edit page usually looks like: https://quick-edit-demo.vercel.app/admin/index.html#/collect...

But was taking a bit of work to configure.

Since I made my post, I've also discovered Decap CMS. This looks fairly close to what I was looking for - it deploys as a static SPA alongside the site on a /admin route, allows login with Github (and several other platforms), and builds the site using a choice of static site generator like Gatsby/Hugo/Jekyll etc. The templates are relatively rigid by default though - page layouts are defined up front, and to add a page with a different layout you need to manually add some files to the repo. It seems like there's a way to work around this and add flexibility, but it needs a bit of custom React development. It seems like this might be worth the time investment for me though, since it's the closest thing I've found to what I need so far.

If you've got the content in .md and .json files and you just need a way to add or modify that content, I would recommend you look into decap CMS (formerly netlify CMS)