Giter Club home page Giter Club logo

enki's Introduction

Extended Enki

A demo of our Enki version: blog.agile-pandas.com

Changes:

  • Main layout and admin layout are completely different (For a preview see top)
  • Haml/Sass (some views still need to be updated)
  • i18n (some views still need to be updated)
  • Post-preview-as-you-type
  • Divise instead of OpenID
  • Draft post
  • Removed Google search

Work in progress

  • Blog-setup

TODO

  • Complete i18n support
  • Get rid of ERB (fully implement Haml)
  • Clean up JS
  • Change the way drafting behaves (current:= Leave published at blank)
  • Simple statistics (such as blog-post views)
  • Google Analytics
  • Google Webmaster tools

Original Enki README

A Ruby on Rails blogging app for the fashionable developer.

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/xaviershay/enki.git enki
  cd enki
  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
  rails server    # Start the server
  # Load http://localhost:3000/admin in your browser

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

More info

Enki 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
  • Hacking code is the easiest way to customize something

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.

If you’re converting from Mephisto, be sure to have a look at enki-translator

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.

License

GPL – See LICENSE

Admin design heavily inspired by Habari

enki's People

Contributors

xaviershay avatar stygeo avatar jasoncheow avatar gaelian avatar zachinglis avatar chrislloyd avatar akitaonrails avatar pauldowman avatar robc avatar toolmantim avatar amoslanka avatar kytrinyx avatar pedrodelgallego avatar

Stargazers

Enrique Macip avatar Jamil Antonino avatar Ömer Avci avatar German Monfort avatar Holden Thomas avatar

Watchers

James Cloos avatar

Forkers

jamalnasir

enki's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.