Andrej Cimperšek - diploma

-------------------------------------------------------------------------------

dojox.editor

-------------------------------------------------------------------------------

Version 0.9

Release date: 9/14/2009

-------------------------------------------------------------------------------

Project state:

experimental, beta, stable

-------------------------------------------------------------------------------

Credits

	Mike Wilcox 	 - Author

	Jared Jurkiewicz - Author (PrettyPrint, PageBreak, ShowBlockNodes,

		Preview, Save, ToolbarLineBreak, InsertEntity,

		NormalizeIndentOutdent, Breadcrumb, FindReplace,

		CollapsibleToolbar, Blockquote, PasteFromWord, InsertAnchor,

		TextColor, NormalizeStyle, StatusBar)

	Dustin Machi 	 - Technical Assistance

	David Schwartz and Gu Yi He (IBM) - Contributed enhancements to the

		look and feel of FindReplace, as well as behavioral

		improvements.

-------------------------------------------------------------------------------

Project description

Space for extensions and additional plugins for dijit.Editor.  The project

currently contains the following plugins:

dojox.editor.plugins.TablePlugins:

	Status: Experimental.

	The Table Plugins provide a mechanism for editing tables withing the

	dijit.Editor.  This plugin is experimental and does not work correctly

	in all dojo supported browsers.

dojox.editor.plugins.UploadImage:

	Status: Experimental.

	The UploadImage plugin makes use of the dojox upload widgets to provide

	a mechanism to upload images to your server for use in the editor.

dojox.editor.plugins.PrettyPrint:

	Status: Supported (stable).

	The PrettyPrint plugin provides a mechanism by which the output from

	editor.getValue()/editor.attr("value") is nicely formatted.  Optional

	format parameters are how many spaces to indent by (default is tab),

	the maximum text line length (not including indent), and what

	characters in text strings should be encoded to their &<enc>;

	representation.

dojox.editor.plugins.PageBreak:

	Status: Supported (stable).

	A simple plugin that allows you to insert 'page breaks' into the doc

	being edited.  These page break styles will then cause the document

	to break to another page when printed.

dojox.editor.plugins.ShowBlockNodes:

	Status: Supported (stable).

	A simple plugin that allows you to toggle on and off a CSS 'view' of

	how the page is laid out in terms of the block nodes used for its

	formatting.

dojox.editor.plugins.Save:

	Status: Supported (beta).

	A simple plugin that allows you to POST the content of the editor back

	to a URL.

dojox.editor.plugins.Preview:

	Status: Supported (beta).

	A simple plugin that allows you to display the content of the editor

	in a new window and apply a set of styles to it so you can see how

	content will look with various styles applied.  It is likely this

	plugin will still evolve a bit.

dojox.editor.plugins.ToolbarLineBreak:

	Status: Supported (stable).

	An extremely simple plugin that allows you to 'linebreak' the dijit toolbar so that really long

	toolbars for editor (lots of plugins enabled), can be broken up into multiple rows.

dojox.editor.plugins.InsertEntity:

	Status: Experimental (unsupported).

	A plugin that enables the ability to insert HTML/XML entity characters

	into a page.  These are often called 'symbols'.  The set it provides are the

	basic latin (8859) set and a portion of greek symbols common to mathematics.

	It has been marked experimental as it is likely this plugin will evolve a bit.

dojox.editor.plugins.NormalizeIndentOutdent:

	Status: Experimental (unsupported).

	A plugin that normalizes the behavior of indent/outdent to use margin styles instead

	of <blockquote> tags.  Also fixes indent/outdent of lists to work properly.  This is new

	and has been tested, but not extensively.  Therefore it is currently classed as experimental.

dojox.editor.plugins.Breadcrumb:

	Status: Experimental (unsupported).

	A plugin that adds a breadcrumb toolbar to the bottom of the editor.  Useful for seeing

	where you aren and what operations you can perform.  This is new and has been tested, but not

	extensively.  Therefore it is currently classed as experimental.

dojox.editor.plugins.FindReplace:

	Status: Experimental (unsupported).

	A plugin that adds a togglable Find/Replace toolbar to the editor.  Useful for searching

	and replacing text strings in the editor content.  Only works on FF, IE, and WebKit.  No Opera

	support.  This is new and has been tested, but not extensively.  Therefore it is currently

	classed as experimental.

