Subversion Repositories wimsdev

Rev

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