feat(build): optionally include version in released filename

Instead of releasing the files:

```
semantic.css
semantic.js
semantic.min.css
semantic.min.js
```
optionally release the files that include the version number and an optional revision string:
```
semantic-2.9.3-a.css
semantic-2.9.3-a.js
semantic-2.9.3-a.min.css
semantic-2.9.3-a.min.js
```

The advantage is to make clear which version is currently being used, and preventing the browser cache from running an obsolete version.

This pull-request is fully backward compatible as the default behaviour does not change at all.

The change is activated in semantic.json by adding the relevant fields:

```
{
  // ...
  "permission": false,
  "autoInstall": false,
  "rtl": false,
  "includeVersionInFileName": true,          <== Here
  "revision": "a",                                           <== Optionally this, too.
  "version": "2.9.3"                                       <== version that is added.                                                                                                                                 
}
```

Author: dreaming-augustin

tasks/config/project/release.js

@@ -7,7 +7,10 @@ const requireDotFile = require('require-dot-file');
 let
     config,
     npmPackage,
-    version
+    version,
+    revision,
+    versionInFileName,
+    includeVersionInFileName
 ;
 
 /*******************************
@@ -31,6 +34,20 @@ version = npmPackage && npmPackage.version !== undefined && npmPackage.name ===
     ? npmPackage.version
     : config.version;
 
+// looks for revision in config.
+revision = config.revision === undefined ? '' : config.revision;
+
+includeVersionInFileName = config.includeVersionInFileName === undefined ? false : config.includeVersionInFileName;
+
+versionInFileName = '';
+
+if (includeVersionInFileName) {
+    versionInFileName = '-' + version;
+    if (revision !== '') {
+        versionInFileName += '-' + revision;
+    }
+}
+
 /*******************************
              Export
 *******************************/
@@ -54,5 +71,6 @@ module.exports = {
         + ' */\n',
 
     version: version,
+    versionInFileName: versionInFileName,
 
 };

tasks/config/tasks.js

@@ -40,12 +40,12 @@ module.exports = {
     },
 
     filenames: {
-        concatenatedCSS: 'semantic.css',
-        concatenatedJS: 'semantic.js',
-        concatenatedMinifiedCSS: 'semantic.min.css',
-        concatenatedMinifiedJS: 'semantic.min.js',
-        concatenatedRTLCSS: 'semantic.rtl.css',
-        concatenatedMinifiedRTLCSS: 'semantic.rtl.min.css',
+        concatenatedCSS: 'semantic' + release.versionInFileName + '.css',
+        concatenatedJS: 'semantic' + release.versionInFileName + '.js',
+        concatenatedMinifiedCSS: 'semantic' + release.versionInFileName + '.min.css',
+        concatenatedMinifiedJS: 'semantic' + release.versionInFileName + '.min.js',
+        concatenatedRTLCSS: 'semantic' + release.versionInFileName + '.rtl.css',
+        concatenatedMinifiedRTLCSS: 'semantic' + release.versionInFileName + '.rtl.min.css',
     },
 
     regExp: {