dojox.editor.plugins.CollapsibleToolbar:

	Status: Supported (Stable).

	A plugin that modified the header node of the editor so that it is 'collapsible'.  Meaning that

	it can be closed (reduced), and reopened.  Useful for increasing editor real-estate.

dojox.editor.plugins.Blockquote:

	Status: Supported (Stable).

	A plugin that puts a button on the toolbar that allows users to select text for a semantic

	'blockquote' tag-wrap action.  It toggles on and off during state changes to determine if

	the current section is contained within a blockquote.

dojox.editor.plugins.PasteFromWord:

	Status: Beta (unsupported).

	A plugin that puts a button that opens a dialog to paste in content from Word and similar

	programs like wordpad.  It will then filter out extraneous and bad html from the content

	before injecting it into the RTE.   Experimental as the filter list may not be complete yet.

	Feedback is welcome and appreciated.  Filters will be updated based on it.

dojox.editor.plugins.InsertAnchor:

	Status: Stable (supported).

	A plugin that allows anchor points to be inserted into the document being edited.

	The anchors are styled in the doc to make them easily visible/editable in the document.

dojox.editor.plugins.TextColor:

	Status: Experimental (unsupported).

	A plugin that makes use of the dojox.widget.ColorPicker widget in lieu of the

	dijit.ColorPalette.

dojox.editor.plugins.NormalizeStyle:

	Status: Experimental (unsupported).

	A plugin that tries to normalize the output from the editor as either CSS styled or semantic (<b>, <i>, etc)

	style.

dojox.editor.plugins.StatusBar:

	Status: Experimental (unsupported).

	A plugin that adds a status bar and an optional resize handle to the footer of the editor.

-------------------------------------------------------------------------------

Dependencies:

dijit

dojox.form

dojox.html.format

dojox.widget.ColorPicker

dojox.layout.ResizeHandle

-------------------------------------------------------------------------------

Documentation

The plugins directory contains extensions which work with dijit.Editor.

See also:

	http://docs.dojocampus.org/dojox/editor/plugins/TablePlugins

	http://docs.dojocampus.org/dojox/editor/plugins/PrettyPrint

	http://docs.dojocampus.org/dojox/editor/plugins/PageBreak

	http://docs.dojocampus.org/dojox/editor/plugins/ShowBlockNodes

	http://docs.dojocampus.org/dojox/editor/plugins/Preview

	http://docs.dojocampus.org/dojox/editor/plugins/Save

	http://docs.dojocampus.org/dojox/editor/plugins/ToolbarLineBreak

	http://docs.dojocampus.org/dojox/editor/plugins/InsertEntity

	http://docs.dojocampus.org/dojox/editor/plugins/NormalizeIndentOutdent

	http://docs.dojocampus.org/dojox/editor/plugins/Breadcrumb

        http://docs.dojocampus.org/dojox/editor/plugins/FindReplace

        http://docs.dojocampus.org/dojox/editor/plugins/CollapsibleToolbar

	http://docs.dojocampus.org/dojox/editor/plugins/Blockquote

	http://docs.dojocampus.org/dojox/editor/plugins/PasteFromWord

	http://docs.dojocampus.org/dojox/editor/plugins/InsertAnchor

	http://docs.dojocampus.org/dojox/editor/plugins/TextColor

	http://docs.dojocampus.org/dojox/editor/plugins/NormalizeStyle

	http://docs.dojocampus.org/dojox/editor/plugins/StatusBar

-------------------------------------------------------------------------------

Plugin Installation instructions

Get dojo and dijit from svn. Include the Editor and plugins in your page:

dojo.require("dijit.Editor");

For the TablePlugins:

	dojo.require("dojox.editor.plugins.TablePlugins");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/editorPlugins.css" type="text/css" rel="stylesheet" />

For the UploadImage plugin:

	dojo.require("dojox.editor.plugins.UploadImage");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/editorPlugins.css" type="text/css" rel="stylesheet" />

	<link href="[path]dojox/form/resources/FileInput.css" type="text/css" rel="stylesheet" />

