Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/locomotivecms/engine

A platform to create, publish and edit sites
https://github.com/locomotivecms/engine

Last synced: 4 days ago
JSON representation

A platform to create, publish and edit sites

Host: GitHub
URL: https://github.com/locomotivecms/engine
Owner: locomotivecms
License: other
Created: 2010-07-22T19:02:27.000Z (over 14 years ago)
Default Branch: master
Last Pushed: 2024-10-18T20:35:05.000Z (3 months ago)
Last Synced: 2024-10-29T15:34:50.394Z (3 months ago)
Language: Ruby
Homepage: http://www.locomotivecms.com
Size: 30.6 MB
Stars: 2,314
Watchers: 82
Forks: 626
Open Issues: 92
Metadata Files:
- Readme: README.md
- License: MIT-LICENSE

Awesome Lists containing this project

awesome-ruby-toolbox - Locomotive - LocomotiveCMS is a next generation CMS system with sexy admin tools, liquid templating, and inline editing powered by mongodb and rails 3.2 (Content Management & Blogging / Content Management)
awesome-starred - locomotivecms/engine - A platform to create, publish and edit sites (others)
Open-Source-Ruby-and-Rails-Apps - locomotiveCMS - Locomotive is an open source platform to create, publish and edit sites (CMS) 🔥 ✅ (Happy Exploring 🤘)

README

# Locomotive

[![Build Status](https://travis-ci.com/locomotivecms/engine.svg?branch=master)](https://travis-ci.com/locomotivecms/engine) [![Code Climate](https://codeclimate.com/github/locomotivecms/engine/badges/gpa.svg)](https://codeclimate.com/github/locomotivecms/engine) [![Coverage Status](https://img.shields.io/coveralls/locomotivecms/engine.svg)](https://coveralls.io/r/locomotivecms/engine?branch=master) [![Join the chat at https://gitter.im/locomotivecms/engine](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/locomotivecms/engine?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

Locomotive is an open source platform to create, publish and edit sites (CMS). It is designed to save time and help you focus on what matters: front-end technology, standard development process and a very low learning curve for your clients.

Locomotive relies on a **very original workflow**:

- Sites are coded locally using our open source tool: [Wagon](https://github.com/locomotivecms/wagon).
- Sites are deployed to the platform (engine) thanks to our internal API.
- A back-office for the end-users is automatically generated based on the custom models and editable regions described by the developers.

![Locomotive](https://i.imgur.com/Qy1K4fT.jpg)

Visit the Locomotive official website [here](https://www.locomotivecms.com) for more information.

## Features

- Multi-sites natively supported
- Uses Liquid, a simple and clean templating language
- Easy to add custom sections, content types, no SQL needed
- Beautiful and intuitive editing interface
- Can fully localize all the content and pages
- Embed a Restful API to manage every site
- Develop and preview sites locally with your favorite tools **(Wagon)**
- Support for Webpack, SASS, HAML and Coffee Script **(Wagon)**

## Instructions and help

- [Documentation](https://doc.locomotivecms.com/)
- Get help with Locomotive or discuss technical issues on [Gitter](https://gitter.im/locomotivecms/engine?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) or [here](https://locomotive-v3.readme.io/discuss).
- [Follow us on twitter](http://twitter.com/locomotivecms)

## Contribute

Have a look at our [Trello](https://trello.com/b/kRiy1dZu/locomotive-v3) board to see what's next or see where you can help out.

### Technologies

Here is a list of the main gems used to power the Locomotive platform:

- Ruby 3+
- Rails 7 - *web framework*
- Bootstrap - *UI framework*
- Mongoid 7 - *Object-Document-Mapper for MongoDB 6*
- Devise 4 - *Authentication*
- Carrierwave - *Upload*
- Pundit - *Permissions*

### Translating the back-office

By default, the Locomotive back-office is fully translated in English, Dutch and Greek.

Adding a new language is pretty straightforward since we now manage all our I18n translation keys in [Transifex](https://www.transifex.com), a platform dedicated to this kind of task.

Here is our Transifex portal page: [https://www.transifex.com/locomotive/locomotive-engine](https://www.transifex.com/locomotive/locomotive-engine). Feel free to sign up and translate!

### How to contribute

Locomotive is an open source project, we encourage contributions. If you have found a bug and want to contribute a fix, or have a new feature you would like to add, follow the steps below to get your patch into the project:

- Install ruby, mongoDB and phantomjs
- Clone the project git clone [email protected]:locomotivecms/engine.git
- Setup a virtual host entry for locomotive.local to point to localhost
- Start mongodb if it is not already running
- Run the tests bundle exec rake
- Write your failing tests
- Make the tests pass
- [Create a GitHub pull request](http://help.github.com/send-pull-requests)

### Contact

Feel free to contact me at didier at nocoffee dot fr.