liblouis for Mac

[https://github.com/liblouis/liblouis/actions/workflows/main.yml] [https://github.com/liblouis/liblouis/actions/workflows/mingw.yml] [https://github.com/liblouis/liblouis/actions/workflows/emscripten.yml] [https://api.securityscorecards.dev/projects/github.com/liblouis/liblouis]

Introduction

Liblouis is an open-source braille translator and back-translator named in honor of [http://en.wikipedia.org/wiki/Louis_Braille]. It features support for computer and literary braille, supports contracted and uncontracted translation for [https://github.com/liblouis/liblouis/tree/master/tables] and has support for hyphenation. New languages can easily be added through tables that support a rule- or dictionary based approach. Tools for testing and debugging tables are also included. Liblouis also supports math braille (Nemeth and Marburg).

Liblouis has features to support screen-reading programs. This has led to its use in two open-source screenreaders, [http://www.nvda-project.org/] and [http://live.gnome.org/Orca]. It is also used in some commercial assistive technology applications for example by [http://www.viewplus.com].

Liblouis is based on the translation routines in the [http://mielke.cc/brltty/] screenreader for Linux. It has, however, gone far beyond these routines. In Linux and Mac OSX it is a shared library, and in Windows it is a DLL.

Liblouis is free software licensed under the [https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html] (see the file COPYING.LESSER).

The command line tools, are licensed under the [https://www.gnu.org/licenses/gpl.html] (see the file COPYING).

Documentation

For documentation, see the [http://www.liblouis.io/documentation/liblouis.html]. If you build liblouis from source you can get the documentation in various formats (either as info file, html, txt or pdf) in the doc directory, see the HACKING file for details.

For examples of translation tables, see =en-us-g2.ctb=, =en-us-g1.ctb=, =chardefs.cti=, and other files in the tables directory which contains tables for many languages.

Installation

After unpacking the distribution tarball from [https://github.com/liblouis/liblouis/releases] go to the directory it creates. You now have the choice to compile liblouis for either 16- or 32-bit unicode. By default it is compiled for the former. To get 32-bit Unicode run configure with =--enable-ucs4=.

After running =./configure= run =make= and then =sudo make install=. As a final step you might have to run =sudo ldconfig=. For other ways of installation, see the file HACKING.

This will produce the liblouis library and the programs =lou_allround= (for testing the library), =lou_checkhyphens=, =lou_checktable= (for checking translation tables), =lou_debug= (for debugging translation tables), =lou_translate= (for extensive testing of forward and backwards translation) and =lou_trace= (for tracing if individual translations). For more details see the liblouis documentation.