Rev 1091 | Go to most recent revision | Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
32 | reyssat | 1 | <p> |
2 | The following is the things you should check. |
||
3 | <ol> |
||
4 | <li>Find a wims site, verify the |
||
5 | <a href=html/policy.html>site policy</a> or contact the site manager, |
||
6 | to see whether they are interested in carrying your page. <p> |
||
7 | If the site has a test server, you may also ask the site manager to give you |
||
8 | a test account. This will allow you to submit and test your draft pages |
||
9 | repeatedly, at a very high frequency. |
||
10 | <p> |
||
11 | The home site wims.unice.fr contains such a test server which welcomes all |
||
12 | people desirous of writing mathematical pages. But connection |
||
13 | might be slow for non-European users. |
||
14 | <p> |
||
15 | <li>Connect to to the test server (from your browser), submit your (existing) |
||
16 | html file into it, and make a http request for the page, to see thether it |
||
17 | is there. |
||
18 | Then add some mathematical symbols, wims variables and commands into your |
||
19 | file, resubmit it, and reload your page to see whether it works. If you |
||
20 | make an error, wims server will |
||
21 | directly send error messages to your browser. Continue this way until everything |
||
22 | seems OK for you. |
||
23 | <p> |
||
24 | You have only to submit your html file which requires wims services. Graphics |
||
25 | files, may stay where they were, on your original site. But you |
||
26 | should make sure that the file you submitted to wims site contains only |
||
27 | links to absolute addresses. |
||
28 | <p> |
||
29 | <li> Please |
||
30 | read the corresponding chapters of the technical reference of this document |
||
31 | to see how to add variables and commands into your file. <p> |
||
32 | Briefly, a variable is a word preceeded by the dollar sign $emph $$$emphend. |
||
33 | You may use predefined variables (see |
||
34 | $(ref1)varspecial$(ref2)varspecial>$title_varspecial</a>), or define your |
||
35 | own (by the command |
||
36 | $(ref1)cmdlist_let_&cmd_choose=all$(ref2)cmdlist_let_>!set</a>). |
||
37 | <p> |
||
38 | And a wims command is a word preceeded by the character $emph !$emphend, <b> |
||
39 | when it appears at the beginning of a line</b>. The list of commands as |
||
40 | well as their syntax can be found |
||
41 | $(ref1)cmdlist$(ref2)cmdlist>here</a> in this document. |
||
42 | <p> |
||
43 | <li>If you want your page to be visible by the (future) wims |
||
44 | search engine, please copy a template file |
||
45 | (<a href=modules/light/template.en.phtml>English</a> or |
||
46 | <a href=modules/light/template.fr.phtml>French</a> version), modify the header |
||
47 | according to your case, and put in the body of your html content. |
||
48 | <p> |
||
49 | <li>You can also copy (the source of) an existing phtml file, study its |
||
50 | structure, modify it to suit you (if the copyright policy of that file |
||
51 | allows you to do so). Please browse |
||
52 | <a href=modules/>the modules directory</a> which contains sources of all the |
||
53 | modules (as well as light phtml files). |
||
54 | <p> |
||
55 | <li>When you think that your phtml page is ready, send a mail to the site manager, |
||
56 | asking him to transfer your page from the test server to the public wims server. |
||
57 | <p> |
||
58 | <li>Once your page appears on the public site, you may put links from anywhere |
||
59 | pointing to it, and/or submit its address to search engines. |
||
60 | <p> |
||
61 | |||
62 | </ol> |
||
63 | |||
64 | <p><hr> <p> |
||
65 | <center><h3>Important notes</h3></center> |
||
66 | <p>When writing a phtml file, please take care of the following. |
||
67 | <ol> |
||
68 | <li>You may adapt any html file composed by any html composer to a phtml |
||
69 | file. But once your file contains any wims commands, you should no longuer |
||
70 | use html composers to modify it. Because WIMS only recognizes commands at |
||
71 | the beginning of a line, while most html composers will reformat the lines |
||
72 | of your file. Use an ordinary text editor instead. |
||
73 | <p> |
||
74 | <li>If your file originally contains the dollar sign $emph$$$emphend other |
||
75 | than as a wims variable introducer, double them. Otherwise your dollar sign |
||
76 | will probably disappear in the visitors' browsers. |
||
77 | <p> |
||
78 | <li>Make sure that no line starts with $emph !$emphend or $emph:$emphend, |
||
79 | other than for wims purposes. |
||
80 | </ol> |
||
81 | <hr> |
||
82 | I have yet to find time to write a detailed tutorial for how to use each |
||
83 | feature provided by wims server. If you have a question, please |
||
84 | !mailurl xiao@unice.fr write me |
||
85 | or check the |
||
86 | <a href=http://www.listes.cri74.org/wws/info/wims>WIMS mailing list</a>. |
||
87 |