Yancy - A simple CMS for administrating data
version 1.001
use Mojolicious::Lite; use Mojo::Pg; # Supported backends: Pg, MySQL, SQLite, DBIx::Class plugin Yancy => { backend => { Pg => Mojo::Pg->new( 'postgres:///myapp' ) }, read_schema => 1, };
Yancy is a simple content management system (CMS) for administering content in a database. Yancy accepts a configuration file that describes the data in the database and builds a website that lists all of the available data and allows a user to edit data, delete data, and add new data.
Yancy uses JSON Schema to define the data in the database. The schema is added to an OpenAPI specification which creates a REST API for your data.
Yancy can be run in a standalone mode (which can be placed behind a proxy), or can be embedded as a plugin into any application that uses the Mojolicious web framework.
Yancy can manage data in multiple databases using different backends (Yancy::Backend modules). Backends exist for Postgres via Mojo::Pg, MySQL via Mojo::mysql, SQLite via Mojo::SQLite, and DBIx::Class, a Perl ORM
Yancy is primarily a Mojolicious plugin to ease development and management of Mojolicious applications. Yancy provides:
Helpers to access data, validate forms
Templates which you can override to customize the Yancy editor's appearance
For information on how to use Yancy as a Mojolicious plugin, see Mojolicious::Plugin::Yancy.
Yancy can also be run as a standalone app in the event one wants to develop applications solely using Mojolicious templates. For information on how to run Yancy as a standalone application, see Yancy::Help::Standalone.
This application creates a REST API using the standard OpenAPI API specification. The API spec document is located at /yancy/api.
/yancy/api
Yancy comes with plugins to enhance your website.
The Auth::Basic plugin provides a simple, password-based authentication system for the Yancy editor and your website.
More development will be happening here soon!
See Yancy::Help::Config for how to configure Yancy in both plugin and standalone mode.
This project bundles some other projects with the following licenses:
jQuery Copyright JS Foundation and other contributors (MIT License)
Bootstrap Copyright 2011-2017 the Bootstrap Authors and Twitter, Inc. (MIT License)
Popper.js Copyright 2016 Federico Zivolo (MIT License)
FontAwesome Copyright Dave Gandy (SIL OFL 1.1 and MIT License)
Vue.js Copyright 2013-2018, Yuxi (Evan) You (MIT License)
marked Copyright 2011-2018, Christopher Jeffrey (MIT License)
JSON schema, Mojolicious
Doug Bell <preaction@cpan.org>
Mohammad S Anwar <mohammad.anwar@yahoo.com>
mohawk2 <mohawk2@users.noreply.github.com>
William Lindley <wlindley@wlindley.com>
This software is copyright (c) 2018 by Doug Bell.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Yancy, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Yancy
CPAN shell
perl -MCPAN -e shell install Yancy
For more information on module installation, please visit the detailed CPAN module installation guide.