For the PrettyPrint plugin:

	dojo.require("dojox.editor.plugins.PrettyPrint");

	and CSS:

	No CSS required.

For the PageBreak plugin:

	dojo.require("dojox.editor.plugins.PageBreak");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/PageBreak.css" type="text/css" rel="stylesheet" />

For the ShowBlockNodes plugin:

	dojo.require("dojox.editor.plugins.ShowBockNodes");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/ShowBlockNodes.css" type="text/css" rel="stylesheet" />

For the Preview plugin:

	dojo.require("dojox.editor.plugins.Preview");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/Preview.css" type="text/css" rel="stylesheet" />

For the Save plugin:

	dojo.require("dojox.editor.plugins.Save");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/Save.css" type="text/css" rel="stylesheet" />

For the ToolbarLineBreak plugin:

	dojo.require("dojox.editor.plugins.ToolbarLineBreak");

	and CSS:

	No CSS required.

For the InsertEntity plugin:

	dojo.require("dojox.editor.plugins.InsertEntity");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/InsertEntity.css" type="text/css" rel="stylesheet" />

For the NormalizeIndentOutdent plugin:

	dojo.require("dojox.editor.plugins.NormalizeIndentOutdent");

	and CSS:

	No CSS required.

For the Breadcrumb plugin:

	dojo.require("dojox.editor.plugins.Breadcrumb");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/Breadcrumb.css" type="text/css" rel="stylesheet" />

For the FindReplace plugin:

	dojo.require("dojox.editor.plugins.FindReplace");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/FindReplace.css" type="text/css" rel="stylesheet" />

For the CollapsibleToolbar plugin:

	dojo.require("dojox.editor.plugins.CollapsibleToolbar");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/CollapsibleToolbar.css" type="text/css" rel="stylesheet" />

For the Blockquote plugin:

	dojo.require("dojox.editor.plugins.Blockquote");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/Blockquote.css" type="text/css" rel="stylesheet" />

For the PasteFromWord plugin:

	dojo.require("dojox.editor.plugins.PasteFromWord");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/PasteFromWord.css" type="text/css" rel="stylesheet" />

For the InsertAnchor plugin:

        dojo.require("dojox.editor.plugins.InsertAnchor");

        and CSS:

        <link href="[path]dojox/editor/plugins/resources/css/InsertAnchor.css" type="text/css" rel="stylesheet" />

For the TextColor plugin:

	dojo.require("dojox.editor.plugins.TextColor");

	and CSS:

	<link href="[path]dojox/editor/plugins/resources/css/TextColor.css" type="text/css" rel="stylesheet" />

For the NormalizeStyle plugin:

	dojo.require("dojox.editor.plugins.NormalizeStyle");

	and CSS:

	No CSS required.

For the StatusBar plugin:

        dojo.require("dojox.editor.plugins.StatusBar");

        and CSS:

        <link href="[path]dojox/editor/plugins/resources/css/StatusBar.css" type="text/css" rel="stylesheet" />

See tests for examples:

	dojox/editor/tests/editorTablePlugs.html

	dojox/editor/tests/editorUploadPlug.html

	dojox/editor/tests/editorPrettyPrint.html

	dojox/editor/tests/editorPageBreak.html

	dojox/editor/tests/editorShowBlockNodes.html

	dojox/editor/tests/editorPreview.html

	dojox/editor/tests/editorSave.html

	dojox/editor/tests/editorToolbarLineBreak.html

	dojox/editor/tests/editorInsertEntity.html

	dojox/editor/tests/editorNormalizeIndentOutdent.html

	dojox/editor/tests/editorBreadcrumb.html

	dojox/editor/tests/editorFindReplace.html

	dojox/editor/tests/editorCollapsibleToolbar.html

	dojox/editor/tests/editorBlockquote.html

	dojox/editor/tests/editorPasteFromWord.html

	dojox/editor/tests/editorInsertAnchor.html

	dojox/editor/tests/editorTextColor.html

	dojox/editor/tests/editorNormalizeStyle.html

	dojox/editor/tests/editorStatusBar.html

	dojox/editor/tests/testPluginsAll.html