Canvas is a minimal blogging application for developers. It attempts to make blogging simple and enjoyable by utilizing the latest technologies and keeping the administration as simple as possible with the primary focus on writing.
Since Canvas is built on Laravel 5.2, there are a few system requirements:
- PHP >= 5.5.9
- OpenSSL PHP Extension
- PDO PHP Extension
- PDO compliant database (SQL, MySQL, PostgreSQL, SQLite)
- Mbstring PHP Extension
- Tokenizer PHP Extension
Getting Canvas up and running is simple. You can choose either of the following download options:
Option 1 - Use Packagist:
composer create-project austintoddj/canvasOption 2 - Use GitHub:
git clone https://github.com/austintoddj/canvas.gitIf you chose Option 1, skip this step. If you chose Option 2, run the following command from the project root:
composer installMake sure to modify the permissions of the storage directory:
sudo chmod o+w -R storageTo enable uploads on the site, give ownership of the uploads directory to the web server:
sudo chown -R www-data:www-data public/uploadsYou will need to create a new .env file and fill in the necessary variables:
cat .env.example > .env; vim .env;| Data Key | Value |
|---|---|
| Login Email | [email protected](default) |
| Login Password | password(default) |
When you download Canvas, you may want to change the default admin user credentials. To update admin user information including setting a new password (Recommended), edit the file Canvas/database/seeds/UsersTableSeeder.php and save it. Don't worry, you can always change this information within the application after the install process.
Installing Canvas is really simple. Just run php artisan canvas:install and follow the on-screen prompts.
Adding or modifying styles with Canvas is a breeze. None of this needs to be done out of the box, it simply works on its own. But if you're feeling a little creative and want to make it stand out more, follow these steps:
Install the project dependencies via npm:
sudo npm installInstall Gulp globally:
sudo npm install --global gulp-cliAfter you make any modifications to the files in Canvas/resources/assets/less/, run gulp:
gulpThis section is optional. If you do not want to run unit tests on your application and just want to get straight to blogging, that's completely up to you. If you do choose to utilize the test suite bundled with Canvas, you will need to have the PHP extension SQLite installed on your server. The unit tests are run against memory so you can safely test your application without affecting real data.
To enable Disqus comments on your blog, you need to have a unique shortname. For more information, check out the Official Documentation.
Once you have registered your site and have a shortname, use it to set the DISQUS_NAME key in your .env file.
Detailed changes for each release are documented in the release notes.
Canvas is open-sourced software licensed under the MIT license.