GiellaLT Documentation

GiellaLT provides rule-based language technology aimed at minority and indigenous languages

View GiellaLT on GitHub

Page Content

Documentation infrastructure

Core components

The documentation infrastructure is built on the following stones:

All keyboard-xxx and lang-xxx repositories (except private ones) have their own online site as subsites of There are separate pages for keyboards and language models with links directly to all subsite repos.

To update the online documentation, just save Markdown files in the docs/ folder of the repository, commit (and if using git: push), and the updated documentation will be online within a minute.

In-source documentation in lang-XXX repositories

All source code in the lang-XXX repositories containing documentation markup will be automatically parsed and the documentation extracted. The extracted documentation will be automatically added to the site on the next svn commit/git push.

Source file types being scanned for documentation comments are:

The top directories src/ and tools/, including all subdirs, are scanned. Generated files of the above types are not scanned.

Additional features

Beyond what is included in GFM, the GiellaLT documentation infrastructure also supports Mermaid through the use of a GitHub Action to convert Mermaid markup to SVG.

Mermaid support has recently been added to GtiHub, but the support does not include GtiHub Pages (not yet, at least). It does cover displaying Markdown source file views, README files, issues and discussion. By adding Mermaid support also to our GitHub Pages sites, there is parity between GH Pages and the rest of GitHub, and documents will render the same everywhere.

Mermaid test

~mermaid diagram 1~

Mermaid markup ```mermaid pie title Formal languages used in GiellaLT "LexC" : 3129 "Xfst regex" : 2374 "Xfst script" : 856 "TwolC" : 125 ```

Based on counts of all files of the various types in all repositories in the GiellaLT infra.

Possible future improvements