Metadata-Version: 1.1
Name: plock
Version: 0.0.3
Summary: Plock is a Plone Installer for the Pip-loving Crowd
Home-page: https://github.com/aclark4life/plock
Author: Alex Clark
Author-email: aclark@aclark.net
License: Whatever license Plone is
Description: plock
        =====
        
        Plock is a Plone Installer for the Pip-loving Crowd
        
        .. Note:: Installing Plone with Plock requires an internet connection. If you want to install Plone offline, try `Plone's Unified Installer <http://plone.org/download>`_.
        
        .. Warning:: Installing Plone with Plock is inherently insecure because it relies on a remote hosted configuration file(s) that in theory could be compromised during a MITM-attack.
        
        Installation
        ------------
        
        .. Note:: Plock supports the latest release (and only the latest release) of Plone, currently Plone 4.3.
        
        Installing Plone with Plock looks like this::
        
            $ pip install plock
            $ bin/install-plone
            $ bin/plone fg
        
        Configuration
        -------------
        
        Plone uses `Buildout <https://pypi.python.org/pypi/zc.buildout>`_ to manage its installation and configuration. Plock creates a ``buildout.cfg`` file for you that looks like this::
        
            [buildout]
            extends = https://raw.github.com/pythonpackages/buildout-plone/master/latest
        
            [plone]
            eggs +=
            # Add-ons go here e.g.:
            #    Products.PloneFormGen
        
        Add-ons 
        ~~~~~~~
        
        .. Warning:: Plock lists packages on PyPI with a description, keyword, or summary containing "plone". Results may include packages that are not installable in the current release of Plone. This issue may be addressed in a future release of plock.
        
        To list available add-ons::
        
            $ bin/install-plone --list-addons
        
        To install add-ons, add the desired Python package name(s) to the ``eggs +=`` parameter e.g.::
        
            [buildout]
            extends = https://raw.github.com/pythonpackages/buildout-plone/master/latest
        
            [plone]
            eggs +=
                Products.PloneFormGen
        
        Stop Plone and run Buildout::
        
            $ bin/buildout
        
        Start Plone::
        
            $ bin/plone fg
        
        Install the add-on(s) in Plone via Site Setup -> Add-ons.
        
        Changelog
        =========
        
        0.0.3 (2013-07-22)
        ------------------
        
        - List add-ons with bin/install-plone --list-addons
        
        0.0.2 (2013-07-19)
        ------------------
        
        - Provide add-on installation instructions
        - Write local ``buildout.cfg`` instead of relying on -c remote_cfg.cfg
        
        0.0.1 (2013-07-15)
        ------------------
        
        - Initial release
        
Keywords: pip plone
Platform: UNKNOWN
Classifier: Framework :: Plone :: 4.3
Classifier: Programming Language :: Python :: 2.7
