He hecho un minimanual de instalación de mapache para la version 1.09.
Falta la mitad pero la parte mas importante ya está. por favor, echadle un ojo a ver que os parece y decidme si se ve claro todo.

Si quereis añadir algo, o contribuir de la manera que sea (haciendo una sección, corrigiendo tildes, etc) se agradecerá mucho.

Mapache 1.0.9

1.-Introducción

Mapache es un sistema de weblog personalizable.
Instalando Mapache en un servidor, tendrás un sistema avanzado y modular de weblog que podrás personalizar a tu gusto, ya que las funciones de weblog son totalmente independientes del diseño. Mapache viene con una plantilla muy básica preinstalada (la que veras cuando lo instales por primera vez), pero la idea es que tu hagas el dise�o, y al dise�o le a�adas los modulos de mapache que consideres oportunos.

Para utilizar mapache con la plantilla predeterminada (o con las que vayan apareciendo posteriormente) no necesitas conocimientos de html. Pero si tu intención es cambiar el aspecto gráfico de mapache, necesitarás saber html. La idea es que tu hagas primero el diseño de tu weblog, y luego le a�adas las funciones de Mapache.

En la sección personalizaci�n hay un ejemplo completo de como hacer un weblog desde 0 con Mapache, pero para que te hagas una idea, las funciones de mapache son bloques de codigo del estilo post(4);. Si introduces este codigo en una de tus páginas de weblog, mapache mostrará los 4 ultimos posts. Algunas funcioens admiten parametros. Por ejemplo post(4,"/images/separador.gif"); mostrar� los 4 ultimos posts, pero separandolos con la imagen separador que se encuentra en el directorio /images de tu web.

2.-Instalación

2.1. Requerimientos

Para instalar Mapache necesitas un hosting o un servidor conectado a internet (vale, tambien lo puedes instalar en tu casa, pero solo podrás verlo t�). El servidor puede ser linux, windows, bsd, lo que quieras, pero tiene que cumplir los siguientes requerimientos:

• El servidor debe ser Apache (1.3 o 2.0).
• Debes tener acceso a una base de datos mysql 4.1 o superior (la mayor parte de los hostings te dan una al menos)


• El servidor debe permitir PHP

Como ves, los requerimientos son bastante sencillos. Es bastante conveniente que tu servidor apache disponga de mod_rewrite, pero mapache funcionará bien aunque no este instalado.
En caso de cualquier duda, tu proveedor de hosting puede resolverte cualquier duda con respecto a si sus equipos pueden ofrecerte lo que necesitas para instalar mapache.

2.1. Preparación del servidor.

