PmWiki para tu escritorio II (Configurar funcionalidades)

Publicado por pptux

en Diciembre 21, 2009

Configurar PmWiki es realmente muy sencillo, pues no requiere de acciones complicadas. Se le otorgan nuevas funcionalidades por medio de su amplio libro de recetas (Cookbook que cuenta con más de 500 recetas elaboradas por su comunidad y distribuidas azarosamente entre Windows, Mac y Linux), basta colocar la extensión en su carpeta correspondiente y a continuación habilitarla con una instrucción en el archivo /pmwiki/local/config.php. Sin embargo, cuando se instala por primera vez PmWiki, el fichero /local/config.php no existe. Usted podría crear el /local/config.php desde cero, pero sin duda, será más fácil copiarlo de la muestra /pmwiki/docs/sample-config.php como punto de partida, ya que, éste archivo incluye muchas de las opciones con la posibilidad de sólo desmarcar etiquetas.

Instalación

La encontrará aquí mismo vía su enlace en la sección: Completa esta lectura con. El artículo se encuentra en ««PmWiki la pluscuamperfectus para tu escritorio»»

Distribución, mapa interno de los archivos de PmWiki
Referencias: "http://localhost/~(nombre_mi_equipo)/pmwiki/" (ruta Web) «es = a» "~/public_html/pmwiki/" (ruta en disco)

 /pmwiki/
  /cookbook	-  Contiene las recetas
  /docs		-  Documentación y ejemplos
  /local	-  Archivo «config.php»
  /pub		-  Carpetas de complementos como CSS, Skins, etc.
  /scripts	-  Operativo de PmWiki
  /uploads	-  Carpeta usuario para subir archivos: html, odt, png, etc.
  /wiki.d	-  Carpeta usuario, contiene las páginas creadas en la Wiki
  /wikilib.d	-  Corazón de PmWiki

¡Si decide iniciar de cero! Debe crear un archivo script PHP. Estos siempre deben iniciar con la etiqueta: [< ?php ] antes que nada y, terminar con [?>] despues que todo. A continuación, en este caso, debemos agregar la condición [if (!defined('PmWiki')) exit();] quedando como inicio y primera línea; además, para cerrar el archivo, deberá contener en su última línea la entidad [?>]. Por ahora iniciar y finalizar el config.php así:

<?php if (!defined('PmWiki')) exit(); ?>

Quienes decidan valerse de la muestra del archivo config: en /docs/sample-config.php, deben copiarlo a /pmwiki/local/ como config.php, y tendrán que ir desmarcando las opciones que coincidan de acuerdo a sus necesidades o crearlas con lo siguiente, ejemplo:

Españolizar PmWiki

Observe los pasos, gran parte de los complementos (cookbooks) se instalan de esta manera.

Primer paso: Bajar la Cookbook
Quiero suponer que lo primero que desean es españolizar PmWiki. Entonces necesitaremos el paquete [i18n-es.zip] contenido por el repositorio ubicado en http://www.pmwiki.org/pub/pmwiki/i18n/ donde buscaremos el archivo i18n-es.zip. Al descomprimirlo, hay dos carpetas que eran contenidas en el .zip, una para /scripts/ y la otra para /wikilib.d/. Copie los archivos respectivamente en cada una de sus carpetas; quedarán como sigue:: /pmwiki/scripts/xlpage*.php y /pmwiki/wikilib.d/PmWikiEs*

Segundo paso: Habilitar esta Cookbook para españolizar
A continuación, se habilita la localización mediante la adición de una instrucción al fichero /local/config.php para que PmWiki cargue el módulo correspondiente: [include_once($FarmD.'/scripts/xlpage-utf-8.php');], pero podría ser cualquiera, recuerden que son cuatro scripts que descargamos para el idioma español; en España por ejemplo, usan el ISO-8859-1, luego entonces, deberán habilitarlo con [include_once($FarmD.'/scripts/xlpage-ISO-8859-1.php');]. Copie aquí su línea de configuración y pegue en su /local/config.php (deberá elegir entre una u otra)

