Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/clairefro/rw-mycelium


https://github.com/clairefro/rw-mycelium

Last synced: 3 days ago
JSON representation

Awesome Lists containing this project

README

        

# rw-mycelium

A docs middleman for managing internationalization. This is a sandbox repo.

## Usage

All source docs are maintained in `source`. [Gitlocalize](https://gitlocalize.com/) is used to sync source docs with respective target languages in `i18n` directory.

It is important that the target dir structure be a mirror of the source dir structure.The Gitlocalize translations should be configured accordingly.

This allows builds of respective language repo sites to maintain the same path structure, so you only have to change the target language dir on build.

### Adding translations

Do so from the [Gitlocalize repo](https://gitlocalize.com/repo/5471)

Gitlocalize manages doc syncing when source content is added or changed.

### Adding a target language

To create a new target language directory, run this from the root, where `LANG_CODE` is a the [ISO 639-1 code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) of the target language.

```
# copy directory skeleton from source to i18n//
rsync -av -f"+ */" -f"- *" "./source/" "./i18n//

# add .gitkeepers to empty dirs
find . -type d ! -path "*.git*" -empty -exec touch '{}'/.gitkeep \;

```