Ortotipografa de programas informticos

Javier Bezos
Versin 0.1. 2007-03-14.

Este documento tiene como propsito proporcionar una serie de reglas generales sobre la composicin de cdigo informtico destinado a tcnicos, autores, editores y correctores que tienen que tratar con obras o artculos de este tipo. Cdigo El cdigo escrito en algn lenguaje de programacin deber distinguirse tipogrcamente del texto, normalmente con letra sin remates o mecanogrca. Listados de cdigo En los bloques de cdigo que ocupan varias lneas, se deber prestar atencin a la posibilidad de que la medida del texto sea inferior a la longitud de las lneas del cdigo. Es ese caso, no se dejar que el cdigo pase simplemente a la lnea siguiente (y menos sin sangrar), sino que se organizar siguiendo las reglas sintcticas del lenguage, normalmente con sangrado adicional, y en ocasiones con el apoyo de algn signo especial (ninguno en C, Java o Pascal, pero \ en Python, _ en Visual Basic y en AppleScript, por ejemplo). if (png_info (img)->valid & PNG_INFO_pHYs) { img_xres (img) = round (0.0254 * png_get_x_pixels_per_meter (png_ptr (img), png_info (img))); img_yres (img) = round (0.0254 * png_get_y_pixels_per_meter (png_ptr (img), png_info (img))); } y no if (png_info (img)->valid & PNG_INFO_pHYs) { img_xres (img) = round (0.0254 * png_get_x_pixels_per_meter (png_ptr (img), png_info (img))); img_yres (img) = round (0.0254 * png_get_y_pixels_per_meter (png_ptr (img), png_info (img))); }

2 Tambin se puede emplear un signo especial que indique que una lnea es continuacin de la anterior y que debe considerarse que en el cdigo es en realidad una sola lnea: if (png_info (img)->valid & PNG_INFO_pHYs) { img_xres (img) = round (0.0254 * png_get_x_pixels_per_meter (png_ptr (img), png_info (img))); img_yres (img) = round (0.0254 * png_get_y_pixels_per_meter (png_ptr (img), png_info (img))); } Alineacin Cuando la letra sea mecanogrca, se ajustarn las lneas de forma que los caracteres resulten alineados verticalmente, por lo que el espacio ha de ser jo: for f in fndf.split(\n): f = f.strip() end y no for f in fndf.split(\n): f = f.strip() end Cdigo en texto Contra la norma general, los signos de puntuacin pegados al cdigo pero que no forman parte de l, deben ser de la letra principal, aunque conservando la gura y el trazo. Adems, los espacios del cdigo, incluso si forman parte de l, deben ser los que corresponden al texto (en la letra mecanogrca suelen ser jos y ms anchos, lo que resta uniformidad a los prrafos).
Entre los mtodos de la clase String estn: count, find, index, join, split, strip y otros. y no Entre los mtodos de la clase String estn: count, find, index, join, split, strip y otros. La orden a.put (x, i) asigna x al valor i-simo de a. y no La orden a.put (x, i) asigna x al valor i-simo de a.

Puntuacin Los listados de cdigo, es decir, el cdigo que no est en el texto sino dispuesto aparte, no llevarn ningn signo de puntuacin que no les corresponda, incluso si les pudiera corresponder por su posicin en el texto (coma, punto, etc.). Si se trata de un cdigo breve del texto, que cita una orden, la explica, etc., s se pondr la puntuacin que corresponde al texto. Contacto Para errores, comentarios y sugerencias, puede ponerse en contacto conmigo a travs de:

3 http://www.tex-tipografia.com/contact.html La ltima versin de este documento est disponible en: http://www.tex-tipografia.com/typo.html Licencia Este documento se puede distribuir e imprimir libre y gratuitamente tanto en formato electrnico como impreso, pero su contenido est bajo copyright del autor y no se puede copiar, ni reproducir en otras obras sin autorizacin previa del autor, salvo en caso de cita tal y como prev la legislacin espaola. c 2005-2008. Javier Bezos.