Los artículos se han de enviar en un formato ASCII plano. No te preocupes por estos términos, de hecho ASCII es el juego de caracteres por defecto para Linux e incluso Windows lo respeta en cierta medida.

Se utilizan etiquetas sencillas para enfatizar el texto en ciertos pasajes (títulos, listados, imágenes, etc.). Estas etiquetas se mantienen lo más cortas posible para evitar tecleos innecesarios. La siguiente sección detalla las etiquetas de formato brevemente.

Los elementos del texto, como títulos, cuerpo de texto normal, etc., se separan con etiquetas especiales. Las etiquetas siempre utilizan el formato @XX:. Nuestros textos en general incluyen los siguientes elementos:

• Una línea que describe el tema (@D:)
• Un ingenioso título/titular principal (@T:)
• Una introducción (@V:)
• El cuerpo del texto (@L:)
• Entradillas (o Subtítulos) (@ZT:)
• Una caja con un corto resumen del curriculum del autor (@IT:)

Sólo necesitas insertar una etiqueta cuando cambia el formato. Si tienes varios párrafos del cuerpo del artículo seguidos, bastará con un sencillo @L: al principio de la primera línea del bloque. Como los párrafos pueden comprender varias líneas de texto, un nuevo párrafo no ocurrirá hasta que se indique con una línea en blanco (cáracter de nueva línea) o con una nueva etiqueta.

Un artículo nunca comprende sólo texto. Las imágenes y otros elementos de maquetación (cajas, diagramas,...) avivan el flujo del texto. Después de todo, ¿a quién le interesaría un artículo compuesto exclusivamente de aburrido texto y sin gráficos ilustrativos, bonitas capturas o interesantes listados. Recuerda que las imágenes, tablas y cuadros son elementos móviles, por tanto no te puedes referir a ellos diciendo algo así como "Como se ve abajo..." o "Tal y como muestra la imagen...". En vez de ello, has de referirte a una Figura con un número. Cada imagen contendrá la palabra "Figura X" o "figx" en el nombre del archivo (p.ej.: "Figura 3.tif", "fig3.png", ...), a menos, claro está, que tu artículo contenga una sola imagen.

Imágenes

Los humanos encontramos más fácil digerir información visual que información verbal. Las imágenes no están para "rellenar" espacio en una revista, sino para facilitar al lector la comprensión de lo que en general son temas técnicos complejos. Mientras escribas intenta pensar qué necesitarás para que el lector te comprenda, ya sea en forma de gráficos y diagramas, o como capturas.

La pregunta de qué formato de fichero es el más adecuado es difícil de contestar. Xfig suele ser una buena elección para gráficos (es decir, diagramas, diagramas de flujo, etc.). Este formato es fácil de procesar (en la redacción todos utilizamos máquinas Linux, por supuesto), y de convertir en un Postscript de alta calidad. Sin embargo, si utilizas un formato diferente, procura incluir el formato original y una versión PS, EPS o PDF. Nuestros maquetadores a menudo han de sustituir fuentes y colores para reflejar el aspecto típico de Linux Magazine. Para fotos, tanto JPEG (no muy comprimidos, por favor) como TIFF son formatos adecuados. En caso de duda, pregunta a la redacción.

Para capturas de pantallas, PNG y GIF son adecuados, pero JPEG no. Cuando vayas a crear una captura, procura que contenga sólo los áreas de pantalla relevantes, en vez de un montón de espacio vacío.Los combinaciones de colores que elijas deberán reflejar el (sobrio) gusto típico europeo y para que no queden demasiado chillones en el conjunto de Linux Magazine. Recuerda que las fuentes, en especial los menús, han de ser legibles en una revista impresa, por lo que se aconseja restringir el tamaño de la ventana de las aplicaciones a como mucho 800 x 600 pixels.

Las figuras se indican del siguiente modo:

@Bi:fig1.png @B:Figura 1: Aquí vemos a Julián compilando su primer kernel. Nótense las perlas de sudor en su frente mientras observa la salida de los diferentes comandos make.

El pie deberá describir lo que se ve en la imagen (¡claro!) y, por tanto, enfatizar el aspecto importante que tienen las imágenes. Utiliza una oración como la siguiente en el cuerpo del texto para referirte a una imagen:

@L:La Figura 1 muestra a Julián compilando el kernel.

Ó:

@L:... vemos a Julián compilando el kernel (Figura 1)

Etiquetas en el cuerpo del artículo

