Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://jekyll.github.io/jekyll-admin/
A Jekyll plugin that provides users with a traditional CMS-style graphical interface to author content and administer Jekyll sites.
https://jekyll.github.io/jekyll-admin/
cms javascript jekyll jekyll-plugin react ruby
Last synced: 3 months ago
JSON representation
A Jekyll plugin that provides users with a traditional CMS-style graphical interface to author content and administer Jekyll sites.
- Host: GitHub
- URL: https://jekyll.github.io/jekyll-admin/
- Owner: jekyll
- License: mit
- Created: 2016-05-19T17:23:27.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-03-15T04:46:18.000Z (8 months ago)
- Last Synced: 2024-04-13T21:57:57.252Z (7 months ago)
- Topics: cms, javascript, jekyll, jekyll-plugin, react, ruby
- Language: JavaScript
- Homepage: https://jekyll.github.io/jekyll-admin/
- Size: 7.74 MB
- Stars: 2,807
- Watchers: 79
- Forks: 355
- Open Issues: 71
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-static-hosting-and-cms - jekyll.github.io/jekyll-admin - A Jekyll plugin that provides users with a traditional CMS-style graphical interface to author content and administer Jekyll sites. Developed on GitHub: https://github.com/jekyll/jekyll-admin (Content Management Systems (CMS))
README
[](https://rubygems.org/gems/jekyll-admin)
[](https://github.com/jekyll/jekyll-admin/actions/workflows/ci.yml)
[](https://ci.appveyor.com/project/jekyll/jekyll-admin)
[](https://coveralls.io/github/jekyll/jekyll-admin?branch=master)
[](https://david-dm.org/jekyll/jekyll-admin)
[](https://opencollective.com/jekyll-admin)
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](https://jekyllrb.com/docs/plugins/installation/) section of Jekyll's documentation and install the `jekyll-admin` plugin as you would any other plugin. Here's the short version:
1. Add the following to your site's Gemfile:
```ruby
gem 'jekyll-admin', group: :jekyll_plugins
```
2. Run `bundle install`
## Usage
1. Start Jekyll as you would normally (`bundle exec jekyll serve`)
2. 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`.
```yaml
jekyll_admin:
hidden_links:
- posts
- pages
- staticfiles
- datafiles
- configuration
homepage: "pages"
```
### Customizing collection label in Sidebar
The plugin allows you to customize the name of a collection that is displayed in the sidebar by defining it in the collection's
metadata in the config file. For example, if your source's *posts* are actually *news-items* on the deployed site, then it can
be distracting to see the label `Posts` in the admin's sidebar. This situation can be resolved with the following configuration:
```yaml
collections:
posts:
output: true
sidebar_label: News
```
## 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](.github/CONTRIBUTING.md), and [the development docs](https://jekyll.github.io/jekyll-admin/development/) for more information.
## Contributors
### Code Contributors
This project exists thanks to all the people who contribute. [[Contribute](.github/CONTRIBUTING.md)].
### Financial Contributors
Become a financial contributor and help us sustain our community. [[Contribute](https://opencollective.com/jekyll-admin/contribute)]
#### Individuals
#### Organizations
Support this project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/jekyll-admin/contribute)]
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).