Poet Help

Registering and Signing In to Poet

Step Process What you see
1. Open your Internet browser and go to the URL provided for Poet, or click on the Poet link.
If you are a new user, proceed to Step 2; if you are a returning user skip to Step 3.

2. Register on the Poet Image Description tool by clicking the Register link in the upper right corner of the screen. 

The Sign up screen appears. All the fields with asterisks * are required.  Fill in First Name, Last Name, User Name, and your email address. 

Select one or more categories in Subject Matter Expertise. Add additional expertise in the Other Expertise field.

Select one of the libraries from the list, or if you are creating a new library then check the "Click to create a new library", and provide the name of new library in New Library field.

In the password field enter a password of at least 6 characters. Repeat the same password in the Password Confirmation field.
Once you are finished entering all the information click the Sign up button.
You are returned to the home page and a confirmation message is displayed if the registration is successful.  If unsuccessful, an error message will indicate the corrective action to take.

3. Sign in to Poet by clicking the Sign In link in the upper right corner of the screen. The Sign in screen appears. Fill in your username and password, then click the Sign in button.
You are returned to the home page and a confirmation message is displayed if the sign in is successful. If unsuccessful, an error message will indicate the corrective action to take.

Uploading a DAISY Book to the Poet Server

Step Process What you see
1. After signing in, you are at the home page. The Poet Welcome page:

2. Unless you have been assigned a book already uploaded into Poet, you must upload your DAISY file to the server.
Click the Upload link on the Home page to access the DAISY Book Upload page.
Note: To do this, your DAISY book must have been previously downloaded to your computer from your digital book library.
To select your DAISY file, click on the Browse (or Choose file) button.
The DAISY Book Upload page:


3. A file selection dialog box will open showing your computer's file structure.
Locate and select your DAISY file, then click Open. You are returned to the DAISY Book Upload page with the file name populated.
If the file is password protected, enter it in the password field.
File Upload dialog box (Mac appearance):

