Skip to content

Latest commit

 

History

History
102 lines (70 loc) · 3.19 KB

CONTRIBUTING.md

File metadata and controls

102 lines (70 loc) · 3.19 KB

Development

Building

Prerequisites

In order to build this module, recent versions of node and npm are required. Most likely, using yarn also works, but only npm is officially supported. We recommend using the latest lts version of node. If you use nvm to manage your node versions, you can simply run

nvm install

in the project's root directory.

You also need to install the project's dependencies. To do so, run

npm install

Building

You can build the project by running

npm run build

Alternatively, you can run

npm run build:watch

to watch for changes and automatically build as necessary.

Linking the built project to Foundry VTT

In order to provide a fluent development experience, it is recommended to link the built module to your local Foundry VTT installation's data folder. In order to do so, first add a file called foundryconfig.json to the project root with the following content:

{
  "dataPath": ["/absolute/path/to/your/FoundryVTT"]
}

(if you are using Windows, make sure to use \ as a path separator instead of /)

Then run

npm run link-project

On Windows, creating symlinks requires administrator privileges, so unfortunately you need to run the above command in an administrator terminal for it to work.

You can also link to multiple data folders by specifying multiple paths in the dataPath array.

System Support

If you want to add support for a system, be sure to check the API page.

The guide assumes you're contributing the code to another module or system. If you want to contribute to this project, you will still need to create a subclass, but you should add it to LanguageProvider.js and its name to the import list on api.js.

Translations

Translation status

Polyglot is available in the following languages:

Contributing

If you want to contribute with any translation, check out Polyglot's Weblate page.

System Specific Translations

Some translations are specific to a system (e.g. COC7, SWADE, and WFRP4E. When in doubt about its translation, check up with other translators of the system or the Babele module's translation.