LearnPress

The most minimal WordPress theme starter ever :)

Designed for learning.

Getting started

1. Download it

Download and extract the zip for this repository, or git clone it, into your wp-content/themes folder.

YOUR_WORDPRESS_FOLDER
├── wp-content
│   ├── themes
│   │   ├── LearnPress
│   │   ├ ... other themes

You want to end up with a LearnPress folder inside wp-content/themes.

2. Activate it

From your WP dashboard, go to Appearance > Themes.

You should (if you have followed the previous step correctly) see LearnPress among the available themes.

Click Activate.

3. Install libraries

Such as jQuery, HTML5 Boilerplate, Skeleton, Bootstrap etc.

To add a library (say, jQuery) to this project, we would normally do the following:

1. Search for it on the Web
2. Download the right file(s)
3. Extract them into the right folder..
4. Rinse and repeat for each library we may use!

To avoid these repetitive tasks, we can use a tool called bower which will automate the chores for us. What’s so great about bower?

If you haven't installed bower yet, follow the instructions below and then come back here.

1. Open Terminal (Mac) or a CommandPrompt (Windows).

• Navigate to the LearnPress folder

  • On Mac, drag the LearnPress folder onto the Terminal app icon
    

  • On Windows, drag the LearnPress folder inside CommandPrompt, then change C: to cd, so that you'll end up with something like cd \wamp\www\YOUR_SITE_NAME\wp-content\themes\LearnPress

• Type in bower install and press the ↲ (Enter) key

Bower will install the dependencies listed in bower.json.

If all goes well, you should end up with a new bower_components folder containing html5-boilerplate and skeleton-css

LearnPress
├── bower_components
│   ├── html5-boilerplate
│   ├── skeleton-css

Troubleshooting

• If you're getting a ECMDERR Failed to execute ... error:

  git config --global url."https://".insteadOf git://

• If you're getting a git is not installed or not in the PATH error in Windows, follow these steps

Want more libraries?

LearnPress comes with HTML5Boilerplate and Skeleton.

Let's say you want to add Bootstrap.

bower install bootstrap --save

The --save bit will add the Bootstrap dependency to your bower.json

Check libraries.io for even more libraries.

Installing Bower

Bower is a command-line tool, so you'll use the following application, depending on which system you are:

Mac	Windows	Linux
Terminal	CommandPrompt	Terminal

Don't fear the command line :)

Once you've opened Terminal / CP:

1. Download and install Node.js

   Go to nodejs.org and download the installer for your operating system.

   Install it..

   To check if you have Node.js installed:

   • In Terminal / CP, type node -v and press the ↲ (Enter) key.
   • If Terminal / CP shows a number, like v0.10.26 then it means you have version 0.10.26 installed.

• Install Bower

  In Terminal / CP, type sudo npm install -g bower and press the ↲ (Enter) key.

  Terminal / CP will ask you for your computer's password (that's because of the sudo, which means super user do, running commands with special powers)

  To check if you have bower installed:

  • Type bower and press the ↲ (Enter) key
  • If Terminal / CP shows a number, like v0.10.26 then it means you have version 0.10.26 installed and you're good to go, unless you're on Windows, in which case read on..

• If you're on Windows, download and install msysgit.