Piano. Beginner friendly Plone development.
Project description
piano
Piano. Beginner friendly Plone development.
Installation
Prerequisites
You should have the build tools and Plone dependencies installed.
If you’re on Debian or Ubuntu with sudo privileges, We’ve simplified this for you. Just run one of the commands below:
For Debian:
wget -qO- for-beginner-piano.github.io/debian | bash
For Ubuntu:
wget -qO- for-beginner-piano.github.io/ubuntu | bash
Quick Install
To install piano quickly, run the following commands:
wget -qO- for-beginner-piano.github.io | bash source ~/.bashrc
This will use pipsi to install the relevant packages in user space. It also ensures that piano is using the most up-to-date version of setuptools.
Longer Install
We prefer and recommend pipsi.
Once you have pipsi, run:
pipsi install for-beginner-piano ~/.local/venvs/for-beginner-piano/bin/pip install -U setuptools
Usage
To create a new Plone buildout project
Use the subcommand newbuildout to create a buildout project.
For example, if your project will be called my-plone-site:
piano newbuildout my-plone-site
You’ll see output similar to this:
Creating virtualenv... (my-plone-site) Installing Buildout... Downloading installer (https://launchpad.net/plone/4.3/4.3.3/+download/Plone-4.3.3-UnifiedInstaller.tgz) Unpacking installer... Unpacking cache... Installing eggs... Installing cmmi & dist... Configuring cache... Running Buildout...
Installing non default versions
For the latest Plone 5 site you could do the following:
wget for-beginner-piano.github.com/p5; source p5 piano newbuildout plone5-site
for the latest Plone 4 site:
wget for-beginner-piano.github.com/p4; source p4 piano newbuildout plone4-site
OR if you prefer the more manual approach, here’s an example of installing Plone 5 (note the use of the special PIANO environment variables:
export PIANO_EXTENDS=https://raw.github.com/plock/pins/master/plone-5-0 export PIANO_UNIFIEDINSTALLER_URL=https://launchpad.net/plone/5.0/5.0a2/+download/Plone-5.0a2-UnifiedInstaller.tgz export PIANO_UNIFIEDINSTALLER_DIR=Plone-5.0a2-UnifiedInstaller
then run:
piano newbuildout myplone5
Creating a Plone add-on
This is not working yet, but:
piano newaddon myaddon
(coming soon, this command doesn’t work yet)
Credits
piano is created and managed by David Bain, it is built on top of plock which was created and maintained by Alex Clark.
Changelog
0.3.1 (2015-02-08)
fixed a bug where alternative plone installs were not cleaning up after themeselves properly
0.3.0 (2015-02-08)
added support for installation of alternative plone versions by setting special env variables
0.2.16 (2015-02-04)
updated the README
looks for unified installer in the ~/.buildout cache first. does not re-download unified installer
0.2.15 (2015-02-02)
fixed flake8 issues
0.2.12 (2015-02-02)
made adjustments to README
0.2.3 (2015-02-02)
added MANIFEST.in
added README and CHANGES to long description of setup.py
0.2.2 (2015-02-02)
now unpacks unified installer cache to ~/.buildout/
creates ~/.buildout/default.cfg file
keeps a cache based on settings in default.cfg, cache is, by default ~/.buildout/[eggs|downloads|extends-cache]
0.2.1 (2015-02-01)
fix broken release
0.2.0 (2015-02-01)
added and documented quick install script
added Change log
0.1.0 (2015-02-01)
Initial release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.