/usr/share/doc/xcdroast/README.setup-bulgarian.html

<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
   <meta http-equiv="Content-Type" content="text/html; charset=microsoft-cp1251">
   <title>X-CD-Roast - bg</title>
</head>
<body bgcolor="#FFFFFF" link="#00008D" vlink="#84807F" alink="#8D1D13">

<i>This file is available in both Áúëãàðñêè and <a
href="#eng">English</a>.</i><br>

<h4>X-CD-Roast - Èíñòðóêöèè çà èíñòàëèðàíå íà ïðåâîäà íà áúëãàðñêè åçèê.</h4>


<p>Çà äà ïîëçâàòå X-CD-Roast íà áúëãàðñêè, ùå òðÿáâà äà èìàòå èíñòàëèðàíè øðèôòîâå
ñ êîäîâà òàáëèöà microsoft-cp1251. Íàé-ëåñíî å äà èíñòàëèðàòå
<a href="http://linux.zonebg.com/mirrors/bglinux/" name="BG Linux" type="text/html">BG
Linux</a>, èëè ïîíå ïîëçâàéòå øðèôòîâåòå êîäèðàíè â "cp1251" îò òîçè ïàêåò.</p>

<p>Àêî ïîëçâàòå êîäîâàòà òàáëèöà koi8, ùå òðÿáâà äà ïðå-êîäèðàòå òåêñòà îò "cp-1251" â
"koi8". Äâàòà åçèêîâè ôàéëà ñà: language.def è langhelp.def è ñå íàìèðàò â
/usr/lib/xcdroast-0.98/lang.</p>

<p>Àêî âàøèÿ "locale" å êîíôèãóðèðàí ïðàâèëíî, X-CD-Roast áè òðÿáâàëî äà ïðåâêëþ÷è
íà áúëãàðñêè åçèê àâòîìàòè÷íî. Àêî å
íà àíãëèéñêè - èçáåðåòå "Áúëãàðñêè" îò ìåíþòî â "Setup - Miscellaneous - Language"
(íàè-äîëó). Àêî íå - ìîæåòå äà ãî
êîíôèãóðèðàòå ðú÷íî.</p>

<h4>Ðú÷íà êîíôèãóðàöèÿ:</h4>

<p>Øðèôòà íà áóòîíèòå è â ïðîçîðöèòå â X-CD-Roast çàâèñè îò âàøàòà GTK+ êîíôèãóðàöèÿ è å
çàïèñàí âúâ âàøèÿ ~/.gtkrc ôàéë (çíàêúò "~" îçíà÷àâà âàøàòà ïîòðåáèòåëñêà äèðåêòîðèÿ,
íàïðèìåð "/home/anton/". Òî÷êàòà ïðåäè èìåòî íà ôàéëà îçíà÷àâà ÷å òîâà å ñêðèò ôàéë.
Çà äà ãî âèäèòå ùå òðÿáâà äà èçáåðåòå "Show hidden files" âúâ âàøèÿ ôàéë ìåíèäæúð). Â
íà÷àëîòî íà âàøèÿ ~/.gtkrc ôàéë òðÿáâà äà èìàòå ñëåäíàòà ñåêöèÿ:</p>

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

<p>Ðàçáèðà ñå, ìîæåòå äà ïîëçâàòå ïðåäïî÷èòàíèÿ îò âàñ "ñð1251" øðèôò.</p>


<p>Øðèôòúò çà òåêñòà â îáÿñíèòåëíèòå ïðîçîðöè, êîèòî ñå ïîêàçâàò àêî çàäúðæèòå ìèøêàòà
âúðõó íÿêîé áóòîí çà 2 ñåêóíäè, å êîäèðàí äèðåêòíî â GTK+ è íå ìîæå äà áúäå ïðîìåíåí
ëåñíî. Çà äà ãî êîíôèãóðèðàòå, ùå òðÿáâà äà ñëîæèòå äèðåêòîðèÿòà ñ âàøèòå "ñð-1251"
øðèôòîâå íàé-îòãîðå íà âàøèÿ øðèôò-ïúò è äà íàïðàâèòå "alias" çà îñíîâíèòå
"adobe-helvetica" øðèôòîâå:</p>

<p><i>Íàïðèìåð</i> (àêî ïîëçâàòå øðèôòîâåòå îò BG Linux ïàêåòà):</p>

<p>Íàïðàâåòå íîâà äèðåêòîðèÿ ñ èìå "bg" â /usr/share/fonts (êàòî àäìèíèñòðàòîð):</p>

<pre>
  cd /usr/share/fonts
  md bg
</pre>

Êîïèðàéòå íîâèòå øðèôòîâå â íåÿ:

