INSTALLING

This should self-install on most uinx-flavors.  But see fckg/fckeditor/Install_README
for info on where the media files are uploaded to and how to change the appearance
of the tool bar.

If you have DokuWikiFCK installed you must remove the DokuWikiFCK fckg directory from the 
plugins directory, since the two editors have command elements and fckgLite still uses the
fckg directory for its plugin directory.
---------------

ABOUT

fckgLite is a Javascript implementation the the FCKeditor. It is not a fully
graphical editor (unlike DokuWikiFCK).  Rather, it saves its documents in native
DokuWiki format and can therefore do only those things that the native
DokuWiki editor is capable of, which for many users is a benefit.  

Unlike DikuWikiFCK,it does not require Perl or any Perl modules.  So, installation
is simplified.

fckgLite is built on the architecture of DokuWikiFCK and retains many of its benefits. 
It is tied into the DokuWiki lock time-out and auto-draft system. It can still
switch between the FCKeditor and the native DokuWiki editor, as well as switch
between the FCKediting Window and an FCKeditor Preview Window. 

It supports all of DokuWiki's syntax markup except for email-style quoting and  
the php and html tags,which confuse the FCKeditor

You can still paste text into the editing window from external documents; it will
keep the vertical formatting but not the horizontal, that is like DokuWiki, it
produces left-aligned text. As long as the text is left aligned, it can create
lines of different lengths. For instance:

You can have this
kind of text on your page.

Then skip on to a standard full paragraph length which runs over several lines
of text, such as this.  The FCKeditor will allow you to indent a line but when the file is
saved, the indented line will move back to the left-hand margin, since fckgLite
removes all leading spaces--otherwise the text will be mistaken for a non-parsed
block. In fckgLite non-parsed blocks are created using the "Style" menu.

Its media and link tools (as withDokuWikiFCK) are still tied into the DokuWiki
media directory, which means that if you switch between the FCKeditor and the
native DokuWiki editor, you will always have access to your media.
  


---------------
TOOLBAR

The toolbar is self-explanatory and contains almost all the features available to
DokuWiki.  Below are some details about non-evident toolbar features.

Headers:
from the drop-down Format menu on the tool bar, you can create DowkuWiki headers (h1-h5). 
this menu also has a menu item named 'Normal'.  You can apply this to header and
they will return to ordinary type; you can also apply Normal to non-parsed blocks to 
remove them.

Non-parsed blocks and monospace:
from the drop-down Style Menu on the tool bar, you can create non-parsed blocks and
apply standard DokuWiki markup for bold, italic, etc.

When creating non-parsed blocks, it is recommended that you place 
them above a above a new line, or the cursor might get stuck inside the block.

Images
To either upload or select an image, click on the Image icon to bring up the Image
Properties dialogue.  You can upload either by clicking on the upload tab or
the "Browse Server" button.  

Images can be sized and aligned using the Image Properties dialogue.  If you want to change
any of these values after an image has been selected, right click on the image and 
select Image Properties; the dialgoue will pop up and let you change any of the 
values, including the image itself.


Links
fckgLite supports three types of links, which are  available from the "Link Type" drop down
menu:  URL, Dokuwiki Internal Link, and SMB share.  

To upload files for linking, click on the uplod tab or on the "Browse Server" tab.

Smileys:
you can use FCKeditor's smileys chooser or type a DokuWiki smiley Text directly into the file,
for instance FIXME. The Fckeditor's smiley is inserted immiadately, as an image; the
Dokuikwi Text will be converted to an image after the page is saved.

Cutting and Pasting 
you can paste directly into the editing window.  
all vertical line-spacing and line-widths with be retained.

Spellchecker
the spellchecker is the same as in DokuWikiFCK; for instructions on how to install
language support, see the DokuWikiFCK documentation:
   http://www.mturner.org/dwfck/doku.php?id=installation#dokuwikifck_tools_and_toolbar_extensions


The LineBreak to Paragraph Tool (P->BR)
FCKeditor inserts a paragraph whenever you hit the return key
This tool removes the paragraphs and inserts a DokuWiki line-break:  //
In some browsers the lines do not immediately close up; so that after applying the P->BR
tool you must manually close up the line-spacing by deleting the unwanted blank lines.
To reverse this just hit the return key to re-open the line-spacing.


Special Characters Tool 
Allows for the insertion of HTML character entities. This is the same tool
as in DokuWikiFCK, except that it requires an entities file, which is in
fckg/actions/ and is named ent.ser.  You can create your own entities or add to the
standard ones included with the distribution.  See the ENTITIES.HOWTO in fckg/actions/entities,
which explains how to create a new ent.ser with your own addtions.

Plugin Tool
Apply the plugin tool to plugn syntax that you want to be renewed each
time the page is refreshed.  For plugins which place permanent text on yhour page,
just type in the plugin syntax and the text will become a permanent insert
into the page.

With plugins that use angle brackets do this:

~<~plugin_syntax~>~

then apply the plugin tool.  This escapes the angle brackets, which would
otherwise be mistaken for HTML tags by the FCKeditor after a save and then
re-edit.


For the above tools see the DokuWikFCK documentation:
     http://www.mturner.org/dwfck/doku.php?id=installation

---------------
Tables, Table headers, and Cell Properities
    To get table headers right click on the cell you want to be made into a table header
and go to cell properties. Similarly, to create colspans and td alignment, also go 
to cell properties. 
    The cell properties dialogue has many options but only those available to 
DokuWiki are supported by fckgLite.


---------------
LOCK TIME OUT AND AUTO-DRAFT SYSTEM
works as in DokuWikiFCK; again see DokuWikFCK documentation


--------------
FILE MANAGER

There are two ways to access the FCKeditor file browser.
1. There is the default style for unix-type systems, which uses
fckeditor/userfiles as the interface directory to dokuwki data/media. It
has a set of unix symbolic links to data/media which conform to the FCKeditor's
default requirements (for directory types: image, file, etc).

2. There is the system created for Windows, which directly
accesses data/media without the need for unix-style links.  

There is a checkbox in the browser which allows the user to select
the windows set-up and will work with unix systems.  There is
automatic OS detection and Windows installations should automatically
get the Windows file browser set-up.  But if the auto-detect fails,
the user can tick off this box.
