Generate a .gitattributes file from the command line when Generate's CLI is installed globally, or use as a plugin or sub-generator in your own generator to make it a continuous part of the build workflow when scaffolding out a new project.
Example
Templates are customizable and can be overridden.
Generate is a command line tool and developer framework for scaffolding out new GitHub projects using generators and tasks.
Answers to prompts and the user's environment can be used to determine the templates, directories, files and contents to build. Support for gulp, base and assemble plugins, and much more.
For more information:
- Visit the generate project
- Visit the generate documentation
- Find generators on npm (help us author generators)
Installing the CLI
To run the gitattributes generator from the command line, you'll need to install Generate globally first. You can do that now with the following command:
$ npm install --global generateThis adds the gen command to your system path, allowing it to be run from any directory.
Install generate-gitattributes
Install this module with the following command:
$ npm install --global generate-gitattributesYou should now be able to run generate-gitattributes with the following command:
$ gen gitattributesWhat will happen?
Running $ gen gitattributes will run the generator's default task, which writes a .gitattributes file to the current working directory, or the specified directory.
What you should see in the terminal
If completed successfully, you should see both starting and finished events in the terminal, like the following:
[00:44:21] starting ...
...
[00:44:22] finished ✔If you do not see one or both of those events, please let us know about it.
To see a general help menu and available commands for Generate's CLI, run:
$ gen helpgenerate supports running multiple generators at once. Here is an example of a generator that works well with generate-gitattributes.
Run generate-dest before this generator to prompt for the destination directory to use for generated files.
Example
Use generate-gitattributes as a plugin in your own generator.
Install with npm:
$ npm install --save generate-gitattributesInside your own generator:
module.exports = function(app) {
// register generate-gitattributes as a plugin to add the gitattributes
// task to your own generator
app.use(require('generate-gitattributes'));
};Programmatically run tasks from generate-gitattributes.
module.exports = function(app) {
// adds the `gitattributes` task to your generator
app.use(require('generate-gitattributes'));
// run the `gitattributes` task
app.task('default', 'gitattributes');
};Visit the generator docs to learn more about creating, installing, using and publishing generators.
The following instructions can be used to override settings in generate-gitattributes. Visit the Generate documentation to learn about other ways to override defaults.
To customize the destination directory, install generate-dest globally, then in the command line prefix dest before any other generator names.
For example, the following will prompt you for the destination path to use, then pass the result to generate-gitattributes:
$ gen dest gitattributesYou can override a template by adding a template of the same name to the templates directory in user home. For example, to override the .gitattributes template, add a template at the following path ~/generate/generate-gitattributes/templates/.gitattributes, where ~/ is the user-home directory that os.homedir() resolves to on your system.
Generate is a command line tool and developer framework for scaffolding out new GitHub projects using generators and tasks.
Answers to prompts and the user's environment can be used to determine the templates, directories, files and contents to build. Support for gulp, base and assemble plugins, and much more.
For more information:
- Visit the generate project
- Visit the generate documentation
- Find generators on npm (help us author generators)
Installing the CLI
To run the gitattributes generator from the command line, you'll need to install Generate globally first. You can do that now with the following command:
$ npm install --global generateThis adds the gen command to your system path, allowing it to be run from any directory.
Install generate-gitattributes
Install this module with the following command:
$ npm install --global generate-gitattributesRun this generator's default task with the following command:
$ gen gitattributesWhat you should see in the terminal
If completed successfully, you should see both starting and finished events in the terminal, like the following:
[00:44:21] starting ...
...
[00:44:22] finished ✔If you do not see one or both of those events, please let us know about it.
To see a general help menu and available commands for Generate's CLI, run:
$ gen helpAll available tasks.
Generates a .gitattributes file to the current working directory. The built-in template can be overridden.
Example
$ gen gitattributesVisit Generate's documentation for tasks.
Are you using Generate in your project? Have you published a generator and want to share your project with the world?
Here are some suggestions!
- If you get like Generate and want to tweet about it, please feel free to mention
@generatejsor use the#generatejshashtag - Show your love by starring Generate and
generate-gitattributes - Get implementation help on StackOverflow (please use the
generatejstag in questions) - Gitter Discuss Generate with us on Gitter
- If you publish an generator, thank you! To make your project as discoverable as possible, please add the keyword
generategeneratorto package.json.
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Install dev dependencies:
$ npm install -d && npm testJon Schlinkert
Copyright © 2016, Jon Schlinkert. Released under the MIT license.
This file was generated by verb-generate-readme, v0.1.30, on August 17, 2016.