<pre>
  cp ~/cp1251/* /usr/share/fonts/bg
</pre>

Ïîäãîòâåòå øðèôòîâåòå çà ïîëçâàíå:

<pre>
  mkfontdir /usr/share/fonts/bg
</pre>

<p>Ñúçäàéòå ôàéëà "fonts.alias" â ñúùàòà äèðåêòîðèÿ. Â íåãî ìîæå äà äîáàâèòå ðàçëè÷íè
èìåíà è êîäîâè òàáëèöè çà âàøèòå øðèôòîâå. Íàïðèìåð êàòî èíñòàëèðàòå øðèôò ñ êîäîâà
òàáëèöà "microsoft-cp1251", ìîæåòå äà äîáàâèòå ÷å ñúùèÿò øðèôò ñúäúðæà è êîäîâàòà
òàáëèöà "iso8859-1". Íà âñåêè ðåä ïúðâî ñå çàïèñâà íîâîòî èìå íà øðèôòà, ñëåä òîâà
ñå îñòàâÿ ïîíå åäíî ïðàçíî ìÿñòî è ñëåä òîâà å èìåòî íà øðèôòà, êîéòî ñòå èíñòàëèðàëè
â ñúùàòà äèðåêòîðèÿ.</p>

<p><i>Ïðèìåð:</i></p>

<pre>
-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
</pre>

<p>(âñè÷êî å íà åäèí ðåä). Òðÿáâÿ äà èìàòå òàêèâà "alias" ïîíå çà îñíîâíèòå ðàçìåðè íà
øðèôòà adobe-helvetica, - 8, 10, 12, 14 è ò.í.</p>

<p>Ñëåä òîâà ïðèáàâåòå ïúòÿ äî òàçè äèðåêòîðèÿ â íà÷àëîòî íà âàøèÿ øðèôò-ïúò, òàêà ÷å äà
áúäå ïîäîáåí íà:</p>

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

<p>Âàøèÿ øðèôò-ïúò å â íà÷àëîòî íà êîíôèãóðàöèîííèÿ ôàéë íà X-Free, îáèêíîâåíî â
/etc/X11/XF86Config çà âåðñèÿ 3.3 èëè /etc/X11/XF86Config-4 çà âåðñèÿ 4.0. Àêî
ïîëçâàòå øðèôò-ñúðâúð, âàøèÿ øðèôò-ïúò å â êîíôèãóðàöèîííèÿ ôàéë íà ñúðâúðà.</p>

<p>Ðåñòàðòèðàéòå X-Free (çàòâîðåòå âñè÷êè ïðîãðàìè è íàòèñíåòå CTRL-ALT-BACKSPACE, à
ñëåä òîâà íàïèøåòå "startx" è íàòèñíåòå "Enter"). Àêî ïîëçâàòå øðèôò-ñúðâúð, íÿìà
íóæäà äà ðåñòàðòèðàòå X-Free, ñàìî ðåñòàðòèðàéòå ñúðâúðà (âèæòå â äîêóìåíòàöèÿòà
ìó òî÷íî êàê äà ãî íàïðàâèòå). Âêëþ÷åòå X-CD-Roast è èçáåðåòå "Áúëãàðñêè" îò ìåíþòî
çà åçèöè (Setup - Miscellaneous - Language).</p>

<hr><a name="eng"></a>

<h4>
X-CD-Roast - Installation instructions for Bulgarian language support.</h4>
<p>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
<a href="http://linux.zonebg.com/mirrors/bglinux/" name="BG Linux" type="text/html">BG
Linux</a>, or at least the "cp-1251" fonts that come with it.</p>

<p>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.</p>

<p>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.</p>

<h4>Configuration by hand</h4>

<p>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:</p>

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

<p>Of course you can use your favorite "cp1251" font.</p>

<p>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. </p>

<i>Example</i> (if you use fonts from
<a href="http://linux.zonebg.com/mirrors/bglinux/" name="BG Linux" type="text/html">BG
Linux</a>):

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

<pre>
  cd /usr/share/fonts
  md bg
</pre>

Copy your "cp1251 fonts there:

<pre>
  cp ~/cp1251/* /usr/share/fonts/bg
</pre>

Prepare the fonts for use:

<pre>
mkfontdir /usr/share/fonts/bg
</pre>

<p>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.</p>

<p><i>Example:</i></p>

<pre>
-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
</pre>

<p>(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.</p>

<p>Now add your new font directory to your font path. It should look something like:</p>

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

<p>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.</p>

<p>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.</p>

&nbsp;
</body>
</html>
xcdroast 0.98+0alpha16-1ubuntu1 / usr / share / doc / xcdroast / README.setup-bulgarian.html
