restructured docs

docs/guide/install.rst

@@ -0,0 +1,9 @@
+
+Installation
+=============
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   install/tripal_jbrowse

docs/guide/install/dependencies.rst

@@ -0,0 +1,7 @@
+Dependencies
+============
+
+Please ensure that the following are installed on your server:
+
+- `JBrowse <http://gmod.org/wiki/JBrowse_Configuration_Guide>`_.
+- `Tripal <http://tripal.info>`_

docs/guide/install/instance_page.rst

@@ -0,0 +1,39 @@
+
+JBrowse Page Integration
+========================
+
+This guide will show you **how to create a page within your Tripal site for an existing JBrowse instance**. This ensures a *consistent user experience* by making the menu system of the Tripal site available to the user while browsing. If the user needs more space they can choose the *FullScreen option* to remove the menus.
+
+.. warning::
+
+   This requires you already have a JBrowse instance. Both local (hosted on the same machine as your Tripal site) or external JBrowse instances are supported.
+
+.. note::
+
+   The Tripal JBrowse Management sub-module provides a user interface to ease setup of multiple JBrowse instances. It is a great option but is not required.
+
+You create a JBrowse Instance page by navigating to **Content > Add Content > JBrowse Instance** on the Administration Toolbar. Then just fill out the form and click save!
+
+.. image:: ../../assets/instancepage.1.addcontent.png
+
+.. image:: ../../assets/instancepage.2.addinstance.png
+
+The **title** will become the title of the page and the **description** will be shown above the JBrowse instances. The description is a good place to add any warnings or instructions.
+
+.. image:: ../../assets/instancepage.3.createtop.png
+
+The **Existing JBrowse URL** is the URL to the JBrowse instance you want to embed. You should be able to put this URL into your browser and access the JBrowse instance directly, even in the case of local instances.
+
+The **Start Locations** allows you to specify where you want the JBrowse to navigate to for first time users. Keep in mind that JBrowse caches user location and thus all subsequent times a user accesses the instance it will start at their last browsed location.
+
+.. image:: ../../assets/instancepage.4.createbottom.png
+
+The **Tracks** allows you to set which tracks you want shown by default. You should enter the machine name of the tracks here with multiple tracks separated by comma's.
+
+.. note::
+
+    Depending on how your Drupal site is configured, you may be presented with a **Preview** button instead of a **Save** button. In this case, simply click Preview and then on the next page, click Save.
+
+    The preview for the JBrowse may not load properly. Do not be concerned as this is not an indication that you have incorrectly configured the page.
+
+    To disable the preview button, navigate to Structure > Content Types > JBrowse Instance > edit and set the "Submission for settings" > "Preview before submitting" to "Disabled".

docs/guide/install/jbrowse_mgmt/configuration.rst

@@ -0,0 +1,8 @@
+Tripal JBrowse Configuration
+==============================
+
+In order for the module to function properly, you need to first configure it.
+Please visit ``http://YOUR_SITE/admin/tripal_jbrowse/configure`` (replace YOUR_SITE with your domain)
+and fill out the form. You will need to know information about your JBrowse information.
+
+.. image:: ../../assets/settings_page.png

docs/guide/install/jbrowse_mgmt/install.rst

@@ -0,0 +1,14 @@
+Tripal JBrowse Installation
+============================
+
+This module is available for download from github.com/tripal/tripal_jbrowse.
+
+1. Download and upack the module into ``[DRUPAL ROOT]/sites/all/modules`` where ``DRUPAL_ROOT`` is the path to your Drupal site.
+2. Navigate to ``https://yourdrupalsite.com/admin/modules`` or click **Administration Toolbar > Modules**
+3. Scroll to **Tripal Extensions**, click the checkbox beside "Tripal JBrowse Integration", and click the "Save Configuration" button at the bottom of the page.
+
+.. image:: ../../assets/tripal_jbrowse.1.install.png
+
+.. note::
+
+   This module is dependent upon the **Link** module. It is not mentioned above in the install instructions since you should already have installed it when installing Tripal.

docs/guide/install/management.rst

@@ -0,0 +1,8 @@
+Tripal JBrowse Management
+=============
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   jbrowse_mgmt

docs/guide/installation.rst

@@ -1,28 +0,0 @@
-Installation and Configuration
-==============================
-
-Dependencies
-------------
-
-Please ensure that the following are installed on your server:
-
-- `JBrowse <http://gmod.org/wiki/JBrowse_Configuration_Guide>`_.
-- `Tripal <http://tripal.info>`_
-
-
-Installation
-------------
-
-- Download the module to your Drupal modules folder
-- Run ``drush en -y tripal_jbrowse`` or enable through the modules page
-- Visit the configuration page at ``/admin/tripal_jbrowse/configure``
-
-
-Configuring Tripal JBrowse
---------------------------
-
-In order for the module to function properly, you need to first configure it.
-Please visit ``http://YOUR_SITE/admin/tripal_jbrowse/configure`` (replace YOUR_SITE with your domain)
-and fill out the form. You will need to know information about your JBrowse information.
-
-.. image:: ../assets/settings_page.png

docs/guide/instances.rst → docs/guide/jbrowse_management/instances.rst

@@ -6,7 +6,7 @@ Listing and Creating Instances
 
 To list all instances, visit ``/admin/tripal_jbrowse``.
 
-.. image:: ../assets/instances.png
+.. image:: ../../assets/instances.png
 
 
 Creating Instances

docs/guide/tracks.rst → docs/guide/jbrowse_management/tracks.rst

@@ -6,11 +6,11 @@ Creating and Deleting Tracks
 
 To create a new track, you need visit the instances list page and click Manage Tracks.
 
-.. image:: ../assets/manage_tracks.png
+.. image:: ../../assets/manage_tracks.png
 
 The manage tracks link, will lead to a page where you can create and delete tracks (see screenshot below).
 
-.. image:: ../assets/tracks_list.png
+.. image:: ../../assets/tracks_list.png
 
 .. warning::
     Please note that files don't get automatically removed. You have to manually remove the track files yourself.

docs/index.rst

@@ -17,6 +17,5 @@ This package of modules integrates `GMOD JBrowse <https://jbrowse.org/>`_ into y
 .. toctree::
     :maxdepth: 2
 
-    guide/installation
-    guide/instances
-    guide/tracks
+    guide/install
+    guide/jbrowse_mgmt

docs/tripal_jbrowse.rst

@@ -0,0 +1,13 @@
+
+Tripal JBrowse Page Integration
+================================
+
+.. note::
+
+   The following functionality is provided by the **Tripal JBrowse Integration** sub-module.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Functionality:
+
+   tripal_jbrowse/instance_page