Macros for Transliteration of Russian and Ukrainian

This page explains how to install and use the Microsoft Word template with macros for scholarly transliteration of Russian and Ukrainian text.

Installation on Windows

1. Download RU_UA_Translit.dotm.
2. Open Word and go to:
   • English: File → Options → Advanced → General → File Locations...
   • German: Datei → Optionen → Erweitert → Allgemein → Dateispeicherorte...
   • Russian: Файл → Параметры → Дополнительно → Общие → Расположение файлов...
3. Select Startup / Autostart / Автозагрузка and note the folder path.
4. Close Word.
5. Copy RU_UA_Translit.dotm into that folder.
6. Start Word again.

Typical Windows path: C:\Users\<username>\AppData\Roaming\Microsoft\Word\STARTUP

Installation on macOS

1. Download RU_UA_Translit.dotm.
2. Quit Microsoft Word.
3. In Finder, open the Word Startup folder. A common path is:

~/Library/Group Containers/UBF8T346G9.Office/User Content/Startup/Word

4. If needed, you can also check the location in Word:
   • English: Word → Preferences → File Locations
   • German: Word → Einstellungen → Dateispeicherorte
   • Russian: Word → Параметры → Расположение файлов
5. Copy RU_UA_Translit.dotm into the Startup folder.
6. Start Word again.

If the Library folder is hidden in Finder, open Finder, choose Go, and hold the Option key to reveal Library.

How to run the macros

1. Open any Word document.
2. Select the Cyrillic text you want to transliterate.
3. Open the macro dialog:
   • English: View → Macros → View Macros or Developer → Macros
   • German: Ansicht → Makros → Makros anzeigen or Entwicklertools → Makros
   • Russian: Вид → Макросы → Макросы... or Разработчик → Макросы
4. Select RU_Translate for Russian or UA_Translate for Ukrainian.
5. Click Run / Ausführen / Выполнить.

Recommended: add buttons to the Quick Access Toolbar

For regular use, I recommend adding both macros to the Quick Access Toolbar.

Windows

• English: File → Options → Quick Access Toolbar
• German: Datei → Optionen → Symbolleiste für den Schnellzugriff
• Russian: Файл → Параметры → Панель быстрого доступа

1. Open the Quick Access Toolbar settings.
2. In Choose commands from / Befehle auswählen / Выбрать команды из, select Macros / Makros / Макросы.
3. Add RU_Translate and UA_Translate.
4. Optionally rename the buttons or choose icons.
5. Click OK.

macOS

• English: Word → Preferences → Quick Access Toolbar or Word → Preferences → Ribbon & Toolbar
• German: Word → Einstellungen → Symbolleiste für den Schnellzugriff or Word → Einstellungen → Menüband und Symbolleiste
• Russian: Word → Параметры → Панель быстрого доступа or Word → Параметры → Лента и панель инструментов

1. Open the toolbar settings.
2. Find the list of available commands or macros.
3. Add RU_Translate and UA_Translate to the Quick Access Toolbar.
4. Save the changes.

Keyboard shortcuts

If you prefer, you can also assign keyboard shortcuts to the macros.

Windows

• English: File → Options → Customize Ribbon → Keyboard shortcuts: Customize...
• German: Datei → Optionen → Menüband anpassen → Tastenkombinationen: Anpassen...
• Russian: Файл → Параметры → Настроить ленту → Сочетания клавиш: Настройка...

1. Open the keyboard customization dialog.
2. Select the category Macros / Makros / Макросы.
3. Select RU_Translate or UA_Translate.
4. Enter a shortcut and assign it.

macOS

Depending on the Word version, toolbar buttons are usually the simpler and more reliable option on Mac.

Troubleshooting

• If the macros do not appear, make sure the template was copied to the Word Startup folder and restart Word.
• If Word blocks the template, your system or institutional settings may restrict macros.
• If the Startup folder is difficult to find, check it from Word through the menu paths listed above.

Terms of use and disclaimer

This template and the accompanying instructions are provided on an “as is” and “as available” basis, without any warranties of any kind, express or implied, including but not limited to warranties of correctness, completeness, reliability, fitness for a particular purpose, compatibility, or uninterrupted availability.

Use of the template is entirely at your own risk. You are solely responsible for checking the output, testing the macros in your own environment, and deciding whether the results are suitable for your academic, editorial, or other purposes.

The maintainer accepts no liability for any loss, damage, malfunction, data loss, formatting changes, workflow interruption, security issues, or any other direct or indirect consequences arising from the download, installation, execution, or use of the template or these instructions.

No guarantee is given that the template will work in all Word versions, operating systems, interface languages, or institutional configurations. Users are responsible for complying with local IT rules, macro security policies, and any applicable legal or institutional requirements.