Comiotto Thomas wrote:
Hi devs
I have attached Neutron support for 1.2.X to the Bugzilla.
very cool :-) Can you send a pointer to Bugzilla entry?
Thanks
Michi
For information about Neutron check
http://www.wyona.org/osr-101/index.html.
Below a short README (could go to a Wiki page).
--
Bests
Thomas
++++++
README
Neutron is a Protocol for remote content authoring. Check
http://www.wyona.org/osr-101/index.html for more information. Lenya
1.2.X currently supports the following Neutron remote operations:
- Entering a Neutron request/response chain by document introspection.
- Neutron authentication for embedded and stand-alone clients.
- Open/save document
- Checkin/out document
- Lock/unlock document
- Document styling by xslt for WYSIWYG editing
AVAILABLE CLIENTS
Currently the only Neutron enabled client is Ulysses. Ulysses is GPL
licenced and available for download at http://demo.ulysses.wyona.org/.
RELEVANT FILES
- Neutron authentication and introspection (webapp/sitemap.xmap)
- Neutron usecase matchers
(/lenya/webapp/lenya/usecases/neutron/usecase-neutron.xmap)
- Flowscript with usecase related methods
(/lenya/webapp/lenya/usecases/neutron/neutron.js)
- jx-templates for protocol messages
(/lenya/webapp/lenya/usecases/neutron/jx)
USAGE
A Neutron request/response chain is initiated by parsing an
introspection file. Introspection files contain commandURLs and
client configuration directives needed for remote operation.
Neutron clients can be pointed to an introspection file by embedding
introspection links into accessible resources (web pages for
instance). To enable Neutron support for your Lenya publication add
the following directive to the <head> tag of the web pages generated
by Lenya:
<link href="?lenya.usecase=neutron&lenya.step=introspect"
type="application/neutron+xml" rel="neutron-introspection" />
This will enable Neutron enabled clients to edit the underlying
source of the requested document.
WYSIWYG EDITING
Neutron has support for WYSIWYG editing based on xslt stylesheets,
whereas the server has to provide a stylesheet that transforms the
editable document source to xhtml. Because document styling depends
on the document type, Lenya 1.2.X Neutron styling directives have to
be configured on publication level. To enable Neutron WYSIWYG-editing
do the following:
1. Copy introspection.jx from
webapp/lenya/usecases/neutron/jx/introspection.jx to
{yourpub}/lenya/usecases/neutron/jx/introspection.jx
2. Add the following to the copied introspection file (or uncomment
if already there):
<edit>
..
<styles>
<style
href="${cocoon.parameters['base-url']}${cocoon.parameters['document-
url']}?lenya.usecase=neutron&lenya.step=xsl"/>
</styles>
</edit>
3. Copy the file neutron-styles.xmap from the default publication to
{yourpub}/lenya/usecases/neutron. This file contains a usecase
matcher that generates the xslt sent to the client. The relevant part
of the file is:
<map:match type="usecase" pattern="neutron">
<map:match type="step" pattern="xsl">
.. <!-- add the code generating a xslt providing for a
document2xhtml transform here. -->
</map:match>
</map:match>
4. Your done.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
--
Michael Wechner
Wyona - Open Source Content Management - Apache Lenya
http://www.wyona.com http://lenya.apache.org
[EMAIL PROTECTED] [EMAIL PROTECTED]
+41 44 272 91 61
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
