The default branch of this repository is develop. This is a development branch, which is usable and has the latest features, but is not so stable as master, our release branch. Bugfixes are to be pushed to develop, where development takes place.
This branch contains built files in the dist/ folder.
Welcome to Ink
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.
Read the full documentation here: http:https://ink.sapo.pt. The Ink.js documentation is in http:https://js.ink.sapo.pt/docs/ (note: this documentation is for the most recent release, but the development version may have additions).
We've completely rewritten the grid system and JavaScript components, along with many other changes. Please read our changelog to find out about them.
We have three branches on our github repository:
- The master branch contains the latest release as its HEAD and all previous releases as tags.
- The develop branch contains our latest code that will eventually lead to a new release and tag on master. This branch is likely to contain code that is not fully functional or documented. Use at your own risk.
- The staging branch is a semi-stable branch containing code from the develop branch which is going to go into the next release.
To get a specific release clone the repository and use, e.g. git checkout 1.0.0.
Let's get you started with Ink right away. Here's what you need to know and do:
- Download latest build.
- Open
my-page.htmlif you want to serve Ink from your host ormy-cdn-page.htmlif you want to serve Ink from our servers. - Check the template we provide and remove whatever you don't feel necessary for your project.
- Make sure you have
ink.css,ink-ie.cssandink.jsincluded somewhere in the<head>. - Add your own stylesheets and scripts to carry all your project-specific changes.
- Keep coming back to the documentation to help you along the way.
- That's it! You'll see how easy it is once you pick it up.
Do this process if you'd like to build your own Ink and hack on the Ink source.
Make sure you have node installed. Then, on the root Ink folder of this repo:
[sudo] npm install -g bower
[sudo] npm install -g grunt
bower install
npm install
grunt
The Ink JavaScript modules used to be in a separate repository. Now they are in the src/js folder. Check out the README.md file inside with further information regarding those modules.
Ink requires the 1.4.2 LESS compiler version.
We built Ink by standing on the shoulders of giants, following the opensource mantra. We acknowledge & credit those giants here.
- {LESS} (under under Apache License 2.0)
- FontAwesome (under cc-by-3.0)
- Ubuntu Font (under Ubuntu Font License)
- html5shiv (under MIT License)
- normalize.css (under normalizes license agreement)
If you wish to contribute with your own code, please submit your pull requests to the develop branch.
- Ink v2.2.1 (current)
- Ink v2.2.0
- Ink v2.1.1
- Ink v2.1.0
- Ink v2.0.0
- Ink v1.1.0
You can check out a list of projects we find around the web that are using Ink in some form here.