Nota: Me estaré refiriendo a copiar y pegar «la línea» o «las líneas», sin embargo, les sugiero incluir en su copia; el texto precedido por el doble signo de numeral (#, hash) y que describirá la acción en el /local/config.php.

## Activa el juego de caracteres utf-8 include_once($FarmD.'/scripts/xlpage-utf-8.php');
## Activa el juego de caracteres ISO-8859-1 include_once($FarmD.'/scripts/xlpage-ISO-8859-1.php');

Tercer paso: Instrucciones adicionales y variables de acuerdo a cada Cookbook
Como último paso para españolizar, deberá habilitar la instrucción que sirve para cargar la página de traducción PmWikiEs.XLPage. Agregar la siguiente línea al /local/config.php:

## Cambiar el idioma XLPage('es', 'PmWikiEs.XLPage');

Fin de la españolización.

Poner nombre a mi wiki

En seguida agregar la siguiente línea para modificar el nombre de la wiki, tenga en cuenta que el signo de «$», es parte de la sintaxis de PHP para la variable WikiTitle:

## Imprime nuevo nombre o título $WikiTitle = "Nombre_de_MI_wiki";

Crear uploads

La carpeta que a partir de ella subamos los archivos adjuntos (attach) a la wiki.
Con ayuda de su navegador de archivos, muévase a la carpeta …/pmwiki, desde ahí, crear la sub carpeta “uploads” y dele permisos completos de escritura-lectura:

o desde consola si lo prefiere:

cd ~/public_html/pmwiki mkdir uploads chmod +x uploads

Ahora hay que activarlo y darle instrucciones de ruta al config.php de como acceder a uploads, para ello, agregue las siguientes líneas:

Nota: Para subir archivos se requiere de un password. En esta configuración parto del supuesto que usted es el único usuario de su wiki, por tanto, tal vez no requiera password y lo podemos representar como [pw=''] (nada entre comillas). De otra manera, cambie “mi_secreto” por su palabra clave. Al arrancar PHP encriptará su password (mi_secreto)

$DefaultPasswords['upload'] = crypt('mi_secreto')

Es momento de activar la carpeta “uploads”, mostrar su ruta en disco y su URL, en estas últimas sustituya «Mi_nombre por el suyo, el real.

$EnableUpload = 1; $UploadDir = "/home/Mi_nombre/public_html/pmwiki/uploads"; $UploadUrlFmt = "http://localhost/~Mi_nombre/pmwiki/uploads/";

En seguida establecemos la manera como deben guardarse y organizarse todos los archivos subidos (uploads). PmWiki lo hace bajo tres maneras, Global, Grupo, y Página. Global guarda todos los archivos en /uploads, Grupo lo hace dentro de /uploads en una carpeta con nombre de cada grupo, y Página al igual que grupo, pero con el nombre de todas las páginas que contengan archivos subidos. La sintaxis es la siguiente y debe seleccionar solamente una de ellas:

## Organiza Global, sin agrupar $UploadPrefixFmt = '';
## Organiza por Grupo $UploadPrefixFmt = '/$Group';
## Organiza por Grupo y Página $UploadPrefixFmt = '/$Group/$Name';
## Organiza por Página $UploadPrefixFmt = '/$FullName';

Poner un símbolo, anagrama y/o logotipo a la wiki

Esto es rutina, así que, agregue la siguiente línea al /local/config.php

## Imprime mi logo $PageLogoUrl = "http://localhost/... /uploads/MI_LOGO.png";

Simular edición tipo e-mail o edit-post

Para crear o editar una hoja wiki es necesario a partir de una hoja de formato; sin embargo, los parámetros de html son diferentes a los de una wiki, pero para facilitarle el trabajo, usted puede editar por medio de una barra de herramientas como si lo hiciese en la edición de un correo electrónico (e-mail). Agregue la siguiente línea a su config.php:

$EnableGUIButtons = 1;

Cambiar la Piel (Skin) de PmWiki

Usted puesde cambiar la piel de su wiki instalando una de las especialmente diseñadas por los usuarios en el sitio oficial de PmWiki, es lo más fácil y son específicas; pero también, puede instalar cualquier otra diseñada por usted o bien, una de aquellas que se ofrecen de manera libre para instalar un blog o página Web, claro, esto último requiere de usted un poco de conocimiento en lenguaje html. Sin importar su elección, la instalación es similar:

Descargue de la Web de PmWiki la Piel de su elección y guardela en la carpeta ~/public_html/pmwiki/pub/skins/

Ahora renombre la carpeta de la piel por defaul, por ejemplo, podría renombrar agregando el prefijo “bkup”: ~/public_html/pmwiki/pub/skins/bkup-pmwiki

Agregue el nombre de la piel al config.php:

$Skin = 'piel_elegida';

Firme la autoría de su wiki.

PmWiki es el autor del código. Usted es el autor de su wiki.
(Cambie año_actual y mi_nombre_autor por los reales):

$SkinCopyright = ' © año_actual - Mi_Nombre_Autor';

Crear una Galería Fotográfica

En lo personal, experimenté con algunas galerías como: EasyGalleriy, EmbededGalleriy, pmGallery, Galleria, etc., sin embargo, decidí por la de nombre “Mini” que es muy sencilla y ligera; por el momento no requiero más, Carrusel por ejemplo es muy bonita.

Descargue Mini y descompacte
Guarde el contenido (la de sus dos carpetas) como corresponden en /cookbook y /pub
Agregue la siguiente línea a su config.php

include_once("$FarmD/cookbook/mini.php");

y aquí mismo (me refiero a /local/config.php), pero al final de todas las líneas del archivo:

$Mini['FixFilenames'] = 1; $Mini['EnableCache'] = 1;

Guarde (salve) su config.php.

En seguida agregue estas líneas al final del archivo local de estilo en cascada, se encuentra ubicado en: /pub/css/local.css

.mini { padding:2px; border:1px solid #dddddd; background-color:#ffffff; } .miniH, .miniF {display:block;}

Guarde su local.css.

!Es momento de probar! Abra PmWiki. Si todo bien, lo que sigue es interno.

Esta pendiente terminar la configuración de la galería. Para concluir, usted debe crear una página wiki en donde a partir de ella pueda visualizar sus imágenes. Para aprender y practicar, antes utilice la página WikiSandbox diseñada por las wiki precisamente para ello. Haga clic en WikiSandbox y en seguida sobre Editar en el menú, con ello, se abrirá el formato de edición de esta página; vaya al final y de entrada a la marca “Attach:mi_imagen.jpg”, guarde. Aparecerá wikisandbox con la nueva línea, más el símbolo Δ (delta) que indica un enlace; ahora bien, como no se le dio una ruta, PmWiki abrirá un cuadro de diálogo (siguientes imágenes) que a su vez llamará al navegador de archivos.

Attach:

‘ ‘

Galería:

Crear un motor de búsqueda para Internet

(Búsqueda externa)

La siguiente rutina se apoya en Google para crear un motor personal de búsqueda, la forma de como trabaja es idéntica al motor ubicado con frecuencia en la barra de navegación, otras en la barra de herramientas de su navegador Web, en él, usted cuenta con las opciones de búsqueda en Google, Yahoo, Amazon, etc., no obstante su utilidad, no permite hacer motores propios, a menos que escribamos una extensión (gadget) o bien, darse de alta en Google_Sites para desde ahí poder hacerlo.

En cambio es posible hacerlo a las necesidades personales con PmWiki. La manera más práctica para crearlo, es en la página principal (home) para que al abrir el navegador Web se tenga a primera instancia. Una breve descripción por número de línea del código en el párrafo posterior:

Utiliza google_search
Acepta una solicitud
Formato del cuadro para entrada
Inicia Menú del lugar de búsqueda (observe valor=”", así la búsqueda sera global, por toda la Web)
Valor=”ubuntu-es.org” buscara exclusivamente en este sitio
Crear el botón para iniciar búsqueda
Finalizar

Ahora en código:
(:input form action="http://www.google.com/search" method=get:) (:input default request=1:) (:input text name=q value="" size=20 :) (:input select name="sitesearch" value="" checked=1 :) (:input select name="sitesearch" value="ubuntu-es.org" checked=2 :) %padding-left=3px%(:input submit value="Google":) (:input end:)

Usted puede crear nuevas líneas de acuerdo a sus necesidades e intercalarlas entre los puntos 4 y 6.

Con el ejemplo de búsqueda anterior, una palabra o frase será buscada en Internet por medio de la cuarta línea valor=”", o específicamente como en la quinta línea con el valor=”ubuntu-es.org”, dependerá de nuestra elección en el menú adjunto y Google regresará todas las coincidencias, lo puede apreciar en la siguientes imágenes.

‘ ‘

Búsqueda Interna

Para realizar búsquedas locales, es decir, en las páginas propias de la wiki, basta introducir la siguiente línea:

(:searchbox:)

Abrir una Web con un clic

Para abrir una página Web de manera directa con un «clic» sobre un icono, pega el código posterior a esta descripción: Se le ordena a PmWiki crear un botón con la imagen.png, con enlace a una Web, pero que lo haga en una nueva pestaña (usted puede apreciar la fila de iconos en la imagen anterior).

%newwin% [[http://www.gmail.com/ | Attach: google.png ]]%%

He descrito algunos ejemplos del enorme potencial de PmWiki, muchas otras características las encontrará en el sitio oficial. Utilice la página de práctica llamada WikiSandBox ubicada en el menú de la barra lateral.

Espero les sea de utilidad como lo ha sido para mi.

¡Un saludo!