Skip to content

Commit

Permalink
Added new articles and renamed some files
Browse files Browse the repository at this point in the history
  • Loading branch information
macagua committed Jul 31, 2012
1 parent 6727d97 commit 51702e6
Show file tree
Hide file tree
Showing 6 changed files with 138 additions and 24 deletions.
File renamed without changes.
104 changes: 104 additions & 0 deletions 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
12 changes: 7 additions & 5 deletions source/index.rst
Expand Up @@ -21,6 +21,7 @@ software Berkeley) y prácticamente cualquier otra plataforma.
.. toctree::
:maxdepth: 1

manuales/requerimientos_sistema_plone
manuales/instalando_plone


Expand Down Expand Up @@ -55,7 +56,7 @@ agilicen nuestro desarrollo.
:maxdepth: 1

plone/apariencias/index
Realizando pruebas en Plone <plone/haciendo_pruebas/index>
Realizando pruebas en Plone 3 <plone/haciendo_pruebas/index>


==========================
Expand Down Expand Up @@ -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
-------------------
Expand Down Expand Up @@ -293,6 +293,7 @@ Otros recursos
.. toctree::
:maxdepth: 2

glosario
links
presentaciones

Expand All @@ -305,8 +306,9 @@ Instrucciones acerca de esta documentación.
.. toctree::
:maxdepth: 2

procesos_de_documentacion
traducciones_de_contenidos
documentando
traduciendo
copyright



Expand Down
2 changes: 2 additions & 0 deletions source/manuales/usando_plone3/introduccion.rst
@@ -1,3 +1,5 @@
.. -*- coding: utf-8 -*-
.. highlight:: rest

.. _introduccion:
Expand Down
Expand Up @@ -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
============
Expand All @@ -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_policy>`.

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:

Expand All @@ -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 <producto_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.

Expand All @@ -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 <producto_policy>`.

Productos de apoyo
Uno o varios productos que realicen funciones no específicamente
asociadas al contenido.
Expand Down
File renamed without changes.

0 comments on commit 51702e6

Please sign in to comment.