Sangría (composición tipográfica)
En la forma escrita de muchos idiomas, una sangría o sangría es un espacio vacío al comienzo de una línea para señalar el comienzo de un nuevo párrafo. Muchos lenguajes informáticos han adoptado esta técnica para designar "párrafos" u otros bloques lógicos en el programa.
Por ejemplo, las siguientes líneas tienen sangría y utilizan entre uno y seis espacios:
Este párrafo tiene una sangría de 1 espacio.
Este párrafo tiene una sangría de 3 espacios.
Este párrafo tiene una sangría de 6 espacios.
En programación informática, los neologismos outdent, unindent y dedent se utilizan para describir la inversión del proceso de sangría, realineando el texto con el margen de página (o con niveles de sangría anteriores, menores).
En los idiomas que se escriben de derecha a izquierda (por ejemplo, hebreo y árabe), la sangría se utiliza de la misma manera, pero desde el margen derecho del papel, donde comienza la línea.
Sangría en la composición tipográfica
Hay tres tipos principales de sangría, que se ilustran a continuación en relación con los bordes que representan las dimensiones de la página.
- A indentación de primera línea indents only the first line of each paragraph.
- Una indentación de primera línea de 2 em:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
- A indentación colgante indents the remaining lines of each paragraph while leaving the first line of each paragraph in place.
- Una indentación colgante de 2 em:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
- A indentación del bloque Identifica todo el bloque de texto.
- Una indentación de bloque de 2 em a la izquierda:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
- La indentación de ambos lados se utiliza comúnmente para las citas de bloque, aquí mostradas con 2 em en la izquierda y derecha (que puede ser mayor en la derecha para ciertas líneas, dependiendo de la envoltura de palabras, si el texto no tiene alineación justificada):
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
- Un ejemplo justificado-texto de una cita de bloque que ha sido bloqueada de ambos lados por 3 em:
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Sangría en programación
En los lenguajes de programación de computadoras, la sangría se utiliza para formatear el código fuente del programa para mejorar la legibilidad. La sangría generalmente sólo es útil para los programadores; A los compiladores e intérpretes rara vez les importa cuánto espacio en blanco hay entre las declaraciones de programación. Sin embargo, ciertos lenguajes de programación se basan en el uso de sangría para demarcar la estructura de programación, utilizando a menudo una variación de la regla del fuera de juego. Los lenguajes de programación Haskell, Occam, Python, MoonScript y Ya se basan en la sangría de esta manera.
Las opiniones sobre dónde aplicar sangría, si utilizar espacios o tabulaciones y cuántos espacios utilizar suelen ser objeto de acalorados debates entre los programadores, lo que lleva a algunos a describir las disputas sobre sangría como algo similar a una guerra religiosa. En 2006 se propuso un tercer método de sangría, llamado tabulaciones elásticas.
Además de la sangría general de las declaraciones, comúnmente se utilizan diferentes estilos de sangría entre corchetes.
| Idioma | Indentación | Nota |
|---|---|---|
| Bash | varias | La guía de estilo de Fritz Mehner sugiere 2, 4 o 8 espacios y utiliza 2 en todos los ejemplos. Google utiliza 2 espacios. |
| C | varias | El núcleo Linux utiliza 1 pestaña. NASA utiliza 4 espacios. Clinton Staley aboga por 3 espacios. |
| C++ | varias | Web Kit recomienda 4 espacios. Google utiliza 2 espacios. |
| C# | 4 espacios | Convenciones de codificación C# de Microsoft. |
| CSS | varias | Drupal, GitHub y Google utilizan 2 espacios. Palabra La prensa usa pestañas. |
| Dart | dart format utiliza 2 espacios.
| |
| Delphi | 2 espacios | Per Delphi Style Guide. |
| F# | 4 espacios | De acuerdo con la guía de estilo F#. |
| Vamos. | 1 ficha | Por "Effective Go". |
| Haskell | varias | Google utiliza 2 espacios. |
| HTML | varias | Google utiliza 2 espacios. HTML Tidy predetermina a 2 espacios. |
| Java | varias | Oracle utiliza 4 espacios. Android utiliza 4 espacios. La mayoría de los componentes de Eclipse IDE usan pestañas. |
| JavaScript | varias | Douglas Crockford aboga por 4 espacios. GitHub y Google utilizan 2 espacios. jQuery usa fichas. El jsbeautifier integrado de Firefox predetermina a 2 espacios. El grabador incorporado en Google Chrome e Internet Explorer utiliza 4 espacios. |
| Julia | 4 espacios | Guía de estilo Per Julia. |
| Kotlin | 4 espacios | Guía de estilo Per Kotlin. |
| Lua | 2 espacios | Per Lua Style Guide. |
| Perl | varias | "Perlstyle: Guía de estilo Perl" dice Larry Wall prefiere pero no manda 4 espacios. |
| PHP | varias | Uso dupal 2 espacios. PEAR y Zend usan 4 espacios. CodeIgniter y WordPress utiliza pestañas. PSR-2 especifica 4 espacios. |
| PowerShell | varias | 4 espacios en The Unofficial PowerShell Best Practices and Style Guide. |
| Python | 4 espacios | Per PEP-8. (1 pestaña también se utiliza a veces, pero 4 espacios es preferido.) |
| Ruby | 2 espacios | Per Ruby Style Guide. |
| Rust | 4 espacios | Per Rust Style Guide. |
| Scala | 2 espacios | Guía de estilo de Scala. |
| Swift | varias | Google utiliza 2 espacios. |
| Tcl | 4 espacios | Per Guía de estilo Tcl. |
| Visual Basic | 4 espacios | Convenciones de codificación visual básica de Microsoft. |
| XML | varias | Google utiliza 2 espacios. |