Changeset 92

Show
Ignore:
Timestamp:
03/16/04 21:54:31 (4 years ago)
Author:
ug
Message:

Updated tutorial

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • 05/devel/doc/tutorial.html

    r89 r92  
    9090  search pattern. 
    9191 
    92 <li> New in 0.5j: Support for character set encodings (in particular 
    93 encodings of Asian languages). The database list now also lists, for each 
     92<li> New in 0.5j: <a href="#encondings">Support for character set encodings</a>  
     93(in particular encodings of Asian languages). The database list now also  
     94lists, for each 
    9495database, the date when it was last modified. Optionally, Kombilo marks 
    9596the current move (thanks to Bernd Schmidt who provided a patch to do this). 
     
    786787possible to change it, later.) 
    787788 
     789<b>Character encodings</b> 
     790 
     791If your SGF files are not plain ASCII, but contain other characters, you have to 
     792tell Kombilo in which way they are encoded in the file. The best way to do this 
     793is to put a CA[] tag in the root node of the SGF file (e.g. CA[gb2312]). However, 
     794since there are many SGF files out there without the correct tag, you can also 
     795tell Kombilo about the encoding when you process your SGF databases. 
     796 
     797You have to know in which way your files are encoded, and all SGF files in the 
     798directory which is to be processed have to have the same encoding. Choose the 
     799encoding 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 
     802remember the encoding of the files in this database however, so the Kombilo 
     803core functions will know about the right encoding (in particular the game list, 
     804and the small window with the game info of the currently selected game, below 
     805the game list). When you double-click the game to play through it, the encoding 
     806is 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 
     810the encoding of this file. This is probably a good idea if you are sure that you 
     811know the right encoding. (Right now, if you have Kombilo add a wrong CA tag, you 
     812will have to remove it manually, because Kombilo will always obey a CA tag if 
     813present.) 
     814 
     815- Transcode to utf-8: In this case Kombilo will replace the SGF file with a 
     816transcoded version. CA tag?! 
     817 
     818Note: If a file already has a CA tag, Kombilo will not touch it. 
     819 
     820In order to use codecs for asian languages (like gb2312 or big5 for Chinese, 
     821shift-jis for Japanese or euc-kr for Korean), you have to install the cjkcodecs 
     822package. (In the Windows installer, this is already included.) 
     823This package may be available as a package in your Linux distribution; for  
     824Mac OS X users it is available via fink. Otherwise, 
     825you can get it at  
     826<a href="http://cjkpython.berlios.de/">http://cjkpython.berlios.de/</a>. 
     827 
     828 
    788829<div style="border:none; padding:3px; width:600px;  
    789830background-color:#99CCCC; z-index:1">  
     
    10841125(This is useful for BettyGo users; BettyGo is a program written by 
    10851126Max Durbano which provides a user interface to access several go related 
    1086 programs, see <a href="http://.../">http;//www.....fr/</a>.) 
     1127programs, see  
     1128<a href="http://perso.wanadoo.fr/gib.explore/BettyGo/BettyGo.htm"> 
     1129http://perso.wanadoo.fr/gib.explore/BettyGo/BettyGo.htm</a>.) 
    10871130<p> 
    10881131