wiki:CkEditorPlugin

Version 5 (modified by itamarost, 4 years ago) (diff)

added installation instructions and full_integration disclaimer

CKEditor Wysiwyg Plugin

Description

Wysiwyg wiki editor plugin using the open-source CKEditor, inspired by TracWysiwygPlugin.

NOTE: The full_integration mode is not recommended for use in production! It is still experimental, and under massive development.

The plugin does not contain the CKEditor source (get it from their SVN - require >= 3.6). After installation of both the plugin and CKEditor, set the [ckeditor] editor_source option for this plugin to the path of the CKEditor ckeditor.js script.

The plugin has 3 modes of integration, determined by the [ckeditor] editor_type option:

html_wrapper CKEditor with HTML output wrapped in html-processor
full_integration CKEditor with TracWiki output (experimental, under development)
none No integration - plain old textarea

The full_integration mode is the holy grail, but currently just a handful of elements are supported in this mode (see the tracwiki plugin for details on that) - help with this is needed!

Disclaimer:

  • Does not co-exist with TracWysiwygPlugin - have only one of them enabled.
  • When using the html_wrapper mode and editing an existing wiki page, the page will be rendered in HTML upon save (macros are lost, etc.)

Help Wanted

Help wanted for further development:

  • Killer Feature: Support TracWiki syntax (by HTML<->TracWiki conversions? or by making CKEditor's rendering engine emit TracWiki?)
  • Insert WikiLinks using cool dialogs (e.g. choose existing page from TitleIndex, insert link to stubbed page & open new tab to create the stubbed page)
  • Insert other kinds of TracLinks using cool dialogs (changesets, tickets, other resources...)
  • Insert images intuitively (selector from attachments / repositories / upload from file-system as attachment or into repository, maybe even drag-and-drop)
  • Macro-awareness - select macro to insert from supported macros, expand inserted macros inline

Bugs/Feature Requests

Existing bugs and feature requests for CkEditorPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out CkEditorPlugin from here using Subversion, or browse the source with Trac.

Installation

Install the plugin:

easy_install http://trac-hacks.org/svn/ckeditorplugin/trunk

Get the CKEditor package and deploy it in a URL-accessible path, e.g. the htdocs directory of your Trac environmemt:

$ mkdir /path/to/trac-env/htdocs/js
$ svn checkout http://svn.ckeditor.com/CKEditor/releases/stable /path/to/trac-env/htdocs/js/ckeditor

Enable it from the Plugins section of the Administration panel, or by adding the following to the [components] section of your trac.ini:

[components]
ckintegration.* = enabled

The following options can be specified in the [ckeditor] section of your trac.ini (default values shown):

[ckeditor]
editor_type = html_wrapper # mode of integration, as explained above
editor_source = sites/js/ckeditor/ckeditor.js # The URL where CKEditor was installed (the default matches the example above for deploying CKEditor)

Example

Recent Changes

[14145] by framay on 2014-09-01 16:02:36

refs #11330: avoid error with Genshi 0.7:

UnicodeError: source returned bytes, but no encoding specified
[10922] by framay on 2011-11-16 08:28:09
fixes #8850, #8851, #8852: implemented a lot of new functionalities, so named this version 1.1dev
[10921] by framay on 2011-11-16 08:22:33
tagging old version 1.0dev, before replacing by 1.1dev
[10271] by itamarost on 2011-06-10 09:04:13
fixes #8867
[10258] by itamarost on 2011-06-04 18:59:35
Add various ignore patterns (Eclipse stuff, Pydev stuff, Git & hg stuff)

Author/Contributors

Author: Edan Maor, itamarost
Maintainer: itamarost
Contributors:

Attachments (1)

Download all attachments as: .zip