Kupu

1.What the Icons mean:

The icons are for the most part intuitive, but if you're not sure let the cursor hover over them and an explanation will come up.

The B and I are obviously for bold and italics, and the next two are for _subscript and ^superscript

The next three icons are for page justification and the two after that for bullets and numbering - they look just like their Word equivalents.

The next one, the interlocking lines creates some kind of indentation - but its a bit funny, it takes a bit of getting used to.

The next two icons, the ones with the blue arrows, are a nice feature - create a block quote. Just highlight the paragraph and click on the right hand icon to put it in blockquote form. The left hand button reverts a blockquote to normal - i hope in future kupu releases these buttons are switched around.

2.Adding images and internal links

The two of these are very similar so let's deal with them together.

• Click on the tree icon to add an image, or on the chain to add a link.

• In both cases you'll see a navigaton box come up. Initially you'll have two choices on the left section: Current folder (the folder you are in) and Home. Click on whichever one is closest to the file you want, and you'll see its contents come up in the middle bar. If it's in a subfolder, just click on that subfolder to see its contents.
  
• Alternatively, theres a search box in the top right hand corner where you can type in a word from the file you're looking for.
  

• Images: When you finally do click the image you want to add, you'll see a preview of it come up on the screen along with some options.

1. alt text: this text will appear in place of your image if, for example, you move the image at a later time and the image doesnt show on the page. Its considered best practise to put something here.
2. You have three choices to align your image: left, right or inline. Then click OK. Be warned that sometimes left gives you a black border around your image, if this happens click on the image, click on the tree icon and choose inline.
3. Image resizing: we havent gotten this to work properly yet. In anycase its best practise to have the images the right size before you upload them.
4. When all is done, just click ok to add!
   

• Internal links: When you do click one file you want to link to, youll see its title and description come up on the right hand side. Click ok to add.
• Troubleshooting: there are some known issues with adding images and internal links in kupu
  

1. No scrollbar on Mac computers! When you go to add an image or internal link, there's no scrollbar, so if the file you want is at the bottom of a very long list of files, you cant access it. The chances are that you are using Firefox as your browser and you havent got the latest version installed. If you can't upgrade, try these workarounds:
   - you can highlight the bottommost document/image/file you can get your hands on keep the mouse button pressed down and dragging the cursor down to scroll down.
   -you can select the bottom document/image/flie and press the down button
   -use 'search' in the top right corner
2. Cant get out of image/internal link dialogue box: Youve found your image or link, clicked 'ok' but the dialogue box doesnt go away! Just click cancel.

• We have more pages on adding images and adding internal links - these pages are a general discussion, not just confined to kupu. Also see bottom of page for more known issues with Kupu images.

3.Adding tables

Kupu has a no-nonsense add table mechanism: just click on the icon, pick the type of table you want, number of rows, columns and whether you want a heading.

To edit an existing table, just right click on the table border - a range of choices will come up in the drop down menu: add row, delete row ect.

4.The last three buttons:

Undo, Redo and a way to access the HTML interface.

5.Text style menu

The drop down menu selects what kind of text style to use:

• <no style> keeps the page spacing at the minimum - equivalent to using <br> in HTML
• Normal keeps paragraph spacing - equivalent to <p> in HTML. The spacing depends on the settings <p> set in the page CSS, but in general there'll be a bit more space between lines and a lot more space between one paragraph and another.
• Heading - produces a heading the same size as the page title
• Subheading - produces a slightly smaller heading, like 'Text style menu' above.

These are the main ones you'll need to use, there are other ones there to try out, but they're a bit messy, your site administrator might see fit to remove them in kupu configuration.

6. Zooming

Click on the icon in the very corner and Kupu will expand to fill screen. Click again to go back to normal.

7.Issues with using Kupu

• Choosing Kupu: Kupu might be the default editor on your computer, but perhaps you can only see a HTML browser when you go to edit. To change this, click on preferences, then personal pereferences, scroll down to 'change content editor' and select Kupu.

• Using Kupu for first time: There seems to be an issue for some users that they have kupu selected as their content editor but they only get the basic html editor. Press the link at bottom which says 'click to edit with visual editor', then Kupu's buttons will work. This shouldn't happen again upon subsequent visits.

• Kupu strips out HTML: Basically if you try and add HTML that doesnt comply with XHTML 1.0 Transitional, Kupu will strip it out. This means no background colour for tables, no hardwiring table widths, no table aligning to top ect... This behaviour can be changed, and indeed has been done so for all the sites managed by the Vasudeva Service project: read this article on configuring Kupu's stripping mechanism.
  

• Issues with resizing images: Because of the stripping, Kupu will take out HTML code that resizes images (that includes CSS classes). The dialogue box that comes with the 'add image' button actually has a drop down menu where you can size your image, but we havent got it working yet; again, something to do with the stripping, we suspect.

8. Helpful Links

Vasudevaservice.com:

• Changing your content editor
• Plone 2.5 Advice

External:

• Kupu official website