Giter Site home page Giter Site logo

nanoc's Introduction

Build Status Code Climate Coverage Status

Please take a moment and donate to nanoc. A lot of time has gone into developing nanoc, and I would like to keep the current pace. Your support will ensure that nanoc will continue to improve.

nanoc

nanoc is a simple but very flexible static site generator written in Ruby. It operates on local files, and therefore does not run on the server. nanoc “compiles” the local source files into HTML (usually), by evaluating eRuby, Markdown, etc.

Note: This documentation looks best with Yardoc, not RDoc.

Requirements

Ruby 1.9.x and up.

nanoc has few dependencies. It is possible to use nanoc programmatically without any dependencies at all, but if you want to use nanoc in a proper way, you’ll likely need some dependencies:

  • The commandline frontend depends on cri.
  • Filters and helpers likely have dependencies on their own too.

If you’re developing for nanoc, such as writing custom filters or helpers, you may be interested in the development dependencies:

  • For documentation generation you’ll need yard.
  • For testing you’ll need mocha and minitest.

Installation

gem install nanoc or take a look at the installation page.

Tests

Running rake will run all the tests. To run a subset, use specific tasks, e.g. rake test:filters for running filter tests only.

Versioning

nanoc uses Semantic Versioning.

Documentation

Check out the nanoc web site!

License

nanoc is licensed under the MIT license. For details, check out the LICENSE file.

Support

You can get help in the following places:

nanoc's People

Contributors

arnau avatar benarmston avatar benilovj avatar bil-bas avatar bobthecow avatar brief avatar cakebaker avatar callahad avatar candlerb avatar cdlm avatar chriseppstein avatar daveeveritt avatar denisdefreyne avatar dufour avatar fabianbuch avatar goodside avatar gpakosz avatar gregkare avatar mkeveney avatar nvie avatar pointlessone avatar reima avatar rubenverborgh avatar spwhitt avatar stbuehler avatar stmontgomery avatar sunshineco avatar takashi-u avatar tkareine avatar xaviershay avatar

Watchers

 avatar  avatar

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.