Snippets: What are the different types of snippets that can be inserted into a fact sheet?
A snippet is industry sector-specific content that is inserted into a fact sheet either automatically when the sheet is loaded ('auto show') or on demand ('click to show')
- An 'auto show' snippet is one that automatically appears in the fact sheet when the sheet loads. The content of the 'auto show' snippet is consistent with the sector group of the viewer.
- A 'click to show' snippet is one in which content is dynamically inserted into a fact sheet when the user clicks on a 'click to show' hyperlink - i.e. the content is 'on demand'. The link is 'intelligent' in that it will retrieve content appropriate to the user's sector group. Each link 'access' a snippet cluster, which is a set of individual entries in the database containing content relevant to each sector group.
Snippets: How do I enter content of a new snippet into the database?
There are two ways of entering new content, depending on whether you are adding a new link or adding sector content to an existing link.
- Click on the Snippet Editor tab
- To add sector content to an existing link, click on the [Add] button associated with the link you are working with.
- If you are creating content for a new link, then click on 'Create a new snippet/snippet cluster' at the bottom of the page
- Fill in the form that appears
Snippets: How do I insert an existing 'auto show' snippet into a fact sheet?
- Click on the Snippet Editor tab
- Locate the snippet from the list that appears and take note of the ID number associated with it
- Click on the Core Editor tab
- At the position in the fact sheet that the snippet is to appear, insert a new line.
- Enter the string !DDXXXXX where XXXXX is the ID number of the auto show snippet. For example, if the ID number is 24, you will enter !DD00024
Snippets: How do I insert a 'click to show' snippet into a fact sheet?
- Click on the Snippet Editor tab
- Locate the 'Click to show' snippet from the list that appears and take note of the ID number associated with it
- Click on the Core Editor tab
- Highlight the phrase/words that will form the text link from which the snippet is launched
- Click on the 'Insert/edit link' icon on the toolbar
- Select the 'drill' class from the dropdown list on the 'General' tab
- Click on the 'Advanced' tab
- In the 'Id' box, insert 'dd' followed by the snippet's ID number. ('dd' is case sensitive)
- Click 'Insert' to return to the editor.
Preview: The links in the preview page don't work!
That is by design - all links on the preview page are disabled.
Core editor: How can I copy, cut and paste text to, from or within the editor?
You use the keyboard sequences of Ctrl-c (to copy), Ctrl-x (to cut), and Ctrl-v (to paste). The standard toolbar icons have been turned off - in a website editor, they are more trouble than they are worth.
- If your browser is Internet Explorer, they allow you to inadvertantly paste potentially damaging code into the website whenever you copy from a Word document and paste into the editor.
- If your browser is Firefox, you cannot use these functions unless you alter your browser's security functions - and this is not a straightforward procedure.
What is straightforward, however, are the replacements to these icons.
- To copy something from Word (or any other wordprocessor) and paste it into the online editor:
- Copy your text in your normal way.
- Click in the main content space of the online editor
- Paste the text into the editor using keyboard sequence of Ctrl-v (Ctrl-v means depress the Ctrl key and, keeping it depressed, tap the "v" key)
- To copy something from within your document in the online editor to somewhere else in the document:
- Highlight the area you want to copy by dragging your mouse from the beginning to the end of the section
- Copy that section of text by using the keyboard sequence Ctrl-c (i.e. depress the Ctrl key and with it depressed, tap "c").
- Position your cursor at the place in the document where you want to copy the section to (i.e. paste)
- Paste the copied section using the keyboard sequence Ctrl-v.
- To cut something from within your document in the online editor and paste it somewhere else in the document:
- Highlight the area you want to copy by dragging your mouse from the beginning to the end of the section
- Cut that section of text by using the keyboard sequence Ctrl-x
- Position your cursor at the place in the document where you want to paste the section
- Paste the copied section using the keyboard sequence Ctrl-v.
Core editor: Summary
There are two ways of entering text into the summary box (in the 'Footer info' section).
- Use the auto-formatting feature which will create a bullet-point list. For this formatting to be triggered, you must separate the items by an asterisk. The first item will be treated as a sentence.
Example: 'The main points to remember about the information in this factsheet are:*roses are red*violets are blue*you know the rest'
In this example, the 3 lines of the poem will be bullet-pointed and the first item ('The main points...') will be treated as a sentence. - Insert your own HTML codes (e.g. paragraph tags etc) to enter your own material.
Core editor: Acknowledgements
There are two ways of entering text into the acknowledgements box (in the 'Footer info' section).
- Use the auto-formatting feature which will create a bullet-point list. For this formatting to be triggered, you must separate the items by an asterisk. The first item will be treated as a title and placed in italics.
Example: 'References*McDonald, O. 2007. Farming with chickens. Jour. American Broiler Soc. 23:11-14.*Smith, A. and J. Jones. 2008. The effect of stuff on things. Jour. Amer. Soc. Hort. Sci. 98:107-110'
In this example, the first line will be italicised and the two references will start on new lines immediately below the title. - Insert your own HTML codes (e.g. paragraph tags etc) to enter your own material.
Quotes: How do I create them?
In this context, quotes are a block of text - usually a short sentence or sentence fragment - that is presented in large font and enclosed by 'large' quotes. Its role is to highlight an important piece of information within the text.
Quotes are easily formatted within the core or snippet editor. They can appear in 200 pixel wide blocks on the left or right hand sides of the text body, or they can be full width.
- Create a paragraph containing the text at the position in the factsheet where you want it to start - the easiest way to do this is to have the text appear on its own line separated from the surrounding text.
- Left click on any letter of the text to be quoted.
- Left click on the Edit/Insert Attributes icon (bottom right hand side of the editor's toolbar - a hand holding a document)
- From the drop down list of the 'Class' attribute, select either 'rquote', 'lquote', or 'fquote' (for right, left and full width respectively).
- Click 'Insert'
- Nothing will appear to change within the editor - the quote format will be applied dynamically as the page is loaded into users' browsers.
Images: How big, what format is best, and how do I link to them?
The following 'rules' apply to images on this site:
- Photographs must be in a *jpg format
- Line drawings, with or without colour, must be in either a *.gif or a *.png format
- Images should be no wider than 600px
- Images should be no deeper than about 400px
- An image less than 100 pixels wide is usually too small to display its intended 'story'
- Images intended for left- or right-hand side positioning should be either 200 or 400 pixels wide
- The file size of any image should not exceed 40kb
- Copy the images onto the server and into the appropriate folder using the 'Multimedia manager' (> Manage images > Upload images) listed on the main menu.
- You link to images from within the editor by clicking on the image button and entering the string ../images/xxxx/zzzz.zzz - where xxxx is the name of the folder into which you uploaded the image and zzzz.zzz is the name of the image.
Images: How do I position them on the page and create a title for each of them?
Positioning images on the page requires a class statement to be manually added to the HTML image tag. You can do this after you've inserted an image tag using the WYSIWYG editor, or directly when you enter an image tag through the HTML editor.
The HTML image tag is structured as:
<img class="___" title=' src="../images/folderName/fileName" alt=' width="xxx" height="xxx" />
In order to be positioned on the page, the class statement must take one of four values:
- imgposf = position in the left hand side column (the first column) of a 2 column layout (max. image width = 200px)
- imgposr = position on the right and wrap text
-
imgposl = position on the left and wrap text
-
imgposc = centre on the page, no wrapping
Text entered into the title statement will be extracted and placed immediately beneath the image in the form of a title. The title statement will be automatically inserted into the alt statement, if the latter is empty.
Note that adjacent images in the first columnn of a 2 column layout will overlap each other if they are too close (vertically) - the only solution is to alter the position of the image within the text.
Images: How do I create a zoomable image?
Zoomable images are ones which, when clicked, expand to a larger version of that image.
To create such an image, prepare the code for the image in the normal way (see the item above), with the only difference being that the class statement must take one of four following values:
- imgposfz = position in the left hand side column (the first column) of a 2 column layout (max. image width = 200px)
- imgposrz = position on the right and wrap text
-
imgposlz = position on the left and wrap text
-
imgposcz = centre on the page, no wrapping
Obviously, both versions of the image must be loaded into the same folder on the server. They must share the same root name; the larger version must have a "_l" added to the end of its name. For example, "sprinkler.jpg" and "sprinkler_l.jpg".
Text entered into the title statement will be extracted and placed immediately beneath the image in the form of a title. The title statement will be automatically inserted into the alt statement, if the latter is empty.
This positioning and image titling is done by javascript on the user's side only - the functionality is not currently available on in the preview tab of the editor
Note that adjacent images in the first columnn of a 2 column layout will overlap each other if they are too close (vertically) - the only solution is to alter the position of the image within the text.
Links: How to link to other factsheets
- Copy the name of the file of the factsheet (Utilities > Fact sheet files); it will be of the general form "fsXX-YY.asp"
- In the core or snippet editor, highlight the word or phrase to which you wish to attach the hyperlink
- Click on the link icon and in the "Link URL" input element, paste the filename of the fact sheet.
- Click "Insert".
Links: How are the special links made?
- All these tags are invoked using the links icon on the toolbar.
- Tool tip
This link takes information entered in the title element of the 'a' tag and displays it in a dialogue box when the user hovers over the link.
Enter '#' for the href element, select 'tip' as the class, and enter the information into the title field e.g.
<a class="tip" title="This information will be displayed to the user when he/she hovers over the link" href="#">some word or phrase<a>
- Dynamic glossary link
This version of the 'a' tag is used to give the user an explanation of the word or phrase about which the 'a' tag is placed. The word/phrase must already exist in the site's glossary (use the 'Glossary wizard' to enter or check the presence of the word).
Enter '#' for the href element, select 'glossary' as the class, and enter the word to be searched for into the title field e.g.
<a class="glossary" title="climate change" href="#">climate change<a>
- Graybox/layer
This is used for external links that you want to load "in" the current page, so that the user does not move away from the site.
Enter the external address (complete with http://) for the href element and select 'sbox' as the class e.g.
<a class="sbox" href="http://en.wikipedia.org/wiki/Climate">climate<a>
You can control the width and height of the layer by adding an ID of the form 'wh_www_hhh' (e.g. wh_500_600). The width value must precede the height value.
- Link to other pages on this site
As the title suggests, this link is used to link to other pages in the current ebook.
Locate the filename of the page to which you want to link (a dynamic list of site pages will soon be available from within the Utilities tab).
Highlight the word or phrase you wish to hyperlink
Click the link icon from the toolbar
Enter the filename/URL into the "Link URL" box
Click "Insert"
Glossary: how do I add a new entry to the glossary database?
The glossary is managed through the glossary check/edit utility.
- Check that the word/phrase doesn't already exist by typing it into the input box. The box has a suggest function that will indicate if the word/phrase exists or not.
- If the word/phrase does exist, select it from the suggest list and click "View entry" to read and edit, if necessary, the current entry.
- If the word/phrase doesn't exist, then either select the phrase "No records found" in the suggest list and click "View entry" or with the word/phrase in the input box, click "View entry"
- A form will appear for you to enter the new word/phrase and its meaning.