aws.zope2zcmldoc

by Alter Way Solutions — last modified Nov 02, 2011 02:42 PM

ZCML documentation browser for Zope 2

Project Description

aws.zope2zcmldoc

aws.zope2zcmldoc

An additional Zope 2 control panel that renders the live ZCML documentation, this means the ZCML that is installed in your Zope instance, including the ZCML vocabulary provided by the third party components. Read more details and have a look at some screenshots in this blog post.

Intended audience

This component is clearly dedicated to Zope developers and integrators. This component does not provide features for the end user.

Works with

aws.zope2zcmldoc has been tested with Zope 2.10 to Zope 2.13. It may or may not work with earlier or later versions of Zope.

Tests reports with other Zope versions, and related contributions are welcome (note that supporting Zope 2.8 and earlier versions is not considered).

Installation

With zc.buildout and plone.recipe.zope2instance, you just need to add this in your buildout.cfg file

...
[instance]
recipe = plone.recipe.zope2instance
...
eggs =
    ...
    aws.zope2zcmldoc
    ...
# You don't need this if you have Plone 3.3 or later in the eggs list
zcml =
    ...
    aws.zope2zcmldoc
    ...

Control panel creation

Sorry for the impatients but I did not find the way to automate the creation of a new Zope 2 control panel at Zope startup. In order to complete the installation, and install the control panel entry, open a browser in your Zope root as Manager and type in your address bar:

http://<your-zope-root>/@@install-aws-zope2zcmldoc

Now go to the Zope Control Panel and learn the various ZCML namespaces, elements and attributes.

Uninstallation

Before removing the aws.zope2zcmldoc from your buildout.cfg and rebuilding your instance, you may want to remove the control panel entry.

Removing the Control Panel entry is not essential, but if you don't do this, a slate entry will be left in the Zope Control Panel of your Zope instance.

Start your Zope instance, open a browser in your Zope root as Manager and type in your address bar:

http://<your-zope-root>/@@uninstall-aws-zope2zcmldoc

License

This software is licensed under GNU GPL available here: http://www.gnu.org/licenses/gpl.html

Contributors

Changelog

1.1.0

  • Missing spanish translations added [macagua]

1.1.0rc1

  • Code cleanup with pyflakes and pep8 [glenfant]
  • Removed useless <tal:comment ... stuff in templates: more compact, easear to read and maintain, less ZPT processing. [glenfant]
  • Added French translation [glenfant]
  • Added locales update utility in pure Python such developers with a Windows box can contribute. [glenfant]
  • The UI can be forced to English, translations of ZCML docs might be inconsistent. [glenfant]

1.0.0

  • Added support Spanish translation. [macagua]
  • Added support for i18n. [macagua]
  • Added a minimal set of unit tests. [glenfant]
  • Tested with Zope 2.13 (thanks to Mautits van Rees). [glenfant]
  • Added z3c.autoinclude awareness with Plone (3.3 +). [glenfant]
  • Some explanations about missing "zcml" namespace on Zope 2.12 and earlier versions. [glenfant]

1.0.0b1

  • Some rationale refactorings in view and templates [glenfant]
  • A sexy layout (as possible in a ZMI context) [glenfant]

1.0.0a1

  • Initial release [glenfant]

Current Release
aws.zope2zcmldoc 1.1.0

Released Nov 02, 2011 — tested with Plone 4.1, Plone 4, Plone 3

Same code as 1.1.0rc1, with the add of missing spanish translations.
More about this release…

Download file Get aws.zope2zcmldoc for all platforms
aws.zope2zcmldoc-1.1.0.tar.gz
If you are using Plone 3.2 or higher, you probably want to install this product with buildout. See our tutorial on installing add-on products with buildout for more information.

All Releases

Version Released Description Compatibility Licenses Status
1.1.0rc1 Nov 02, 2011 * UI small improvements, * French and Spanish translations (please contribute for other languages) * Possible to force full english whatever browser preferences More about this release…
Plone 4.1
Plone 4
Plone 3
 GPL release-candidate
1.1.0 Nov 02, 2011 Same code as 1.1.0rc1, with the add of missing spanish translations. More about this release…
Plone 4.1
Plone 4
Plone 3
 GPL final

Comments (0)