ZRCola

A Microsoft Windows application for composing texts using a wide range of Slavic (and general) letters from or beyond Unicode.

Project Website

http://zrcola.zrc-sazu.si/en/

Binaries for Download

https://prenos.amebis.si/ZRCola/

Building

Building Environment Requirements

• Microsoft Windows Vista or later
• Microsoft Visual Studio 2017
• sed.exe and grep.exe
• Command line utilities from Microsoft Windows SDK Bin folder: distributed with Visual Studio, add Bin folder to path manually.
• Additional command line utilities from project's bin folder: add bin folder to path. The source code is provided on request.

wxWidgets

ZRCola is using wxWidgets static libraries. You have to compile static libraries yourself.

Compiling wxWidgets Win32 static libraries

1. Start x86 Native Tools Command Prompt for VS 2017
2. Change working folder to build\msw
3. Run: nmake /f makefile.vc /ls RUNTIME_LIBS=static SHARED=0 COMPILER_VERSION=141
4. Run: nmake /f makefile.vc /ls RUNTIME_LIBS=static SHARED=0 COMPILER_VERSION=141 BUILD=release

Compiling wxWidgets x64 static libraries

1. Start x64 Native Tools Command Prompt for VS 2017
2. Change working folder to build\msw
3. Run: nmake /f makefile.vc /ls RUNTIME_LIBS=static SHARED=0 COMPILER_VERSION=141 TARGET_CPU=X64
4. Run: nmake /f makefile.vc /ls RUNTIME_LIBS=static SHARED=0 COMPILER_VERSION=141 TARGET_CPU=X64 BUILD=release

Specifying wxWidgets path

ZRCola compilation references wxWidgets libraries using WXWIN environment variable. Please set it to wxWidgets folder (e.g. C:\SDK\wxWidgets).

Digital Signing of Build Outputs

In order to have the build process digitally sign output files, one should provide the following:

1. A signing certificate installed in the current user's certificate store.
2. The following variables in the environment:

• ManifestCertificateThumbprint - set the value to certificate's SHA1 thumbprint (hexadecimal, without spaces, e.g. f61b973226c502a732d24f41aa85e192b009e7c0).
• ManifestTimestampRFC3161Url - set the value to URL used to perform RFC3161 timestamp signature (e.g. http://time.certum.pl). In order to perform timestamp signing successfully, the computer running the build should be online and able to access this URL.

Please note that only Release builds are configured for timestamp signing. Debug configurations do not attempt to timestamp sign the resulting DLL and EXE files in order to speed up the building process and enable offline building.

Building

Use Microsoft NMAKE to build the project. The resulting files can be found in output subfolder. Open x64 Native Tools Command Prompt for VS 2017 for building.

• nmake Clean Delete all intermediate and output files.
• nmake Setup Build a release version of project and release MSI setup files.
• nmake SetupDebug Build a debug version of project and debug MSI setup files.
• nmake Register Build a debug version of project, install fonts (reboot required), and Start Menu shortcuts. For development purposes only!
• nmake Unregister Remove Start Menu shortcuts, and fonts. For development purposes only!

The /ls flag can be appended to the commands above to reduce NMAKE's verbosity. You can combine multiple targets (e.g. nmake Unregister Clean). Please, see NMAKE reference for further reading.

Building and installing ZRCola webservice

ZRCola is also available as a Linux web-service. See ZRColaWS/README.md for instructions.

Translating ZRCola

Instructions how to translate ZRCola to your language can be found here.

Contact Information

Please contact the following addressee for further information and help:

• ZRC SAZU, [email protected]
• Amebis, [email protected]