yelp-new

Create a new file from a template. You can quickly create a new page or other file from a template. This is useful when many of your pages have a common layout or structure. You must pass at least two arguments: the identifier of the template, and the ID of the file to create. The second argument is used both for the base file name of the new file and for the id attribute. You can optionally pass a page title as the third argument.

Template files can be installed with yelp-new or they can be kept locally in the same directory. Local templates are useful if you have common page styles that are specific to your project. To get a list of available templates, run yelp-new --help.

You can create your own template files. Just create a file with the .tmpl extension appended. You can also use the --tmpl option on yelp-new to copy an existing template to the current directory without substituting, allowing you to build off of it for your own template.

Output files are created by substituting special markers in the template.

@ID@

The ID value passed as the second argument to yelp-new, which is the same as the base file name of the output file.

@DATE@

The current date in the format YYYY-MM-DD.

@YEAR@

The current year in the format YYYY.

@NAME@

The name of the person running the command. This value may come from either git or bzr. Failing that, the value "YOUR NAME" is used.

@EMAIL@

The email address of the person running the command. This value may come from either git or bzr. Failing that, the value "YOUR EMAIL ADDRESS" is used.

@TITLE@

The title as passed as the third argument to yelp-new. If you do not pass a title, the value "TITLE" is used.

You can also pass the --stub option to create a .page.stub file instead of a regular .page file.