Skip to content

Commit

Permalink
first commit
Browse files Browse the repository at this point in the history
  • Loading branch information
jonschlinkert committed Sep 24, 2013
0 parents commit f0c8428
Show file tree
Hide file tree
Showing 68 changed files with 7,529 additions and 0 deletions.
3 changes: 3 additions & 0 deletions .bowerrc
@@ -0,0 +1,3 @@
{
"directory": "vendor"
}
9 changes: 9 additions & 0 deletions .gitattributes
@@ -0,0 +1,9 @@
# Set default behaviour, in case users don't have core.autocrlf set.
*.* text=lf
*.* text eol=lf
*.* eol=lf

*.jpg binary
*.gif binary
*.png binary
*.jpeg binary
13 changes: 13 additions & 0 deletions .gitignore
@@ -0,0 +1,13 @@
# live site
_gh_pages

# node.js
node_modules
npm-debug.log

# local dev
tmp
temp
vendor
TODO.md
*.sublime-*
13 changes: 13 additions & 0 deletions .jshintrc
@@ -0,0 +1,13 @@
{
"curly": true,
"eqeqeq": true,
"immed": true,
"latedef": true,
"newcap": true,
"noarg": true,
"sub": true,
"undef": true,
"boss": true,
"eqnull": true,
"node": true
}
6 changes: 6 additions & 0 deletions .travis.yml
@@ -0,0 +1,6 @@
language: node_js
node_js:
- "0.8"
before_script:
- npm install -g grunt-cli
- npm install grunt
58 changes: 58 additions & 0 deletions CONTRIBUTING.md
@@ -0,0 +1,58 @@
## Contributing to the Wiki

**Formatting Standards**

For consistency across all examples in the wiki, and to ensure that our code examples are readable, we ask that you please follow these guidelines when contributing to the wiki:

* Four spaces for indentation, and always use proper indentation
* Multiple-line formatting (one property and value per line)
* Double quotes only, never single quotes
* Always a space after a property's colon (.e.g, `display: block;` and not `display:block;`)
* End all lines with a semi-colon
* For multiple, comma-separated selectors, place each selector on it's own line
* Attribute selectors, like `input[type="text"]` should always wrap the attribute's value in double quotes. This is important to do in your own code as well, for consistency and safety (see this [blog post on unquoted attribute values](http://mathiasbynens.be/notes/unquoted-attribute-values) that can lead to XSS attacks).
* When HTML is in your examples, use tags and elements appropriate for an HTML5 doctype (e.g., self-closing tags with no trailing slash)
* All page files should have globally unique names regardless of where they are located in the repository.


## Tools

### Assemble

