README

Development

Local environment

The project uses @wordpress/env to run a local WordPress environment. To get started, run the following commands:

npm install
npm run wp-env:start
npm run wp:rewrite
npm run composer install

The WordPress environment will be available at http://localhost:8888.

Building assets

To build the assets for development, run the following command:

npm run start

To build the assets for production, run the following command:

npm run build

I18n

We use i18n-midoru to make pots, uploads pots and download translations from Localise. It has one relevant file for configuration i18n-midoru.json in the root. This file has a list of projects, indexed by their name and with configurations for making pots, uploading pots and downloading translations. A generated file i18n-midoru.lock can also be found in the root after downloading translations. This file is used to poll Localise for new changes when trying to download translations again.

Make pots

Before making pots, make sure to build the assets first. To make the pots, run the following command:

composer run-script make-pots

To make pots for a specific project, add the name of the project (key string in the i18n-midoru.json) as an argument to the command.

Upload pots

To upload pots to Localise, run the following command:

composer run-script upload-pots

To upload pots for a specific project, add the name of the project (key string in the i18n-midoru.json) as an argument to the command.

Download translations

To download translations from Localise, run the following command:

composer run-script download-translations

To download translations for a specific project, add the name of the project (key string in the i18n-midoru.json) as an argument to the command.