This file is available in both Български and English.

#### X-CD-Roast - Инструкции за инсталиране на превода на български език.

За да ползвате X-CD-Roast на български, ще трябва да имате инсталирани шрифтове с кодова таблица microsoft-cp1251. Най-лесно е да инсталирате BG Linux, или поне ползвайте шрифтовете кодирани в "cp1251" от този пакет.

Ако ползвате кодовата таблица koi8, ще трябва да пре-кодирате текста от "cp-1251" в "koi8". Двата езикови файла са: language.def и langhelp.def и се намират в /usr/lib/xcdroast-0.98/lang.

Ако вашия "locale" е конфигуриран правилно, X-CD-Roast би трябвало да превключи на български език автоматично. Ако е на английски - изберете "Български" от менюто в "Setup - Miscellaneous - Language" (наи-долу). Ако не - можете да го конфигурирате ръчно.

#### Ръчна конфигурация:

Шрифта на бутоните и в прозорците в X-CD-Roast зависи от вашата GTK+ конфигурация и е записан във вашия ~/.gtkrc файл (знакът "~" означава вашата потребителска директория, например "/home/anton/". Точката преди името на файла означава че това е скрит файл. За да го видите ще трябва да изберете "Show hidden files" във вашия файл мениджър). В началото на вашия ~/.gtkrc файл трябва да имате следната секция:

    style "user-font"
      {
        font="-adobe-helvetica-medium-r-normal-*-*-120-*-*-p-*-microsoft-cp1251"
      }
    widget_class "*" style "user-font"

Разбира се, можете да ползвате предпочитания от вас "ср1251" шрифт.

Шрифтът за текста в обяснителните прозорци, които се показват ако задържите мишката върху някой бутон за 2 секунди, е кодиран директно в GTK+ и не може да бъде променен лесно. За да го конфигурирате, ще трябва да сложите директорията с вашите "ср-1251" шрифтове най-отгоре на вашия шрифт-път и да направите "alias" за основните "adobe-helvetica" шрифтове:

Например (ако ползвате шрифтовете от BG Linux пакета):

Направете нова директория с име "bg" в /usr/share/fonts (като администратор):

      cd /usr/share/fonts
      md bg

Копирайте новите шрифтове в нея:

      cp ~/cp1251/* /usr/share/fonts/bg

Подгответе шрифтовете за ползване:

      mkfontdir /usr/share/fonts/bg

Създайте файла "fonts.alias" в същата директория. В него може да добавите различни имена и кодови таблици за вашите шрифтове. Например като инсталирате шрифт с кодова таблица "microsoft-cp1251", можете да добавите че същият шрифт съдържа и кодовата таблица "iso8859-1". На всеки ред първо се записва новото име на шрифта, след това се оставя поне едно празно място и след това е името на шрифта, който сте инсталирали в същата директория.

Пример:

    -adobe-helvetica-medium-r-normal--12-120-75-75-p-67-iso8859-1
         -adobe-helvetica-medium-r-normal--12-120-75-75-p-67-microsoft-cp1251

(всичко е на един ред). Трябвя да имате такива "alias" поне за основните размери на шрифта adobe-helvetica, - 8, 10, 12, 14 и т.н.

След това прибавете пътя до тази директория в началото на вашия шрифт-път, така че да бъде подобен на:

    catalogue = /usr/share/fonts/bg:unscaled,
            /usr/X11R6/lib/X11/fonts/misc:unscaled,
            /usr/X11R6/lib/X11/fonts/75dpi:unscaled,
            .........

Вашия шрифт-път е в началото на конфигурационния файл на X-Free, обикновено в /etc/X11/XF86Config за версия 3.3 или /etc/X11/XF86Config-4 за версия 4.0. Ако ползвате шрифт-сървър, вашия шрифт-път е в конфигурационния файл на сървъра.

Рестартирайте X-Free (затворете всички програми и натиснете CTRL-ALT-BACKSPACE, а след това напишете "startx" и натиснете "Enter"). Ако ползвате шрифт-сървър, няма нужда да рестартирате X-Free, само рестартирайте сървъра (вижте в документацията му точно как да го направите). Включете X-CD-Roast и изберете "Български" от менюто за езици (Setup - Miscellaneous - Language).

#### X-CD-Roast - Installation instructions for Bulgarian language support.

To be able to use X-CD-Roast in Bulgarian, you will need to install some "microsoft-cp1251" fonts. The easiest would be to install BG Linux, or at least the "cp-1251" fonts that come with it.

If you're using koi8 charset, you'll need to convert both language files: /usr/lib/xcdroast-0.98/lang/language.def and /usr/lib/xcdroast-0.98/lang/langhelp.def from cp-1251 to koi8 charset, and (of course) use appropriate fonts.

If you already have support for Bulgarian language installed and your locale is configured correctly, X-CD-Roast should switch to Bulgarian automatically. If not - you can try selecting "Български" from the "Setup - Miscellaneous - Language" menu. If that doesn't work - you can configure it by hand.

#### Configuration by hand

The interface font depends on your GTK+ configuration and is in your ~/.gtkrc file (the symbol "~" stands for your home directory, like "/home/anton", the dot in front of the file's name means that it's a hidden file. To be able to see it, you will have to select "Show hidden files" in your file manager). At the top of your ~/.gtkrc file you will need to have the following section:

      style "user-font"
        {
          font="-adobe-helvetica-medium-r-normal-*-*-120-*-*-p-*-microsoft-cp1251"
        }
      widget_class "*" style "user-font"

Of course you can use your favorite "cp1251" font.

The font for the pop-up help is hard-coded in GTK+ and is harder to set. You can configure it by putting your cp1251 fonts at the top of your font path and making alias to them.

Example (if you use fonts from BG Linux):

Make new directory named "bg" in /usr/share/fonts (as root):

      cd /usr/share/fonts
      md bg

Copy your "cp1251 fonts there:

      cp ~/cp1251/* /usr/share/fonts/bg

Prepare the fonts for use:

    mkfontdir /usr/share/fonts/bg

Create the file "fonts.alias" in the same directory. There you can add different names and encodings for your fonts. For example after installing "cp1251" fonts, you can specify that the same fonts will be used for "iso8859-1" encoding as well. On every row you need to put first the name of the alias, then an empty space, and then the name of the actual font you have installed in the same directory.

Example:

    -adobe-helvetica-medium-r-normal--12-120-75-75-p-67-iso8859-1
            -adobe-helvetica-medium-r-normal--12-120-75-75-p-67-microsoft-cp1251

(all on the same row). You will need these aliases at least for the most common sizes of "adobe-helvetica" - 8, 10, 12, 14, etc.

Now add your new font directory to your font path. It should look something like:

    catalogue = /usr/share/fonts/bg:unscaled,
              /usr/X11R6/lib/X11/fonts/misc:unscaled,
              /usr/X11R6/lib/X11/fonts/75dpi:unscaled,
              .........

Your font-path is at the top of your /etc/X11/XF86Config file for X-Free-3.6, or /etc/X11/XF86Config-4 for X-Free-4.0. If you use font server - your font-path is in your font server's configuration file.

Restart X-Free (close all programs and press "Ctrl-Alt-Backspace", then type "startx" and press "Enter"). If you use font server, you don't need to restart X-Free. Just restart the server (see in it's documentation exactly how to do that). Start X-CD-Roast and choose "Bulgarian" from the "Languages" menu.