diff --git a/source/procesos_de_documentacion.rst b/source/documentando.rst similarity index 100% rename from source/procesos_de_documentacion.rst rename to source/documentando.rst diff --git a/source/glosario.rst b/source/glosario.rst new file mode 100644 index 0000000..1a358d8 --- /dev/null +++ b/source/glosario.rst @@ -0,0 +1,104 @@ +.. -*- coding: utf-8 -*- + +.. _glosario: + +======== +Glosario +======== + +A continuación una serie de terminos usados en las tecnologías Python / Zope / Plone + +.. glossary :: + :sorted: + + PYTHONPATH + Una lista de nombre de directorios, con la misma sintaxis como la variable ``PATH`` del shell de su sistema. + + buildout + En la herramienta buildout, es un conjunto de partes que describe como ensamblar una aplicación. + + part + En la herramienta buildout, es un conjunto opciones que le permite a usted construir una pieza de la aplicación. + + recipe + En la herramienta buildout, es el software usado para crear una parte basada en sus opciones. + + Paquete Python + Es un termino generalmente usando para describir un módulo Python. en el + más básico nivel, un paquete es un directorio que contiene un archivo + ``__init__.py`` y algún código Python. + + Productos + Es una terminología usada por la comunidad Zope / Plone asociada a + cualquier implementación de módulos / complementos y agregados que amplíen la + funcionalidad por defecto que ofrece Zope/Plone. También son conocidos como + *"Productos de terceros"* del Ingles `Third-Party Products`_. + + Producto Zope + Es un tipo especial de paquete Python usado para extender Zope. En las + antiguas versiones de Zope, todos los productos eran carpetas que se ubican + dentro de una carpeta especial llamada ``Products`` de una instancia Zope; + estos tendrían un nombre de módulo Python que empiezan por "**Products.**". + Por ejemplo, el núcleo de Plone es un producto llamado CMFPlone, conocido en + Python como `Products.CMFPlone`_. + + Producto Plone + Es un tipo especial de paquete Zope usado para extender las funcionalidades + de Plone. Se puede decir que son productos que su ámbito de uso es solo en el + desde la interfaz gráfica de Plone. + + Paquete Egg de Python + Es una forma de empaquetar y distribuir paquetes Python. Cada Egg contiene + un archivo ``setup.py`` con metadata (como el nombre del autor y la correo + electrónico y información sobre el licenciamiento), como las dependencias del + paquete. La herramienta del ``setuptools``, es la librería Python que permite + usar el mecanismo de paquetes egg, esta es capaz de encontrar y descargar + automáticamente las dependencias de los paquetes Egg que se instale. Incluso + es posible que dos paquetes Egg diferentes necesiten utilizar simultáneamente + diferentes versiones de la misma dependencia. El formato de paquetes Eggs + también soportan una función llamada ``entry points``, una especie de + mecanismo genérico de plug-in. Mucha más detalle sobre este tema se encuentra + disponible en el `sitio web de PEAK`_. + + Collective + Es un repositorio de código comunitario, para Productos Plone y productos + de terceros, y es un sitio muy útil para buscar la ultima versión de código + fuente del producto para cientos de productos de terceros a Plone. Los + desarrolladores de nuevos productos de Plone son animados a compartir su + código a través de Collective para que otros puedan encontrarlo, usarlo, y + contribuir con correcciones / mejoras. Si usted quiere publicar un nuevo + producto en el repositorio Collective de Plone necesita + `obtener acceso de escritura al repositorio`_ y `crear su estructura básica de repositorio`_ + para su producto. Para consultar el repositorio en forma Web en el siguiente + `enlace`_. + + Temas / Apariencias + Por lo general si un producto de Tema esta bien diseñado y implementado + debe aplicarse de una ves al momento de instalarlo. En caso que no se aplique + de una puede acceder a la sección `Configuración de Temas`_ y cambiar el + **Tema predeterminado** por el de su gusto. + + Tipos de contenidos + Los tipos de contenidos son productos que extienden la funcionalidad de + **Agregar elemento** que permite agregar nuevos tipos de registros + (Contenidos) a tu sitio. Esto quiere decir que si instala un tipo de + contenido exitosamente debería poder acceder a usarlo desde el menú de + **Agregar elemento** en el sitio Plone. Opcionalmente algunos productos + instalan un panel de control del producto que puede acceder a este en la + sección `Configuración de Productos Adicionales`_. + + Productos Zope + Este tipo de productos esta disponibles desde la interfaz administrativa de + Zope (ZMI) de `su instalación`_ donde deben acceder con las credenciales del + usuario Administrador de Zope. Muchas veces el producto simplemente no hay + que instalarlo por que se agregar automáticamente. + +.. _Third-Party Products: http://plone.org/documentation/kb/add-ons/tutorial-all-pages +.. _Products.CMFPlone: http://pypi.python.org/pypi/Products.CMFPlone +.. _sitio web de PEAK: http://peak.telecommunity.com/DevCenter/setuptools +.. _obtener acceso de escritura al repositorio: http://plone.org/countries/conosur/documentacion/obtener-acceso-de-escritura-al-repositorio-svn-de-plone +.. _crear su estructura básica de repositorio: http://plone.org/countries/conosur/documentacion/crear-un-nuevo-proyecto-en-el-repositorio-collective-de-plone +.. _enlace: http://svn.plone.org/svn/collective/ +.. _Configuración de Temas: http://localhost:8080/Plone/@@skins-controlpanel +.. _Configuración de Productos Adicionales: http://localhost:8080/Plone/prefs_install_products_form +.. _su instalación: http://localhost:8080/manage diff --git a/source/index.rst b/source/index.rst index cb2b0d7..df01548 100644 --- a/source/index.rst +++ b/source/index.rst @@ -21,6 +21,7 @@ software Berkeley) y prácticamente cualquier otra plataforma. .. toctree:: :maxdepth: 1 + manuales/requerimientos_sistema_plone manuales/instalando_plone @@ -55,7 +56,7 @@ agilicen nuestro desarrollo. :maxdepth: 1 plone/apariencias/index - Realizando pruebas en Plone + Realizando pruebas en Plone 3 ========================== @@ -252,10 +253,9 @@ sección tocaremos algunos de ellos. .. toctree:: :maxdepth: 1 - plone/desarrollar_productos + plone/tipos_productos plone/crear_producto_policy plone/crear_producto_tema - plone/inmersion_interactiva_plone3 Tecnologías de Zope ------------------- @@ -293,6 +293,7 @@ Otros recursos .. toctree:: :maxdepth: 2 + glosario links presentaciones @@ -305,8 +306,9 @@ Instrucciones acerca de esta documentación. .. toctree:: :maxdepth: 2 - procesos_de_documentacion - traducciones_de_contenidos + documentando + traduciendo + copyright diff --git a/source/manuales/usando_plone3/introduccion.rst b/source/manuales/usando_plone3/introduccion.rst index de9d308..c8f852d 100644 --- a/source/manuales/usando_plone3/introduccion.rst +++ b/source/manuales/usando_plone3/introduccion.rst @@ -1,3 +1,5 @@ +.. -*- coding: utf-8 -*- + .. highlight:: rest .. _introduccion: diff --git a/source/plone/desarrollar_productos.rst b/source/plone/tipos_productos.rst similarity index 90% rename from source/plone/desarrollar_productos.rst rename to source/plone/tipos_productos.rst index 3960b86..68dd1c9 100644 --- a/source/plone/desarrollar_productos.rst +++ b/source/plone/tipos_productos.rst @@ -6,7 +6,13 @@ Desarrollar diversos productos con Plone 3 ========================================== -.. contents :: :local: +:Autor(es): Carlos de la Guardia, Leonardo J. Caballero G. +:Correo(s): carlos.delaguardia@gmail.com, leonardocaballero@gmail.com +:Lanzamiento: |version| +:Fecha: |today| + +En esta articulo busca explicar los tipos desarrollos de productos / módulos +disponibles para Plone 3. Introducción ============ @@ -28,7 +34,23 @@ La estructura del código que se recomienda incluye las siguientes partes: .. glossary:: - Producto de tema + Producto de configuración (policy product) + Incluye toda la configuración general del sitio. Representa las reglas + generales de manejo de sitios Plone de una organización y puede incluir: + + * Configuraciones del sitio y propiedades de navegación. + * Productos propios y de terceros que deben instalarse automáticamente + con el sitio. + * Configuraciones de viewlets. + * Estructura inicial de contenido del sitio. + * Pasos adicionales a la instalación del producto, como creación de + cuentas de usuarios y contenido personalizado. + * Portlets utilizados en el sitio. + * Flujo de trabajos generales de la organización. + + Para crear este producto consulte el articulo :ref:`Creación de un producto de configuración `. + + Producto de tema (plone theme) Incluye uno o más productos que definan un "skin" de Plone que especifique la presentación visual del sitio. Cada uno puede incluir: @@ -41,7 +63,7 @@ La estructura del código que se recomienda incluye las siguientes partes: Para crear este producto consulte el articulo :ref:`Creación de un paquete de tema `. - Productos de contenido + Productos de contenido (content types) Uno o varios productos que definen los tipos de contenido que representan la base del sitio web. @@ -52,22 +74,6 @@ La estructura del código que se recomienda incluye las siguientes partes: * Portlets propios del contenido. * Índices y metadatos del catálogo para cada tipo utilizado. - Producto de configuración (policy product) - Incluye toda la configuración general del sitio. Representa las reglas - generales de manejo de sitios Plone de una organización y puede incluir: - - * Configuraciones del sitio y propiedades de navegación. - * Productos propios y de terceros que deben instalarse automáticamente - con el sitio. - * Configuraciones de viewlets. - * Estructura inicial de contenido del sitio. - * Pasos adicionales a la instalación del producto, como creación de - cuentas de usuarios y contenido personalizado. - * Portlets utilizados en el sitio. - * Flujo de trabajos generales de la organización. - - Para crear este producto consulte el articulo :ref:`Creación de un producto de configuración `. - Productos de apoyo Uno o varios productos que realicen funciones no específicamente asociadas al contenido. diff --git a/source/traducciones_de_contenidos.rst b/source/traduciendo.rst similarity index 100% rename from source/traducciones_de_contenidos.rst rename to source/traduciendo.rst