JAL-1986 JAL-1996 separated out appletDeploment page from appletParameter page, updat...
authortcofoegbu <tcnofoegbu@dundee.ac.uk>
Thu, 21 Jan 2016 12:44:53 +0000 (12:44 +0000)
committertcofoegbu <tcnofoegbu@dundee.ac.uk>
Thu, 21 Jan 2016 12:44:53 +0000 (12:44 +0000)
examples/appletDeployment.html [new file with mode: 0644]
examples/appletParameters.html
examples/embedded.html
examples/embeddedWJmol.html
examples/formComplete.html
examples/includes/nav_jv.html
examples/javascriptLaunch.html
examples/linkedapplets_ng.html

diff --git a/examples/appletDeployment.html b/examples/appletDeployment.html
new file mode 100644 (file)
index 0000000..a7653ed
--- /dev/null
@@ -0,0 +1,162 @@
+<!--
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ The Jalview Authors
+ * 
+ * This file is part of Jalview.
+ * 
+ * Jalview is free software: you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License 
+ * as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+ *  
+ * Jalview is distributed in the hope that it will be useful, but 
+ * WITHOUT ANY WARRANTY; without even the implied warranty 
+ * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
+ * PURPOSE.  See the GNU General Public License for more details.
+ * 
+ * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
+-->
+
+
+<div id="view_decorated" name="view_decorated"  style="margin:8px; padding:10px; border: 2px solid red; text-align:center; display:none;"><b>Click <a href="index.html#appletDeployment"> here</a> to view decorated page</b></div>
+
+<!-- content start -->
+<h2><a name="appletdeploymentnotes"/>Notes on applet deployment</h2>
+        <ul>
+          <li>Package all your data files into a single (or multiple) zip / jar 
+            files. This is very useful to reduce download time of large data files. 
+            The applet archive tag can take multiple entries separated by commas, 
+            eg<br>
+            <pre>&lt;applet code=&quot;jalview.bin.JalviewLite&quot;<em><strong> 
+            archive=&quot;jalviewApplet.jar, mydata.zip&quot;</strong></em>&gt;
+            </pre></li>
+          <li> Use Jalview for input to a HTML form. For an example of how to 
+            code this using Javascript, click <a href="javascript:doSubmit('formComplete')">here</a>. 
+            <br>
+          </li>
+          <li>Embed Jalview into the web page, without the &quot;Start Jalview&quot; 
+            button by setting the embed parameter to true;<br>
+            &lt;param name=&quot;embedded&quot;
+          value=&quot;true&quot;&gt; </li>
+       <li><a href="javascript:doSubmit('appletParameters')">View full list of supported parameters here.</a> </li>
+        </ul>
+        
+        <p><strong>**NEW FEATURES** in Jalview 2.9</strong></p> 
+        <ul>
+        <li>Split Views for cDNA and Protein alignments<br/>Specify second alignment with 'file2' parameter, and set cDNA/Protein column scaling with scaleProteinAsCdna
+        </li>
+       <li>Jmol compatibility updated to Jmol 14.2.x series - <a href="JmolApplet-14.2.14_2015.06.11.jar">download the JmolApplet here </a></li>
+       <li>The Jmol jar must be updated from <b>&#39;JmolApplet-12.2.4.jar&#39;</b> to <b>&#39;JmolApplet-14.2.14_2015.06.11.jar&#39;</b> in the applet archive argument as highlighted in red below:<br>
+               <pre>archive=&quot;jalviewApplet.jar,<font color="red">JmolApplet-14.2.14_2015.06.11.jar,</font>java-json.jar,json_simple-1.1.jar&quot;</pre>
+       </li>
+       <li>BioJson - A Json file format for representing a single multiple sequence alignment. 
+           Biojson uses the following external libraries: java-json and json_simple-1.1. <br>Hence the jar files highlighted in red must be included in the applet archive argument as follows:<br>
+            <pre>archive=&quot;jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar,<font color="red">java-json.jar,json_simple-1.1.jar</font>&quot;</pre>              
+       </li>
+        </ul>
+        </p>
+        <p><strong>**NEW FEATURES** in Jalview 2.8</strong></p> 
+        <ul>
+        <li>Normalised sequence logo display
+        </li>
+        <li>RNA secondary structure annotation row
+        </li>
+<li>Jmol compatibility updated to Jmol 12.2.x series - <a href="JmolApplet-12.2.4.jar">download the JmolApplet here</a></li>
+<li>To use Jmol as the structure viewer for Jalview, you must include 
+            the jar file in the applet archive argument thus:<br>
+            <pre>archive=&quot;jalviewApplet.jar,Jmol-12.2.4.jar&quot;</pre>
+          </li>
+          <li>Jmol 12.2.x requires at least Java 1.6 to run in the clients web browser. If the client does not have 
+            Java 1.6, or if the Jmol-12.2.jar is not added to the archive, the 
+            original Jalview structure viewer will still be available. <br>
+          </li>
+          
+        </ul>
+        <p><strong>**NEW FEATURES** in Jalview 2.7</strong></p>
+        <ul>
+        <li>Javascript callbacks capabilities<ul><li>oninit parameter and methods for registering javascript handlers for selections, mouseovers and linking to Jmol applets on the page.</li>
+        <li>To use javascript callbacks, ensure the applet tag includes the '<a href="http://download.oracle.com/javase/6/docs/technotes/guides/plugin/developer_guide/java_js.html">mayscript</a>' attribute - either as a parameter (&lt;param name="mayscript" value="true"/;gt;) or as a bare attribute in the applet html tag).</li></ul>
+        </li>
+        <li>New <a href="javascript:doSubmit('jalviewLiteJs')">jalviewLite java api</a> methods for selecting, highlighting, scrolling and reordering sequences in an alignment view.
+        </li></ul>
+        <p><strong>**NEW FEATURES** in Jalview 2.6</strong></p>
+        <ul>
+        <li>Jmol compatibility updated to Jmol 12.1.x series</li>
+          <li>Jalview 2.6 works only with Jmol version 12.1.13 or later. You can use the JmolApplet.jar from 
+          the Jmol binary distribution available at the Jmol Sourceforge site, 
+          or <a href="JmolApplet-12.1.13.jar">download the Jmol applet from here</a></li>
+          <li>Minimum recommended version of Java runtime for the applet is now 1.5 (JalviewLite v2.6 without the Jmol viewer may work ok on earlier Java environments but compatibility can no-longer be guaranteed).</li>
+  </ul>
+        <br><strong>**NEW FEATURES** in Jalview 2.5</strong></p>
+        <ul>
+        <li>New parameters to control display of tree annotation, width of alignment columns, and to disable the jalview button and check for Jmol on startup.</li>
+  </ul>        
+        <br><strong>**NEW FEATURES** in Jalview 2.4</strong></p>
+        <ul>
+        <li>New applet API methods for feature display control, views, and obtaining current selection via javascript.</li>
+          <li>Group show and hide parameters:
+        &quot;showfeaturegroups&quot; and
+        &quot;hidefeaturegroups&quot;. Both take a list
+        of feature group names (separarated by &quot;|&quot; by default) to hide or show on the displayed
+        alignment.
+        </li>
+        <li>Regular expressions can be used in URL links for sequence IDs.</li>
+        <li>&quot;debug&quot; parameter to control verbosity of the applet's console output.</li>
+        <li>&quot;showbutton&quot; parameter to disable launch button and open JalviewLite immediatly.</li>
+        <li>&quot;nojmol&quot; parameter to disable check for Jmol classes.</li>
+        </ul><br>
+        <strong>**NEW FEATURES** in Jalview 2.3</strong></p>
+        <ul>
+          <li>Note that Parameter &quot;PDBFile&quot; now takes 
+            the PDB file followed by a space separated list of alignment sequence 
+            ids to associate the structure to. It is also possible to associate 
+            multiple PDB files by adding an incremental value to PDBFile (up to 
+            10). It is also possible to map specific sequences to specific chains 
+            by using the following notation:<br>
+            <br>
+            <pre>
+            &lt;param name=&quot;PDBFile&quot; value=&quot;First.pdb SeqA SeqB 
+            SeqC&quot;&gt;<br>
+            &lt;param name=&quot;PDBFile2&quot; value=&quot;Second.pdb 
+            A=SeqA B=SeqB C=SeqC&quot;&gt;<br>
+            &lt;param name=&quot;PDBFile3&quot; value=&quot;Third.pdb 
+            D=SeqX B=SeqY C=SeqZ&quot;&gt;<br>
+            </pre>
+          </li>
+          <li>Note parameter &quot;PDBSeq&quot; is no longer required.<br>
+          </li>
+          <li>Jalview 2.3 was updated to work with Jmol 11. See the <a href="/development">versions archive if you want to download the old Jmol applet</a>.</li> 
+            <p>&nbsp;</p>
+          </li>
+        </ul>
+        <strong>**NEW FEATURES** in Jalview 2.1</strong> 
+        <ul>
+          <li>Jalview Applet can read and display JNet secondary structure annotation 
+            directly via the <strong>jnetfile</strong> parameter. <br>
+          </li>
+          <li>Param &quot;UserDefinedColour&quot; - specify your own colours for each residue using a semi colon 
+            separated list. Multiple residues can be assigned the same colour 
+            using commas. eg:<br>
+            <pre>&lt;param name=&quot;userDefinedColour&quot; 
+            value=&quot;D,E=red; K,R,H=0022FF; C=yellow&quot;&gt;</pre>
+          </li>
+          <li>Param &quot;showFeatureSettings&quot;
+            - this will display the feature settings window when the applet starts.
+          </li>
+          <li>Param &quot;Application_URL&quot; value=&quot;http://www.jalview.org/services/launchApp&quot;<br/>
+            This calls a servlet which creates a JNLP file with the alignment 
+            file, annotations file and features file of the applet as arguments. 
+            If the user has Java installed, the returned JNLP file should start 
+            up the full Jalview Application. BUT this does not currently work 
+            for alignment files added to the applet in a zip file.
+            <br/>Look at the XML comments in the file downloaded from <a href="http://www.jalview.org/services/launchApp">The LaunchApp page</a> for full documentation.
+          </li>
+          <li>Alignment file can be a series of parameters using eg PFAM format 
+            <br>
+            <pre>&lt;param name=&quot;sequence1&quot; 
+            value=&quot;Q93XJ9_SOLTU/11-26 TSFLPRKPVVTSLKAI&quot;&gt;<br>
+            &lt;param name=&quot;sequence2&quot; value=&quot;FER1_PEA/14-29 TSFLRTQPMPMSVTTT&quot;&gt;<br>
+            </pre>(All the usual Jalview File formats are valid, however each 
+            new line in an alignment file must be entered as a parameter)</li>
+        </ul>
+<!-- content end -->
index 1e45aae..433f5a9 100644 (file)
@@ -357,133 +357,4 @@ the applet can be interacted with <em>via</em> its
           <td>Multiple sequences aligment scores file. Currently is supported only the T-Coffee score_ascii file format</td>
           </tr>
                   </table>
