We currently use FCKEditor as a reach text editor for the site, it is meant to be easy to use and familiar to everyone who already uses some kind of word processor like MS word or OpenOffice, following are some tips on using the editor:
my experience shows that using the 'Show Blocks' feature makes editing much easier, you turn it on and off by clicking the toolbar button 'Show Blocks', its the button with the magnifier icon. which actually shows blocks of content, an image for example takes a block while editing. a paragraph is a block also. just click on it and start editing, you will see its value right away. it will help you manage your blocks and avoid typing inside images or code snippets blocks.
if you are permitted to post in full html format and you really need to add html code to your post click the 'Source' button to switch source editing on and off.
if you prefer to compose your post in ms word or open office then use the 'paste from word' option in the editor.
we use syntax highlighter module for code snippets, open it's dialog by clicking the 'code' toolbar button. there are many supported languages, but the dialog supports only a subset of them. to add code snippet for a language that is not supported by the dialog, like scala for example, you will have to edit you post in source mode and add the required html tags like:
<pre class="SYNTAXHIGHLIGHTER-OPTIONS"> program code ... </pre>
where the format of SYNTAXHIGHLIGHTER-OPTIONS is: brush: java; , so for scala do:
<pre class="brush: scala"> def apply(x:Int): Tree = new LeafImpl(x); </pre>
and this is how it really looks:
def apply(x:Int): Tree = new LeafImpl(x);
see here the full list of supported languages.
note that while hovering over code snippet a small floating button will popup and enable you to copy the code to your clipboard.
and this is how xml code looks like:
<context-param> <param-name>contextConfigLocation</param-name> <param-value> classpath:/applicationContext.xml, classpath:/testContext.xml </param-value> </context-param>
you can also insert images in your post, use the 'insert/edit image' button in the editor's toolbar to open the image upload dialog, click browse server to select an existing image or to upload a new image, select the image and click 'send to fckeditor',
You can also embed videos to your post. upload the video to blip.tv or youtube or some other video hosting site that supports embedding and embed the html code to your post, you must embed the code in source mode editing. it usually looks like:
<embed width="450" height="359" src="http://blip.tv/play/grVLgc2VRgA" type="application/x-shockwave-flash" allowscriptaccess="always" allowfullscreen="true"></embed>
and this is an embedded video:
So don't expect this editor to be easy to use as you use MS word, but its OK if you are gentle with it