diff options
| -rw-r--r-- | doc/faq/faq.sgml | 109 |
1 files changed, 57 insertions, 52 deletions
diff --git a/doc/faq/faq.sgml b/doc/faq/faq.sgml index d3e8f6c40..6a9417733 100644 --- a/doc/faq/faq.sgml +++ b/doc/faq/faq.sgml @@ -1823,79 +1823,84 @@ </sect2> <sect2 id="supportedfonts"> - <title>Which kinds of subtitle fonts xine uses and how to use them?</title> - <para> - xine can use two kinds of the fonts: + <title>What kinds of subtitle fonts does xine use?</title> + <para> + xine can use two kinds of fonts: <itemizedlist> - <listitem> + <listitem> <para> - TTF fonts + TTF fonts </para> <para> - If xine is compiled with freetype library xine recognises and uses TTF - fonts directly. + If xine is compiled with freetype library xine recognizes and uses TTF + fonts directly. </para> - </listitem> - <listitem> + </listitem> + <listitem> <para> - xine fonts + xine fonts </para> <para> - This is the xine native format. It's better because in the font - generator utility is implemented more features than in the - "on the fly" TTF renderer. + This is xine's native format. It's better because the font + generator utility implements more features than the "on the fly" TTF renderer. </para> - </listitem> + </listitem> </itemizedlist> - </para> - <para> - Font for external subtitles is selected via config option - 'misc.spu_font'. You can specify xine font name ('sans', 'serif', ...) - or file name of TTF font. The fonts are searched in the directories + </para> + <para> + The font for text subtitles is selected via config option + <parameter>misc.spu_font</parameter>. You can specify xine font name + (<parameter>sans</parameter>, <parameter>serif</parameter>, ...) + or file name of the TTF font. The directories <filename>$prefix/share/xine/libxine1/fonts</filename> and - <filename>~/.xine/fonts</filename>. TTF fonts are searched also in the - current directory. - </para> + <filename>~/.xine/fonts</filename> are searched for the fonts, with + <filename>$prefix</filename> being the place xine-lib was installed to. + Usually this is <filename>/usr/local</filename> or <filename>/usr</filename>. + TTF fonts are also searched for in the current directory. + </para> </sect2> <sect2 id="generatefonts"> - <title>How to create own xine subtitle fonts?</title> - <para> - xine native subtitle fonts can be generated from TTF fonts with the - utility xine-fontconv. It isn't compiled and installed by default but - you can make it manually. You'll need freetype and zlib packages and - their versions for development: + <title>How to create own xine subtitle fonts?</title> + <para> + xine's native subtitle fonts can be generated from TTF fonts with the + utility <command>xine-fontconv</command>. It isn't compiled and installed by default but + you can make it manually. You'll need freetype and zlib packages together with + their versions for development plus a compiler, of course ;) + Here's how you build <command>xine-fontconv</command>: <itemizedlist> - <listitem> - <para> - Get the source of xine-fontconv utility from xine-lib sources. - </para> - </listitem> - <listitem> - <para> - Compile it: - <screen><command>gcc xine-fontconv.c -o xine-fontconv `freetype-config --cflags --libs` -lz </command></screen> - </para> - </listitem> + <listitem> + <para> + Get the source of xine-fontconv utility from the <filename>misc</filename> + directory within the xine-lib sources. + </para> + </listitem> + <listitem> + <para> + Compile it: + <screen> <command>gcc xine-fontconv.c -o xine-fontconv `freetype-config --cflags --libs` -lz</command></screen> + </para> + </listitem> </itemizedlist> You'll need some TTF font for generating. Characters in this font should - cover all codepages you want support else you'll have missing characters. - </para> - <para> + cover all codepages you want supported, otherwise you'll have missing characters. + </para> + <para> Syntax is: - <screen><command>./xine-fontconf font.ttf font_name [encoding1 [encoding2 [...]]]</command></screen> - </para> - <para> + <screen> <command>./xine-fontconf font.ttf font_name [encoding1 [encoding2 [...]]]</command></screen> + </para> + <para> For example default font <filename>sans</filename> was generated with following command: - <screen><command>./xine-fontconv Aril_Bold.ttf sans iso-8859-1 iso-8859-2 iso-8859-5 \ - iso-8859-9 iso-8859-15 cp1250 cp1251</command></screen> - </para> - <para> + <screen> + <command>./xine-fontconv Aril_Bold.ttf sans iso-8859-1 iso-8859-2 iso-8859-5 \ + iso-8859-9 iso-8859-15 cp1250 cp1251</command></screen> + </para> + <para> There are displayed messages about missing characters on the screen during generating. It's OK if the missing characters are U+007f..U+009F. These characters come from iso-8859-1 and they aren't displayable. - </para> + </para> </sect2> <sect2 id="subencoding"> @@ -1903,8 +1908,8 @@ <para> Default expected encoding of the external subtitles is iso-8859-1. You need set appropriate encoding in the config option - 'misc.spu_src_encoding'. Note you need also the font which contains all - characters from given encoding. + <parameter>misc.spu_src_encoding</parameter>. Note you need also the font + which contains all characters from given encoding. </para> <para> Default font <filename>sans</filename> and fonts |