CMS.js is fully client-side, Javascript site generator in the spirit of Jekyll that uses plain ol' HTML, CSS and Javascript to generate your website. CMS.js is like a file-based CMS. It takes your content, renders Markdown and delivers a complete website in Single-Page App fashion...without the aid of server-side scripting (no Node.js, PHP, Ruby, etc.).
Check out a working demo here: dat:https://0d9e0bafd274f8ddee3327d1c2d6c196095d911ba64b73e0aed4d4e6087116e6
*** Requires Beaker Browser or other dat-compatible modern browser ***
CMS.js currently supports two website modes, Github and Server.
Github Mode
This is the default mode for CMS.js. Host your website on Github using Github Pages, similar to Jekyll.
Server Mode
Use server mode if you choose to self host your content. Apache and NGINX servers are supported. If using server mode, make sure the server's directory indexing feature is enabled.
- Apache - Make sure
htaccess
is enabled OROptions Indexes
is set for your directory.- NGINX - Make sure
autoindex on
is set for your directoryMore info on server setup is available on the wiki
No more need for external hosting, do it yourself with Beaker!
Just visit the demo site using Beaker, then Fork the site to create a local copy for yourself which you'll serve up to the swarm whenever your computer is online.
To create new posts, add files to the posts folder
Install
- Visit the demo site, and fork it
- Configure
js/config.js
to your liking, and update the posts and page contents with your info - Publish your changes within Beaker
- ??
- View your site!
Github Mode
In Github mode, CMS.js uses the Github API to get the content of your gh-pages repo and serve them as a full website.
Server Mode
In Server mode, CMS.js takes advantage of the Server's Directory Indexing feature. By allowing indexes, CMS.js sends an AJAX call to your specified folders and looks for Markdown files. After they are found, it takes care of everything else and delivers a full website.
Importing Posts
Once you've forked this site and CMS.js is up and running, you'll see an exact duplicate of this site, but on your own new dat url. Now go to the folder on your local drive where it's stored (available under Beaker > Library > Sites > ( whatever you just named it ), and then delete all the existing posts (mine) and paste in yours!
note it only supports .md
Importing Pages
Copy all of your Markdown pages from your Jekyll projects root folder into your designated CMS.js pages folder.
- Poole (Default Theme)
- CMS.JS (non-p2p original version, i.e. 99.9% of what you see here)
- jQuery
- Marked
All forms of contribution are welcome: bug reports, bug fixes, pull requests and simple suggestions. If you do wish to contribute, please follow the Airbnb Javascript Style Guide Thanks!
You can find the list of contributors here.