A Ruby on Rails blogging app for the adventurous developer.

StEnki is a Ruby on Rails blog engine and a fork of Enki. You can find a demonstration of Enki at my personal blog ifailedtheturingtest.herokuapp.com. A tip of my hat to Xavier and all the other Enki developers for their hard work. Thanks guys!

Preferences are for the masses. Any real coder knows the easiest and best way to customize something is by hacking code. Because you want your blog to be you, not bog standard install #4958 with 20 posts per page instead of 15. For this you need a clean, simple, easy to understand code base that stays out of your way. No liquid drops and templates hindering your path, no ugly PHP stylings burning your eyeballs.

Quick Start

  git clone git://github.com/adamwong246/StEnki.git StEnki
  cd StEnki
  git checkout -b myblog # Create a new work branch
  bundle install         # Install all the required gems

  cp config/database.example.yml config/database.yml
  # Edit config/enki.yml and config/database.yml to taste

  # Next step needs libxml2 and libxslt1 and their headers
  # On Debian-based systems: apt-get install libxml2-dev libxslt1-dev
  # On Mac OS X: no action required

  rake db:migrate
  rake            # Run tests
  rake db:seed
  rails server    # Start the server
  # Load http://localhost:3000/admin in your browser

Or for bonus points, fork StEnki at github and clone that instead.

More info

StEnki is a compact, easily extendable base for your blog. It does this by being highly opinionated, for example:

• Public facing views should adhere to standards (XHTML, Atom)
• /yyyy/mm/dd/post-title is a good URL for your posts
• Live comment preview should be provided by default
• Google does search better than you or I
• You don’t need a plugin system when you’ve got decent source control
• If you’re not using OpenID you’re a chump. But StEnki actually uses multiple service providers for authentication! Chump like a fox…
• Hacking code is the easiest way to customize something

How it differs from Enki

I decided to re-christen this project under a new name because it has diverged so substantially from the original. StEnki, to me, is my personal programming playground. Think of it as my workshop. Because of this, StEnki has many more dependencies than Enki and prefers to use many wonderful gems rather than stay lightweight. StEnki is feature rich and can provide a programmer with a safari popular gems, such as rails_admin, cancan, devise, and more. In many ways, StEnki is more of a generic base for a RoR app- I just so happened to need a blog. But with so may features, StEnki can be much much more than a blog.

Features:
- Removed custom authentication and administration in favor of rails_admin.
- Reddit-style comments ie. tree structured comments
- Scss for style
- Slim for layouts.
- Bootstrap for base styling, with multiple themes!
- User login using many different social networks.
- Deployable to Heroku’s cedar stack.

Features yet to come:
- Much more testing
- Content!

How it differs from Mephisto

Mephisto is feature packed and quite customizable. It can however be daunting trying to find your way around the code, which isn’t so good if you’re trying to hack in your own features. Enki strips out a lot of the features that you probably don’t need (multiple authors and liquid templates, for example), and focuses on keeping a tight code base that is easy to comprehend and extend.

How it differs from SimpleLog

Enki embodies much of the philosophy of SimpleLog, but does so in a style that is much more consistent with Rails best practices, making it easier to understand and hack the code.

Compatibility

Uses rails 3. Runs on MySQL or Postgres. Works on heroku.

Contributors, these guys rock

git log | grep Author | sort | uniq

If you want to help out, try tackling an open issue. Please include specs for any fixes. Enki is by design feature light. Unless you feel very strongly your feature should be in core, add a link to your fork in the wiki instead.

License

GPL – See LICENSE