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 
 
 -