Silva
Silva 2.0 Documentation

Getting started

Overview

Silva features

What’s new in Silva 2.0

Log in

Navigation tour

Author – basic

Adding content

location Using the Kupu editor

Previewing a document

Submitting for publication

Author – advanced

Adding metadata

Document versioning

Content organization

Importing content

Importing spreadsheet data

Exporting content

Forms editor

Navigation – advanced

Access Keys

WebDAV

Editor

Publishing

Subscription management

Atom and RSS feeds

Chief Editor

Full media export

Roles and permissions

Assigning roles

Groups management

Restricting public access

Addables configuration

Manager

Manager login

Zope Level Management

Adding Users

Subscription configuration

External sources: SQL, CSV, and Code Sources

Groups

Site design and templates

Accessibility Links in Silva

Public API of Silva

Code Source HowTo

Internationalization

File System Storage

Maintenance Notes for Managers

Silva Docs Index

Search

subscribe envelope

Using the Kupu editor

What is Kupu?

Kupu is a WYSIWYG content editor inside Silva. It allows Authors to add text, links, images, tables, citations, abbreviations, acronyms and index items and more. 

Kupu uses many of the same commands as typical word processors such as Microsoft Word.

In Silva the Kupu editor is usually configured so you cannot change the font face to a different font or color. These settings are set by the Manager to ensure a harmonious look to the site.

Prerequisites

You need to have been given access to Silva as an Author, Editor or Chief Editor. Access usually given to you by the Chief Editor or Manager.

You will need to have one of the following browsers on your computer:

Accessing the Kupu Editor

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.

doc.png

Fig. 1. Contents screen

After clicking on the document you wish to edit you will be taken to the Editor screen. (Fig. 2.)

kupulite.png

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 Toolbox running down the right side of the screen. The Kupu Toolbar is just below the Silva top navigation (Fig. 2).

Toolbar options

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. To change a word or words use your mouse cursor to select the text and then click the appropriate button in the Kupu 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.

To change the size of your text make a title, heading, sub heading etc. Click onto the drop down list in the tool bar with the default style plain.

Roll your mouse over the other toolbar icons, they are: save, bold, italics, underline, subscript, superscript, numbered list, bulleted list, definition list, undo, redo, spellcheck and edit html.

Toolboxes 

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 are below.

Changes are not saved automatically

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.

To save a document

There are three ways to save a document:

savekupu2.png

Fig. 3. Click on the floppy disc icon in the top tool bar to save your work

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.

Adding Text

As well as typing text into Kupu you can copy and paste text from a web page or a word processor.

Adding links

1. Adding a link to an external site

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.

linkprodark.png

Fig. 4. Adding a link

2. Adding a link to a page within your Silva site

Click get link reference... and locate an item within Silva (Fig. 4).
Click save.

3. Editing a link

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.

4. Linking to a named anchor

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.

linknamedanchor.png

Fig. 5. Linking to a named anchor in this page

5. Inserting a named anchor

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. You will see the named anchor highlighted in yellow.

indexitemdark.png

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.

Indexing

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.

1. Inserting an index item 

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.

indexitemlight.png

Fig. 5b. Creating an index item

2. Indexer setup 

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.)

indexeradd2.png

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.

Images

You can add an image from within Silva or upload an image from your computer.

1. Adding an image already in Silva

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.

imagedark.png

Fig. 7.  Adding an image

2. Uploading 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 link called new image.... will appear, click on this link. (Fig. 8.)
In the popup window upload your image, click save.
In the screen that follows select the radio button next to the image and click place reference....
Then click save.

newimagebutton.png

Fig. 8. Uploading an image

3. Aligning an image on the page

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.

imageediting1.png

Fig. 9.  Image toolbox appears when you click on your image

4. Link to a high resolution version of an 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.

5. Rollover text/alt tag for an image

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.

6. Resizing an image

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 next to scaling. Follow the onscreen instructions for other ways to resize or crop your image. (Fig. 10.)
Click save.

imageresizing.png

Fig. 10. Resizing or cropping an image

Adding a rollover to abbreviations and acronyms

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.

abbreviation.png

Fig. 11. Adding a rollover to abbreviations and acronyms

Adding an External Source

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

externalsourceKu.png

Fig. 12.  External source

Click on add external source and fill in the details of your external source in the text area. (Fig. 13.)

extsourceKu2.png

Fig. 13.  External source text area

Citation

To add a citation or reference to the body of your document.
Click your cursor where you want to citation to appear in your document.
Fill out
the citation form located in the toolbox on the right and click insert citation. (Fig. 14.)Then click save.

citation.png

Fig. 14.  Adding a citation or reference

View the citation in your document by clicking on the public preview tab in the top navigation area. In the Kupu editing area you will just see a blank form. (Fig. 15.)

This is the text of the citation. Only this text appears in the editing area, however the author and/or source will be shown in the preview and published version of the document.

Shakespeare

Global Theatre

Fig. 15. Citation view

Tables

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 and then click save.

Kupu uses percentages internally to scale the table. 

tabledark1a.png

Fig. 16.  Adding a table

Editing a table

Click anywhere on the table.
This will change the tables Toolbox located on the right, to the options in Fig. 17.

tableedit.png

Fig. 17. Editing options for a table

You can add or remove columns and rows and also change the ratio of the column widths.

Table of Contents

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 toc. You will see the words Table of Contents appear in your document highlighted by a yellow background.
Click save.
To view the table of contents click on public preview... in the navigation bar above the Kupu Editor. Use your browser’s back button to return.

TOC.png

Fig. 18.  Adding an automatic Table of Contents.

When you have created a table of contents in your document, the table of contents properties area 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.)

TOCedit1a.png

Fig. 19. Editing or deleting a Table of Contents

Typographical characters

The following typographical characters can be added to your document by copying and pasting them from the toolbox area. (Fig. 20)

typographical1a.png

Fig. 20. Typographical Characters.

Kupu access keys 

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
i    italic
u   underline
-   subscript
+  superscript
#  numbered list
*   bulleted list
=  definition list
z   undo
y   redo
h   html source

In the Public Preview you can publish the document using the publish now button or acc-p.


Kupu is Maori for message or word, kupu kupu is Indonesian for butterfly. 
Thus the kupu logo is a butterfly.

© Copyright 2002-2007 Infrae.
All rights reserved. mail