Temas para MoinMoin

Introducción

Una de las características más llamativas de Moin es la fácil y modular separación de la apariencia y comportamiento del Wiki (look & feel) de su contenido y lógica de trabajo. Esto permite hacer que Moin se adapte a diferentes usuarios asimilando la apariencia familiar de algún Wiki que ya sepan usar (por ejemplo asumiendo la apariencia de la popular Wikipedia). Acá documentaremos cómo instalar algunos temas en MoinMoin.

Para más información contextual sobre lo tratado en este artículo vea:

Ayuda sobre cómo instalar temas en Moin (en inglés).
Mercado de temas (en ingles): Para descargar temas disponibles y reportar los construidos.
Sobre cómo usar el instalador de paquetes de Moin (en inglés) Para facilitar la instalación de extensiones, scripts y temas para Moin (disponible en las versiones 1.3.4 de la Edición de escritorio y en la 1.5 Beta).
Un macro para explorar temas de Moin
Resultados de búsqueda sobre temas en Moin

Instalación de un tema

Usando Package Instaler

El Package Installer es una herramienta que nos permite fácilmente instalar extensiones y temas para Moin. Para esto creamos una vez descargamos el tema que nos interesa (y que tenga soporte para el Package Installer) por ejemplo:

http://moinmoin.wikiwikiweb.de/ThemeMarket?action=AttachFile&do=get&target=monomoin-0.1.pkg

Luego creamos una nueva página para alojar el tema (por ejemplo /Temas/monomoin) y en ella anexamos el archivo del tema descargado (véase los "Tips" de Uso). Aparecerá entonces la página con el tema anexo y cuatro enlaces en ella en un menú así <nowiki>[del | get | view | install]</nowiki>. Seleccionamos "install", luego de lo cual aparecerá un mensaje como este:

Attachment 'monomoin-0.1.pkg' installed.

Installed monomoin successfully.
Please restart MoinMoin to complete installation (if you do not use CGI).

Clear message

Procedemos entonces a detener el Moin (puede ser mirando el proceso que éste corre e interrumpiéndolo). Agregamos las líneas referidas al nuevo tema al archivo de configuración:

echo "    theme_default= 'monomoin' " >> wikiconfig

y lo reiniciamos.

Usando el método tradicional

Para usar este método es conveniente entender un poco la estructura de los temas. Las carpetas de los temas están en general tienen una estructura de la siguiente forma:

+--nombredeltema/
 |
 +--css/
 |
 +--img/
 |
 +--nombredeltema.py

La carpeta llamada "css" contiene las hojas de estilo del tema y carpeta "img" contiene las imágenes. El archivo nombredeltema.py es el que le indica a Moin como usar los contenidos de las carpetas anteriores y se usa como parámetro para las preferencias del usuario y del sitio.

Para instalar un tema de acuerdo al método tradicional basta con descargar el tema deseado, descomprimirlo y colocar la carpeta "nombredeltema" en la ubicación "/htdocs" donde corre la instancia del wiki. Luego mover el archivo <nombredeltema>.py a la ubicación: "MoinMoin/theme/."

Ejemplo:

Supondremos que vamos a instalar el tema monobook y que nuestra ubicación por defecto para la instancia del Wiki de Moin que ejecutamos es:

~/Programas/Wikis/MoinMoin/DesktopEdition/1.5.0-rc1/ElDirectorio/"

Definimos una variable para la instancia del wiki, de modo que nos quede más fácil invocar todo en el futuro:
export $wikidir=~/Programas/Wikis/MoinMoin/DesktopEdition/1.5.0-rc1/ElDirectorio/
Obtenemos el tema que deseamos instalar:
wget http://moinmoin.wikiwikiweb.de/ThemeMarket?action=AttachFile&do=get&target=monobook-0.2.tar.gz
los descomprimimos:
unzip monobook-02.tar.gz
movemos la carpeta a la ubicación "htdocs" de nuestra instancia:
cp monobook/ $wikidir/wiki/htdocs/
y ahora movemos el archivo "monobook.py" a la ubicación adecuada:
mv $wikidir/wiki/htdocs/monobook/monobook.py $wikidir/wiki/MoinMoin/theme
Reiniciamos el wiki (o esperamos a que el administrador lo haga) y listo! ahora debemos poder usarlo en nuestras preferencias de usuario.

Usar temas para crear un CMS

Una de las utilidades de los temas es la posibilidad de convertir un wiki en un CMS tradicional. Sólo los usuarios acreditados tendrán permisos de edición y verán los enlaces para emprender las acciones asociadas (edición, diferencias, anexos, etc) mientras que los visitantes o usuarios sin permisos de edición verán un CMS tradicional sin mayores complicaciones. Para instalar un tema que convierta a Moin en un CMS se debe hacer lo siguiente:

Se decarga el script de Python en este enlace
Se coloca el script renombrado modern_cms.py (sin el número 15 original) en la carpeta wiki/data/plugin/theme/ de la instancia del wiki que esté ejecutándose.
Agregue o coloque las siguientes líneas en el archivo wikiconfig.py
```
 theme_default = 'modern_cms'
 theme_force = True
```
eso es todo!, ahora Moin funciona como un CMS