<html>
<h2>BioJS MSA Viewer</h2>
-Since Jalview 2.9, BioJS MSA HTML files can be generated from alignment within the Jalview desktop application. BioJS MSA Viewer is a JavaScript based multiple sequence alignment visualisation system. Jalview generates BioJS HTML files by parsing a BioJS MSA export template file and embedding BioJSON data from a given alignment on the Jalview desktop application.
+Since Jalview 2.9, BioJS MSA HTML files can be generated from an alignment within the Jalview desktop application. BioJS MSA Viewer is a JavaScript based multiple sequence alignment visualisation system. Jalview generates BioJS HTML files by parsing a BioJS MSA export template file and embedding BioJSON data from a given alignment on the Jalview desktop application.
<p>To ensure that the BioJS MSA export mechanism is easily extensible, the export templates are externalised from the Jalview codebase. Consequently, new versions of BioJS MSA Viewer can easily be integrated into Jalview without having to deploy a new version of Jalview.</p>
<h2>What constitutes a BioJS MSA Template</h2>
<ul>
-<li>All JavaScripts necessary to visualise BioJS</li>
+<li>All JavaScripts necessary to render and visualise BioJS data</li>
<li>JavaScripts to transform BioJSON data to BioJS MSA data </li>
-<li>And a place holder for BioJSON data (a div or input element as show below):
- <ul>
- <li><pre><code><div name="seqData" id="seqData" style="display: none;">#valid BioJSON data#</div> OR</pre></code></li>
- <li><pre><code><input type="hidden" id="seqData" name="seqData" value='#valid BioJSON data#'/></pre></code></li>
- </ul>
-</li></ul>
+<li>Place holder for BioJSON data (this can be a div or input element as show below):
+<pre><code><div name="seqData" id="seqData" style="display: none;">#valid BioJSON data#</div> OR
+<input type="hidden" id="seqData" name="seqData" value='#valid BioJSON data#'/>
+</code></pre></li></ul>
-
-
-
-The externalised BioJS MSA templates are available in the github repository <a href="https://github.com/jalview/exporter-templates/tree/master/biojs">https://github.com/jalview/exporter-templates/tree/master/biojs</a>.
-</br>Jalview looks at the <b>package.json</b> file at <a href="https://github.com/jalview/exporter-templates/blob/master/biojs/package.json">https://github.com/jalview/exporter-templates/blob/master/biojs/package.json</a> to work out the available versions of BioJS MSA Viewer templates and the latest release version to use for its exports.
+The externalised BioJS MSA templates are available in the Github repository <a href="https://github.com/jalview/exporter-templates/tree/master/biojs">https://github.com/jalview/exporter-templates/tree/master/biojs</a>.
+<br/>Jalview processes the <b>package.json</b> file at <a href="https://github.com/jalview/exporter-templates/blob/master/biojs/package.json">https://github.com/jalview/exporter-templates/blob/master/biojs/package.json</a> to work out the available versions of BioJS MSA Viewer templates and the latest release version to use for its exports.
<h2>Creating/Updating a new BioJS MSA Template</h2>
-The following steps can be taken to create a new BioJS MSA template
+The following steps can be taken to create or update a BioJS MSA template
<ol>
<li>Add/update all BioJS MSA scripts to the template file</li>
-<li>Update codes for transforming BioJSON data to BioJS MSA data (this requires knowledge of both data models)</li>
-<li>Ensure that the new template created can be employed by Jalivew to generate valid BioJS MSA files. This can be achieved by following the steps below to deploy the new export template to a test repo and subsequently configure jalview to use the test repo for testing the template:</li>
- <ul>
- <li>Publish the template and an equivalent <b>VALID</b> package.json file to a live URL</li>
- <li>Configure Jalview preferences to point to the raw url of package.json in your test repository. This is done by creating/changing the property <b>'biojs_template_git_repo'</b> in <b>jalview_properties</b> file </br>e.g.
- biojs_template_git_repo="https://raw.githubusercontent.com/gituser/biojs-templates/package.json</li>
- <li>Restart Jalview and ensure that the test templates are downloaded</li>
+<li>Add/update codes for transforming BioJSON data to BioJS MSA data (this requires knowledge of both data models)</li>
+<li>Ensure that the new template created can be employed by Jalview to generate valid BioJS MSA files. This can be achieved by following the steps below to deploy the new export template to a test repository and subsequently configure Jalview to use the test repository for testing the template:
+ <ol type="i">
+ <li>Publish the template along with a valid package.json file to an online repository</li>
+ <li>Configure Jalview preferences to point to the raw URL of package.json in your test repository. This is done by creating/changing the property <b>'biojs_template_git_repo'</b> in the <b>jalview_properties</b> file <br/>e.g.
+ <b>biojs_template_git_repo=https://raw.githubusercontent.com/gituser/biojs-templates/package.json</b></li>
+ <li>Restart Jalview and ensure that the new templates are downloaded</li>
<li>Export an alignment to BioJS MSA</li>
<li>Check that the exported file is valid and reflects all the incorporated changes</li>
- </ul>
-<li>Commit the new template to the official Jalview-BioJS github template repository <a href="https://github.com/jalview/exporter-templates/tree/master/biojs">https://github.com/jalview/exporter-templates/tree/master/biojs</a></li>
-<li>Update the package.json of the official template repo at <a href="https://github.com/jalview/exporter-templates/blob/master/biojs/package.json">https://github.com/jalview/exporter-templates/blob/master/biojs/package.json</a> accordingly</li>
-<li>Restore value for <b>'biojs_template_git_repo'</b> in jalview_properties to point to the official template repo</li>
-<li>Restart Jalview</li>
+ </ol>
+</li>
+<li>Commit the new template to the official Jalview-BioJS Github template repository <a href="https://github.com/jalview/exporter-templates/tree/master/biojs">https://github.com/jalview/exporter-templates/tree/master/biojs</a></li>
+<li>Update the package.json of the official template repository at <a href="https://github.com/jalview/exporter-templates/blob/master/biojs/package.json">https://github.com/jalview/exporter-templates/blob/master/biojs/package.json</a> accordingly</li>
+<li>Restore value for <b>'biojs_template_git_repo'</b> in jalview_properties to point to the official template repository</li>
+<li>Repeat steps 4iii to 4v above</li>
</ol>
<b>Note: </b>
-Whenever Jalview starts up, if internet connection is available, it checks if there are new updates of BioJS MSA template added to the repository and downloads them to a local user directory for subsequent offline use.
+When Jalview starts up, provided that there is an internet connection, Jalview checks if there are new updates of BioJS MSA template added to the repository and downloads them to a local user directory for subsequent offline use.
</html>
git://source.jalview.org / jalview.git / commitdiff