cabin

Simple and extensible static site generator powered by Grunt.

Getting started

Visit the getting started guide at cabinjs.com.

Contributing to Cabin

Project Philosophy

Cabin's goal is to be a static site generator that encourages designers and developers to make themes and share them with the open source community. We want to make it easy to create and install themes so that theme authors can focus on developing themes, and users can quickly get up and running with their static sites.

Cabin should be usable by everyone who knows how to edit markdown, templates, and css. At the same time, we want to provide support for Grunt power users and evolve with the Grunt ecosystem. As such, we plan on having a minimal default Gruntfile and providing options for power users to scaffold a more advanced Gruntfile.

Workflow

The recomended way to develop Cabin is to run npm link in the repo folder to create a symbolic global reference to cabin. You can then work on bugs/features using the latest code that you author in the repo.

Debugging

We provide a debug grunt task to debug Cabin using node-inspector. Once you have node-inspector launched in a separate terminal tab, simply run grunt debug command and set breakpoints in your browser.

You also debug integration and unit tests using the grunt debug-test command or the grunt debug-test-dev command to ignore remote tests for faster debugging.

Tests

We use the mocha test framework to test Cabin. To run the test suite and lint the JavaScripts, enter the following command:

grunt test

There are integration tests located in this file which verify that the html files were created as expected, and unit tests in this file which verify the logic implemented in methods is working as expected.

The goal is to test any new features in the integration test file and test any changes to method logic in the unit test file.

Changelog

0.3.5 - Added .sass-cache to .gitignore thanks to @rogeriopvl and removed unnecessary dot property from copy task config.

0.3.4 - Fixed duplicate grunt-contrib-watch devDep and made generated package.json modules and generated Gruntfile task order match.

0.3.3 - Made update-notifier a proper dependency.

0.3.2 - Added deployment tool prompt during theme installation to allow users to easily setup automated deployment. Updated _Gruntfile.js template to be leaner and have a consitent ordering of tasks. Added update-notifier to notify users of new Cabin versions.

0.3.1 - Fixed bug with incorrect filepath to cabin's package.json file.

0.3.0 - Themes now required to list cabin as a dependency in the package.json. Added error logging when users forget to specify the site name. Fixed node 0.8 bug with downloading zips.

Breaking changes:

Themes now required to list cabin as a dependency in the package.json.

0.2.0 - Project wide naming convention standardization, added --noInstall CLI flag. Themes must list grunt-pages as a dependency in the package.json.

Breaking changes:

Themes must list grunt-pages as a dependency in the package.json.

0.1.8 - Corrected templateLang flag description, fixed bug with single template engine in cabin.json.

0.1.7 - Added Windows support, preprocessor and template engine CLI flags, and support for additional theme location formats (GitHub URLs).

0.1.6 - Use themes' package.json file to determine the grunt-pages version rather than the gruntPagesVersion property in the cabin.json.

0.1.5 - Have cabin new download theme's master branch instead of default branch.

0.1.4 - Added -l flag to test local themes during development. Slimmed down generated Gruntfile.

0.1.3 - Use 0.0.0.0 as hostname for mobile debugging. Removed extra whitespace and connect folder from generated Gruntfile. Added gruntPagesVersion to cabin.json config.

0.1.2 - Built-in LiveReload functionality added.

0.1.1 - The Gruntfile now copies fonts from the src/styles/fonts folder.

0.1.0 - grunt server is now the default task. The Gruntfile template now copys images, vanilla css, and scripts and no longer copies .ico and .htaccess files.

0.0.2 - Use git clone instead of downloading theme zips from GitHub repos.

0.0.1 - Only copy specified file extensions from themes.

0.0.0 - Initial push.

License

(The MIT License)

Copyright (c) 2013 Colin and Christopher Wren

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.