annotate README.html @ 68:8a1af7e3d1f1

Ok.
author Matti Hamalainen <ccr@tnsp.org>
date Mon, 17 Feb 2014 20:34:16 +0200
parents 74777d6109a0
children 61292cb4e59c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
49
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
1 <html>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
2 <head>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
3 <title>AlchTool Documentation</title>
65
Matti Hamalainen <ccr@tnsp.org>
parents: 63
diff changeset
4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
49
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
5 <link href="alch.css" title="compact" rel="stylesheet" type="text/css">
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
6 </head>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
7 <body>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
8 <div class="docs">
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
9 <h1>AlchTool - PHP-based alchemist potion research tool</h1>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
10 <p>
67
74777d6109a0 Fix typos.
Matti Hamalainen <ccr@tnsp.org>
parents: 65
diff changeset
11 &copy; 2006-2011 Jarkko Vääräniemi (Jeskko Pupunen) and Matti Hämäläinen (Ggr Pupunen)
49
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
12 </p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
13 <p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
14 This software is a simple PHP-based script for making <a
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
15 href="http://www.bat.org/">BatMUD</a> alchemist potion research easier and
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
16 a more bearable process. It will help you keep book of the combinations you
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
17 have researched and will automatically eliminate combinations that are not
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
18 possible.
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
19 </p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
20
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
21 <h2>Requirements</h2>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
22 <p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
23 Requirements are simple, but may not be available to everyone. You will need
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
24 an environment capable of hosting PHP scripts, and a web-server. Most
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
25 UNIX/Linux shell accounts offer this possibility. PHP version 5 is
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
26 recommended, but the script may work with PHP version old as 4.3. We make no
63
414c64973f0c Change documentation, as PHP GD extension currently strictly required (this
Matti Hamalainen <ccr@tnsp.org>
parents: 50
diff changeset
27 guarantees, however. <b>GD extension</b> for PHP is also currently required.
49
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
28 </p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
29 <p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
30 Other thing you will need, of course, is a web-browser, for viewing the data.
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
31 </p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
32
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
33 <h2>How to use</h2>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
34 <p>
50
c3bb5c0f15d4 Clarify documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 49
diff changeset
35 Input data for the script can be written in file <b>results.txt</b>
67
74777d6109a0 Fix typos.
Matti Hamalainen <ccr@tnsp.org>
parents: 65
diff changeset
36 either by hand, or any other way desired, such as MUD client triggers. Latest version of <a
49
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
37 href="http://www.tnsp.org/~ccr/ggrtf/">GgrTF scriptset</a> for TinyFugue
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
38 offers a nifty alchemist guild module, that can automate the data file
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
39 generation completely.
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
40 </p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
41 <p>
50
c3bb5c0f15d4 Clarify documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 49
diff changeset
42 The format of the data file is as follows, example of a datafile can be
49
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
43 found <a href="results_example.txt">here</a>.
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
44 </p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
45 <ul>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
46 <li>Any non-empty line that does NOT start with hash '#' character, is considered data.</li>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
47 <li>Each data line is of format: <b>mineral</b> <b>organ</b> <b>herb</b>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
48 <i>result</i></li>
68
Matti Hamalainen <ccr@tnsp.org>
parents: 67
diff changeset
49 <li>Each entry (mineral, organ, herb, result) is separated by whitespace
Matti Hamalainen <ccr@tnsp.org>
parents: 67
diff changeset
50 of any amount you want to use.</li>
49
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
51 <li>Result field is as follows:<br />
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
52 <ul>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
53 <li><b>-</b> : No match.</li>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
54 <li><b>?potion_name</b> : Close, but no cigar.</li>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
55 <li><b>!potion_name</b> : Found potion.</li>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
56 </ul>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
57 </li>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
58 <li>Allowed names for minerals, herbs and organs are listed by the script.
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
59 Potion names are not limited, but you should be consistent, mismatches
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
60 cannot be detected!</li>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
61 </ul>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
62
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
63 <h2>Contact, bugreports, etc</h2>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
64 <p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
65 Tells to Ggr or Jeskko @ BatMUD, or e-mail ccr@tnsp.org (Ggr).
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
66 </p>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
67 </div>
3fa5d890fc5a Add documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
68 </html>