Fuentes de Documentación para OpenCms 7
1.-
Introducción
A la hora de trabajar con
este gestor de contenidos nos hemos encontrado con la
dificultad de asimilar información proveniente de una
documentación bastante
heterogénea, especialmente para la versión 7. Por
supuesto, existen aportaciones de
referencia desde la página oficial y
sus comunidades
de desarrollo. También existen libros; pero se echa en falta
por
ejemplo, guías de desarollo rápido que permitan
introducirse en el gestor y sus componentes o desarrolar una web hasta
un nivel intermedio yendo por cada una de sus etapas.
Con
este tutorial pretendemos dar un poco de orden a este
pupurrí de documentación.
2.-
Documentación de referencia
OpenCms
|
 |
Es
la página oficial del proyecto, a nivel opensource,
desarrollo y
servicios comerciales añadidos. Especialmente enfocado a
comprender el qué de este gestor, sus ventajas y potencial,
y el
cómo en determinados aspectos(plantillas/componentes). Pero
falta documentar el
‘pegamento’ que une las partes individuales para dar forma a un web
site (secciones/navegación)
- Existe
un tour por OpenCms en la que se muestran
capturas de pantalla con las posibilidades del gestor. Se encuentra en
la sección de Support
| Guided
tour - Aparte del acceso a
la API (imprescindible), la sección Downloads
| Documentation
hay ejemplos útiles pero específicos.
Presentaciones en
PDF de características y descarga de módulos de
documentación (HOWTOs) que deben importarse en nuestro
OpenCms
instalado y leer desde ahí. - Encontraremos
también
extensiones (módulos) como carritos de compra, soporte RSS,
plantillas, etc. habitualmente aportadas por terceros. - Instrucciones
sobre i18n y i10n. - Veremos
que el logo de Alkacon (Alkacon OpenCms Enterprise Extensions, OCEE)
aparece casi por todas partes. Es una empresa experta en openCms
(así se definen) que ofrece extensiones comerciales a
OpenCMS,
formación e información técnica, pero
también aportaciones y documentación muy
útil bajo
GPL es decir, de libre uso. Realmente hacen un buen trabajo los chicos
de Alkacon.
Documentación
|
 |
Desde
la web incio del gestor (http://localhost:8080/opencms/opencms/)
tenemos acceso a toda la documentación incluída
por defecto, más la que podemos descargar.
En el
menú superior encontraremos estos enlaces:
- TEMPLATEONE
DEMO PAGES: páginas hechas con plantillas de OpenCms,
acompañadas de una breve explicación - MODULES
DEMO PAGES: páginas hechas con módulos de OpenCms
(Eventos, Noticias, trabajo…) - XML
CONTENT DEMO: muestra los módulos basados en XML en OpenCms.
Éstos permiten añadir contenidos a la web
desarrollada de
manera dinámica y desde el modo edición de la
web, sin
tener que utilizar la consola de administración para
añadir manualmente nuevos contenidos. - ALKACON
DOCUMENTATION: documentación variada proporcionada por
Alkacon.
OpenCms
|
 |
Puede
considerarse como la web de referencia en castellano de OpenCms.
Abundante información y la más útil
para dar los
primeros pasos desde cero y posteriormente abarcar aspectos de mayor
complejidad. A destacar tres secciones:
- Artículos:
entre ellos existe uno publicado en PC-Actual titulado OpenCms Paso a
Paso. - Tutoriales:
muchos dedicados a la instalación y
administración, pero
también a la creación desde cero y ampliar con
nuevas
funcionalidades y tipos de contenidos personalizados. - Código
útil: código Jsp que usa la API de OpenCms para
diversos
propósitos. Es muy interesante aprender de estos ejemplos y
usarlos adaptándolos a nuestras necesidades.
3.-
Documentación técnica
OpenCms
|
 |
Un
interesante wiki con secciones aún sin desarrollar pero con
otras que abarcan aspectos técnicos no encontrados en otros
sitios (acegi, Spring). Incluye enlaces (alguno obsoleto) a
páginas web, chat, foros y demos.
Open
|
 |
Una
singular página con recopilaciones de sitios web (se queda
en la versión 6 de OpenCms).
Tutoriales
|
 |
A
veces la mejor manera de avanzar es dejarse enseñar. En
nuestra web hay tutoriales enviados por colaboradores de OpenCmsHispano
y otros desarrollados por Autentia como resultado del I+D aplicado a
sus proyectos. Una búsqueda local al site con eltérmino opencms te dará los tutoriales
publicados
4.-
Libros
A destacar dos libros editados sobre OpenCms
para las versiones 5 y 6. Se consideran útiles
aún para la versión 7 puesto que asegura la
compatibilidad hacia atrás, al menos con la 6.
Managing and Customizing OpenCms 6 Websites
Language |
 |
Este
es el libro más actualizado que existe para OpenCms (índice).
De toda la documentación disponible, este libro es de
obligada
referencia, a la espera de que Matt Butcher publique una
edición
actualizada a OpenCms 7.
Building Websites With OpenCms
Language |
 |
Este
libro ha sido escrito para OpenCms 5 y es la versión
anterior
del Managing and Customizing OpenCms 6 Websites. Está bien
estructurado
(índice), sin embargo
algunos contenidos esenciales han quedado obsoletos, así
como los ejemplos que utilizan la API para las páginas Jsp
no compilan puesto que la jerarquía de clases y paquetes ha
sido remodelado en versiones posteriores.
En mi
opinión este libro está desactualizado y como
fuente de conocimientos técnicos es
útil, pero no como guia de trabajo aplicable ad hoc al
desarrollo de sites. La documentación online ya abarca y
pone al día lo expuesto en sus páginas.
5.-
Conclusión
A
la espera de un libro que recoja los avances de openCms 7, la
manera recomendable de abordar el estudio de OpenCms es, en mi
opinión, obtener un ejemplar de Managing and Customizing
OpenCms
6 Website, usar la documentación incluida con la
distribución instalada y ejercitarse al principio con un
tutorial de construcción de un web site paso a paso, como el
que
ofrece OpenCmsHispano o adictosaltrabajo.com.
