The Word Press Roots.io child theme for the University of Alabama Libraries
Please note, these docs are written for developers newer to these types of tools. If the above dependency list looks familiar to you, you can just skim through the instructions below.
It is highly recommended that you work on a locally installed Word Press installation, and only push changes to this repo after your commits are ready for staging/optimization.
Be aware, many of these tools do not have native GUIs and may require use of the command prompt. If you are unfamiliar with your operating system's command prompt or terminal check out these resources before proceeding:
- OS X: [http://blog.teamtreehouse.com/introduction-to-the-mac-os-x-command-line]
- Windows: [http://windows.microsoft.com/en-us/windows-vista/open-a-command-prompt-window]
- Linux: You already know what to do...
Node's package manager is called via the
npmcommand. You'll use this command to install tools like Grunt and Bower
- Go to the NodeJS website and download their installer (Windows, OS X, or Linux)
- Open a command prompt or terminal window
- Type
npm install -g grunt-clito install Grunt's command line interface. - Type
npm install -g bowerto install Bower
Be sure to read Grunt's and Bower's docs to get better acquainted with these tools:
"Local development stacks" are web servers that run from your computer. That way, you can try all types of crazy things safely.
Our stacks will include Apache, PHP, and MySQL
The theme CSS is generated from LESS files under /assets/css/less/. Any edits to the CSS files themselves will be overwritten
after the theme files are built using both the dev and default grunt tasks.
You need Node.js to use the tools that build the CSS and the Styleguide. Download the proper Node.js package from their download page.
After Node.js is installed, then you need to install Grunt.js and Bower. To do so, run the following commands:
npm install -g grunt-cli
npm install -g bower