/canvas

Primary LanguagePHPMIT LicenseMIT

Canvas

Canvas Screens

Build Status StyleCI Dependency Status Total Downloads Latest Stable Version License

Canvas is a simple, powerful blog publishing platform that lets you to share your stories with the world. Its beautifully designed interface and completely customizable framework allows you to create and publish your own blog, giving you tools that make it easy and even fun to do.

Features Google Material Design, SimpleMDE for Markdown publishing with syntax highlighting by PrismJS, full-site searching by TNTSearch, native Google Analytics integration and more, all powered by Laravel!

Requirements

Before you proceed make sure your server meets the following requirements:

Installation

  1. There are 3 ways of downloading the application:

    • Use GitHub: simply click the Clone or download button at the top right of this page and choose Download ZIP
    • Use Git: git clone https://github.com/austintoddj/canvas.git
    • Use Packagist: composer create-project austintoddj/canvas

  2. From the command line in the project root, run composer install

  3. Give the uploads/ directory write-access by the web server: chown -R www-data:www-data public/uploads/

  4. Copy the contents of .env.example and create a new file called .env in the project root. Set your application variables in the new file.

  5. Run php artisan canvas:install and follow the on-screen prompts.

  6. Change the permissions of the storage/ directory: chmod -R 777 storage/

  7. Sign in to the application at http://YOUR_DOMAIN/admin

    • Email: admin@canvas.com
    • Password: password

Congratulations! Your new blog is set up and ready to go. Feeling adventurous? Continue on with the advanced options below to get even more out of Canvas.

Advanced Options

  1. Themes

    • Run npm install from the project root.
    • Run npm install gulp
    • Create your own theme by editing the stylesheet at resources/assets/sass/theme/styles.scss or grab an Official Canvas Theme, fresh off the palette.
    • After any changes to this file, run gulp

  2. Google Analytics

    • Set up a web property on Google Analytics.
    • Enter your tracking ID on the Settings page.

  3. Disqus Integration

    • Generate a unique shortname from Disqus.
    • Enter your shortname on the Settings page.

  4. Email Notifications

    • To enable the Forgot My Password feature on the login page, make sure you set the appropriate mail driver variables in your .env file.

Contributing

Thank you for considering contributing to Canvas! The contribution guide provides instructions on how to submit an issue, create pull requests and more. It also has details about joining the official HipChat group for those who want to be a part of Canvas' future development.

Changelog

Detailed changes for each release are documented in the release notes.

License

Canvas is open-sourced software licensed under the MIT license.

canvas

d9aa9cff6d2c7d6cf6c5998c45904d8e734fda22