This feature allows a teacher to create interactive tutorials and exercises for their students. A tutorial consists of a number of HTML pages and Geneious documents. The student edits the pages and documents to answer the tutorial questions, and then exports the tutorial to submit for marking.
Creating a tutorial
Geneious Tutorials are comprised of HTML documents with linked images and geneious files. Simply create your html documents, and place them together in a folder. The first page of the tutorial should be called "index.html", and this will be loaded as the main page. Geneious will follow all hyperlinks between the pages, and external hyperlinks (beginning with
http://) will be opened in the user's browser. If you want to include figures and diagrams in the pages, just put the image files in the same folder and reference them with
<img> tags like a normal HTML document (supported image formats are GIF, JPG, and PNG).
If you want to include Geneious documents in your tutorial, simply place them in the same folder as the html documents and they will automatically be imported into Geneious with the tutorial. If you want to link to them from the tutorial pages, create a hyperlink pointing to the file in the HTML document. For example, to create a link to the file sequence.fasta in your tutorial folder, use the HTML
<a href="sequence.fasta">click here</a>. To open more than one document from a link, separate the filenames with the pipe (|) character, for example
<a href="sequence.fasta|sequence2.fasta">click here</a>.
You can add a short one-line summary by writing your summary in a file called "summary.txt" (case sensitive) and putting it in the tutorial folder. Make sure that the entire summary is on the first line of the file, as all other lines will be ignored.
Once you have all your files together, put the contents of the folder in a zip file. In order to be recognised as a tutorial, the extension of the zipped file must be either .tutorial.zip or .geneiousTutorial. Subfolders within the zip file are supported in Geneious R8 and higher.
To import the tutorial into Geneious, use File → Import → From file, or drag it in. The tutorial document and any associated geneious documents will be imported into the currently selected folder. The tutorial itself will be displayed in the help pane on the right hand side of the Geneious window. If you accidentally close the help pane, you can display it by choosing Help from the Help menu.
Answering a tutorial
If the tutorial requires you to enter answers, click the edit button at the top of the tutorial window and type your answer in to the space provided. Click the Save button when you are done.
If the tutorial has a link to a Geneious document, when you click the link the document will be opened in the document viewer. Any changes you make to this document will be preserved when you export the tutorial.
When you have finished the tutorial, export it by selecting the tutorial document and choosing File → Export → Selected Documents from the main menu. Make sure that Geneious Tutorial File is selected as the filetype, and then give it a name and click Export.