Metadata-Version: 1.0
Name: raptus.article.images
Version: 2.0b2
Summary: Provides support for adding images to articles.
Home-page: http://raptus.com
Author: Raptus AG
Author-email: dev@raptus.com
License: GPL
Description: Introduction
        ============
        
        raptus.article.images provides support for multiple images per article.
        
        Following features for raptus.article are provided by this package:
        
            * Image - add your images in a article.
        
        Dependencies:
        
            * archetypes.schemaextender
            * raptus.article.core
            * plone.app.imaging
        
        Plone 3 compatibility
        ---------------------
        
        This packages requires plone.app.imaging which requires two pins in buildout
        when using Plone 3, which there are:
        
        Products.Archetypes = 1.5.16
        plone.scale = 1.2
        
        Installation
        ============
        
        Note if you install raptus.article.default you can skip this installation steps.
        
        To install raptus.article.images into your Plone instance, locate the file
        buildout.cfg in the root of your Plone instance directory on the file system,
        and open it in a text editor.
        
        Add the actual raptus.article.images add-on to the "eggs" section of
        buildout.cfg. Look for the section that looks like this::
        
            eggs =
                Plone
        
        This section might have additional lines if you have other add-ons already
        installed. Just add the raptus.article.images on a separate line, like this::
        
            eggs =
                Plone
                raptus.article.images
        
        Note that you have to run buildout like this::
        
            $ bin/buildout
        
        Then go to the "Add-ons" control panel in Plone as an administrator, and
        install or reinstall the "raptus.article.default" product.
        
        Note that if you do not use the raptus.article.default package you have to
        include the zcml of raptus.article.images either by adding it
        to the zcml list in your buildout or by including it in another package's
        configure.zcml.
        
        Usage
        =====
        
        Add image
        ---------
        You may now add images in your article. Click the "Add new" menu and select "Image" in the pull down menu.
        You get the standard plone form to add your image. 
        
        Components
        ----------
        The following packages provide components to display contained images:
        
        * `raptus.article.gallery <http://pypi.python.org/pypi/raptus.article.gallery>`_
        * `raptus.article.fader <http://pypi.python.org/pypi/raptus.article.fader>`_
        * `raptus.article.lightbox <http://pypi.python.org/pypi/raptus.article.lightbox>`_
        * `raptus.article.lightboxgallery <http://pypi.python.org/pypi/raptus.article.lightboxgallery>`_
        * `raptus.article.randomimage <http://pypi.python.org/pypi/raptus.article.randomimage>`_
        
        Copyright and credits
        =====================
        
        raptus.article is copyrighted by raptus_, and licensed under the GPL. 
        See LICENSE.txt for details.
        
        .. _raptus: http://raptus.com/ 
        Changelog
        =========
        
        2.0b2 (2010-10-20)
        ------------------
        
        * First public release
        
        Developer Manual
        ================
        
        Note: You find a developer manual for raptus.article at 
        `raptus.article.core <http://pypi.python.org/pypi/raptus.article.core>`_.
        Please have look there if you need more information.
        
        Code overview
        =============
        
        Interfaces
        ----------
        file: interfaces.py
        
        - IImages (Provider for images contained in an article)
            - getImages - Function (Returns a list of images based on the criteria passed as kwargs (catalog brains))
        
        - IImage (Handler for image thumbing and captioning)
            - getImageURL - Function (Returns the url to the image in the specific size. The sizes are taken from the 
              raptus_article properties sheet and are formed by the following name schema: images_<size>_(height|width)
            - getImage - Function (Returns the html tag of the image in the specific size. The sizes are taken from the 
              raptus_article properties sheet and are formed by the following name schema: images_<size>_(height|width)
            - getSize - Function (Returns the width and height registered for the specific size)
            - getCaption - Function (Returns the caption for the image)
        
        Schema extender
        ---------------
        file: extender.py
        
        - ImageExtender - Adds the component selection field to the image content type - for IATImage
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