* Visit [Assemble's documentation](http://assemble.io/docs/) site to learn more about customization and configuration.
* Markdown: [Markdown Cheatsheet](http://assemble.io/docs/Cheatsheet-Markdown.html)


## Coding Style

Examples:

**Good**

```css
body {
padding-top: 80px;
font-size: 12px;
}
```

**Bad**

```css
body {
padding-top: 80px;
font-size: 12px;
}
```

**Bad**

```css
body { padding-top: 80px; font-size: 12px }
```

### Feature Requests, Bugs and Pull Requests

* If you would like to request a feature, suggest an improvement, or report a bug, please [submit an Issue](https://github.com/cloudhead/less.js/issues?state=open).
* Feature requests are more likely to get attention if you include a clearly described use case.
* If you wish to submit a pull request, please [read this first](https://github.com/cloudhead/less.js/blob/master/CONTRIBUTING).md.
104 changes: 104 additions & 0 deletions Gruntfile.js
@@ -0,0 +1,104 @@
/*
* lesscss.org
* https://github.com/less/less-docs
* Copyright (c) 2013
* Licensed under the MIT license.
*/

'use strict';

module.exports = function(grunt) {

// Project configuration.
grunt.initConfig({

// Project metadata
site: grunt.file.readYAML('data/site.yml'),
pkg: grunt.file.readJSON('package.json'),

// Lint JavaScript
jshint: {
options: {
jshintrc: '.jshintrc'
},
all: [
'Gruntfile.js',
'helpers/*.js'
]
},

// Build HTML from templates and data
assemble: {
options: {
flatten: true,
assets: 'assets',
partials: ['templates/includes/*.hbs'],
helpers: ['helper-prettify'],
layout: 'templates/layouts/default.hbs',
data: ['data/*.{json,yml}', 'package.json']
},
pages: {
src: 'templates/*.hbs',
dest: '<%= site.destination %>/'
}
},

// Compile LESS to CSS
less: {
options: {
paths: ['vendor/bootstrap/less', 'styles'],
imports: {
reference: ['mixins.less', 'variables.less']
}
},
bootstrap: {
src: ['styles/bootstrap.less', 'styles/docs.less'],
dest: '<%= assemble.options.assets %>/css/docs.css'
}
},

// Before generating any new files clear out any previously-created files.
clean: {
example: ['<%= site.destination %>/*.html']
},

watch: {
all: {
files: ['<%= jshint.all %>'],
tasks: ['jshint', 'nodeunit']
},
design: {
files: ['Gruntfile.js', '<%= less.options.paths %>/*.less', '**/*.hbs'],
tasks: ['design']
}
}
});

// Load npm plugins to provide necessary tasks.
grunt.loadNpmTasks('assemble');
grunt.loadNpmTasks('assemble-less');
grunt.loadNpmTasks('grunt-recess');
grunt.loadNpmTasks('grunt-contrib-clean');
grunt.loadNpmTasks('grunt-contrib-jshint');
grunt.loadNpmTasks('grunt-contrib-watch');

// Default tasks to be run.
grunt.registerTask('default', [
'clean',
'jshint',
'assemble',
'prettify',
'less'
]);

// Build HTML, compile LESS and watch for changes.
// You must first run "bower install" or install
// Bootstrap to the "vendor" directory before running
// this command.
grunt.registerTask('design', [
'clean',
'assemble',
'less:docs',
'watch:design'
]);
};
22 changes: 22 additions & 0 deletions LICENSE-MIT
@@ -0,0 +1,22 @@
Copyright (c) 2013 Jon Schlinkert

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
78 changes: 78 additions & 0 deletions README.md
@@ -0,0 +1,78 @@
# lesscss.org

> Official website and documentation for LESS/Less.js
### [Visit the website](http://lesscss.org)

### [Visit Less.js](https://less/less.js)


## Libs

The documentation site is generated using [Assemble](http://assemble.io) and [Grunt.js](http://gruntjs.com). Please visit those respective projects to learn more about usage and customization.

## Todo

* Add grunt-github-api to sync changelog from main site
* Add grunt-readme


## Contributing

**Formatting Standards**

For _consistency and readability_ across all examples in the documentation, we ask that you please conform these guidelines when contributing:

* Two spaces for indentation, never tabs, and always use proper indentation
* Multiple-line formatting (one property and value per line)
* For multiple, comma-separated selectors, place each selector on it's own line
* Double quotes only, never single quotes
* Always a space after a property's colon (.e.g, `display: block;` and not `display:block;`)
* End _all_ lines with a semi-colon
* Attribute selectors, like `input[type="text"]` should always wrap the attribute's value in double quotes. This is important to do in your own code as well, for consistency and safety (see this [blog post on unquoted attribute values](http://mathiasbynens.be/notes/unquoted-attribute-values) that can lead to XSS attacks).
* When HTML is in your examples, use tags and elements appropriate for an HTML5 doctype (e.g., self-closing tags with no trailing slash)
* All page files should have globally unique names regardless of where they are located in the repository.

Examples:

**Good**

```css
body {
padding-top: 80px;
font-size: 12px;
}
```

**Bad**

```css
body {
padding-top: 80px;
font-size: 12px;
}
```

**Bad**

```css
body { padding-top: 80px; font-size: 12px }
```

### Feature Requests, Bugs and Pull Requests

* If you would like to request a feature, suggest an improvement, or report a bug, please [submit an Issue](https://github.com/cloudhead/less.js/issues?state=open).
* Feature requests are more likely to get attention if you include a clearly described use case.
* If you wish to submit a pull request, please [read this first](https://github.com/cloudhead/less.js/blob/master/CONTRIBUTING).md.

## Tools

### Assemble

* Visit [Assemble's documentation](http://assemble.io/docs/) site to learn more about customization and configuration.
* Markdown: [Markdown Cheatsheet](http://assemble.io/docs/Cheatsheet-Markdown.html)
* Handlebars


## Release History
_(Nothing yet)_
6 changes: 6 additions & 0 deletions bower.json
@@ -0,0 +1,6 @@
{
"name": "lesscss.org",
"dependencies": {
"bootstrap": "~3.0.0-rc1"
}
}

0 comments on commit f0c8428

Please sign in to comment.