4. Click the Upload button on the DAISY Book Upload page.
This will upload your DAISY file to the server. You may need to allow up to 15 minutes for the upload process to complete, depending on the size of the book and the number of images it contains.
Note: Be sure to record the book ID number presented in the confirmation message (the book ID number is a variation of the book's ISBN).
Click the Home link to return to the Poet home page.
A confirmation message and unique book ID code are presented:

My Books

Step Process What you see
1. All the books uploaded by a user appear in the My Books section. A user has complete access to only the books they have uploaded. Users may add and/or edit descriptions, update the status of descriptions, and delete their own books. The Books that are uploaded by a user show up here:

2 You can mark all the images in a single book as essential by clicking Mark All Essential
Once descriptions are complete, you can approve all descriptions in a single book by clicking on Approve Image Description.
You can delete a title by clicking on Delete

Clicking on UID of a title will generate an image description check and report. 
Clicking on the book title link will open it in the description pane, where you can describe individual images.

Tagging Images for Description 

Step Process What you see
1. To add or edit image descriptions in a DAISY file, click the Edit link on the Poet home page. On the next page, enter the ID (from Step 4 above) of the book you wish to work on the in the Book ID field and click the Edit button.
The book will open in Poet with a navigation frame (images only) on the left, and a reading/editing frame (with images and their surrounding text) on the right.
Note: If a description already exists for an image, it will appear in the Previous Description box just beneath the image. New (and revised) descriptions are entered in the lower New Description box.
The Poet image description interface:

2. Each book contains images that need different types of descriptions. You will need to determine which images are relevant to the educational experience of your student(s).  Some images may not enhance the learning experience and can be skipped (and tagged as non-essential).  Some images may be redundant to the text or existing captions, they may be duplicate images, or they may not be vital to the content.
Note: To understand which images should be described and learn about creating effective image descriptions, click the Information icon (blue circle with the letter "i") at the top of the navigation frame.
Follow the links in the Image Description Guidelines to obtain the information you need.
Image Description Guidelines :

3 Books are presented in Parts for ease of use.  Each Part contains about 200 images.  Begin by selecting the Part you wish to describe.  A second drop down menu at the top of the image navigation pane allows you to filter and view images in the following categories:  All images, only essential, only non-essential, description needed and unspecified. Images matching the filtering criteria. Note: the filter only applies to the images in the navigation frame. All images are still visible in the editing frame. 
4. Beneath each image in the navigation frame is a drop down menu which allows you to tag images.  To indicate that an image doesn't need describing, select "No" from the "Should be described". If an image should be described, select "Yes;" if uncertain, select "Unspecified."
Your selections are saved as they are made. To change a selection, merely choose another option from the drop down list and it will become the current choice.

Creating a new or editing an existing image description

Step Process What you see
1. Note: This instruction assumes you already have a book open in Poet for image describing. If not, click the Edit link from the Poet home page, enter the book ID and click the Edit button.
In order to focus on only those images requiring description, select the "Description Needed" from the filter drop down box at the heading of the left navigation frame.
An image of Poet's description screen. On the left you can see a panel to filter images by various methods, on the right side you can see the content of the title (text with images.)
 



2 Only the images designated as "Should be described," will now appear in the left navigation frame. 
Select an image to describe by clicking on that image in the left navigation frame. Poet will scroll to that image in the reading/editing area in the right frame.  The opposite screenshot shows an image with no previous description.  Click on Add Description button to start describing this image.
The screen shows an image with no previous description.

3 Clicking on the Add Description button will open the description panel for that image. The description panel shows a subset of elements from the Diagram content model. A describer has the option to enter any of the following data elements as part of description for this image:
  • Image Category
  • Long Description
  • Summary
  • Simplified Language Description
  • Annotation
  • Target Age & Grade
  • Tactile Image Source & Tour
     For a complete description of what a Content Model is and how to use it for effective descriptions, please see here.
Description fields will be displayed on the right of the image you have selected.  The screen below lists all the possible data elements that can be described for a description.


4 The POET Help Wizard references NCAM to provide reference examples for 10 specific types of STEM images.

Select an Image Category to accompany the described image. This will also bring up an abbreviated sample descriptions, including (where applicable):

  1. Link to original NCAM sample
  2. Sample image
  3. Accompanying image description
  4. Guidelines for image description writing
  5. Template for image description writing

5 For some fields Poet provides an HTML editor and MathHelper. HTML Editor is especially useful if you want to enter a data table, or other basic HTML tags.

To facilitate the description of simple mathematical graphs, equations and functions Poet provides MathHelper. You will only see MathHelper below the description fields that accept mathematics input. See Adding Mathematics in descriptions section below for how to enter maths in descriptions.


6 Once you are done with your description, hit Save. A confirmation message will inform that the description has been saved, and it immediately becomes part of the file.

Adding Mathematics in descriptions

Step Process What you see
1 Certain fields in the content model allow users to enter Mathematics using Math Helper. You can Show/Hide Math Helper using the toggle button below the description box.

Note: The Math Helper only appears for images that need Mathematics input.



2 When Math Helper is visible, you will see an  Equation Editor box with an equation rendering area beneath it. 

You use a standard ASCII input to type the equation in the Equation Editor. To see some examples and help, please click the link "examples".
3 Once you have entered an equation in the Equation Editor box, click Add to Long Description to move the math equation to the description field above it. 

If you want to edit your mathematical equation or formula, you simply re-write the equation in the Equation Editor box and Add to description field again.  The most current description will always supersede the previous description.

4 To preview the contents of a description including mathematics and other description elements click on Preview. Preview will render the content of its field. Again to correct any error in the content of the description field click edit. Equation Editor content can only be edited in Equation Editor itself. 

Continue entering descriptions in remaining the fields. Once you are done, click on Save.  The content of all descriptions are added to the Poet database. 

Caution: You must save each description as you write them, or they will be lost.     
On successful saving, you will see the message, "The description has been saved".  Then you can move on to the next image.

5 If you need help in entering equations, click examples link next to an Equation Editor. The link point to this url, please click here for more details:

Equation Editor documentation
     

Update a DAISY Book with the Latest Image Descriptions 

Step Process What you see
1. When the image descriptions for a book have been completed, they should be processed from the server into the original DAISY file on your computer.
From the Poet home page, click on the Process link. On the Update DAISY Book Image Descriptions screen, click the Browse (or Choose file) button.
The Update DAISY Book Image Descriptions screen :

 

2. A file selection dialog box will open showing your computer's file structure.
Locate and select your DAISY file, then click Open. You are returned to the Update DAISY Book Image Descriptions page with the file name populated.
If the file is password protected, enter it in the password field, otherwise leave it blank.
File Upload dialog box (Mac appearance):

3. Click the Process button. This will process the image descriptions into the DAISY file on the server and download the zip file to your computer so that you can re-publish it to your library or read it with a tool which supports the voicing of prodnotes. Look into your default download folders to find the title with updated descriptions.

Check Image (Description) Coverage

Step Process What you see
1. To check the image description coverage for a title, go to the Image Coverage Checker and click on Check. On the next screen click the Browse (or Choose File) button below, and select a DAISY 3 book (zip) file from your local drive to process. Click Check button to being the check. The screen shows the title upload screen:

 
2. A file selection dialog box will open showing your computer's file structure.
Locate and select your DAISY file, then click Open. You are returned to the Update DAISY Book Image Descriptions page with the file name populated.
If the file is password protected, enter it in the password field, otherwise leave it blank.
File Upload dialog box (Mac appearance):

 
3 The result of running the Image Coverage Checker will display the:
  • Total Images described
  • Total Descriptions
  • Total Number of Images
  • Essential Images that still need description
  • Total Essential Images
The screen shows the result of running an image coverage check: