stringtranslate.com

Sangría (composición tipográfica)


En la forma escrita de muchos idiomas , la sangría describe un espacio vacío, también conocido como espacio en blanco , utilizado alrededor del texto para indicar un aspecto importante del texto, como por ejemplo:

Muchos lenguajes de programación utilizan sangría de bloque para delimitar bloques de código fuente .

La sangría es básicamente la misma independientemente de si el sistema de escritura es de izquierda a derecha (por ejemplo, el latín y el cirílico ) o de derecha a izquierda (por ejemplo, el hebreo y el árabe ) cuando se considera el comienzo y el final de la línea. Por ejemplo, la sangría al comienzo de la línea significa a la izquierda para una escritura de izquierda a derecha y a la derecha para una escritura de derecha a izquierda.

Indentar es tanto un sustantivo como un verbo. El verbo es el acto de dar formato al texto que se va a sangrar, mientras que el sustantivo se refiere al espacio vacío resultante.

Tipos

Hay tres tipos principales de sangría: de primera línea, colgante y de bloque.

Cada ejemplo que se muestra a continuación se encuentra en un cuadro que representa el límite de la página y utiliza la composición tipográfica habitual de Lorem Ipsum . El ancho de la sangría se expresa en unidades de espacios largos .

Para la sangría de primera línea, se sangra la primera línea de un párrafo.
Una sangría 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. 
Para la sangría francesa se sangra todo el texto de un párrafo excepto la primera línea.
Una sangría francesa 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.
Para la sangría en bloque, todo el párrafo se sangra en relación con el párrafo anterior.
Una sangría 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 sangría de bloque en ambos lados se usa comúnmente para una cita, una cita de bloque , aquí se muestra con 2 em a la izquierda y a la derecha, pero como no está alineada a la derecha , el espacio vacío a la derecha varía según la longitud de la línea:
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.
Aquí es lo mismo que el anterior pero justificado (alineado a la izquierda y a la derecha):
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 programación informática , la sangría describe el formato del código fuente con espacios en blanco a la izquierda del texto del código, a menudo para mostrar visualmente que una secuencia de líneas de código es sintácticamente un bloque de código . Normalmente, las líneas de un bloque están alineadas con una cantidad de espacio en blanco que indica la profundidad del bloque en la estructura jerárquica del código. Cada nivel interno de la jerarquía está sangrado por un múltiplo de este ancho de sangría .

Los espacios en blanco en el código normalmente se almacenan como caracteres de espacio en blanco .

En un lenguaje de formato libre , la sangría es exclusiva del programador, ya que un procesador de código (es decir, un compilador o un intérprete ) ignora los caracteres de espacio en blanco. El código puede tener una sangría inconsistente o incluso no tenerla, pero en general está formateado con una sangría relativamente consistente.

Algunos lenguajes dependen de la sangría para delimitar la estructura de bloques, a menudo mediante la regla del lado opuesto . Debido a este requisito de sintaxis , el código debe tener un nivel de consistencia que no se requiere en el código de lenguaje de formato libre.

Los neologismos outdent , unindent y dedent describen lo opuesto a la sangría: alinear el texto del código de una línea a la izquierda de la línea anterior.

Variaciones

Las variaciones comunes en la implementación de la sangría incluyen: cuánto sangrar un bloque en cada nivel de la jerarquía de código, generalmente medido en espacios, y si almacenar caracteres de espacio en blanco como espacios o caracteres de tabulación . Aunque existen prácticas comunes, el consenso no es universal. [1] Estas variaciones están impulsadas por factores que pueden incluir, entre otros: sintaxis del lenguaje, mandato organizacional y preferencia personal.

Prácticas comunes

La siguiente tabla identifica prácticas notables con respecto a la sangría de código.

Topes de lengüeta elásticos

En 2006, se propuso un nuevo método de sangría, llamado tabuladores elásticos . [ cita requerida ]

