Readme file for ZopeEditManager 0.8

Zope Edit Manager

Zope Edit Manager is a wrapper application for Casey Duncan's excellent External Editor for Mac OS X, allowing Mac users the same level of flexibility in editors and number of concurrent edits.

The Problem

Using the current Mac OS X Solution: http://zope.org/Members/Feneric/ExtEditMacOSX will only get you part of the way to <textarea> freedom. Specifically, it only allows for applications that have either a CLI component, like BBEdit, or that are bundle applications with an easily attainable executable file, mostly limited to Cocoa applications.

In addition, because of the way Mac OS X approaches applications, you can only have one External Editor process going at a time. Unlike Windows and UNIX/X11 applications, Mac OS X native applications have one runtime instance.

The Solution

Taking Casey's work to the next level for Mac OS X users, I replicated his work using the PyObjC bridge, creating a native, Mac OS X application to act as manager for all External Editor processes. This means that you can specify any Mac OS X application (Carbon or Cocoa) to act as the editor for a MIME type, type group, or Zope meta_type. And you can have as many concurrent edits as you like, since all edits are proxied through a single application.

Using It

Drag the ZopeEditManger application to the Applications folder in your hard drive or home directory. You can use the built-in preferences, one of the supplied preference files, or edit your own.

Configuring your Browser

Currently, the only browser fully set to work with ZopeEditManager is Mozilla. Internet Explorer supports the configuration of File Helpers, but I've been unable to get it working quite right. In any case, other browsers will download a particular file. That file can be dragged onto the ZopeEditManager icon and it will work fine. To enable ZopeEditManager in Mozilla, select the Helper Applications pane from the Navigator group, and create a New Type called application/x-zope-edit, and choose ZopeEditManager with the Application picker.

Configuration

The configuration file has changed since version 0.7. ZopeEditManager now provides a means to automatically upgrade your preference file, if you've modified it past the defaults.

ZopeEditManager also now sports a GUI Preferences panel. Just choose "Preferences..." from the ZopeEditManager menu, or press Command-, to open the window.

Options

The available options for ZopeEditManager are (names in parentheses are the corresponding key names in the Preferences plist):

General Prefs

Cleanup Files (cleanup_files) Whether to delete the temp files created.

WARNING the temp file coming from the browser contains authentication information and therefore setting this to is a security risk, especially on shared machines. If set to , that file is deleted at the earliest opportunity, before the editor is even spawned. Set to for debugging only.

Save Interval (save_interval) The interval in seconds that the helper application checks the edited file for changes.

Confirm on Finish (confirm_on_finish) When you are finished locally editing a file, ZopeEditManager will ask you to confirm this. You can disable this behavior by unchecking this button.

User WebDAV Locks (use_locks) Whether to use WebDAV locking. The user editing must have the proper WebDAV related permissions for this to work.

Always borrow WebDAV Locks (always_borrow_locks) When use_locks is enabled this features suppresses warnings when trying to edit an object you have already locked. When enabled, external editor will always "borrow" the existing lock token instead of doing the locking itself. This is useful when using CMFStaging for instance. If omitted, this option defaults to .

temp_dir Path to store local copies of object data being edited. Defaults to operating system temp directory. (This preference is currently unsupported in the Preference Panel; however, it can be set by manually editing the .plist file)

Helper Apps Prefs

Type Either the meta_type of the Zope object, or the MIME type of the file it would represent.

Extension (extension) The file extension to add to the content file. Allows better handling of images and can improve syntax highlighting.

Editor (editor) Application name used to invoke the editor application.

Conclusion

I hope you enjoy using this software. If you have any comments, suggestions or would like to report a bug, send an email to the author:

Zachery Bir