Sobre Mastering Plone

This training was created by Philip Bauer and Patrick Gerken of starzel.de to create a canonical training for future Plone developers. The aim is that anyone with the appropriate knowledge can give a training based on it and contribute to it. It is published as Open Source on github and training.plone.org.

If you want to inquire the original authors about organizing a training please contact them at team@starzel.de.

Upcoming Trainings

12. - 13. October 2015, Bucharest
by Philip Bauer, Fulvio Casali, Fred van Dijk, Franco Pellegrini and Giacomo Spettoli.

Trainers

The following trainers have given trainings based on Mastering Plone:

Leonardo Caballero
Leonardo J. Caballero G. of Maracaibo, Venezuela, is a Technical Director at Covantec R.L. and Conectivo C.A. Leonardo maintains the Spanish translations of more than 49 Plone Add-ons as well as Spanish-language documentation for Plone itself. He has contributed several Plone Add-ons that are part of PloneGov. Currently serving the Plone Board as a Plone Ambassador, Leonardo has also served as an Advisory Board member and has spoken at or helped organize Plone and open-source events throughout South America.
Philip Bauer
Philip Bauer is a web developer from Munich who fell in love with Plone in 2005 and since then works almost exclusively with Plone. A historian by education he drifted towards creating websites in the 90’s and founded the company Starzel.de in 2000. He is a member of the Plone foundation, loves teaching and is dedicated to Open Source. Among other Plone-related projects he started creating the Mastering Plone Training so that everyone can become a Plone-Developer.
Patrick Gerken
Patrick Gerken works with Python since 2002. He started working with pure Zope applications and now develops mainly with Plone, Pyramid and Javascript as well as doing what is called DevOps. He works at Starzel.de.
Steve McMahon
Steve McMahon is a long-time Plone community member, contributor and trainer. He is the creator of PloneFormGen and maintainer of the Unified installer. Steve also wrote several chapters of Practical Plone and is an experienced speaker and instructor.
Steffen Lindner
Steffen Lindner started developing Plone in 2006. He worked on small Plone sites and also with huge intranet sites. As Open Source / Free Software developer he joined the Plone core developer team 2011 and works at Starzel.de.

Usando la documentación para un entrenamiento

Siéntase libre para organizar un entrenamiento por ti mismo. Por favor, sea tan amable de aportar cualquier corrección de errores o mejoras que haya realizado en la documentación de su entrenamiento.

El entrenamiento se representa mediante la sphinx y se basa en dos sabores:

por defecto
The verbose version used for the online documentation and for the trainer. Build it in sphinx with make html or use the online version.
presentation
A abbreviated version used for the projector during a training. It should use more bullet points than verbose text. Build it in sphinx with make presentation.

Nota

By prefixing an indented block of text or code with .. only:: presentation you can control that this block is used for the presentation version only.

To hide a block from the presentation version use .. only:: not presentation

Contenido sin un prefijo sera incluido en ambas versiones.

The readthedocs theme

We slightly tweaked readthedocs theme in _static/custom.css so that it works better with projectors:

  • Comenzamos ocultar la barra de navegación mucho antes de manera que no interfiera con el texto.

  • Ampliamos el ancho predeterminado del área de contenido.

Exercises

Some additional javascript shows hidden solutions for exercises by clicking.

Just prepend the solution with this markup:

..  admonition:: Solution
    :class: toggle

Here is a full example:

Exercise 1
^^^^^^^^^^

Your mission, should you choose to accept it...

..  admonition:: Solution
    :class: toggle

    To save the world with only seconds to spare do the following:

    .. code-block:: python

        from plone import api

It will be rendered like this:

Exercise 1

Your mission, should you choose to accept it...

Solution

To save the world with only seconds to spare do the following:

from plone import api

Building the documentation locally

To build the documentation follow these steps:

$ git clone https://github.com/plone/training.git
$ cd training
$ virtualenv-2.7 .
$ source bin/activate

If you want to build the version for Plone 5 now switch to that branch:

$ git checkout plone5

Not install dependencies and build.

$ pip install -r requirements.txt
$ make html

You can now open the output from _build/html/index.html. To build the presentation version use make presentation instead of make html. You can open the presentation at presentation/index.html.

Build new

$ git clone https://github.com/plone/training.git
$ cd training
$ git checkout plone5
$ virtualenv-2.7 .
$ source bin/activate
$ pip install -r requirements.txt
$ make html
$ open _build/html/index.html

Update existing

$ git pull
$ source bin/activate
$ make html
$ open _build/html/index.html

Things to do before a training (as a trainer)

Contribuyendo

Everyone is very welcome to contribute. Minor bugfixes can be pushed direcly in the repository, bigger changes should made as pull-requests and discussed previously in tickets.

Licencia

El entrenamiento Mastering Plone es licenciado bajo la Creative Commons Attribution 4.0 International License.

Asegúrese de que ha completado el Acuerdo de contribuidor.

If you haven’t filled out a Contributor Agreement, you can still contribute. Contact the Documentation team, for instance via the mailinglist or directly send a mail to plone-docs@lists.sourceforge.net Basically, all we need is your written confirmation that you are agreeing your contribution can be under Creative Commons. You can also add in a comment with your pull request “I, <full name>, agree to have this published under Creative Commons 4.0 International BY”.