new

The new command creates a new project from a blueprint, folder or repository URL.

To create a new project using the default blueprint pass the project name:

uwe new project-name

If you know the language or host you can set them when creating the project:

uwe new project-name --language=fr --host=docs.example.com

List

To print a list of available blueprints run:

uwe task list-blueprints

Multi Lingual

For multi-lingual sites you can pass the locales option to create the structure for multiple languages. The locales is a comma-delimited list of Unicode language identifiers:

uwe new project-name --locales=fr,de,zh

Which will create the skeleton structure in the site/locales directory and update the fluent settings.

When creating a multi-lingual project a redirect is configured for the default locale. The default locale is the --language option when it is given otherwise the first locale in the list is used.

When --language is combined with --locales the given language must exist in the list of locales.

Repositories

To use an alternative blueprint repository pass a URL such as:

uwe new project-name https://github.com/uwe-app/blog.git

If you clone via SSH the key agent is used:

uwe new project-name git@github.com:uwe-app/blog.git

Usage

uwe-new 0.48.15
Create a new project

USAGE:
    uwe new [FLAGS] [OPTIONS] <target> [plugin]

FLAGS:
        --bare       Create project without git initialization
        --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -g, --git <git>                    Create project from a git blueprint
    -h, --host <host>                  Host name for the new project
    -l, --language <language>          Language for the new project
    -L, --locales <locales>            Create translation locales (comma delimited)
    -m, --message <message>            Initial commit message
    -p, --path <path>                  Create project from a folder blueprint
        --prefix <prefix>              Folder prefix for git blueprints
        --remote-name <remote-name>    Remote name for the new project [default: origin]
    -r, --remote-url <remote-url>      Remote repository URL for the new project

ARGS:
    <target>    Output directory for the new project
    <plugin>    Plugin name for the project blueprint

Back to uwe