Infrastructure

This page gives an overview of our technical documentation.

Getting started

• Getting started (Source files and the tools required to run them)
• Directory structure
• Connecting to the computer
• SVN repositories
• GitHub Issues

Compiling (building analysers)

• Defining targets for compilation
• Makefile names and organisation
• How to compile our abbreviation handler abbr.txt
• List of defined automake conditionals
• Multiple configurations and out of source building
• How To Use XML Files As Lexc Sources
• Example of file sizes with optimisations

Finite state transducers

• FST technology overview & future perspective
• Lookup and composition - a direction primer
• Understanding up and down in hfst and xerox
• Transducer name conventions in our infrastructure
• How to enable tags in natural languages

How to write documentation

• Forrest, Jspwiki
• How to write documentation as comments in your source code
• How to debug (correct ERRORS) in the documentation written in the source code
• Forrest debugging (when the documentation does not generate)

Testing and maintaining test scripts

• Adding test data in the new infra
• Adding new test scripts in the new infra
• Build your own tests
  • as slideshow
• Ideas for testing our transducers

Older documentation

This documents the move from “old” to “new” (present) infrastructure, in 2012.

Planning the move to newinfra

(This documentation is kept for historical reasons)

• Infra remake
• New infra overview
• Documentation generators (overview of tools - obsolete)
• New infra plan
• New infra progress
• New infra technical overview

The move from the old to the new infrastructure

• Web file names from the old infra
• How to move a language from the old infra to the new
• Names of the fsts in /opt/smi and in newinfra (see also this list)
• Moving plx and Hunspell to the new infra