How tos

How to translate the user interface

This chapter explains how to translate Transcriber user interface in a new language :

    array set local_fr


    array set local_lang

How to make a binary package

How to make a RPM Linux package

This chapter explains how to build a source RPM and a binary RPM from a source project:

    /usr/src/RPM/SPECS ,

    if you have previously installed Transcriber's RPM.


    rpm -ba transcriber.spec

    The place of Transcriber source and binary package will be displayed at the end of the building. Copy them in a safe place in your home directory.

    rpm -i transcriber-1.5.0.rpm

How to make a binary Linux package

The Linux binary package has been simply done by :

    tar -cvf TransPack.tar TransPack > gunzip -c

How to make a Windows Setup package

The Windows Setup package is done by using a Setup builder called Inno Setup. This tools enables to embed in a single Setup file:

      • the Transcriber binary package
      • a single executable file called tclkit that enables to source Tcl/Tk scripts
      • an application to launch Transcriber by sourcing it using tclkit
      • the code necessary to create shortcuts, set registry key values, ...

Creation of the Win32 Transcriber launcher

In order to launch Transcriber simply by double-clicking on an executable file, a Win32 application, named transwin.exe has been created. This has been done with the help of Dev-C++ which is an open Integrated Development Environment for the C/C++ programming language that uses Mingw port of GCC (GNU Compiler Collection) as its compiler and that can create Win32 applications.



Creation of the setup package






      • definition of transwin.exe as the main executable file of Transcriber

      • creation of a desktop shortcut

      • creation of a quicklaunch shortcut

      • association of an icon to the shortcuts

      • association of the same icon to .trs files

      • opening of .trs files with Transcriber when they are double-clicked

      • creation of the registry key HKEY_CLASSES_ROOT\Transcriber\Directory which contains the path to Transcriber installation directory

How to make a Mac OS X binary package

The Mac OS version used to create Transcriber 1.4.6 binary package is Mac OS X 10.3.

The binary version has been created using the standalone version of Tcl/Tk 8.4.4, tcltkaqua , which has been modified to integrate Transcriber's ressources.

Especially, in Contents directory, the following files have been added:

      • librairies and ressources necessary, lib/{html_library, snack 2.2, tcLex1.2, transcriber 1.4}

      • a Tcl script to launch the application, Ressources/Scripts/AppMain.tcl

      • a Transcriber icon, Ressources/Trans.icns

      • and the Info.plist file from Wish package has been modified to application specific settings (new icon file, application name, version, .trs file extension).

Finally, a compressed version *.dmg of Transcriber directory has been created using Disk Utility application of Mac OS X 10.3

How to edit a new release

      • RPM

      • Linux binary saved as a tar.gz

      • Windows setup

      • Mac OS

How to add a global variable

If you want to add a new element in the array v, which contains all the global variables, you just have to type in a Tcl script:

    set v(my_ element) value_element

But, if you want it to be saved when you exit Transcriber, you have to add the following line in etc/default.txt:

    v(my_element) ""

So, when Transcriber will be launched, it will read that line and create the global variable v(my_element) with nothing inside.

If during Transcriber execution, a value is set in the global variable, then when exiting, that value will be saved in the user configuration file (.transcriber on Linux or transcriber.pref on Windows or Transcriber Configuration on Mac), and the next time Transcriber is launched, that value will be set in v (it means that it will have a priority on what is defined in etc/default.txt).