-                  <p><h2><a name="appletdeploymentnotes"/>Notes on applet deployment</h2><br/>
-        <ul>
-          <li>Package all your data files into a single (or multiple) zip / jar 
-            files. This is very useful to reduce download time of large data files. 
-            The applet archive tag can take multiple entries separated by commas, 
-            eg<br>
-            <pre>&lt;applet code=&quot;jalview.bin.JalviewLite&quot;<em><strong> 
-            archive=&quot;jalviewApplet.jar, mydata.zip&quot;</strong></em>&gt;<br>
-            </pre></li>
-          <li> Use Jalview for input to a HTML form. For an example of how to 
-            code this using Javascript, click <a href="javascript:doSubmit('formComplete')">here</a>. 
-            <br>
-          </li>
-          <li>Embed Jalview into the web page, without the &quot;Start Jalview&quot; 
-            button by setting the embed parameter to true;<br>
-            &lt;param name=&quot;embedded&quot;
-          value=&quot;true&quot;&gt; </li>
-        </ul>
-        
-        <p><strong>**NEW FEATURES** in Jalview 2.9</strong></p> 
-        <ul>
-        <li>Split Views for cDNA and Protein alignments<br/>Specify second alignment with 'file2' parameter, and set cDNA/Protein column scaling with scaleProteinAsCdna
-        </li>
-        </ul>
-        </p>
-        <p><strong>**NEW FEATURES** in Jalview 2.8</strong></p> 
-        <ul>
-        <li>Normalised sequence logo display
-        </li>
-        <li>RNA secondary structure annotation row
-        </li>
-<li>Jmol compatibility updated to Jmol 12.2.x series - <a href="JmolApplet-12.2.4.jar">download the JmolApplet here</a></li>
-<li>To use Jmol as the structure viewer for Jalview, you must include 
-            the jar file in the applet archive argument thus:<br>
-            <pre>archive=&quot;jalviewApplet.jar,Jmol-12.2.4.jar&quot;</pre>
-          </li>
-          <li>Jmol 12.2.x requires at least Java 1.6 to run in the clients web browser. If the client does not have 
-            Java 1.6, or if the Jmol-12.2.jar is not added to the archive, the 
-            original Jalview structure viewer will still be available. <br>
-          </li>
-          
-        </ul>
-        <p><strong>**NEW FEATURES** in Jalview 2.7</strong></p>
-        <ul>
-        <li>Javascript callbacks capabilities<ul><li>oninit parameter and methods for registering javascript handlers for selections, mouseovers and linking to Jmol applets on the page.</li>
-        <li>To use javascript callbacks, ensure the applet tag includes the '<a href="http://download.oracle.com/javase/6/docs/technotes/guides/plugin/developer_guide/java_js.html">mayscript</a>' attribute - either as a parameter (&lt;param name="mayscript" value="true"/;gt;) or as a bare attribute in the applet html tag).</li></ul>
-        </li>
-        <li>New <a href="javascript:doSubmit('jalviewLiteJs')">jalviewLite java api</a> methods for selecting, highlighting, scrolling and reordering sequences in an alignment view.
-        </li></ul>
-        <p><strong>**NEW FEATURES** in Jalview 2.6</strong></p>
-        <ul>
-        <li>Jmol compatibility updated to Jmol 12.1.x series</li>
-          <li>Jalview 2.6 works only with Jmol version 12.1.13 or later. You can use the JmolApplet.jar from 
-          the Jmol binary distribution available at the Jmol Sourceforge site, 
-          or <a href="JmolApplet-12.1.13.jar">download the Jmol applet from here</a></li>
-          <li>Minimum recommended version of Java runtime for the applet is now 1.5 (JalviewLite v2.6 without the Jmol viewer may work ok on earlier Java environments but compatibility can no-longer be guaranteed).</li>
-  </ul>
-        <br><strong>**NEW FEATURES** in Jalview 2.5</strong></p>
-        <ul>
-        <li>New parameters to control display of tree annotation, width of alignment columns, and to disable the jalview button and check for Jmol on startup.</li>
-  </ul>        
-        <br><strong>**NEW FEATURES** in Jalview 2.4</strong></p>
-        <ul>
-        <li>New applet API methods for feature display control, views, and obtaining current selection via javascript.</li>
-          <li>Group show and hide parameters:
-        &quot;showfeaturegroups&quot; and
-        &quot;hidefeaturegroups&quot;. Both take a list
-        of feature group names (separarated by &quot;|&quot; by default) to hide or show on the displayed
-        alignment.
-        </li>
-        <li>Regular expressions can be used in URL links for sequence IDs.</li>
-        <li>&quot;debug&quot; parameter to control verbosity of the applet's console output.</li>
-        <li>&quot;showbutton&quot; parameter to disable launch button and open JalviewLite immediatly.</li>
-        <li>&quot;nojmol&quot; parameter to disable check for Jmol classes.</li>
-        </ul><br>
-        <strong>**NEW FEATURES** in Jalview 2.3</strong></p>
-        <ul>
-          <li>Note that Parameter &quot;PDBFile&quot; now takes 
-            the PDB file followed by a space separated list of alignment sequence 
-            ids to associate the structure to. It is also possible to associate 
-            multiple PDB files by adding an incremental value to PDBFile (up to 
-            10). It is also possible to map specific sequences to specific chains 
-            by using the following notation:<br>
-            <br>
-            <pre>
-            &lt;param name=&quot;PDBFile&quot; value=&quot;First.pdb SeqA SeqB 
-            SeqC&quot;&gt;<br>
-            &lt;param name=&quot;PDBFile2&quot; value=&quot;Second.pdb 
-            A=SeqA B=SeqB C=SeqC&quot;&gt;<br>
-            &lt;param name=&quot;PDBFile3&quot; value=&quot;Third.pdb 
-            D=SeqX B=SeqY C=SeqZ&quot;&gt;<br>
-            </pre>
-          </li>
-          <li>Note parameter &quot;PDBSeq&quot; is no longer required.<br>
-          </li>
-          <li>Jalview 2.3 was updated to work with Jmol 11. See the <a href="/development">versions archive if you want to download the old Jmol applet</a>.</li> 
-            <p>&nbsp;</p>
-          </li>
-        </ul>
-        <strong>**NEW FEATURES** in Jalview 2.1</strong> 
-        <ul>
-          <li>Jalview Applet can read and display JNet secondary structure annotation 
-            directly via the <strong>jnetfile</strong> parameter. <br>
-          </li>
-          <li>Param &quot;UserDefinedColour&quot; - specify your own colours for each residue using a semi colon 
-            separated list. Multiple residues can be assigned the same colour 
-            using commas. eg:<br>
-            <pre>&lt;param name=&quot;userDefinedColour&quot; 
-            value=&quot;D,E=red; K,R,H=0022FF; C=yellow&quot;&gt;</pre>
-          </li>
-          <li>Param &quot;showFeatureSettings&quot;
-            - this will display the feature settings window when the applet starts.
-          </li>
-          <li>Param &quot;Application_URL&quot; value=&quot;http://www.jalview.org/services/launchApp&quot;<br/>
-            This calls a servlet which creates a JNLP file with the alignment 
-            file, annotations file and features file of the applet as arguments. 
-            If the user has Java installed, the returned JNLP file should start 
-            up the full Jalview Application. BUT this does not currently work 
-            for alignment files added to the applet in a zip file.
-            <br/>Look at the XML comments in the file downloaded from <a href="http://www.jalview.org/services/launchApp">The LaunchApp page</a> for full documentation.
-          </li>
-          <li>Alignment file can be a series of parameters using eg PFAM format 
-            <br>
-            <pre>&lt;param name=&quot;sequence1&quot; 
-            value=&quot;Q93XJ9_SOLTU/11-26 TSFLPRKPVVTSLKAI&quot;&gt;<br>
-            &lt;param name=&quot;sequence2&quot; value=&quot;FER1_PEA/14-29 TSFLRTQPMPMSVTTT&quot;&gt;<br>
-            </pre>(All the usual Jalview File formats are valid, however each 
-            new line in an alignment file must be entered as a parameter)</li>
-        </ul>
-<!-- content end -->
+                  <!-- content end -->
index 426e275..aa67325 100644 (file)
@@ -42,7 +42,7 @@
   </ul>
   <applet
    code="jalview.bin.JalviewLite" width="756" height="560"
