3 changed files with 74 additions and 5 deletions
@ -1,2 +1,65 @@ |
|||
# file-header |
|||
A template based commandline file-header generator |
|||
A CLI tool for generating file header from a configuration file and an EJS template. |
|||
|
|||
|
|||
## Installation |
|||
|
|||
#### install the package |
|||
`npm i -g file-header` |
|||
|
|||
#### Edit the config file ( Optional ) |
|||
Data to be presented on a file header is stored in a config file which is located at `~/.file-headers/template_data.js` |
|||
|
|||
The default content of this file will be as follows. |
|||
```javascript |
|||
module.exports = { |
|||
user: process.env.USER, |
|||
email: process.env.USER + '@' + process.env.HOST, |
|||
date: new Date(), |
|||
}; |
|||
|
|||
``` |
|||
|
|||
We can customize it as required. For example, change it to |
|||
|
|||
```javascript |
|||
module.exports = { |
|||
user: 'Jake sully' |
|||
email: 'gmail@jakesully.com' |
|||
github: 'https://github.com/jakesully' |
|||
date: new Date(), |
|||
}; |
|||
``` |
|||
|
|||
#### Edit the [EJS](ejs) tempalte of the default file-header ( Optional ) |
|||
|
|||
The default file header template can be found at `~/.file-headers/default` |
|||
It is just [EJS](ejs) template. We can customize it to any extend. |
|||
|
|||
If we require different template for each file type , create a file `~/.file-headers/<extention>` |
|||
|
|||
For javscript, create a custom template at `~/.file-headers/js` and customize it. |
|||
|
|||
|
|||
## Usage |
|||
|
|||
Commandline |
|||
``` |
|||
file-header <filename.ext> |
|||
``` |
|||
which will print the file header to your console. |
|||
|
|||
|
|||
#### Use with Vim editor |
|||
|
|||
Add the below line to your vim config file |
|||
```vim |
|||
command! Header :execute '0r!file-header %' |
|||
``` |
|||
|
|||
Now, type `:Header` to add file header to your current buffer. |
|||
|
|||
[ejs]: https://github.com/mde/ejs "Ejs template engine" |
|||
|
|||
|
|||
|
|||
|
Loading…
Reference in new issue