Library:LTK Manual Pages

From UBC Wiki


What is a Page?

A page is the frame that contains and organizes the content of your research guide. You create and name a page for your particular subject, such as Biology or English. Within a page, you will organize the various categories of information through tabs. For example, if you want to include a section on article databases in your page, you will generate an articles tab. Widgets contain the details of the content which populates your page. For example, you list the individual article databases in a widget. When you are ready, you can drop the widget into the relevant tab on your page. You can add content to your page using the following six widgets: Embed, RSS, Resource Links, Text and Image, UBC Wiki.


Create a new Guide

At this point in time the LTK is only being used to create Subject Guides and Topic Guides. Course guides will be added to the LTK at a later date.

To create a Guide:

  1. Click on the Guides tab.
  2. Click on the Create Page button on the left hand side of the screen.
  3. Specify an "internal" name for your guide. By default it will be named "Page-N" (N is a random number).
  4. Enter a "Guide Display Title".
  5. Under Page Properties enter the following:
    1. Subjects: first select a primary subject from the drop down menu, then select a secondary heading (If you do not see an appropriate secondary subject heading in the list, send a request to Paul Joseph to have it added). Once you've selected both a primary and secondary subject click the green plus icon to add them to the guide. You can then add another set of primary and secondary subjects. You can also delete the subjects by clicking on the red minus icon.
    2. Branches: select the Library branch you would like the guide to reside under (please note: this is not a mandatory field). If your subject also has an Okanagan Librarian designated to it, please add "Okanagan" as a Branch.
    3. Tags: enter keywords (separated by commas) to help users locate your guide. The search box on the portal page will search page titles and page tags.
    4. Other Options: check this box if you would like links to the Instruction Calendar, How to Cite, and Course Reserves on the home tab of your guide.
  6. Add a widget to the page by dragging the red Add Widget to the page editing space (your page will not save if there is no content in the "Home" tab).
  7. Click on the Save Page button at the top right hand of your screen.


Once you have saved your guide, additional page properties will appear on the page. These include:

  1. Ownership: use this feature to share ownership of your page (especially useful for adding UBCO colleagues) and identify a contact for the page. Only Owners can be selected as Contacts.
  2. Optional Alias: All LTK guides have a url that starts with: guides.library.ubc.ca/. Once the guide has been published you can create an alias, simply add the term you would like to replace the # with.


TIP: Click Save whenever you make a change or addition (adding a widget) to the page. If you hit the backspace key or Back button, you will lose your work if you have not saved it.

N.B. There is a known issue regarding Firefox versions below 4 where you may see a message about "Javascript stack space has been exhausted". This is not an error in LTK. It is recommended that if your guide is "large" (i.e. if it has many widgets -- exact number not known) that you edit it using Internet Explorer or Chrome (if available). If you see this message and if the browser is still responsive, do not save the guide, as the operation will likely fail and you will lose your work. Instead, open another browser and copy the content of any widgets you have edited or added over to the other browser.

"Lost" widgets: It is rare to lose actual widget information, but it is possible in some cases that a page may lose its record of what widgets it contains. Before re-creating widgets, check to see if they still exist (Add widget, then "Use Existing Widget").

Tabs: Add, Name, Move or Delete

When you are in Page Editor:

  1. Add a tab by clicking on the Add tab button.
  2. Name your tab:
    1. Double click on New Tab.
    2. Enter your new title.
    3. Click outside of the tab
    4. Click on Save.
  3. Move a tab by clicking on it and then dragging and dropping it.
  4. Delete a tab by clicking on the tab and then clicking on the Delete tab button. A pop up box will ask if you really want to delete this tab.


Add a Widget to a Page

  1. Click on the red Add Widget button and slowly drag and drop onto your page where you would like the information to appear, you should see an orange line appear before you drop the widget.
  2. Once the widget has been dropped into place choose whether you would like to create a new widget or use an existing widget.


Create a New Widget (from inside a page)

To create a new widget the first step is to select the type of widget you would like to create: Embed, RSS, Resource Links, Text and Image, or UBC Wiki.


