2019-09-19 12:10:37 +00:00
# README
`versions.json` is the file that tells Nunjucks what version strings to append to client-side lolisafe assets.
To bump the version, it's recommended to use use `yarn bump-versions` .
```none
$ yarn bump-versions
$ node ./scripts/bump-versions.js
Bump version strings for client-side assets.
Usage:
node scripts/bump-versions.js < types >
types:
2020-04-19 18:54:54 +00:00
Space separated list of types (accepts 1 to 5).
2019-09-19 12:10:37 +00:00
1: CSS and JS files (lolisafe core assets + fontello.css).
2: Icons, images and config files (manifest.json, browserconfig.xml, etc).
3: CSS and JS files (libs from /public/libs, such as bulma, lazyload, etc).
4: Renders from /public/render/* directories (to be used with /src/js/misc/render.js).
2019-09-19 13:39:23 +00:00
5: Fontello font files.
2019-09-19 12:10:37 +00:00
a: Shortcut to update all types.
```
By default, running `yarn build` will also run `node ./scripts/bump-versions.js 1` .
2019-09-19 13:39:23 +00:00
## Fontello
`fontello.css` itself will use type 1, but its font files will use type 5.
Gulp will automatically append the version string into the built `fontello.css` in `dist` directory when running `yarn build` (or `dist-dev` when running `yarn develop` ).
To bump type 5, you would have to run `yarn bump-versions 5` .
2019-09-19 12:10:37 +00:00
## Cache-Control
Version strings will NOT be used when `cacheControl` in `config.js` is not enabled.
To begin with, version strings are only necessary when the assets are being cached indefinitely in browsers.
2019-09-19 13:39:23 +00:00
However, type 5 will still be appended to the built `fontello.css` if it exists in `versions.json` file.
