External sources: SQL, CSV, and Code Sources
Calling Code Sources from templates
Email Notifications and Site Membership
Kupu is a WYSIWYG content editor inside Silva. It allows Authors to add text, links, images, tables, citations, abbreviations, acronyms, index items and more.
Kupu uses many of the same commands as typical word
processors such as Microsoft Word.
You need to have been given access to Silva as an Author, Editor or Chief Editor. Access is given to you by the Chief Editor or Manager.
You will need to have one of the following browsers on your computer:
Log in to the contents screen (Fig. 1.)
Look at the documents listed under the modify heading
and click on the name of the document you wish to
edit. In Fig. 1. you would click on "tree" to edit the
tree document.
If you wish to add a new document see add content then click on the title of the document listed under the modify heading to reach Kupu.
Fig. 1. Contents screen
After clicking on the document you wish to edit you will be taken to the Editor screen. (Fig. 2.)
Fig. 2. Editor screen and Kupu toolbar
In the editor screen you have a choice of two editors. The button for the one currently active is highlighted. If the forms editor button is highlighted, click on kupu editor to open the Kupu Editor. If you want to use the kupu editor always, check your user settings.
The Kupu Editor is divided into three areas: the toolbar, the central editing area, and the toolboxes running down the right side of
the screen. The oolbar is just below the Silva top navigation (Fig. 2.)
Kupu uses many of the same commands as typical word processors. The buttons in the toolbar controlling bold, italics and underline are the same as in Word.
Fig. 3. Toolbar with formatting options
To change the size of your text make a heading or subheading. Click onto the drop down list in the tool bar with the default style plain.
To change a word or words use your mouse cursor to select the text and then click the appropriate button in the toolbar.
(Fig. 2) For example if you select some text and press the B
icon, you will add or remove bold highlighting to the selected text.
Roll your mouse over the other toolbar icons to see the functions. They are: save, bold, italics, underline, subscript, superscript, numbered list, bulleted list, definition list, undo, redo, spellcheck and edit html.
Using the toolboxes located on the right of your screen, you can add links, images, index items, citations, abbreviations, acronyms, external sources, tables, table of contents and typographical characters to your document. At the base of the toolbox is another save button. The instruction for the Toolbox options follow below.
Remember
to save your work often when working in Kupu. If you preview or
refresh your screen without saving your work you might lose it.
There are three ways to save a document:
click the floppy disc icon in the toolbar to save your work. (Fig. 3.)
click save document that is located in the bottom of the toolbox on the right hand side of the editing screen.
use the keyboard shortcut alt-s
Note: all new work added into a document must be saved before you change or refresh your screen. If you try to leave the page without saving you will be prompted to save.
As well as typing text into Kupu you can copy and paste text from a web page or a word processor.
Highlight the appropriate text.
Type the URL or web address into the links properties area in the right hand tool bar. (Fig. 4.) Include ”http://” in the URL, and click insert link.
For example: insert a link to http://www.infrae.com/
Internet Explorer users, you will notice that the text selection will
not appear to be selected. However as soon as you enter the URL and click insert link the URL will be inserted in the text.
Fig. 4. Adding a link
Click get link reference... and locate an item within Silva (Fig. 4).
Click save.
To edit a link, first place the cursor within the link text. The link toolbox will highlight. This option only appears when the cursor is on an existing link in your document.Type in the new path or web address into the links properties area (or use the get link reference button if the link is within your Silva site).
Click update link.
Click save.
Links go to an anchor, and the anchor can include a name of a location further down in a page. This is commonly used in long pages so site visitors can jump to a section. For instance we can link to the next section in this page, Indexing, by entering the # symbol and a unique name to the link (as in Fig. 5). This link goes to a named anchor. If you hover over it you will see “#Indexing” at the end of the link.
Fig. 5. Linking to a named anchor in this page
To create a link that includes a destination, you have to create a named anchor.
Insert your cursor in the text that you wish the indexer to reference. Do not select a word or phrase, just insert the cursor.
Go to the anchor/index item toolbox on the right and type the anchor name into the input field in the toolbox (Fig. 5a). Note that we entered “jump_to_here”; the anchor should not contain any spaces or special characters. If you do add an invalid character it’ll be replaced by an underscore.
Click add element. You will see the named anchor highlighted in yellow.
Fig. 5a. Creating a named anchor
We didn’t add an index title to this anchor because we don’t want it to be an index item; see the following section.
Sometimes your cursor gets stuck in an anchor/index item. Use your tab key to move the cursor to the end of the text.
Silva provides an indexing facility for your site text in the form of an Indexer content type that displays an index like in the back of a book. Index items are defined in your text. They are a special named anchor (see above).
Index items are also named anchors because we want to jump to them from the Indexer. The difference is an index item has both a name and a title. The Indexer only presents anchor/index items that have a title.
Insert your cursor next to the text that you wish the indexer to reference.
Go to the anchor/index item toolbox on the right and type the anchor name into the input field in the toolbox (Fig. 5b).
Fill in an index title (the words that will appear in the Indexer) into the input field.
Click add. You will see the index item highlighted with yellow. The highlighted words will be invisible when you publish your document, but will be listed in the indexer.
Fig. 5b. Creating an index item
For the indexing to work you need to first add an Indexer in the Folder or Publication your document is contained in. The Indexer is added outside Kupu in the contents screen. (Fig. 6.)
Fig. 6. Add an Indexer in the contents screen
Only documents that are published will be indexed. The Indexer should be updated whenever new index items are published. To update the Indexer go to its edit screen and click update.
You can add an image from within Silva or upload an image from your computer.
Place the cursor where you want the image to appear in your document.
Click get image reference... (Fig. 7.) this is located in the toolbox on the right.
In the resulting pop-up screen select the radio button next to the image you wish to add and clickplace reference....
Then click save.
Fig. 7. Adding an image
To upload an image from your computer into Silva, place the cursor where you want the image to appear in your document.
If you want to upload many images you can import them via a zip file.
In the toolbox on the right, click on the get image reference link. (Fig. 7.)
In the same spot a dropdown will appear, choose Silva Image. (Fig. 8a.)
In the upload window upload your image, fill in required fileds click save. (Fig. 8b.)
In the screen that follows select the radio button next to the image.
Then click save.
Fig. 8a. Adding a Silva Image
Fig. 8b. Uploading and Saving the image
To align an image in Kupu, click on the image. A toolbox will open on the right of the screen. (Fig. 9)
Align your image by choosing a position from the drop down list next to image alignment.
Fig. 9. Image toolbox appears when you click on your image
If the current image is displayed at less than full size.
Click on the image. A toolbox will open on the right of the screen. (Fig. 9)
Check the radio button next to hires version.
Click save.
Click on the image. A Toolbox will open on the right of the screen. (Fig. 9)
In the tooltip text area type the text you would like people to see as they rollover the image.
Click save.
If an image is fairly large either in scale or file size you can resize it within Kupu.
To resize your image click on the image. A toolbox will open on the right of the screen. (Fig. 9.)
Click on the edit image...
link. To make the image smaller you can choose a percentage and
enter it in the text box for scaling. Follow the onscreen
instructions for other ways to resize or crop your image. (Fig. 10.)
Click save.
Fig. 10. Resizing or cropping an image
To add a descriptive rollover to abbreviations and acronyms. Highlight the term (e.g. i.o.u.) then type the full name in the abbreviation toolbox located on the right side of the screen, then click add element. (Fig. 11.)
Then click save.
Fig. 11. Adding a rollover to abbreviations and acronyms
Place the cursor where you want the external source to appear in your document then click add external source (Fig. 12.)
Then click save.
Further details on adding an External Source.
Fig. 12. External source toolbox
Click on add external source and fill in the details of your external source in the text area. (Fig. 13.)
Fig. 13. Example external source form
To add a citation or reference to the body of your document:
Place your cursor where you want the citation to appear in your document.
Fill out the citation form located in the toolbox on the right and click add element. (Fig. 14.)
Save your work.
Fig. 14. Adding a citation or reference
View the citation in your document by clicking on the preview tab in the top navigation. (Fig. 15.)
Global Theatre
Fig. 15. Citation view
To add a table:
Place the cursor where you want the table to appear in your document.
Move your cursor over to the table toolbox located on the right.
Choose the table properties in the table properties area of the toolbox. (Fig. 16.)
Click add table.
Fig. 16. Adding a table
Click anywhere in the table.
This will change the tables toolbox located on the right, to the options in Fig. 17.
Fig. 17. Editing options for a table
You can add or remove columns and rows and also change the ratio of the column widths. Kupu uses percentages internally to scale the table columns equally, but these can be changed by editing the column widths.
In Kupu you can add an automatic table of contents to a document or a folder.
To add a
table of contents for the items in your folder or publication go to the
“table of contents” properties in the right hand toolbox. (Fig. 18.)
Select the level of nesting you wish to reveal from the drop down list and click add element. You will see the words Table of Contents appear in your document highlighted by a yellow background.
Fig. 18. Adding an automatic Table of Contents.
To view the table of contents click on preview in the navigation bar above the Kupu Editor.
When a table of contents exists in your document, the table of
contents toolbox changes to reveal two more options. You can change the number of levels in your contents.
Click the drop down list to choose a different level and then click the change toc button to save this change. To delete the table of contents press the delete toc button. (Fig. 19.)
Fig. 19. Editing or deleting a Table of Contents
The
following typographical characters can be added to your document by
copying and pasting them from the toolbox. (Fig. 20)
Fig. 20. Typographical Characters.
Sometimes you'll find an extra toolbox at the top of the toolboxes, the Comment toolbox. This is used for internal communication. If there is content in the comments field of the document properties it shows up here. This is useful for notes, reminders, etc. (Fig. 21.)
Use the keyboard cursor keys to navigate between table cells and to go out of the table.
Sometimes your cursor appears to be stuck in a Code Source. Use the arrow keys or tab to move the cursor to the next element.
Kupu always insert a paragraph with a space at the end of a document to enable elements to be appended easily. This paragraph is not saved if it's empty.
You can use the access key on your system (the alt key for Windows, the ctrl key for Macs, on Linux usually the alt key) to do various operations with the keyboard. This is a real timesaver, especially when a button has scrolled out of sight. For instance, save your work by hitting acc-s. The following keyboard shortcuts are available:
s save
b bold (doesn’t work in recent Firefox)
i italic
u underline
- subscript
+ superscript
# numbered list
* bulleted list
= definition list
z undo
y redo
h html source
In the preview you can publish the document using the publish button or acc-p.
Kupu is Maori for message or word, while in Indonesian ‘kupu kupu’ means butterfly.
Thus the kupu logo is a butterfly.
© Copyright 2002-2012 Infrae.
All rights reserved. 
