docs: update the generating website assets section from the INSTALL file

This commit is contained in:
Emile Rolley 2023-05-07 14:52:25 +02:00 committed by Emile Rolley
parent 4637260b1e
commit fa8ebd3b62
2 changed files with 16 additions and 7 deletions

View File

@ -128,20 +128,33 @@ To uninstall, use
### Generating website assets ### Generating website assets
#### Updating [`@catala-lang/catala-web-assets`](https://www.npmjs.com/package/@catala-lang/catala-web-assets)
The Catala website features assets generated by the Catala compiler. They are The Catala website features assets generated by the Catala compiler. They are
needed to build the website. To produce them, simply run needed to build the website. To produce them, simply run
make website-assets DUNE_PROFILE=release make website-assets DUNE_PROFILE=release
Then, use a helper script to copy them over to the `assets` directory of the Then, use a helper script to copy them over to the `assets` directory of the
Catala website. [`catala-web-assets`](https://github.com/CatalaLang/catala-web-assets)
repository.
./generate_website_assets.sh <path-to-catala-website>/assets ./generate_website_assets.sh <path-to-catala-web-assets>/assets
You will need the `groff` executable to generate the HTML versions of the man > You will need the `groff` executable to generate the HTML versions of the man
pages, as well as the `rsync` executable to transfer files (preferred to `cp`) pages, as well as the `rsync` executable to transfer files (preferred to `cp`)
because it also works with a remote server. because it also works with a remote server.
#### Updating [`@catala-lang/french-law`](https://www.npmjs.com/package/@catala-lang/french-law)
When a new version of the `french_law.js` (see the [dedicated
README](https://github.com/CatalaLang/catala/tree/master/french_law/js#generating-the-source-files)
to generate the lib) needs to be published, you need to execute from the
`french_law/js` directory, the following commands:
npm version patch -m "Patch message"
npm publish
## Syntax highlighting ## Syntax highlighting
See the [dedicated `README.md`](./syntax_highlighting/README.md). See the [dedicated `README.md`](./syntax_highlighting/README.md).

View File

@ -26,9 +26,5 @@ rsync $BUILD/catala.html $1/
rsync $BUILD/clerk.html $1/ rsync $BUILD/clerk.html $1/
rsync $BUILD/catala_legifrance.html $1/ rsync $BUILD/catala_legifrance.html $1/
# NOTE(@EmileRolley): the french_law.js is accessible through:
# https://www.npmjs.com/package/@catala-lang/french-law
# no need to copy it here.
# rsync $BUILD/french_law/js/french_law.js $1/french_law.js
rsync $BUILD/examples/allocations_familiales/allocations_familiales_schema.json $1/ rsync $BUILD/examples/allocations_familiales/allocations_familiales_schema.json $1/
rsync $BUILD/examples/aides_logement/aides_logement_schema.json $1/ rsync $BUILD/examples/aides_logement/aides_logement_schema.json $1/