Cómo localizar las partes y piezas que usted necesita. Enlaces a ayudas visuales útiles para la identificación de elementos de página, referencias a la localización de su producto y directorios de huevos, diagramas de un huevo de tema en el sistema de archivos.
¿Cómo puede localizar a los archivos relacionados a un elemento de página individual?
En este momento (de escribir esto), no hay una varita mágica incorporada para apuntar a un elemento en una página Web de Plone y saber exactamente que plantillas y código están involucrados en su creación. No obstante puede que la haya pronto, y los aventureros gustarían de explorar Weblion’s Gloworm tool.
Si no está listo para una aventura todavía, entonces hay una serie de buenos tutoriales disponibles con diagramas y guías para dónde está qué.
El proyecto Weblion tiene una página Wiki excelente para ayudarle con esto
Firebug (producto adicional para Firefox), obviamente, es una herramienta esencial para la inspección de código y CSS de una página.
Los elementos de página son constantemente mencionados en Plone, así que una vez que conozca el nombre de un área de página, usted está en buen camino para localizar los archivos relevantes.
La ubicación de su instancia Zope depende del instalador de Plone o el proceso de instalación que haya utilizado.
Buildout En una instalación basada en Buildout, no tiene que preocuparse mucho acerca de su instancia Zope. Si realmente quiere investigar encontrará su instancia en [su buildout]/parts/instance. Sin embargo la mayoría de los detalles clave (sus productos Plone, productos de terceros , y Data.fs) no se alojan allá. Todos ellos están reunidos de varias partes de su sistema de archivos por el archivo zope.conf que se genera cuando ejecuta Buildout.
Instalador de Plone Los instaladores de Plone (aparte del Instalador Universal de Plone 3.1 Universal) suele situar un directorio de instancia Zope junto a los directorios de software Zope y Python. Así que por ejemplo, una instalación estándar de Windows, localiza la instancia de Zope en c:Program FilesPlone 3Data. En una Mac, llamará “instance” y probablemente será ubicada en una carpeta Plone en la carpeta de aplicaciones. Sin embargo el instalador Universal de Plone 3.1, le dará una instalación basada en Buildout. Paquete de producto Plone Si ha instalado Zope usted mismo, se le habrá pedido crear (por terminal) una instancia Zope, por lo que debe tener una buena idea de dónde está en el sistema.
Cómo localizar su directorio de productos. Esto varia de acuerdo al instalador de Plone o el proceso de instalación que haya utilizado.
El directorio de productos es donde los productos 2.5 de viejo estilo se ubican. Para encontrar este, primero tendrá que saber dónde está su instancia Zope o su Buildout.
Para fines de creación de temas, la razón principal para tener que buscar el directorio de productos es para localizar los archivos de Plone Default - ya que partes de Plone todavía siguen en el formulario viejo-estilo de productos.
En una instalación basada en Buildout, usted encontrará los productos en varios directorios.Productos en el Core de Plone (tal como CMFPlone) Para estos, revise
Productos que descargé usted mismo Estos deberían estar en
If you find you haven’t got a products directory there, then it is OK to create one yourself. Productos que le pidió a Buildout que descargara Si le pidió buildout a Buildout que buscara algunos productos viejo-estilo, entonces estos se ubicaran en
(Buildout también creará el directorio y lo llamará algo así como “productdistros”).
Instalador de Plone y paquete de producto Plone debería ser fácil de localizar todos los productos (aquellos que pertenecen a la instalación de núcleo de Plone y aquellos que se han descargado) en
Sin embargo, si usted utiliza el Instalador Universal de Plone 3.1 su instalación será basada en Buildout.
Es lo suficientemente fácil para Zope encontrar los huevos, más difícil para humanos.
Productos Core (núcleo) de Plone Default Para los productos de núcleo utilizados en el tema Plone Default, buildout tiene un directorio de huevos
que es donde los huevos se ubican automáticamente cuando se instala Plone. Su propio producto de tema Debido a que su propio producto de tema estará bajo desarrollo, esto estará en un lugar distinto en su Buildout
(Tenga en cuenta que para compartir huevos entre Buildouts puede especificar una ubicación diferente para esto en un archivo buildout por defecto, revise buildout tutorial en plone.org para más información).
Es más o menos una navegación de arrastre a través de todos los huevos usados por Plone. La receta de Omelette por David Glick crea una estructura de directorio unificado de todos los paquetes de espacio de nombres, realizando enlaces simbólicos a los contenidos, a través de Buildout. Instrucciones completas y documentación sobre esto se puede encontrar aquí:
http://pypi.python.org/pypi/collective.recipe.omelette
Una vez que haya ejecutado nuevamente Buildout con la receta de omelette, se dará cuenta que tiene una nueva sección aquí:
y huevos tales como plone.app.layout se pueden encontrar aquí:
Instalador de Plone Si ha instalado Plone con un instalador, entonces los huevos probablemente se habrán situado en
Sin embargo, si usted utiliza el Instalador Universal de Plone 3.1 su instalación será basada en Buildout. El paquete de producto Plone Si ha utilizado el paquete de producto (es decir, instalado desde el código fuente), entonces es muy posible encontrarlos en
El huevo creado para usted por la plantilla paster de plone3_theme debe tener un diseño de sistema de archivos muy similar a este diagrama.
Si el diagrama no funciona, consulte las siguientes páginas donde las secciones del diagrama están combinadas con una explicación textual.
Estos archivos y directorios serán relevantes cuando se trabaja en la parte del skin de su tema.
Estos archivos y directorios serán relevantes cuando se trabaja en la parte de Componentes de su tema.
Utilice este archivo para ordenar sus viewlets dentro de los administradores de viewlets /browser/configure.zcml
Utilice este archivo para conectar los componentes
Estos archivos y directorios serán relevantes cuando se trabaja en la parte de Configuración de su tema.
Estos son los archivos y directorios necesarios para instalar el huevo en la ruta de python y ponerlo a disposición en el arranque de Zope.
Estos son los archivos que se usan cuando se instala el producto de tema mediante Configuración del sitio ‣ Agregar/Quitar productos o Interfaz de Administración de Zope ‣ portal_quickinstaller
El código fuente de este archivo esta hospedado en GitHub. Todos pueden actualizar y corregir errores en este documento con unos clic - sin necesidad de descargar.
Para mas información básica acerca de como actualizar este manual y referencia a sintaxis Sphinx, por favor consulte la guía Escribiendo y actualizando el manual.