/raven

Raven: a theme-able blog workflow with gulp, pug, sass, and markdown. Check out the demo here:

Primary LanguageHTML

raven logo

Raven

Raven is a theme-able and flexible static blog generator fed with Markdown and processed with gulp, pug, and sass built with lightning, simplicity, and awesomeness in mind.

Features

  • Fast (re)build times and completely static output
  • Semantic HTML boilerplate written in Pug
  • Theme-able CSS boilerplate written in Sass
  • Live reloading and device synchronization
  • Automatic syntax highlighting via highlight.js
  • Integration boilerplate for Disqus and Google Analytics
  • Automatically generated RSS feeds with rss2, atom1, and json1 support
  • Streamlined surge.sh deployments
  • Drafts and future post publication support

Getting Started

Once you're set with npm, whip out your terminal and enter in the following:

git clone https://github.com/mimoduo/raven.git
cd raven
sudo npm install gulp-cli -g
npm install
gulp

That's it! Raven will spin up a live reload server and begin to watch for any changes. At this point, you're either ready to dive right in (especially for those familiar with Pelican blogs) or take a peak into the raven doc.

Contributions

Contributions are welcome! Ask ahead of time if there's any new feature or modification you'd like to add/make. You wouldn't wanna spend a whole bunch of time on something that may be rejected.

Blogs Running Raven

The best kind of contribution is a successful blog. Add yours below for extra recognition in the github spotlight ;)