-   archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar">
+   archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar,java-json.jar,json_simple-1.1.jar">
 <param name="permissions" value="sandbox"/>
 <param name="file" value="plantfdx.fa"/>
 <param name="features" value="plantfdx.features"/>
index e9bf475..f629312 100644 (file)
@@ -222,7 +222,7 @@ jmolInitialize("","JmolApplet-14.2.14_2015.06.11.jar");
  var _jvA=new Object();
  _jvA.attributes = {
   code : 'jalview.bin.JalviewLite',
-  archive : 'jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar',
+  archive : 'jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar,java-json.jar,json_simple-1.1.jar',
   width : '500',
   height : '350',
   mayscript : 'True',
@@ -279,7 +279,7 @@ jmolInitialize("","JmolApplet-14.2.14_2015.06.11.jar");
 </div>
 <div>
 <applet
-   code="jalview.bin.JalviewLite" width="500" height="350" id="jvA" mayscript="mayscript" archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar">
+   code="jalview.bin.JalviewLite" width="500" height="350" id="jvA" mayscript="mayscript" archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar,java-json.jar,json_simple-1.1.jar">
 <param name="permissions" value="sandbox"/>
 <param name="java_arguments" value="-Xmx256m"/>
 <param name="externalstructureviewer" value="true"/>
index efd02f8..91d94f8 100644 (file)
@@ -38,7 +38,7 @@ instance on the page.</p>
 View the source in your browser to see how it has been done. <br/>
 <a name="api">View the full <a href="javascript:doSubmit('jalviewLiteJs')">JalviewLite API documentation</a>.</a>
 <applet code="jalview.bin.JalviewLite" width="0" height="0"
-       archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar" name="Jalview">
+       archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar,java-json.jar,json_simple-1.1.jar" name="Jalview">
   
   <param name="file" value="plantfdx.fa"/>
   <param name="features" value="plantfdx.features"/>
index f338ccb..a4527eb 100644 (file)
@@ -24,6 +24,9 @@
                <li id="jalviewLiteJs" class="leaf menu-mlid-1002">
                <a id="jalviewLiteJs" href="javascript:doSubmit('jalviewLiteJs')" class=" ">Javascript API</a></li>
 
+               <li id="appletDeployment" class="leaf menu-mlid-1003">
+               <a id="appletDeployment" href="javascript:doSubmit('appletDeployment')" class=" ">Applet Deployment</a></li>
+
                <li id="appletParameters" class="leaf menu-mlid-1003">
                <a id="appletParameters" href="javascript:doSubmit('appletParameters')" class=" ">Applet Parameters</a></li>
 
index 98278e2..e161ad6 100644 (file)
@@ -115,7 +115,7 @@ function startJalview(aligURL,title,alwvar) {
 </SCRIPT>
   <form name="Form1">
 <applet name="JalviewLite"  code="jalview.bin.JalviewLite"
-archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar" width="0" height="0">
+archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar,java-json.jar,json_simple-1.1.jar" width="0" height="0">
 <param name="debug" value="true"/>
 <param name="showbutton" value="false"/>
 </applet>
index ccbbf9a..0449c0b 100644 (file)
@@ -40,7 +40,7 @@
 
 
 <applet
-   code="jalview.bin.JalviewLite" width="800" height="300" id="jvapp" mayscript="True" scriptable="True" archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar">
+   code="jalview.bin.JalviewLite" width="800" height="300" id="jvapp" mayscript="True" scriptable="True" archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar,java-json.jar,json_simple-1.1.jar">
 <param name="oninit" value="lJvApp"/>
 <param name="automaticScrolling" value="true"/>
 <param name="file" value="plantfdx.fa"/>
@@ -63,7 +63,7 @@
 
 
 <applet
-   code="jalview.bin.JalviewLite" width="800" height="300" id="jvfollower" mayscript="True" scriptable="True" archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar">
+   code="jalview.bin.JalviewLite" width="800" height="300" id="jvfollower" mayscript="True" scriptable="True" archive="jalviewApplet.jar,JmolApplet-14.2.14_2015.06.11.jar,java-json.jar,json_simple-1.1.jar">
 <param name="oninit" value="lJvFollow"/>
 <param name="file" value="plantfdx.fa"/>
 <param name="annotations" value="plantfdx.annotations"/>