Home

Awesome

#Welcome to Ink Build Status devDependency Status

Ink is an interface kit for quick development of web interfaces, simple to use and expand on. It uses a combination of HTML, CSS and JavaScript to offer modern solutions for building layouts, display common interface elements and implement interactive features that are content-centric and user friendly for both your audience and your designers & developers.

Ink is part of SAPO's Open Source Software initiative.

Current Version: 3.1.10

You can read our full documentation, examples and recipes in http://ink.sapo.pt

Getting started

Let's get you started with Ink right away. Here's what you need to know and do:

  1. Download the latest release.
  2. Check the recipes we provide in the dist/cookbook folder and choose one to start from or use quick-start.html as a blank slate.
  3. Make sure you have ink.css, ink-ie.css and ink.js included somewhere in the <head>.
  4. Add your own css and scripts to carry all your project-specific changes. You can use quick-start.css from the dist/css folder. It already contains the same media queries as Ink.
  5. Keep coming back to the documentation to help you along the way.
  6. That's it! You'll see how easy it is once you pick it up.

##Repository

###Branches

* This branch is very likely to contain code that is not fully functional or documented. Support requests for problems with this branch will have the lowest priority so, use at your own risk.


###Structure

Since version 2.3.0 we've moved things around in order keep source code from distribution code separated:

We've also unified our build system using Grunt and Bower. So, building from source is now a lot easier.


##Building from source

###Required tools If you want to build from our source code, you'll need to install a few things:

If you don't need to rebuild Javascript code you can just use Scout which is a nice, free and cross platform Sass/Compass compiler.

Building on Windows is a lot trickier so we won't get into details on how to install all the required tools. Instead here's a list of useful pages you'll need to read while trying this endeavour:

Building

Grunt exposes these build tasks:


Documentation

The documentation is no longer distributed with Ink releases. We've completely rewritten or documentation and are now running our site on Github pages using Jekyll.

You can read it at http://ink.sapo.pt Get its source, contribute or report an issue here: https://github.com/sapo/Ink-doc

Ink is built with help from these wonderful projects:

CSS Generation

Typography and Icons

Browser feature detection

Build system

Versions

Projects using Ink

You can check out a list of projects we find around the web that are using Ink in some form here.