This extension allow you to insert timestamp, copyright or any information to your file like comment below
/*
* Created on Tue Feb 18 2020
*
* Copyright (c) 2020 - Your Company
*/
date
, time
, datetime
, day
, month
, year
, hour
, minute
, second
, company
, filename
ext install fileheadercomment
By default you don't have to set anything. It will detect most programming language for appropriate comment syntax.
Execute it from Command Pallete
(menu View - Command Pallete...) then type command below:
FileHeaderComment: Insert Default Template at Cursor
FileHeaderComment: Select from Available Templates
The second command will show your available templates defined in Settings
If you want to set your own parameter and template (set from menu Preferences - User Settings), you can read explanation below
This is default configuration
"fileHeaderComment.parameter":{
"*":{
"commentbegin": "/*",
"commentprefix": " *",
"commentend": " */",
"company": "Your Company"
}
},
"fileHeaderComment.template":{
"*":[
"${commentbegin}",
"${commentprefix} Created on ${date}",
"${commentprefix}",
"${commentprefix} Copyright (c) ${year} ${company}",
"${commentend}"
]
}
Define all custom variables/paramenters in asterisk *
like
"fileHeaderComment.parameter":{
"*":{
"company": "Your Company"
"myvar1": "My Variable 1",
"myvar2": "My Variable 2"
}
}
Use your variable in template like (asterisk *
will be default template)
"fileHeaderComment.template":{
"*":[
"${commentbegin}",
"${commentprefix} Created on ${date}",
"${commentprefix}",
"${commentprefix} Copyright (c) ${year} ${company}",
"${commentprefix} my variables are ${myvar1} and ${myvar2}",
"${commentend}"
]
}
You can define multiple templates, for instance template for MIT License
"fileHeaderComment.parameter":{
"*":{
"author": "Your Name",
"license_mit":[
"The MIT License (MIT)",
" Copyright (c) ${year} ${author}",
"",
" Permission is hereby granted, free of charge, to any person obtaining a copy of this software",
" and associated documentation files (the \"Software\"), to deal in the Software without restriction,",
" including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,",
" and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,",
" subject to the following conditions:",
"",
" The above copyright notice and this permission notice shall be included in all copies or substantial",
" portions of the Software.",
"",
" THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED",
" TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL",
" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,",
" TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE."
]
}
},
"fileHeaderComment.template":{
"mit":[
"${commentbegin}",
"${commentprefix} Created on ${date}",
"${commentprefix}",
"${commentprefix} ${license_mit}",
"${commentend}"
]
}
You can use your mit
template above by calling it through Command Pallete
and choose FileHeaderComment: Select from Available Templates
.
You can use parameters below in your template
date
: print current datetime
: print current timetime24h
: print current time in 24 hour formatdatetime
: print current date + timedatetime24h
: print current date + time in 24 hour formatcompany
: print "Your Company"day
: print day of the monthmonth
: print current monthyear
: print current yearhour
: print current hour (24h)minute
: print current minutesecond
: print current secondfilename
: print filename