Lo primero que debes hacer es poder conectarte al servidor. La forma habitual de hacerlo es con un cliente de ftp. Tu proveedor te habra dado un nombre de usuario y una clave. Este será el metodo con el cual subiras los ficheros de mapache a tu servidor
Lo segundo que necesitas saber es el url de tu weblog. El url es el "nombre en internet" donde la gente encontrará tu weblog. Puede ser directamente un nombre de dominio (el mio esta en http://www.incoherencia.com) o un nombre de dominio + un directorio (por ejemplo http://www.incoherencia.com/mapachebeta). Lo normal es instalar mapache en el raiz (no usar directorio).
Lo siguiente que necesitas es crear una base de datos y un usuario de mysql. Puede que tu proovedor de hosting ya haya creado una por ti. En este caso te habrán enviado los 3 datos que necesitas: nombre de la base de datos, usuario y password. Otra posibilidad es que te hayan dado acceso a un panel de control para que crees tu la base de datos. El mas comun es phpmyAdmin. Si no sabes crear la base de datos y el usuario, puedes mirar en la ayuda de tu proveedor, preguntarselo directamente, o ir a google e investigar. Es bastante sencillo. En phpmyAdmin creas la base de datos, creas un usuario con su password y das privilegios a ese usuario sobre la base de datos. Si puedes, crea la base de datos utiliazndo el cotejamiento utf8_general_ci (si no sabes de que te estoy hablando, ni te preocupes). En la gran mayoria de los casos, el servidor de mysql va a ser la propia maquina que aloja tu web, y por lo tanto tu servidor va a ser "localhost". En el caso de que tu proveedor te indique que el servidor es otro, apunta tambien el nombre o ip del servidor mysql.

2.2. Instalación

Conectate con ftp al servidor, y sube a tu directorio de web (o al subdirectorio correspondiente, si es que quieres instalar mapache en un subdirectorio) todos los ficheros que componen Mapache.
Utilizando la opcion cambiar permisos de tu programa de ftp, pon los permisos de los ficheros rss.xml, atom.xml y config.php a 666 ( o a rw-rw-rw, depende de como muestre los permisos tu cliente de ftp).
Abre en tu navegador la página en la que has instalado mapache (en mi caso sería http://www.incoherencia.com). Te cargará una pagina llamada "Configuración de mapachido weBlog".

Ahora deberás rellenar los campos ed configuración de mapache. La mayor parte de los datos los averiguaste en la secci�n anterior. Los que no sabes, probablemente tengas que inventartelos o dejarlos en blanco.

• Base de datos: Es el nombre de la base de datos que vas a usar para mapache. Averiguaste cual era o la creaste) en la sección 2.1.
• Usuario de la base de datos: Es el nombre del usuario de la base de datos que vas a usar para mapache. Averiguaste cual era o lo creaste) en la sección 2.1.
• Password de la base de datos: Es el password del usuario de la base de datos que vas a usar para mapache. Averiguaste cual era o lo creaste) en la sección 2.1.
• Servidor de mysql: Deja esto como "localhost" a no ser que sepas claramente que el servidor se encuentra en otra maquina. En ese caso mete el nombre o ip de la maquina donde esta el servidor de mysql.
• Usuario de Mapache: Inventate un nombre de usuario con el que haras login en mapache para crear entradas, postear, o como lo quieras llamar.
• Password de mapache: Inventate una password para el usuario de mapache.
• Url del servidor: Mete aqui el url de tu weblog. Lo averiguaste en la seccion 2.1. No termines en utl con una "/".
• Nombre de tu weblog: Inventate un nombre para tu weblog e introducelo aquí. este campo es necesario para generar los feeds y para unas cuantas cosas más.
• Usuario de Livejournal: mapache tiene la capacidad de enviar a livejournal todo lo que postees en tu web. Los posts de livejournal pueden ser completas copias de los que aparezcan en tu web o solo el numero de parrafos que tu digas. Todos los posts de livejournal tendrán un link a tu web mapache. Si quieres hacer uso de esta funcionalidad, introduce tu usuario de livejournal.
• Password de livejournal: Exactamente igual que arriba. pero con el password.
• Dirección de correo: Introduce aquí tu direcci�n de correo. Mapache te avisará de nuevos comentarios, intentos de instrusi�n y algunas otras cosas.
• Descripción de tu weblog: una descripci�n breve para los feeds, google y technorati.

A continuación vienen 3 campos para el envio de pings xmlrpc. Si esto te suena a chino, dejalo como está. Mapache enviará pings a technorati cada vez que actualices. De esta forma la gente podr� encontrar entradas tuyas en technorati, conseguiras mas visitas, google te vendr� a ver mas a menudo y ese tipo de cosas. Si quieres hacer pings xmlrpc a algun sitio especifico, pon los datos de ese sitio.
Cuando hayas rellenado todo, pulsa el boton Chachi y mapache creará las tablas de la base de datos, hará el fichero de configuración.

Si todo ha salido bien, verás un Configuración completada con éxito. Puedes pulsar en el link de "Pagina Principal" y comenzar a usar mapache.

2.3. Post-Instalación

Es muy importante que una vez hayas instalado mapache, quites los permisos al fichero configdb.php. Si no lo haces alguien podría reescribir tu configuración dejandote sin acceso a tu weblog.
Tienes dos formas de hacerlo:

1. Conectate por ftp y borra el fichero configdb.php
2. Conectate por ftp y pon los permisos de configdb.php a 000

Ya tienes tu mapache funcionando y asegurado.

