|
| The XML format of RenjuNet database | 2008-03-17 19:30:37 |
Very soon all the 8000+ games of RenjuNet will be available for downloads. The data format will be XML. The Idea of providing such source is to let home users browse games more conveniently. RenjuNet does not have any official Viewer program yet, but I am sure there are many interested programmers in the world who would love to compose a viewer program.
In the future those viewer programs that can read RenjuNet Xml files, can also be published at the Download section of renjunet, thereby helping those programs become more popular.
Frank Arkbo has previously agreed to add an option to his Renlib software that can parse the RenjuNet Xml files, then directly show them on Renlib screen and/or convert them into a Renlib format.
Even though the game records will be freely accessible, the users must keep in mind that all the records are the property of RenjuNet and can be used for personal and non-commercial purposes only. It is OK to use the database in Offline mode with any Viewer software, but it is not allowed to use any parts of the database information in any websites or Online systems.
Below is the first draft on the RenjuNet XML format. I welcome you to discuss and review this format before we make a final decision. In the future, the format can be used as a protocol for data transfer in two directions - for common users as downloads, and for administrators as uploads.
Here is the XML draft. Feel free to discuss and provide your ideas and comments. I will be very thankful! It is not even decided whether xml will be the final choice or not. Perhaps we can also discuss about sgf or other formats.
<?xml version="1.0"?>
<database version="1.0" datetime="2008-03-15 15:24:00" />
<!--######################################################################################################-->
<!-- This is an xml version of RenjuNet games database, containing following: -->
<!-- Copyright information -->
<!-- The list of countries -->
<!-- The list of cities -->
<!-- The list of months -->
<!-- The list of rules -->
<!-- The list of openings -->
<!-- The list of players -->
<!-- The list of tournaments -->
<!-- The list of games -->
<!-- The following escapes inside the texts have to be decoded into original symbols while loading/converting this file: -->
<!-- & < > ' " © -->
<!--######################################################################################################-->
<!-- Copyright information -->
<copyright>
<owner>RenjuNet © 2001</owner>
<source>http://www.renju.net</source>
<email>web@renju.net</email>
<allowed>It is allowed to use this database for non-commercial purposes in the forms of OFFLINE databases only.</allowed>
<disallowed>It is forbidden to use any contents of this database in any website or ONLINE system.</disallowed>
</copyright>
<!-- The list of countries -->
<countries>
<country id="45" name="Estonia" abbr="EST" />
<country id="62" name="Russia" abbr="RUS" />
<country id="67" name="Japan" abbr="JAP" />
</countries>
<!-- The list of cities -->
<cities>
<city id="33" name="Tallinn" />
<city id="52" name="Moscow" />
<city id="55" name="Tokyo" />
</cities>
<!-- The list of months -->
<months>
<month id="1" name="January" />
<month id="2" name="February" />
<month id="3" name="March" />
</months>
<!-- The list of rules -->
<rules>
<rule id="1" name="RIF" info="..." />
<rule id="2" name="Taraguchi" info="..." />
</rules>
<!-- The list of openings -->
<openings>
<opening id="1" name="indirect 1" abbr="i1" />
<opening id="26" name="direct 13" abbr="d13" />
</openings>
<!-- The list of players -->
<players>
<player id="1" name="Ando" surname="Meritee" country="1" city="1" info="..." />
<player id="4" name="Ants" surname="Soosõrv" country="1" city="1" info="..." />
</players>
<!-- The list of tournaments -->
<tournaments>
<tournament id="25" name="Tallinn Open" country="1" city="1" year="1999" month="3" rule="1" rated="1" start="1999-03-12" end="1999-03-15" info="...">
<tournament id="31" name="Moscow Open" country="2" city="2" year="2001" month="12" rule="2" rated="0" start="2001-12-01" end="2001-12-09" info="...">
</tournaments>
<!-- The list of games -->
<games>
<game id="23" tournament="25" round="1" rule="1" black="1" white="2" bresult="1" wresult="0" btime="56" wtime="78" opening="11" alt="j9" swap="R">
<move>h8 i9 g7 h9 g9 i7 i8 g8</move>
<info>...</info>
</game>
<game id="24" tournament="25" round="2" rule="1" black="4" white="7" bresult="0.5" wresult="0.5" btime="92" wtime="81" opening="10" alt="g9" swap="-">
<move>h8 i9 h6 h9 j9 j8</move>
<info>...</info>
</game>
</games>
|
|
|