Subversion Repositories wimsdev

Rev

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
  </p></li><li>Connect to to the test server (from your browser), submit your (existing)
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> Please
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. <p>
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
  </p></li><li>If you want your page to be visible by the (future) wims
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
  </li><li>You can also copy (the source of) an existing phtml file, study its
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
  </li><li>When you think that your phtml page is ready, send a mail to the site manager,
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
  </li><li>Once your page appears on the public site, you may put links from anywhere
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
  </li><li>If your file originally contains the dollar sign $emph$$$emphend other
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
  </li><li>Make sure that no line starts with $emph !$emphend or $emph:$emphend,
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
 
-