g18n-dev #

A small development-time generator for g18n webpage translations.

Installation #

Add the runtime package and the development generator:

gleam add g18n
gleam add --dev g18n_dev

Translation files #

Place one JSON file per language in your application's translation directory:

src/<project>/translations/
├── en.json
├── es.json
└── fr.json

The filename identifies the language but has no runtime semantics. g18n does not apply locale or language rules.

Each file may use flat dotted keys:

{
  "page.title": "Welcome",
  "page.greeting": "Hello {name}!"
}

Or nested objects:

{
  "page": {
    "title": "Welcome",
    "greeting": "Hello {name}!"
  }
}

Both formats may be used with the same command.

Generate the module #

gleam run -m g18n/dev generate

The generator writes src/<project>/translations.gleam. For en.json, it creates:

• en_translations() -> g18n.Translations
• en_translator() -> g18n.Translator

It also creates:

• available_languages() -> List(String)
• all_translators() -> List(#(String, g18n.Translator))

Use the generated module directly in a webpage:

import g18n
import my_app/translations

let translator = translations.en_translator()
g18n.translate(translator, "page.title")

Your application chooses the generated translator. The generator does not parse locales, negotiate languages, apply plural rules, or add browser runtime code.

Commands #

generate  Generate the translation module from every JSON file
help      Show command help

License #

MIT