3.-Problemas

3.1. Problemas enla instalación

4.-Personalización

4.1 Como modificar los estilos.

Vamos a ir poniendo aqui los bugs de esta version y las modificaciones hasta tener la version definitiva.

Necesito ayuda con mod_rewrite. ¿Que hacer cuando no está y como detectar que no esta instalado?

He montado un servidor de pruebas de mapache. La idea es utilizarlo para comprobar diferentes configuraciones, pero mas adelante, dar alojamiento de mapache.

Todos aquellos que quieran hacer temas (o sea, rehacer el index.php con un aspecto grafico diferente) pueden enviarmelos a zor@incoherencia.com.

Esta página irá actualizandose.

1.09 [*] modificacion de configdb.php para que cree las tablas en servidores remotos si es necesario.
1.09 [*] El login no funcionaba en mapaches fuera del raiz. Identificado por Chapon. cambiado weblog.php
1.09 [*] El rss.xml y atom.xml no generaban bien los links. Cambiado en weblog.php. Identificado por David
1.09 [*] El rss.xml y atom.xml no estaban en utf8. Cambiado en weblog.php. Identificado por David
1.09 [*] Configdb.php debe cargarse cuando config.php mida 0 bytes (en vez de cargarse cuando no exista!) Cambiado index.php
1.09 [*] Falta $base_url en admin.php (identificado por Goizeder)
1.09 [*] Falta $base_url en adminprocesa.php (identificado por Goizeder)
1.09 [*] Falta $base_url en weblog.php (identificado por Goizeder)

1.09[+] Añadido soporte para servidores sin mod_rewrite. Nuevo fichero nomodrewrite.php.

Bueno, mapache 1.09 ya esta listo para ser distribuido al público.

Me gustaría probarlo un par de veces mas, y hacer algun tipo de introducción - manual y ajustes gráficos. Así que busco voluntarios que me quieran echar una mano a arreglar chorradas tipo faltas ortográficas, formularios que no estan bonitos, (como el de postear) y similares.

Y tambien a hacer un minimanual de como se instala, se actualiza, y como se hace uno una skin nueva. Si no hay voluntarios, pues lo hare yo solito.

Y si alguno quiere hacer algun tema para incluirlo, que me avise. La idea es tener diferentes index.php y que al instalarlo puedas elegir que tema usar.

Ya esta disponible mapache 1.08 Tu sistema de weblog amigo para dominar el mundo.

Tenemos un nuevo betatester: Macstabilo

Estos son los cambios realizados:

1.08 [*] el seguimiento de usuarios no funcionaba por un error en la funcion anadecomentario (se modifica weblog.php)
1.08 [+] Se añade un nuevo parametro en el fichero de configuración $mysqlserver="nombre del servidor mysql" (localhost por defecto)
1.08 [*] Se modifica configdb.php para que pregunte por el parametro mysqlserver
1.08 [*] corregidos errores en la funcion login que impedian el login en mapaches instalados fuera del raiz (identificado por Goizeder)
1.08 [*] corregidas las localizaciones del fichero de estilos, que hacian que la pagina se descojorciara si se instalaba fuera del raiz. (configdb.php, admin.php, adminprocesa.php,visitors.php)
1.08 [*] corregido un error por el cual no funcionaba el seguimiento por ip [en weblog.php]
1.08 [+] Se añade una funcionalidad para asignar nombres a usuarios identificados por cookies.[adminprocesa.php, weblog.php]
1.08 [*] Se corrige el tabindex del formulario de dejar comentarios para que sea coherente con la distribucion de los input. [weblog.php] (identificado por Chimeno
1.08 [*] Se corrige un valor relativo en el fichero de estilos (font:90% por font:10px;)
1.08 [*] Se aumenta en 1 px el tamaño de letras de los comentarios para facilitar la legibilidad.
1.08 [*] Deteccion del http:// en el campo de web al dejar comentario.

Espero que a partir de esta versión, ya no haya mas cambios radicales en estructura ni de bbdd ni de index. En un par de versiones (dentro de unos dias) la pondré disponible al publico.