
MobBlog 1.0

Ana Saiz Garca (ana@cosasdedos.net)
David Fernndez Vaamonde (davidfv@cosasdedos.net)


* Proposito
----------------------

El proposito de este conjunto de librerias y programas escritos en perl es
el de insertar comentarios via un movil Amena, con su servicio de E-mail
en un blog de tipo Mlog.

Con ellos se podrán isertar comentarios estando en cualquier lugar (que
tengamos cobertura claro ;)), para realizar las entradas "in situ", que es
donde realmente se ve lo que se quiere poner y no se olvidan hasta llegar a
un ordenador.

* Programas necesarios
----------------------

Perl                     --- Cualquier interprete de Perl
LWP (libhtml-perl)       --- Mdulo para acceso web
Procmail                 --- Sistema de filtrado y distribuidor de correo

* Como se usa
----------------------

Antes de comenzar con la instalacin (muy sencilla), es interesante tener
claro como usaremos este sistema. Para insertar una entrada, desde nuestro
movil Amena y habiendo asegurado que podemos usar el servicio de E-mail
desde el mismo, mandaremos uno (o varios mensajes, ver las instrucciones del
uso de Amena-mail), a una direccin determinada por nosotros, procmail
recoger ese mail y lo reencaminar al sistema de MobBlog que se encargar
de formatearlo y enviarlo al weblog en cuestin.

Un SMS tpico para el uso con este sistema sera:

E nuestra@direccion.es clave.ttulo.resto del texto...

y mandado al 2222 (AmenaMail).

Donde clave ser una clave que nosotros hayamos configurado, el ttulo, ser
el ttulo que aparezca en la historia y el resto, ser el texto que aparezca
en la historia.


* Instalacin
-------------------------------

- Procmail

Hemos de instalar una regla en procmail, que desvie nuestro mail
hacia el programa de MobBlog, esto lo haremos en el fichero .procmailrc de
nuestro home, por ejemplo as:

:0
*^To.*mi@arrobadireccion.* 
| formail -k -X "From:" -X "Subject:" | /midirectorio/perl_mlog/moblogging.pl \
-c fichero_de_configuracin -w fichero_de_palabras -s fichero_de_tags 

Usando formail nos aseguramos que solo llegar a moblogging.pl el cuerpo del
mensaje, el subject y el from, de modo que no tendr que andar rebuscando
ms cosas en la cabecera.

- MobBlog

Este programa necesita instalar los .pm en la ruta donde estn todos los .pm
del sistema, para que puedan ser invocados desde cualquier punto del
sistema. Solo usa dos .pm: Mobtranslate.pm, que sirve para la traduccin de
abreviaturas y caracteres SMS y Mlog.pm que hace realmente le interaccin
con nuestro blog Mlog.

* Configuracin
-------------------------------

Hemos intentado hacer MobBlog para que fuese completamente configurable de
modo que cada uno pueda adaptar el programa a su manera de escribir SMS o a
sus preferencias con los tags. Hemos hecho por tanto 3 ficheros donde se ha
de configurar los usuarios permitidos por este sistema y las abreviaturas:

- moblog.config

Fichero donde se configuran los usuarios que haran uso del sistema, un
ejemplo de fichero:


--------------------------------------------------------------------------
#
#       Mobblog configuration file
#

# Admin URL

URL=http://mi.mlog.es/admin.php

# Users
# AUTHOR=phone_number:author:password:phone_key

AUTHOR=777888999:visperas:miclavemlog:miclavetelefonica
AUTHOR=101023132:benji:miclavemlog:miclavetelefonica

- sms_dict

Un diccionario que cambiar nuestras siglas por las palabras que esten en
este diccionario, el formato de cada lnea:

abreviatura=palabra real

y un ejemplo:

#
#       Sms-Moblog dictionary (Spanish)
#

#
#       New entries must be: sms_word=complete_word
#


#########
# Verbs #
#########

s=es

toy=estoy
tas=estas
ta=esta
tamos=estamos
tais=estais
tan=estan

- html_dict

Este diccionario usa expresiones regulares y est destinado a cambiar
nuestros propios tags por tags html, el formato es anlogo al anterior y un
ejemplo de ese fichero sera:

#
#       Sms-Moblog dictionary for HTML tags
#

#
#       New entries must be:
#               symbol_=beginning HTML tag
#               _symbol=ending HTML tag
#

b_=<b>
_b=</b>

i_=<i>
_i=</i>

s_=<strike>
_s=</strike>

u_=<ul>
_u=</ul>

Conclusiones
------------------------------------

Esperamos que os guste este pequeo "gadget" que hemos escrito para Mlog.
Surgi como un experimento para poder blogear la ltima quincena de agosto
en nuestras vacaciones y todava lo estamos probando. Esperamos hacer buen
uso de el. Tambin hemos creido que sera una buena idea publicarlo para que
la comunidad de Mlogeros que cada vez somos ms, pudiera tener un mtodo
sencillo de  hacer mobblog.

Este programa esta licenciado bajo GPL y se acoge a cada punto de esa
licencia, esta licencia la podeis ver en el fichero license.txt que acompaa
a esta distribucin de cdigo.

Si os gusta, os podeis pasar por nuestro blog por el que, de cuando en vez
publicamos nuevos "gadgets" para Mlog y algn "Tip&Trick":

   http://www.cosasdedos.net

All tambin podreis encontrar nuestra direccin de contacto.