Referencias

  1. ^ "Tabs versus Spaces: An Eternal Holy War". Jwz.org . 5 de enero de 2007 . Consultado el 18 de enero de 2014 .
  2. ^ "Guía de estilo y estándar de codificación de Bash" (PDF) . Lug.fh-swf.de .
  3. ^ "Copia archivada". Archivado desde el original el 26 de junio de 2014 . Consultado el 23 de junio de 2014 .{{cite web}}: CS1 maint: copia archivada como título ( enlace )
  4. ^ "Copia archivada". Archivado desde el original el 14 de febrero de 2015 . Consultado el 15 de febrero de 2015 .{{cite web}}: CS1 maint: copia archivada como título ( enlace )
  5. ^ "Estilo de codificación del núcleo de Linux". Archivado desde el original el 11 de junio de 2022. Consultado el 21 de julio de 2022 .
  6. ^ "GUÍA DE ESTILO C". Servidor de informes técnicos de la NASA . Agosto de 1994.
  7. ^ Staley, Clinton (2006). "Reglas de estilo de programación en C". Departamento de Ciencias de la Computación e Ingeniería de Software de Cal Poly .
  8. ^ "Directrices de estilo de código". WebKit . 7 de noviembre de 2015 . Consultado el 31 de diciembre de 2021 .
  9. ^ [1] Archivado el 6 de octubre de 2014 en Wayback Machine.
  10. ^ Bill Wagner. "Convenciones de codificación de C# (Guía de programación de C#)". Msdn.microsoft.com . Consultado el 3 de septiembre de 2017 .
  11. ^ "Directrices de formato CSS". Drupal.org . 14 de enero de 2013 . Consultado el 18 de enero de 2014 .
  12. ^ "CSS · Styleguide · GitHub". Github.com . Consultado el 18 de enero de 2014 .
  13. ^ ab "Guía de estilo HTML/CSS de Google". Google GitHub . Sangría. Archivado desde el original el 13 de marzo de 2016 . Consultado el 13 de marzo de 2016 . Sangría de a 2 espacios por vez.Esta es una copia renderizada en HTML de la versión oficial, que se mantiene en formato XML.
  14. ^ "styleguide: Guías de estilo para proyectos de código abierto originados por Google". Github.com . 3 de septiembre de 2017 . Consultado el 3 de septiembre de 2017 .
  15. ^ "WordPress › Estándares de codificación CSS « ​​Make WordPress Core». Make.wordpress.org . 17 de julio de 2012 . Consultado el 20 de julio de 2018 .
  16. ^ "Guía de estilo de Object Pascal de Delphi: uso de espacios en blanco" . Consultado el 13 de diciembre de 2022 .
  17. ^ "Directrices de formato de código F#". docs.microsoft.com . Consultado el 14 de octubre de 2020 .
  18. ^ "Go eficaz: el lenguaje de programación Go". golang.org . Consultado el 3 de septiembre de 2017 .
  19. ^ "HaskellStyleGuide – ganeti – Style Guide for the Haskell code – Cluster-based virtualization management software – Google Project Hosting". Code.google.com . 8 de enero de 2014. Archivado desde el original el 27 de junio de 2013. Consultado el 18 de enero de 2014 .
  20. ^ "Referencia rápida de opciones de configuración de HTML Tidy". Tidy.sourceforge.net . 18 de junio de 2008 . Consultado el 18 de enero de 2014 .
  21. ^ "Convenciones de código para el lenguaje de programación Java: 4. Sangría". Oracle.com . Consultado el 18 de enero de 2014 .
  22. ^ "Pautas de estilo de código para colaboradores | Desarrolladores de Android". Source.android.com . Consultado el 18 de enero de 2014 .
  23. ^ "Convenciones de código para el lenguaje de programación JavaScript". Javascript.crockford.com . 13 de noviembre de 2006 . Consultado el 18 de enero de 2014 .
  24. ^ "JavaScript · Styleguide". Github.com . Archivado desde el original el 15 de agosto de 2013. Consultado el 18 de enero de 2014 .
  25. ^ "Reglas de estilo de JavaScript". Google-styleguide.googlecode.com . Archivado desde el original el 16 de febrero de 2014. Consultado el 18 de febrero de 2014 .
  26. ^ jQuery Foundation - jquery.org. "Guía de estilo de JavaScript | Contribuir a jQuery". Contribute.jquery.org . Consultado el 18 de enero de 2014 .
  27. ^ "Guía de estilo · El lenguaje Julia". docs.julialang.org .
  28. ^ "Convenciones de codificación: lenguaje de programación Kotlin". Kotlin .
  29. ^ "wiki de lua-users: Guía de estilo de Lua". lua-users.org . Consultado el 3 de septiembre de 2017 .
  30. ^ Allen, Jon (JJ) (ed.). "perlstyle: Guía de estilo de Perl". Documentación de Perl 5 versión 32.1 . Fundación Perl . Consultado el 19 de abril de 2021 .
  31. ^ "Estándares de codificación". Drupal.org . Consultado el 18 de enero de 2014 .
  32. ^ "Manual :: Sangría y longitud de línea". Pear.php.net . Consultado el 18 de enero de 2014 .
  33. ^ "Estándar de codificación PHP (borrador) – Colaboradores – Wiki de Zend Framework". Framework.zend.com . Archivado desde el original el 3 de enero de 2008. Consultado el 18 de enero de 2014 .
  34. ^ "Guía de estilo: Guía del usuario de CodeIgniter". Ellislab.com . Archivado desde el original el 1 de junio de 2013. Consultado el 18 de enero de 2014 .
  35. ^ "WordPress › Estándares de codificación PHP « Make WordPress Core". Make.wordpress.org . 23 de julio de 2012 . Consultado el 18 de enero de 2014 .
  36. ^ "PHP: Guía de estilo de codificación". Php-fig.org . Archivado desde el original el 15 de marzo de 2014. Consultado el 18 de febrero de 2014 .
  37. ^ "Diseño y formato de código: práctica y estilo de PowerShell". Práctica y estilo de PowerShell . Consultado el 17 de octubre de 2021 .
  38. ^ "PEP 8 – Guía de estilo para código Python". Python.org . Consultado el 3 de septiembre de 2017 .
  39. ^ Batsov, Bozhidar (3 de septiembre de 2017). "ruby-style-guide: una guía de estilo de codificación en Ruby impulsada por la comunidad". Github.com . Consultado el 3 de septiembre de 2017 .
  40. ^ "Rust: Un lenguaje seguro, concurrente y práctico". Github.com . 3 de septiembre de 2017 . Consultado el 3 de septiembre de 2017 .
  41. ^ "Indentación – Documentación de Scala". docs.scala-lang.org . Consultado el 3 de septiembre de 2017 .
  42. ^ "Guía de estilo de Swift". google.github.io . Consultado el 17 de octubre de 2021 .
  43. ^ Ray Johnson. "Guía de estilo Tcl" (PDF) . Tcl.tk. Consultado el 3 de septiembre de 2017 .
  44. ^ "Convenciones de codificación estructurada". msdn.microsoft.com . 4 de enero de 2007 . Consultado el 3 de septiembre de 2017 .
  45. ^ "Guía de estilo del formato de documento XML de Google". google.github.io . Google . Consultado el 17 de octubre de 2021 .