Subversion Repositories wimsdev

Rev

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

  1. <p>
  2. The following is the things you should check.
  3. </p>
  4. <ol>
  5.  <li>Find a wims site, verify the
  6.   <a href="html/policy.html">site policy</a> or contact the site manager,
  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>
  12.   The home site https://wims.univ-cotedazur.fr contains such a test server which welcomes all
  13.   people desirous of writing mathematical pages. But connection
  14.   might be slow for non-European users.
  15.   </p></li><li>
  16.   Connect to to the test server (from your browser), submit your (existing)
  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
  22.   directly send error messages to your browser. Continue this way until everything
  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
  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>
  33.   Briefly, a variable is a word preceeded by the dollar sign $emph $$$emphend.
  34.   You may use predefined variables (see
  35.   $(ref1)varspecial$(ref2)varspecial">$title_varspecial</a>), or define your
  36.  own (by the command
  37.  $(ref1)cmdlist_let_&+cmd_choose=all$(ref2)cmdlist_let_">!set</a>).
  38.   </p><p>
  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
  42.   $(ref1)cmdlist$(ref2)cmdlist">here</a> in this document.
  43.  </p></li><li>
  44.  If you want your page to be visible by the (future) wims
  45.  search engine, please copy a template file
  46.  (<a href="modules/light/template.en.phtml">English</a> or
  47.  <a href="modules/light/template.fr.phtml">French</a> version), modify the header
  48.  according to your case, and put in the body of your html content.
  49.  </li><li>
  50.  You can also copy (the source of) an existing phtml file, study its
  51.  structure, modify it to suit you (if the copyright policy of that file
  52.  allows you to do so). Please browse
  53.  <a href="modules/">the modules directory</a> which contains sources of all the
  54.  modules (as well as light phtml files).
  55.  </li><li>
  56.  When you think that your phtml page is ready, send a mail to the site manager,
  57.  asking him to transfer your page from the test server to the public wims server.
  58.  </li><li>
  59.  Once your page appears on the public site, you may put links from anywhere
  60.  pointing to it, and/or submit its address to search engines.
  61.  </li>
  62. </ol>
  63.  
  64. <hr>
  65. <h3 class="wimscenter">Important notes</h3>
  66. <p>When writing a phtml file, please take care of the following.</p>
  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.  </li><li>
  74.  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.  </li><li>
  78.  Make sure that no line starts with $emph !$emphend or $emph:$emphend,
  79.  other than for wims purposes.
  80.  </li>
  81. </ol>
  82. <hr>
  83. I have yet to find time to write a detailed tutorial for how to use each
  84. feature provided by wims server. If you have a question, please
  85. !mailurl xiao@unice.fr write me
  86. or check the
  87. <a href="http://www.listes.cri74.org/wws/info/wims">WIMS mailing list</a>.
  88.