El cuerpo del artículo siempre empieza con la etiqueta@L:. Una etiqueta siempre se refiere al párrafo completo que le sigue. Dos asteriscos en vez de un espacio (como en "Red**Hat") denotan un espacio protegido que no puede ser partido por una nueva línea. Tiene una función similar a   en HTML.

EL marcaje de texto, como negrita, cursiva, etc., se indican con etiquetas encerradas entre signos de menor (<) y mayor (>). Nótese que estas etiquetas no se cierran de la misma manera como se hace en HTML. Comandos cortos como "rm -rf *" o nombres de ficheros y directorios se colocarán en el texto como sigue: <C>Código<C>. Esto aparecerá de la siguiente manera: rm -rf *.Otros posibles marcajes son <I>Cursiva<I>, "comillas" o, en casos excepcionales <B>bold<B>. Puedes también incluir URLs en el cuerpo del texto, utilizando la etiqueta <U> para indicar su existencia:

<U>http://www.mi.mama.me.mima.net/index.html<U>

Un Listado que comprenda sólo una o dos líneas de código puede introducirse con la etiqueta @LI: en un nuevo párrafo dentro del cuerpo del texto. Los listados se imprimen Courier a unos 40 caracteres por línea. Si la línea es más larga, asegúrate de separar la línea. Utiliza el ßß (Alt Gr + 's') para indicar que sigue en la siguiente línea. Obviamente tendrás que procurar que esta secuencia de caracteres se use exclusivamente para esto. Por ejemplo:

@LI: ./configure --with-idea --prefix=/usr --with-rsa

es demasiado largo. Sería preferible:

@LI: ./configure --with-idea --prefix=/usr ßß --with-rsa

Lo lógico es colocar listados más largos en un cuadro aparte. Los listados también pueden suministrarse como ficheros separados. Hay que asegurarse de que se suministran sólo scripts o ficheros fuente completos (es decir, ejecutables), ya que estos se almacenarán en un servidor FTP.

Si existen demasiadas líneas de código en el cuerpo del artículo, éste se hace difícil de leer. Por tanto debería pensarse en colocar el código en un cuadro separado en el artículo.Sabemos que esto no siempre es posible, pero al menos debería intentarse.

Los cuadros siempre tienen un título (@KT:). El texto normal en un cuadro se indica con la etiqueta (@KL:). Los listados se formatean utilizando @LI:, como en el resto del cuerpo del artículo:

@KT:Listado 1: xy.c @LI: #include <stdio.h> ...

Además de código, los cuadros pueden contener información adicional, como glosarios, entrevistas o simplemente un aspecto diferente del tema principal que no tiene cabida en el cuerpo principal del artículo. Todo ello es permisible e, incluso, deseable, pero tampoco conviene abusar.

Las tablas tienen una apariencia similar a los cuadros y comienzan con una etiqueta @TT:. Las líneas individuales de una tabla deben ocupar una línea de código del texto fuente y las columnas separadas por tabuladores, de la siguiente manera:

@TT:Tabla 1: Carácter @TL:Columna1 Columna2

Puedes ahorrarle a nuestro equipo de maquetación muchos dolores de cabeza si nos suministras las tablas en forma de hojas de cálculo (OpenOffice o similar) o en formato compatible con una hoja de cálculo (.csv o similar). Si no, existe el peligro de que la información acabe cayendo en una columna que no es la suya.

La sección Info incluye referencias a URLs o a literatura sobre el tema abordado en el artículo. Normalmente esta información viene en un cuadro al que se accede con una etiqueta @IT:Info donde las referencias se colocan en un área delimitada por @IL::

@IT:Info @IL: [1] Manual en línea para Criadores de Pingüinos: <U>http://www.penguin.org/handbook<U> [2] Casa Carlitos: El Kernel -- Compilación sin Complicación Linux Magazine, Número 22, pág. 45

Utiliza los corchetes [1] en el texto para referirte a un nota al pie en la sección 'Info'.

El cuadro sobre el autor es similar al cuadro Info y se presenta de la siguiente manera:

@IT:El Autor @IL:María Pérez es programadora y ...

• uso excesivo de abreviaciones (p.ej., etc., US $)
• abuso de las formas pasivas
• cambio excesivo de la perspectiva de la narración (tú, vosotros, yo, nosotros)
• insuficientes ilustraciones, sin pies o con pies poco descriptivos
• muy seco: se lee como una página 'man'
• párrafos cortos (de una o dos líneas) e inconexos
• exceso de formalidad
• exceso de informalidad y abuso de smileys
• sin subtítulos (entradillas) o con subtítulos demasiado cortos
• formatos de ficheros inaceptables, como HTML, Latex, Star Office, Word, en vez de texto ASCII