Subversion Repositories wimsdev

Rev

Rev 15337 | Details | Compare with Previous | Last modification | View Log | RSS feed

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