illuminated

internationalization tool for GitHub wikis

function

Converts a GitHub wiki into an HTML or PDF document, optionally translated into multiple languages.

purpose

Support rapid iteration of GitHub Wiki while maintaining broad internationalization support and document generation for distribution.

usage

development

To delete all example files and start over with newly built binary, run:

$ ./test.sh {local|remote} {mock|google} [comma-separated-languages]

production

Build the binary.

$ go build -o illuminated ./cmd

Generate a single, joined HTML and PDF for 5 languages using Google translate.

$ ./illuminated generate --verbose \
  --source https://github.com/getlantern/guide.wiki.git \
  --base "en" \
  --languages "en,zh,ru,fa,ar" \
  --translator "google" \
  --overrides "../overrides.yml" \
  --title "User Guide" \
  --html \
  --pdf \
  --join \
  --force

Use the help command for details.

$ ./illuminated --help

overrides

If a specific phrase is needed for a particular language, define that in an overrides.yml file in the directory where the command is run (or specify a different path with the --overrides flag).

Example overrides.yml:

- title: Lantern
  language: zh
  original: 灯笼
  replacement: 蓝灯
- title: Block
  language: en
  original: blacklist
  replacement: block list
- title: Allow
  language: en
  original: whitelist
  replacement: allow list