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