This section is derived from documentation (c) Katipo. Kea is itself (c) Katipo. Used with permission.
BEFORE STARTING
To create a new language template, you need to contact one of the following people, who will arrange for an area for your language to be created in the Kea system.
System Requirements
Minimum Requirements are:
A Computer Connected to the Internet,
Internet Explorer 5.0 or newer or a Mozilla browser such as Netscape 6,
- NB: Kea is affected on the speed of your internet connection and to a smaller degree by the power of your machine. A faster internet connection will make Kea easier to use.
Things You Need To Ask Someone Else To Do
Restore pages from backup,
Roll back a website to a previous state,
Undelete files marked for deletion.
Logging Into The Kea File Manager
In order to login to File Manager you will need 3 things:
Your Kea user name,
Your Kea password,
The URL of the File Manager on the edit site.
Differences Between The File Manager And Edit Content
The File Manager is the tool where you preform actions on files such as finding files to edit, or preview, deleting moving and triggering files. In order to edit a page, you will first need to find it in the File Manager.
Edit Content: Once you have found the file you wish to edit in the file manager, click on "Edit Content" to launch the content editor. You make your changes in the yellow box and then Submit them to the page, click "Ok" to stay on that page, or "Exit" to return to the file manager.
Navigating In File Manager
To Navigate around our edit site in File Manager, it is best to think of the File Manager Screen in 3 sections.
Breadcrumbs: Breadcrumbs show you the path to where you are now, and enable you to retrace your steps. The first element in the path is the home or root folder for the website. All the names in this path are links, click on any name in the breadcrumbs to jump back to that folder.
Folders: This is a listing of all the folders within the folder you are currently in. If you click on the name of a folder, you will be taken to the File Manager screen for that folder. Clicking on subfolders is how you go forward in a site. You can only move forward one folder at a time (just the same as in the Windows File Manager - -Explorer).
File Listing: This is a listing of all the files in the current folder. If you click on the file name, you will get a preview of the page.
The File Manager Screen Explained
Below is an example of a File Manager Screen for a user with full privileges. Note that some of the Screen options are not availble to all users.
1. You Are Here: These are "breadcrumbs", showing the path through the folders you have taken. They show which folder you are working in at the moment. You can use these for navigation. Click on any of the links in the breadcrumbs to take you back to that folder.
2. Checked Out Files: This is a listing of all the files that are Checked Out to you. Once you have finished working on a file, make sure that it has been released so that others can work on it. To release the file so that others may edit it, click the file name next to "Checked Out Files".
3. Create Folder: Used to make a new folder with the name given in the field next to it. Only letters, hyphens,underscores, full stops and numbers are acceptable characters in the folder name. Spaces are unacceptable. We strongly recommend you use lower case letters in your file and folder names.
4. Folders: Listing of sub folders below the current folder. Use these for navigation. Click on a folder name to access the files in that folder.
5. Upload File: Use this to locate the file you wish to upload locally from your own drive. Clicking Browse will bring up a window from which you can select your file. Click Ok to select the file you want and the name will appear in the field to the left of the browse button. Click Upload to copy the file into the current folder. Note: Files over 1Mb will not be uploaded.
6. Create New File: Used to Create A New Page on the Website (you probably will not need this feature, as you should only be changing copies of the existing files).
7. Check Boxes: Click a box to select a file so you can trigger/notify, move or delete it. Click multiple boxes to preform the same action on multiple files at once (again, not something you should need for a translation).
8. Edit Content: Clicking on the Edit Content link will launch the Kea Editor on this page.
9. Filename: Click on the file name to preview the page.
10. Column Headings: Click on a Column heading to reorder the files.
11. Edit Info: This page contains information about the page such as the page title (appears in the status bar of the browser and breadcrumbs) meta data used by search engines to search your page, who "owns" the page , and when it was published.
12. Edit Source: Opens up the source editor. Only enabled for the webmaster or people with advanced HTML skills.
13. Last Modified: Shows when page was last modified.
14. Modified By: Gives the username of the last person, usually an email address to edit this page. Clicking the username will bring up a history of all the users who have edited this page.
15. Trigger: Copies the page across to the live site. This option is only available to site administrators or those with Trigger privileges.
16. Delete: Deletes the page from the File Manager listing. Note that all deleted files go into a "Trash Can" that is normally deleted weekly. If you have deleted a file by accident contact your website administrator to get the file reinstated.
17. Notify: Appears in place of the Trigger button for most users. This option will send an email to your site administrator, notifying them that changes have been made and requesting that they trigger the page live.
18. Move: Moves the selected file to another folder within the site. Note that it pays to check files after they have been moved to fix links etc. Move also allows users to rename a file. (Again, not something you should need for Koha work.)
19. Select All: Selects all the files in the folder.
Launching The Kea Content Editor
Log on to File Manager
Use the folder listings and breadcrumbs to locate the folder in which your page resides.
Once you are in the correct folder, click the folder name eg index.html, to preview the page in your web browser. Check that this is the correct page that you want to edit. Use the browser back button to go from the preview back to the File Manager screen.
In File Manager, click "Edit Content" to the right of the file name you wish to edit.
You will be taken to a view of the page where the editable text is highlighted yellow. Note that there may also be some text highlighted purple, changes to this text may appear on other pages.
Making Changes
Clicking on an area of yellow highlighted text, will open up the Kea window. It is in the Kea window that you edit a block of text.
Different parts of the page are separated into kea blocks. For example, the page heading is normally in a different Kea block to the main body text.
You can now change the text as you would do normally in Word. Try adding some text. eg "Adding some text".
Kea will recognise line breaks (carriage returns) and paragraph breaks. Hit enter once for a line break. Hit enter twice for a paragraph. Note: Kea will only recognise one paragraph break at a time. If you try to enter several paragraph breaks between paragraphs, kea will ignore all but the first one.
To commit your changes to the page, press Submit.
The Kea box will close and be replaced by a smaller one as per below:
To continue editing the page press Ok, to exit the Kea editor and return to the File Manager screen click exit. We want to continue editing the page so click Ok.
You should now be able to see the change you have made to the page. Click the text you have just changed again to open the Kea window.
Now we are going to look at the other buttons on the Kea window.
In the top right corner of the kea window there are 3 buttons. The horizontal line (-) minimises the kea window. The question mark (?) opens the Kea help pages (Note this function is currently disabled). The cross closes (X) the Kea window. You will loose any changes you have made. In the bottom left of the screen there is the Submit button we used before to commit changes and the Cancel button. Make a change to the page and then press Cancel. You will get a little box that comes up "Loose Changes". Click OK. Your changes will be lost and the Kea window closed.