Changeset 93

Show
Ignore:
Timestamp:
03/18/04 22:13:39 (4 years ago)
Author:
ug
Message:

Updated tutorial

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • 05/devel/doc/tutorial.html

    r92 r93  
    9090  search pattern. 
    9191 
    92 <li> New in 0.5j: <a href="#encondings">Support for character set encodings</a>  
     92<li> New in 0.5j: <a href="#encodings">Support for character set encodings</a>  
    9393(in particular encodings of Asian languages). The database list now also  
    9494lists, for each 
    …… 
    215215the given pattern in the relevant region, no matter what else is on the board. 
    216216Of course, mirroring and rotating the board is automatically taken into account.<p> 
    217 <img src="onepixel.gif" width="600" height="20"> 
    218217 
    219218<table border="0" width="100" cellpadding="6" align=RIGHT> 
    …… 
    785784The default is to write them to the same directory as the SGF files they 
    786785are associated to. (This choice has to be made before adding the database; it's not 
    787 possible to change it, later.) 
    788  
    789 <b>Character encodings</b> 
     786possible to change it, later.)<p> 
     787 
     788<p><b>Character encodings</b> 
    790789 
    791790If your SGF files are not plain ASCII, but contain other characters, you have to 
    792791tell Kombilo in which way they are encoded in the file. The best way to do this 
    793 is to put a CA[] tag in the root node of the SGF file (e.g. CA[gb2312]). However, 
     792is with a CA[] tag in the root node of the SGF file (e.g. CA[gb2312]). However, 
    794793since there are many SGF files out there without the correct tag, you can also 
    795 tell Kombilo about the encoding when you process your SGF databases. 
    796  
    797 You have to know in which way your files are encoded, and all SGF files in the 
     794tell Kombilo about the encoding when you process your SGF databases.</p> 
     795 
     796<p>You have to know in which way your files are encoded, and all SGF files in the 
    798797directory which is to be processed have to have the same encoding. Choose the 
    799 encoding from the list, and choose what Kombilo should do with your SGF files. 
    800  
    801 - Do not change SGF: In this case, Kombilo will not touch your files. It will 
    802 remember the encoding of the files in this database however, so the Kombilo 
    803 core functions will know about the right encoding (in particular the game list, 
    804 and the small window with the game info of the currently selected game, below 
    805 the game list). When you double-click the game to play through it, the encoding 
    806 is not known to the part of the program which deals with SGF editing etc.  
    807 (CHANGE THIS?!?!??!) 
    808  
    809 - Add CA tag: This will add a tag in the root node of the SGF file which contains 
     798encoding from the list, and choose what Kombilo should do with your SGF files.</p> 
     799 
     800<p>- Do not change SGF: In this case, Kombilo will not touch your files. It will 
     801remember the encoding of the files in this database however, so Kombilo 
     802will know about the right encoding.</p> 
     803 
     804<p>- Add CA tag: This will add a tag in the root node of the SGF file which contains 
    810805the encoding of this file. This is probably a good idea if you are sure that you 
    811806know the right encoding. (Right now, if you have Kombilo add a wrong CA tag, you 
    812807will have to remove it manually, because Kombilo will always obey a CA tag if 
    813 present.) 
    814  
    815 - Transcode to utf-8: In this case Kombilo will replace the SGF file with a 
    816 transcoded version. CA tag?! 
    817  
    818 Note: If a file already has a CA tag, Kombilo will not touch it. 
    819  
    820 In order to use codecs for asian languages (like gb2312 or big5 for Chinese, 
     808present.)</p> 
     809 
     810<p>- Transcode to utf-8: In this case Kombilo will replace the SGF file with a 
     811transcoded version. CA tag?!</p> 
     812 
     813<p>Note: If a file already has a CA tag, Kombilo will not touch it.</p> 
     814 
     815<p>In order to use codecs for asian languages (like gb2312 or big5 for Chinese, 
    821816shift-jis for Japanese or euc-kr for Korean), you have to install the cjkcodecs 
    822817package. (In the Windows installer, this is already included.) 
    …… 
    824819Mac OS X users it is available via fink. Otherwise, 
    825820you can get it at  
    826 <a href="http://cjkpython.berlios.de/">http://cjkpython.berlios.de/</a>. 
     821<a href="http://cjkpython.berlios.de/">http://cjkpython.berlios.de/</a>.</p> 
    827822 
    828823 
    …… 
    16941689 
    16951690<HR> 
    1696 <i>Last modified: 15-December-2002</i>  
     1691<i>Last modified: 16-March-2004</i>  
    16971692Contact: <a href="mailto:u@g0ertz.de">u@g0ertz.de</a>. 
    16981693To my <a href="http://www.g0ertz.de/">homepage</a>.