MANUAL DE ESTILO DEL TEXT-RIDER =============================== //\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\ // // // (( Text Rider - Weblog Management System )) // // This program is designed and published by Ahmad and it // // is free to use and modify under GNU General Public License // // Copyright © 2005 by Ahmad // // mollasadra@Gmail.com // // November of 2005 // // // // Diseño del tema 'Empedrado' modificacion del codigo para // // lectores hispanoparlantes (coments descendentes) y trasla- // // cion al español (argentino) por Edwin Aguiar // // Corrientes / Argentina elobservadordelsur@gmail.com // // Diciembre de 2005 // // // //\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\ 1.Que diablos es un CMS y que es Text-Rider ------------------------------------------- Un CMS es un gestor de contenidos que suele usarse para hacer desde portales en la internet hasta blogs, como en este caso. Text Rider (Algo asi como el jinete del texto) es una apli- cacion para hacer un weblog o blog de manera sencilla e intuitiva. 2. Hay limitaciones? -------------------- Por parte de su autor y de quien modifica esta version (yo) ninguna pues es codigo libre ba jo la licencia general GNU. Asi que puedes usar, modificar y hacer lo que se te venga en ga nas siempre y cuando respetes los derechos de auto precedentes. Las limitaciones que hay son mas bien fisicas, es decir este sistema posee capacidades limi tadaas por sus prestaciones. Como no usa bases de datos, "parsea" el texto de los post y de los comments en archivos de texto plano, es logico suponer que con Text Rider no podras ha- cer un "barrapunto" como lei por ahi. 3. Que hacer con Text Rider? ---------------------------- Con sta maravillosa aplicacion basada en php podras hacer cosas tales como: a) Tablones de noticias o anuncios de tu escuela, club, oficina o lo que desees poner en la red (Internet) o en tu lan (localhost) b) Sitios ligeros, rapidos y faciles de cargar, altamente compatibles con las normas de la W3C (html, php, css, rss) con el cual TODO el mundo te vera sin que tengan que agonizar esperando que bajen esos fastidiosos archivos flash, cosas extravagantes de ASP p CGI u- sualmente incompatibles (por inepcia de sus desarrolladores) con los navegadores libres o los que no son IE. c) El placer de usar algo agradabe y sencillo de instalar y usar. 4. Que no hacer con el Text Rider --------------------------------- Blogs de miles de visitantes diarios, post largos y abundantes, galerias de fotografias al estilo de los fotoblogs, etc. 5.MIS METIDAS DE MANO EN EL CODIGO DEL POBRE AHMAD: --------------------------------------------------- Ademas de traducir la parte publica del Text Rider (cosa que seguire haciendo) he modifica- do algunas cositas: 1> Comentarios en orden descendente, al uso nostro 2> Diccionario de consulta: DRAE (Diccionario de la Real Academia Española) No ibamos a preguntarle al Oxford por palabrejas en nuestro idioma? 3> Modificaciones del TAG IMG para dotarlas de algunas prestaciones adicionales tambien a nuestra forma de usar el texto. 4> LETRAS CAPITELES: incorporacion de letras para capitalizar las letras de inicio de cada post o parrafo, como te venga en ganas; son imagenes (ver manual mas adelante) =========================================================================================== I N S T A L A C I O N =========================================================================================== HAY DOS TIPOS DE INSTALACIONES: -> En tu red lan (o pc solitaria) en tu localhost o -> En la Internet (obviamente) Para ambas instalaciones se sigue un proceso muy elemental: -> Baja este ZIP y descomprimelo en una carpeta lla mada 'textrider' -> Coloca esta carpeta en tu localhost (segun el ti po de linux que uses puede ser /var/www/html/ o en un mal windows con un pobreton LAMP en c:/"lamp"/html o algo asi) -> En la internet en tu servidor en la raiz, copian do las carpetas y el index.php y asignando permi sos de lectura y escritura (si no es asi nadie - podra opinar y grabar sus comments o los otros - posteadores subir sus articulos/post). +-----------------------------------------------+ | usuarios de linux: chmod 666 | +-----------------------------------------------+ Primera instalacion y diagnosis: -------------------------------- Welcome to TEXT RIDER... everything is ready to be used ! the default user/pass is admin/admin(you can and should change the password when you log in) ... check see if these files are writable : the 1s.txt file in the data folder -> Unwriteable the userlist.txt file in the data folder -> Unwriteable the temp.txt file in the data folder -> Unwriteable the comment.txt file in the data folder -> Unwriteable the Default.tpl file in the data folder -> Unwriteable the config.php file in the data folder -> Unwriteable the data folder -> Unwriteable the files folder -> Unwriteable If they are not you should make them Writeable by changing thier Chmod (files to 666 and folders to 777) using your FTP program ... If everything was okay you can go ahead and login ... plaese send any feedback that you migh have to mollasadra [at] Gmail [dot] com ENJOY ! o su traduccion al español: --------------------------- Bienvenido a TEXT RIDER... Utilidad listra para ser usada de inmediato El usuario y contraseña son admin/admin (Cambialos despues de ingresar por primera vez!)... Y revisa que estos archivos se puedan escribir en tu servidor/localhost : the 1s.txt file in the data folder -> Unwriteable the userlist.txt file in the data folder -> Unwriteable the temp.txt file in the data folder -> Unwriteable the comment.txt file in the data folder -> Unwriteable the Default.tpl file in the data folder -> Unwriteable the config.php file in the data folder -> Unwriteable the data folder -> Unwriteable the files folder -> Unwriteable Si no sabes como hacerlo ('chmod 666') prueba en busca en este link como hacer Chmod (archivos: 666 y directorios: 777) usando tu programa de FTP Si los archivos son modificables, logueate como admin/admin para entrar al panel de control (y cambiar las contraseñas luego) Agradecere tu mail contandome a: mollasadra [at] Gmail [dot] com (Autor) o a elobservadordelsur[at]gmail.com para esta traduccion y modificacion Diviertete! En pocas palabras: SI SALEN LOS MENSAJES DE "UNWRITABLE" ES QUE DEBES CAM BIAR LOS PERMISOS A 666 (ARCHIVOS) y 777 (DIRECTORIOS). Recomendaciones: ---------------- Si eres desarrollador y te interesa meter mano al codigo lo que puedes hacer es instalarlo en tu localhost el Text Rider y desde alli manipular el codigo antes de subirlo (o hacer algun - upgrade) a tu servidor mediante FTP. ============================================================================================= C O M O U S A R T E X T - R I D E R ============================================================================================= Es muy sencillo e intuitivo. Primero debes logearte como admin y cambiar la contraseña, una - vez que lo hayas hecho puedes crear nuevos usuarios desde el panel de control. Alli los nue - vos usuarios podran tener privilegios de root o no, segun selecciones. En el PANEL DE CONTROL veras una serie de operaciones que por sencillas no requieren explica- ciones ulteriores, solo sigue las indicaciones y haras el trabajo de subir material o modifi- carlo a tu gusto. Debes tener en cuenta que si no eres admin o posees privilegios como tal,hay operaciones que te estaran vedadas. Como usuario no podras modificar articulos de otros ni borrarlos, asi co mo tampoco modificar el template (plantilla de estilo) del sitio. Ahora pasemos al manual de estilo ============================================================================================ M A N U A L D E E S T I L O ============================================================================================ 1.Que es un MANUAL DE ESTILO? ----------------------------- Es una serie de normas y estilos para determinar la identidad y el contenido del texto dando una serie de pautas de formateo que redundan en relzar el mensaje que se desea trasmitir. No es algo menor que textos mal redactados o mal formateados pierden su fuerza y capacidad de - llegada al publico. Este breve manual de estilo es solo una serie de pautas que ayudan a que tu mensaje (post/articulos) sean mas efectivos, esteticamente mas ordenados y agradables. Cuida la sintaxis y los acentos (no escritos en este documento por una cuestion de compatibi lidad con otros juegos de caracteres). 2. Como postear articulos ------------------------- La desventaja del Text Rider de parsear texto en lugar de usar bases de datos lo hacen ideal para articulos cortos; asi que cuando escribas ve directo al grano, escribe teniendo en cuen- ta tu objetivo o mensaje. Usa un esquema de informacion que sea descriptivo, por ejemplo es-- tructurando el texto segun los canones aristotelicos: 1------------------------> introduccion--------> en breves palabras introduce en el tema indi cando cual es el asunto del que trata, desde el titulo que debe ser corto e indicativo. 2------------------------> desarrollo----------> aqui debes exponer tus argumentos y contrar- gumentos mediante el desarrollo de la trama expositiva (o explicativa si es una opinion) 3------------------------> conclusion----------> finaliza la argumentacion con la definicion del tema o tu opinion, usualmente en una fra se o parrafo aparte, que cierra el post. Nombres propios: ---------------- Cuando menciones sustantivos propios (nombre sde personas o lugares) conviene resaltarlos con negrita. Esto se hace presionando el tag BOLD antes y despues /BOLD (para cerrar el tag) esto insertara las etiquetas y dentro del articulo, lo cual marcara al texto. Citar frases: ------------- Para citar frases debes colocar ITALIC antes e /ITALIC despues del texto citado (cita textual) esto insertara los tags y enfatizando al texto encerrado entre ambas etiquetas. Colocar links: -------------- al igual que en las anteriores, pero te pedira que coloques la direccion, luego la palabra del link y finalmente que cierres el tag. Imagenes: --------- En el caso del tratamiento de imagenes he configurado una serie de valores predeterminados por default: alineacion a la izquierda con un espacio de 10 pixeles entre el texto y la imagen, el tag de imagen te pedira que ingreses los siguientes parametros: 1) Ruta de la imagen (usualmente es '/images/xxxxxxx.jpg' lo cual quiere decir que debes subir tus imagenes a la carpeta images dentro del servidor y de localhost. 2) Una descripcion de la imagen, para colocar en el sitio mientras aparece la imagen, es una propiedad del tag 'img' que muestra el 'alt' (alternativo). 3) Una leyenda que aparece cuando poses el cursor encima de la imagen, ideal para usar como un epigrafe, por ejemplo "Fulano de tal, dando un discurso" o lo que necesites. El resultante sera, por ejemplo: Pepe Corcholis Con esto se logra que el texto fluira alrededor de la imagen separado lo suficiente como para que lo lean sin que se estorben mutuamente y ademas posea texto alternativo (por si no carga o tarda la descarga de la imagen) y una leyenda. Conviene usar un ancho inferior a 150 px por el alto que desees, un ancho mayor crear una colum na con problemas de alineacion justificada creando lo que en diseño grafico se llaman "calles" afeando la composicion. No uses anchos mayores a 150 pixeles entonces, ni inferiores a 100 pixe les, trata que todas las imagenes respeten estas medidas para que no quede desparejo y desaline ada la composicion de cada post. Pon una imagenpor cada post o si este es largo dos, nunca mas porque se volveria farragoso. Letras Capiteles: ----------------- las letras capitalizadas con sencillamente archivos jpg que debes incluir con esta formula: letra.jpg Por ejemplo para la letra e: l flamante intendente electo Jose Antonio Cheme ha comenzado su ......... Diccionario incorporado: ------------------------ El original Text Rider usa un diccionario en red de Ingles, lo he sustituido por nuestro 'DRAE' (Diccionario de la Real academia Española). Con solo pulsar en 'Dict.' saldra un cuadro de dia- logo que preguntara por la palabra que necesites saber, por ejemplo: pene. (Del lat. penis). 1. m. Anat. Órgano masculino del hombre y de algunos animales que sirve para miccionar y copular. Real Academia Española © Todos los derechos reservados Listas: ------- Con este tag creas listas, debes colocar un tag de apertura y uno de cierre:
  • primer asunto
  • segundo asunto
  • tercer asunto
    • Donde 'n' asunto es cuestion tuya Close Tags: ----------- Algo util, por si te olvidas de cerrar un tag, con este boton lo solucionas y cierras los que ha yan quedado abiertos, pero ten en cuenta de revisarlos manualmente antes de postear. Aunque no hay 'divs' que creen peligrosos engorros, no esta de mas tener cuidado en al composicion del es- tilo de tu articulo. ================================================================================================ Esto es todo por el momento. Espero que este pequeño manual te sea de utilidad, cualquier sugere cia o duda no vaciles en consultarme o contactarme a elobservadordelsur@gmail.com Edwin M. Aguiar Diciembre de 2005 ================================================================================================