A Jekyll plugin that provides users with a traditional CMS-style graphical interface to author content and administer Jekyll sites. The project is divided into two parts. A Ruby-based HTTP API that handles Jekyll and filesystem operations, and a JavaScript-based front end, built on that API.
Installation
Refer to the installing plugins section of Jekyll's documentation and install the jekyll-admin
plugin as you would any other plugin. Here's the short version:
-
Add the following to your site's Gemfile:
gem 'jekyll-admin', group: :jekyll_plugins
-
Run
bundle install
Usage
- Start Jekyll as you would normally (
bundle exec jekyll serve
) - Navigate to
http://localhost:4000/admin
to access the administrative interface
Options
Jekyll Admin related options can be specified in _config.yml
under a key called jekyll_admin
. Currently it has only one option hidden_links
which is for hiding unwanted links on the sidebar. The following keys under hidden_links
can be used in order to hide default links;
jekyll_admin:
hidden_links:
- posts
- pages
- staticfiles
- datafiles
- configuration
Contributing
Interested in contributing to Jekyll Admin? We’d love your help. Jekyll Admin is an open source project, built one contribution at a time by users like you. See the contributing instructions, and the development docs for more information.
Looking for a hosted version?
Jekyll Admin is intended to be run on your computer alongside your local Jekyll installation. If you're looking for a hosted version, we'd recommend checking out Siteleaf a hosted Jekyll editor with deep GitHub integration (whom we'd also like to thank for inspiring parts of Jekyll Admin itself!).
License
The gem is available as open source under the terms of the MIT License.