Embed widget

Use an Embed widget when you want to include embeddable java script into your guide. For example a You Tube or Vimeo video, a meebo chat box, a delicious tag cloud, etc.

To create an Embed widget (from inside a Page), once you've dragged the widget into place:

  1. Next to Create New Widget select Embed from the Select Type drop down menu .
  2. This will pop up a new window to create your embed widget in.
  3. Enter the internal name for your widget.
  4. If you want to have a title displayed on the public view, enter that title in the Display Name box.
  5. Open a separate tab on your browser and go to the original website and cut & paste the embed code. For example, In You Tube you can copy the code from the "Embed" box (found in the "About This Video" box when you're watching the video). For more information, on using the "Embed" feature, in youtube, you can view this short video for a quick demo [1].
  6. Add information about the original Creator in the Credit box
  7. Add details about the video in the Description box.
  8. In the Tags box, add a tag(s) to help you associate this widget with the guide you are adding it to.
  9. Click on Save Widget at the bottom right hand side of the screen.
  10. Once the widget has been saved make sure to click on Save at the top of the page to save the new widget to your guide.


RSS widget

Use an RSS widget when you want to include dynamically updated information in your guide.

To create a RSS widget (from inside a Page), once you've dragged the widget into place:

  1. Next to Create New Widget select RSS from the Select Type drop down menu .
  2. This will pop up a new window to create your RSS widget in.
  3. Enter the internal name for your widget.
  4. If you want to have a title displayed on the public view, enter that title in the Display Name box.
  5. If you are interested in a New Books @ UBC Library feed, click on click here! and fill out the form to generate an RSS feed.
  6. When you have an RSS feed, Copy the RSS feed URL, and paste it in the Feed URL box.
  7. Enter the description of your feed in the Description box.
  8. Customize the display options to your preference.
  9. In the Tags box, add a tag(s) to help you associate this widget with the guide you are adding it to.
  10. Click on Save Widget on the bottom right hand side of the screen.
  11. Once the widget has been saved make sure to click on Save at the top of the page to save the new widget to your guide.


Resource Links widget

Use a Resource Links widget when you want to include a list of web links in your guide. For example, a list of databases.

To create a Resource Links widget (from inside a Page), once you've dragged the widget into place:

  1. Next to Create New Widget select Resource Links from the Select Type drop down menu .
  2. This will pop up a new window to create your Resource Links widget in.
  3. Enter the internal name for your widget.
  4. If you want to have a title displayed on the public view, enter that title in the Display Name box.
  5. Click on the box under Link URL and enter the URL of an Information Page or a website.
  6. Click in the box Link Title. This will cause the Get Resource Title and Description button to appear.
    1. To import the title and database description from a webpage, click the Get Resource Title and Description and the information will automatically populate the next two boxes. Please note, for database information pages, if there is no "short description" filled in on the information page, no description will be imported. The SGIT recommends filling in the short description in ColdFusion for future use.
    2. Alternatively you can manually enter the title and description.
  7. If you want to add another resource link, click on the blue Add Link button.
  8. Please Note: Only check the Use EZProxy? box, when linking directly to articles or ebooks. Do not click on this box if you are linking to an Information Page or an ebook record in the catalogue, as these will prompt the user to authenticate.
  9. In the Tags box, add a tag(s) to help you associate this widget with the guide you are adding it to.
  10. Click on Save Widget on the bottom right hand side of the screen.
  11. Once the widget has been saved make sure to click on Save at the top of the page to save the new widget to your guide.

Text and Image widget

Use the Text and Image widget when you want to include descriptive or explanatory information in your guide and/or images.

To create a Text and Image widget (from inside a Page), once you've dragged the widget into place:

  1. Next to Create New Widget select Text and Image from the Select Type drop down menu .
  2. This will pop up a new window to create your Text and Image widget in.
  3. Click in the Internal Name box and change the name of the widget to something that will help you to identify it later.
  4. If you want the widget to have a title, click in the Display Title box and enter the title.
  5. Enter your text and/or image in the Content box (see below for more detailed instructions for adding images).
  6. In the Tags box, add a tag(s) to help you associate this widget with the guide you are adding it to.
  7. Click on Save Widget at the bottom right hand side of the screen.
  8. Once the widget has been saved make sure to click on Save at the top of the page to save the new widget to your guide.


To insert an image:

  1. Click on the insert an image icon (square with a tree in the middle) on the Content menu bar.
  2. Clicking on the icon will launch the Moxiecode Image Manager.
  3. Navigate to the folder that you would like the image to reside in (see the Guidelines section for naming of image folders).
  4. Once you have navigated to the appropriate folder, click on the Upload icon in the top, right hand corner.
  5. In the upload window, click on Choose Files.
  6. In the open window, select the image file(s) on your computer that you would like to upload.
  7. In the upload window, the selected file(s) should appear with an upload to server button, click this button.
  8. The uploaded image can be edited by clicking on the up arrow at the bottom, right hand side of the image. The image editor allows you to crop, resize, flip and rotate.
  9. To add the image to the widget, click on the image.
  10. Having added the image to the content box, you can now add descriptive text and/or an attribution. Standard image citations can include: Artist's Name (First and Last), Title and Date, Museum Name and Location.

Sample Image citation:
Mary Cassatt
The Bath, 1890-91
Scan by: Mark Harden's Artchive


UBC Wiki widget

Use a UBC Wiki widget to import content from a UBC Wiki page to your guide.

To create a UBC Wiki widget (from inside a Page), once you've dragged the widget into place:

  1. Next to Create New Widget select UBC Wiki from the Select Type drop down menu .
  2. This will pop up a new window to create your UBC Wiki widget in.
  3. Enter the internal name for your widget.
  4. If you want to have a title displayed on the public view, enter that title in the Display Title box.
  5. Add the url for the UBC wiki page you want to import.
  6. In the Tags box, add a tag(s) to help you associate this widget with the guide you are adding it to.
  7. Click on Save Widget at the bottom right hand side of the screen.
  8. Once the widget has been saved make sure to click on Save at the top of the page to save the new widget to your guide.


Remove a widget from a page

  1. In Page Editor, mouse over the widget you wish you to remove.
  2. Click on the red x in the top, right-hand area of the widget.
  3. You will be prompted by the message "Remove widget?"
  4. Click OK


Preview a Page

You will want to preview your page at various times in order to review its layout, design and clarity.
TIP: You will have to save any changes to your page before you can preview it:

  1. Click on the Save button on the top right hand of your screen.
  2. Click on the Preview button.


Edit a Page

  1. Click on Guides Tab.
  2. Locate the page/guide you would like to edit.
  3. Click the Edit button
  4. When you have a made a change, be sure to click on Save at the top right of the screen.


Delete a Page

  1. Click on Guides Tab.
  2. Locate the page/guide you would like to delete.
  3. Click the Delete button
  4. You will be prompted to answer the following question: "Really Delete?", before the page will be deleted.


Filter Pages

Use Filter Pages to help you locate guides in the LTK. The default is to list your guides; however, the LTK is designed to help us collaborate with each other.

You can select a page to view by using these filter options:

  1. To filter By Title, type the title of an existing page.
  2. To filter By User, type the name of the person who created the page.
  3. To filter By Branch, select the name of the branch that owns the page.
  4. To filter By Tag, type the name of the tag attached to the page.

Linking directly to a Tab within a Published Guide

Sometimes you may wish to direct users to a tab within an existing guide. You will notice that the URL in the address bar remains the same which ever tab you have open. However, you can follow these instructions (while in Firefox) to link to a particular tab:

  1. Right click on the tab.
  2. Select Copy Link Location.
  3. Use the Ctrl + V shortcut to paste the URL onto the page or document from which you are linking or into the address bar of another window or o.


Back to LTK Manual Home

Retrieved from "https://wiki.ubc.ca/index.php?title=Library:LTK_Manual_Pages&oldid=126446"