NAME

krang_upload_templates - import templates from filesystem

SYNOPSIS

   krang_upload_templates  --path /path/to/templates [--url '/bleh.tmpl' --url ...]

DESCRIPTION

Upload a directory of templates into a Krang instance, via the API. Uploaded templates will be deployed. Checked out templates will be skipped, as will those for which sites or caregories do not exist in the CMS.

This tool is primarily to aid developers, permitting them to work with templates on the filesystem (presumably version controlled by CVS or SVN), as opposed to having to muck around with ``templates.kds''.

OPTIONS

The script takes the following options:

• --path

  Path from which to upload templates. Note, this will be uploaded verbatim to the site. For example:

    /path/to/templates/
        +--- bleh.tmpl
        +--- site1.com/
        |     +--- bleh.tmpl
        |     +--- foo/bleh.tmpl
        +--- site2.com/
              +--- bleh.tmpl
              +--- foo/bleh.tmpl

  Sites and Categories will NOT be created. Template files in invalid directories will be ignored.

• --force-checkin

  If specified, templates which are checked out will be checked in rather than skipped.

• --makecats

  If specified, categories which do not exist in the CMS will be created instead of skipped.

• --url '/bleh.tmpl' --url 'site1.com/foo/bleh.tmpl'

  Limit the upload to the templates specified by their URL. This option may be give more than once.

• --verbose
• --help
• --man