Authoring Tool Documentation

What is the Authoring Tool

please refer to Authoring_Tool

What tools does the Authoring Tool application provide

• test box
• intervention
• image
• button
• logic
• explore

What functions are avalibale

• properties
• backward and forward

Interface (what they are and what they do?)

• top section menu bars:
  • text menu:
  • icon menu:
• mid section:
  • mid-left: projects and their files
  • mid-top: page tags
  • mid-certer: the editing area
  • mid-button: editing tools
  • mid-right: properties
• botton menu bar:
  • tags:
    • page...
    • error messages
  • problems:

How to get started

To make use of this Authoring Tool, you need to install the program to your PC first

install the system

• download the application to your computer
• unzip it if it is a zip file
• run the file called "runme.bat". You don't need to choose any options, it will pop up and go away before you can do anything.

run the application for the first time

• run the executable file called "LifeGuide Author.exe".
• a dialog box will pop up to ask you where you would like to save your work. The default folder is called "workspace", it will be placeed under the same folder as the executable file. alternatively, you can choose another location by click the "browse" button.
• once you have chosen the location for saving your work, a dialog box will pop up to ask you to name the new project - just give it a name and click "OK"
• you will now be entered to the working area of the Authoring Tool system.

Using the tool

Create a new project

• click on the “New project” button (or alternatively select the same option from the File menu)
• a pop up box will ask you to name the project, you neeed to give it an unique name from all the existing projects, and click "finish"
• to make use of the tool, you need to have a page open for editing

Create a new page

• if start with a new project, you need to create a project as mentioned above first
• if start with an existing project, you need to select the required project by click on the project name that is displayed on the left hand session, then
• click on the “New Web Page” button (or alternatively select the same option from the File menu)
• a pop up box will ask you to name the page, you neeed to give it an unique name from all the existing pages within the project, and click "finish". you should now have a bland new page open in the mid section of the Authoring Tool.

Open an existing page

• click on the page name that is displayed under the project, you should now have the selected page open in the mid section of the Authoring Tool.

Create a text box, a intervention, a button, or insert an image

• common features of these four tool buttons
  • click on the required button at the bottom of the page author, a newly created object will be displayed on the top left hand side of the mid section (the editing area).
  • you can move it to the area where it is required by clicking and draging.
  • You can resize it by dragging the resize handles on its corners and sides.

• individual features
  • to edit the text of a text box: - there are two ways
    • a) typing the text with HTML format in the .......box
    • b) alternatively, click on the "....." button to edit the text without HTML format in a pop up box that is similar to MS word.
  • to edit the questions of an intervention
  • to edit an button

• change the style of a page, a text box, or an intervention:
  • select the target that you want to change the style for, e.g. click on a text area to select the text box, or click on the page background to select the page,
  • in its right hand side property section, uncheck the checkbox saying ‘Use global style’ underneath the heading ‘Style Properties’.
  • you will be presented with many options,
    • Bold, italic, underlined: check the corresponding checkboxes
    • font: click on the ....., select a required one from the list
    • text size: click on the ....., select a required one from the list

Copy a page

• Open the page that you want to copy
• Click on “Save as” in the “File” menu
• Enter or select the project name for the file that you want to put into
• Name it unquitly within the project folder
• Click “OK”

Copy a project

• Click on “Import Project” in the “File” menu
• Use the “browse” button to select your project
• Check the “copy projects into workspace” box
• Click “Finish”

Delete a page

• Select the page by click on the file name in the “Project Explorer” area
• Click “Delete” key
• click “Yes” to confirm

Delete a project

• Select the project by click on the name in the “Project Explorer”
• Click “Delete” key
• Select a delete option from the pop up box, then click “Yes”

FAQ

Do all the assessment questions have to be coded using the interface tools?

The short answer is yes, all the assessment questions need to be coded using the interface tools.

It is possible to read questions from a database, but this is beyond the scope of the current project. This is one of the features we will need for the next proposal but not this one.

Creating questions through the Lifeguide interface has its advantage, it helps people produce questions to the correct standard.

The interface of the workshop demo has very few options. What else can the tool offer?

The workshop handout was just to introduce people in a 45 minute workshop to how to create questions, pages and logic - this is why there is such a simple example! It is only there to give you a basic idea of what is like to create an intervention using the Authoring Tool.

The tool has lots more to offer and more functions are developing. I think one of the ways to explain this is our online demos that we presented during the workshop. Please follow the links below, and play around with the selecting options, hopefully it will give you a better idea of what the tool can offer at the current stage. Alcohol Calculator: http://beta.lifeguideonline.org/player/play/acohol LifeGuide Internet Doctor: http://beta.lifeguideonline.org/player/play/doctor

There is an error message poped up, suggest to check the .log file. Where is this .log file? What can I do with it?

The location of the .log file may varied depends on the error. Usually, it will be shown on the error message. If there is not, try to look for it in the folder where the “LifeGuide Authoe.exe” file is, or try under the configuration folder. The file name will looks something like this: 1231330817922.log The .log file would help to identify the problem. If you don't understand it, or can't fix it, you can send it to the Authoring Tool suport team.