https://github.com/wunderio/nameless

nameless starter theme
https://github.com/wunderio/nameless

Last synced: 26 days ago
JSON representation

nameless starter theme

• Host: GitHub
• URL: https://github.com/wunderio/nameless
• Owner: wunderio
• Archived: true
• Created: 2013-08-20T10:04:49.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2016-05-13T07:50:25.000Z (over 8 years ago)
• Last Synced: 2024-07-31T18:19:46.417Z (4 months ago)
• Language: CSS
• Size: 313 KB
• Stars: 5
• Watchers: 8
• Forks: 4
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Nameless Drupal theme

[![devDependency Status](https://david-dm.org/wunderkraut/nameless/dev-status.svg)](https://david-dm.org/wunderkraut/nameless#info=devDependencies)

Starting point for drupal theme development and to allow a clean output of content.

## Technical goals

* HTML 5

* basic html elements should be styled normalized and simple but pretty

* all Drupal elements should be styled or explicitly left out -> normalize

* basic Drupal theme scaffolding, preprocessing and resets should be done

* Cross-browser and device support (IE8+, Firefox, Chrome, Safari, Opera, iOS, Android. IE7 is partly supported)

## Usage

1. Add to %drupalroot%/sites/all/themes

2. **Rename theme and hooks to a project specific name**

3. Update README to contain project specific information

4. Run `bower install` to download the required libraries

5. Run `npm install` to install the required npm plugins for automation

6. Delete the .gitignore file or remove the line ignoring the libraries folder

7. Run `grunt` to generate the first version of your css files

## Quick install via command line

Replace the **[placeholder]** with your new theme name.

    # Go into your theme directory

    cd /your/drupal/folder/sites/all/themes/

    

    # Prepare the theme template

    git clone [email protected]:wunderkraut/nameless.git

	cp -r nameless [placeholder]

	cd [placeholder]

	rm -rdf .git*

	# Rename files

	find . -depth -name '*nameless*' -execdir bash -c 'mv -i "$1" "${1//nameless/[placeholder]}"' bash {} \;

	# Replace the theme name recursive

	find . -depth -type f \( -name '*.info' -o -name 'bower.json' -o -name '*.php' -o -name '*.js' \) -exec sed -i '' s%nameless%[placeholder]% {} +

	# Install libraries

	bower install

	# Compile the css files the first time

	compass compile	

	

	

## Automation with Grunt

@see: [Grunt documentation](http://gruntjs.com/getting-started)

### pre-requisites:

* you need to have [nodejs and npm](http://nodejs.org/) installed.  

* you need to have grunt-cli installed as global package `npm install -g grunt-cli`, see [grunt getting started guide](http://gruntjs.com/getting-started)

* you need to run `npm install`

### usage in a local dev environment

* to lint your JavaScript files once, you run `grunt jshint`

* to minify images and SVGs, place files in `./images_originals` folder and run `grunt imagemin` or `grunt svgmin`

* to compile CSS files from your SASS, run `grunt compass:localdev`

* to constantly monitor your theme directory and execute all necessary tasks while developing, you run `grunt`

* to lint your SCSS files once, you run `grunt scsslint`

### usage in a CI/production environment

run `grunt dist` to

* lint JS files  

* compile compressed CSS from SASS  

### roadmap

* compass compile tasks for server/CI with grunt

* uglifying of JS scripts

* performance monitoring with phantomas