diff --git a/manual/README.md b/manual/README.md index 3f6a3cc..94f5e57 100644 --- a/manual/README.md +++ b/manual/README.md @@ -1,5 +1,113 @@ +## Normas y Formatos de Publicación ## + +Un resumen de cómo tienes que preparar tus artículos para que puedan ser publicados + +###Formato de los artículos e imágenes### + +* Todos los artículos deben de venir en texto plano .txt +* Se admiten imágenes en formato .png, .jpg o .gif. +* Intenta que no sean demasiado grandes para que se carguen más rápido. + +Completa la autoría del artículo con tu Nombre y Apellidos. + +Si has usado alguna fuente externa incluyelo como Bibliografía al final de tu artículo. + +###Numeración de los textos e imágenes### + +* El CMS interno de Solo Con Linux utiliza unicamente ficheros de texto e imágenes que estén numerados, esto se ha diseñado así para que la publicación y orden de las imágenes y textos a la hora de crear y generar las páginas html al vuelo sea rápida y sencila. +* Se utiliza una nomenclatura especial para renderizar y mostrar el html final que se muestra en la web. +* De forma general, **numera todos los ficheros con 3 digitos**, más un punto y la extensión del tipo de fichero para que sean procesados. +Todos los ficheros van numerados del *000* al *999*. + +###Ficheros con formato de nomenclatura y extensión obligatoria### + +* 000.txt: Contiene en su primera línea el título del artículo. +En su segunda línea debe de aparecer una pequeña y breve descripción del artículo. +Solo puede contener 2 líneas de texto. +* 000.png: Obligatoriamente debe ser un PNG. +Es la imagen que aparecerá como referencia al artículo. +Debe de tener un tamaño de 253×182 píxeles o un tamaño proporcional. + + +###Ficheros del Contenido del Artículo### + +Para elaborar el resto del artículo, las imágenes y los textos van numerados del 001 al 999. + +* El formato admitido para las imágenes es **.png, .jpg y .gif** +* Para los textos, solo se admite texto plano en un fichero **.txt** + +El formato de estos ficheros es: **NNN..ext** + +En donde: + + *NNN*: Tres dígitos del 001 al 999. + **: Su uso es opcional. Pero aporta claridad a la hora de revisar los artículos. + *ext*: Extensión del fichero (.jpg, .png, .gif o .txt) + +El CMS de Solo Con Linux genera la salida en formato HTML organizado por bloques, por simplificación del código sólo existen tres tipos de bloques en la generación del contenido web, aunque suficientes para generar un contenido web sencillo y elegante. + + +###Tipos de Bloques en los artículos### + +* Bloque de Imagen + + Sigue el formato NNN..ext + No puede existir ningun otro fichero con la misma numeración que él. + +![Bloque-Imagen](bloque_imagen.png) + +* Bloque de Texto + + Sigue el formato NNN..ext + El contenido es texto plano y admite acentos y símbolos especiales. + El texto siempre se muestra justificado. + + Los saltos de línea se fuerzan con
o el símbolo · (punto medio), que está sobre la tecla · 3 + No puede existir ningun otro fichero con la misma numeración que él. + +![Bloque-Texto](bloque_texto.png) + +* Bloque de Imagen con Texto + Se compone de 2 ficheros que tienen que tener la misma numeracion y descripción. + Ambos ficheros usarán el formato de nombre de fichero: NNN..ext + No puede existir un tercer fichero con la misma numeración. + + +![Bloque-Imagen](bloque_imagen_texto.png) + +###Formatos HTML especiales en los ficheros TXT### + +Los ficheros de texto .txt admiten el uso de etiquetas html dentro de ellos y son compatibles con Bootstrap 4. + +Etiquetas html permitidas: +``` + ...: Poner texto en negrita + ...: Poner texto en cursiva/itálica + ...: Resaltar texto, aparece en color rojo + ...: Simular una Tecla del teclado + ...: Poner un color Bootstrap 4 a un texto + ...: Poner texto en un tamaño menor +
 ...
: Muestra el texto tal y como se escribe, util para poner código o comandos Linux. +``` + +###Caracteres Especiales### + +Algunos caracteres especiales de HTML pueden no ser interpretados correctamente. +Si ocurre esto simplemente reemplaza ese caracter por su codificación html. + +Ejemplo: +``` + < El símbolo de menor se escribe como < + > El símbolo de mayor se escribe como > +``` + +Si quieres forzar varios espacios, puedes usar ``` ``` tantas veces como espacios desees incorporar. + + ## Ejemplo del Contenido de un Artículo ## + + Te muestro un ejemplo de los ficheros que pueder usar a la hora de elaborar tu artículo para que sean correctamente leidos por el CMS de Solo Con Linux. **Imágenes y Archivos de Texto** diff --git a/manual/bloque_imagen.png b/manual/bloque_imagen.png new file mode 100644 index 0000000..35ec150 Binary files /dev/null and b/manual/bloque_imagen.png differ diff --git a/manual/bloque_imagen_texto.png b/manual/bloque_imagen_texto.png new file mode 100644 index 0000000..eae11c0 Binary files /dev/null and b/manual/bloque_imagen_texto.png differ diff --git a/manual/bloque_texto.png b/manual/bloque_texto.png new file mode 100644 index 0000000..e379001 Binary files /dev/null and b/manual/bloque_texto.png differ