Sobre “Maestría en Plone”¶

Esta entrenamiento fue creada por Philip Bauer y Patrick Gerken de la empresa starzel.de para crear una formación canónica para futuros desarrolladores de Plone. El objetivo es que cualquier persona con los conocimientos adecuados puede dar un entrenamiento basado en este y si lo desea pueda contribuir a mejorar este material. Se publica como código abierto en github y readthedocs.

Si desea ponerse en contacto con los autores originales para un entrenamiento, por favor, puede hacerlo por medio del correo team@starzel.de.

Próximos entrenamientos¶

Mastering Plone 5 Development: 2. - 6 de Marzo de 2015, en Múnich: por Philip Bauer y Patrick Gerken

Entrenamientos previos¶

El entrenamiento “Maestría en Plone” se celebró públicamente en las siguientes ocasiones:

Entrenadores¶

Los siguientes entrenadores han dado entrenamiento basado en el material “Maestría en Plone”:

Leonardo Caballero: Leonardo J. Caballero G. de Maracaibo, Venezuela, es Director Técnico de Covantec R.L. y Conectivo C.A. Leonardo mantiene las traducciones en español de más de 49 complementos de Plone, así como documentación en español para Plone. Ha contribuido con varios complementos de Plone que forman parte de PloneGov. Actualmente sirve a la Junta de Plone como Embajador de Plone, Leonardo también ha servido como un miembro de la Junta Asesora y ha hablado o ayudado en la organización eventos de Plone y código abierto en toda América del Sur.
Philip Bauer: Philip Bauer es un desarrollador web de Munich que se enamoró de Plone en 2005 y desde entonces trabaja casi exclusivamente con Plone. Un historiador por educación que derivó hacia la creación de sitios web en los años 90 y fundó la empresa Starzel.de en 2000. Es miembro de la Fundación Plone, ama la enseñanza y se dedica al Open Source. Entre otros proyectos relacionados con Plone, comenzó a crear el manual de entrenamiento “Maestría en Plone” para que todos puedan convertirse en programadores Plone.
Patrick Gerken: Patrick Gerken trabaja con Python desde 2002. Comenzó a trabajar con aplicaciones Zope puras y ahora desarrolla principalmente con Plone, Pyramid y Javascript, además de hacer tareas de lo que se llama DevOps. Trabaja en Starzel.de.
Steve McMahon: Steve McMahon es un miembro de la comunidad Plone hace mucho tiempo, colaborador y entrenador. Él es el creador del producto PloneFormGen, el cual es un generador de formulario a traves de la Web para Plone y el mantenedor del instalador unificado. Steve también escribió varios capítulos del libro ‘Practical Plone’ y es un orador e instructor experimentado.
Steffen Lindner: Steffen Lindner comenzó a desarrollar Plone en 2006. Trabajó en pequeños sitios de Plone y también en enormes sitios de intranet. Como desarrollador de Open Source / Software Libre se unió al equipo de desarrolladores del núcleo de Plone en 2011 y trabaja en 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 genera mediante la herramienta Sphinx y se basa en dos sabores:

por defecto: La versión detallada utilizada para la documentación en línea y para el instructor. Para construirlo con Sphinx, ejecute el el comando make html o use la versión en línea.
presentation: Una versión abreviada utilizada para el proyector durante un entrenamiento. Ese debe usar más lista de viñetas que texto detallado. Para construirlo con Sphinx, ejecute el el comando make presentation.

Nota

Anteponiendo un bloque con indentación de texto o código con .. only:: presentation usted puede controlar que este bloque es usado solamente en la versión presentación.

Para ocultar un bloque desde la versión presentation use .. only:: not presentation

Contenido sin un prefijo sera incluido en ambas versiones.

El tema readthedocs¶

Nos ajustamos ligeramente al tema readthedocs en el archivo _static/custom.css para que funcione mejor con proyectores:

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.

Ejercicios¶

Algunos javascript adicionales muestran las soluciones ocultas para los ejercicios haciendo clic en ellos.

Simplemente escriba la solución con este markup:

..  admonition:: Solution
    :class: toggle

Aqui hay un ejemplo completo:

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

Eso sera renderizado como algo así:

Ejercicio 1¶

Su misión, si decide aceptarla...

Solución

Para salvar al mundo con sólo unos segundos de sobra haga lo siguiente:

from plone import api

Construyendo la documentación localmente¶

Para construir la documentación siga estos pasos:

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

Ahora puede abrir lo generado en el directorio _build/html/index.html. Para construir la versión de presentación ejecute el comando make presentation en lugar del comando make html. Usted puede abrir la versión presentación en el directorio presentation/index.html.

Cosas que hacer antes de un entrenamiento (como entrenador)¶

Preparar un servidor de correo electrónico para el registro de usuario (http://plone-training.readthedocs.io/en/legacy/features.html#configure-a-mailserver)
Si usted sólo hace una parte del entrenamiento (Avanzado) prepare una base de datos con los pasos de los secciones anteriores. Tenga en cuenta que el archivo y el blobstorage en el Vagrant box está aquí: /home/vagrant/var/ (no con la ruta del directorio de buildout /vagrant/buildout/)

Contribuyendo¶

Todos están invitados a contribuir. Los cambios de errores menores pueden ser empujados directamente en el repositorio, los cambios más grandes deben haber como un pull requests y discutirlos previamente en tickets.

Licencia¶

El entrenamiento “Maestría en Plone” es licenciado bajo la Creative Commons Attribution 4.0 International License.

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

Si usted no ha completado un Acuerdo de colaborador, todavía puede aportar. Póngase en contacto con el equipo de documentación, por ejemplo a través de la lista de correo o directamente enviar un correo a plone-docs@lists.sourceforge.net. Básicamente, todo lo que necesitamos es la confirmación por escrito de que usted está de acuerdo que su contribución puede ser bajo licencia Creative Commons. También puede agregar en un comentario con su pull request “Yo, <nombre completo>, estoy acuerdo en que esta publicado bajo licencia Creative Commons 4.0 International BY”.