Fully Document Using web-base-template

[mikeedwards]

Leaving a documentation comment here:

When I try to deploy api.jquery.com within my user directory, I get the following error:

my-machine:api.jquery.com myname$ grunt deploy
Running "clean:folder" (clean) task
Folder "dist" contents removed.

Running "lint:grunt" (lint) task
Lint free.
.
.
.
Created post width.
Created post wrap.
Created post wrapAll.
Created post wrapInner.
>> Error publishing 0042_04_01.png.
>> Error: XML-RPC fault: Unable to create directory /Users/myname/Documents/projects/jquery/webroot/WordPress/web-base-template/blogs.dir/3/files/2012/10. Is its parent directory writable by the server?
<WARN> Task "wordpress-sync" failed. Use --force to continue. </WARN>

The easy (bad) way to fix this is to run:

chmod 777 /Users/myname/Documents/projects/jquery/webroot/WordPress/

and then repeat grunt deploy

A better way of dealing with this, especially for people less familiar with Wordpress, Apache, etc., should be documented.

[all9lives]

The current virtual host setting doesn't set AllowOverrides which .htaccess needs set set rewrites. Here is an updated virtual host block.

<VirtualHost *:80>
ServerName dev.jquery.com
ServerAlias *.jquery.com *.jqueryui.com *.jquery.org *.qunitjs.com *.sizzlejs.com *.jquerymobile.com
DocumentRoot "/srv/www/jquery"
    <Directory /srv/www/jquery>
       Options All
       AllowOverride All
       Order allow,deny
       Allow from all
    </Directory>
</VirtualHost>