Add "Versions" section with links to old versions and NEWS file.

[mkws-moved-to-github.git] / tools / htdocs / index.html

diff --git a/tools/htdocs/index.html b/tools/htdocs/index.html
index 697eb35..67ad015 100644 (file)
--- a/tools/htdocs/index.html
+++ b/tools/htdocs/index.html
@@ -6,8 +6,8 @@
       body {
       font-family: Gill Sans, "Gillius ADF", Gillius, GilliusADF, Sans-Serif;
       }
-      h1 { font-weight: normal; color: #606060 }
-      h2 { font-size: 100% }
+      h1, h3 { font-weight: normal; color: #606060 }
+      h2 { margin-top: 0.5em }
       .pane { padding: 0em 1em; margin: 0.75em;
               border: 0.5em solid #eee;
               border-radius: 1em;
@@ -40,7 +40,7 @@
     </div>
 
     <div class="pane">
-      <h2>Example</h2>
+      <h2>A minimal example</h2>
       <p>
        Here is a completely functional (though ugly) MKWS-based
        searching application:
@@ -113,6 +113,17 @@
        </li>
       </ul>
       <p>
+       Minified versions of the MKWS JavaScript files are also available:
+      <p>
+      <ul>
+       <li>
+          <a href="mkws.min.js">mkws.min.js</a>
+       </li>
+       <li>
+          <a href="mkws-complete.min.js">mkws-complete.min.js</a>
+       </li>
+      </ul>
+      <p>
        (This domain also hosts two web-service endpoints that are used by
        running MKWS-based applications:
        <tt>/service-proxy-auth</tt>
@@ -125,11 +136,38 @@
     </div>
 
     <div class="pane">
+      <h2>Versions</h2>
+      <p>
+       The links above to the various forms of the widget-set JavaScript
+        (<a href="mkws.js">mkws.js</a>,
+        <a href="mkws-complete.js">mkws-complete.js</a>,
+        <a href="mkws.min.js">mkws.min.js</a>
+       and
+        <a href="mkws-complete.min.js">mkws-complete.min.js</a>)
+       are always to the current versions of those
+       files. Applications that rely on a particular version can
+       instead use the specific numbered versions in
+       <a href="releases/">the releases area</a>,
+       for example
+       <a href="releases/mkws-0.9.1.js">releases/mkws-0.9.1.js</a>.
+      </p>
+      <p>
+       The current version number is always in
+       <a href="VERSION">the VERSION file</a>.
+      </p>
+      <p>
+       Version history is in
+       <a href="NEWS">the NEWS file</a>.
+      </p>
+    </div>
+
+    <div class="pane">
       <h2>Examples using the widget-set</h2>
       <p>
         It's worth viewing the source of these to see how small they
         are and how various things are done.
       </p>
+      <h3>Simple examples</h3>
       <ul>
        <li>
           A very simple application at
@@ -149,11 +187,15 @@
           the application in Arabic.
        </li>
        <li>
-          The
-          <a href="http://example.indexdata.com/jquery.html"
-             >jQuery plugin</a>
-          version, consisting of a single JavaScript statement.
+          <a href="http://example.indexdata.com/mobile.html"
+             >A version suitable for mobile devices</a>,
+         with a responsive design that moves components around
+          depending on the screen size.
        </li>
+      </ul>
+
+      <h3>Advanced examples</h3>
+      <ul>
        <li>
          An application that
          <a href="http://example.indexdata.com/lowlevel.html"
@@ -170,15 +212,26 @@
             >the templating language</a>.)
        </li>
        <li>
-          <a href="http://example.indexdata.com/mobile.html"
-             >A version suitable for mobile devices</a>,
-         with a responsive design that moves components around
-          depending on the screen size.
+         <a href="http://example.indexdata.com/localauth.html"
+            >An application that uses a local authentication regime</a>,
+         and the corresponding
+         <a href="http://example.indexdata.com/apache-config.txt"
+            >Apache2 configuration stanza</a>.
+       </li>
+       <li>
+          The
+          <a href="http://example.indexdata.com/jquery.html"
+             >jQuery plugin</a>
+          version, consisting of a single JavaScript statement.
        </li>
        <li>
           <a href="http://example.indexdata.com/popup.html"
              >A version that uses a jQuery popup</a>.
        </li>
+      </ul>
+
+      <h3>Non-standard interfaces</h3>
+      <ul>
        <li>
           <a href="http://example.indexdata.com/dict.html"
              >An application that uses MKWS to find dictionary
@@ -189,13 +242,6 @@
              >An application that runs an automatic search on load</a>.
        </li>
        <li>
-         <a href="http://example.indexdata.com/localauth.html"
-            >An application that uses a local authentication regime</a>,
-         and the corresponding
-         <a href="http://example.indexdata.com/apache-config.txt"
-            >Apache2 configuration stanza</a>.
-       </li>
-       <li>
           An existing web-site,
           <a href="http://sagp.miketaylor.org.uk/"
              >The Self-Appointed Grammar Police</a>,
@@ -204,12 +250,14 @@
           <a href="http://sagp.miketaylor.org.uk/style.css"
              >that site's stylesheet</a>.)
        </li>
+<!--
        <li>
          Another existing web-site,
           <a href="http://zthes.z3950.org/"
              >The Zthes specifications</a>,
          which has been fitted with a popup MKWS search-box.
        </li>
+-->
       </ul>
     </div>