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 , que se utiliza alrededor del texto para indicar un aspecto importante del texto, como por ejemplo:

Muchos lenguajes informáticos utilizan sangría de bloques para delimitar bloques de código fuente .

La sangría es esencialmente la misma independientemente de si el sistema de escritura es de izquierda a derecha (por ejemplo, latín y cirílico ) o de derecha a izquierda (por ejemplo, hebreo y árabe ) al considerar el principio y el final de la línea. Por ejemplo, sangrar al principio de una línea significa a la izquierda para una escritura de izquierda a derecha y a la derecha para una escritura de derecha a izquierda.

La sangría es tanto un sustantivo como un verbo. El verbo es el acto de formatear el texto para que tenga sangría, 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 a continuación está en un cuadro que representa el límite de la página y utiliza el contenido tipográfico común de lorem ipsum . El ancho de la sangría aquí está en unidades de espacios em .

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 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 de bloque , todo el párrafo tiene una sangría relativa al 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 en bloque en ambos lados se usa comúnmente para una cita, una cita en bloque , que 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 (alineados 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 de computadoras , 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 tiene una sangría de 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 .

Para un lenguaje de forma libre , la sangría es exclusivamente para el programador ya que un procesador de código (es decir, compilador , intérprete ) ignora los espacios en blanco. El código puede tener sangría inconsistente o incluso ninguna, pero en general está formateado con una sangría algo consistente.

Algunos lenguajes se basan en la sangría para demarcar la estructura del bloque, a menudo mediante la regla del fuera de juego . Debido a este requisito de sintaxis , el código debe tener un nivel de coherencia que no se requiere en el código de lenguaje de formato libre.

Los neologismos quitar sangría , quitar sangría y sangría 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ánta sangría se debe aplicar a un bloque en cada nivel de la jerarquía del código, generalmente medida en espacios, y si se deben almacenar los espacios en blanco como espacios o tabulaciones . 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 idioma, mandato organizacional y preferencia personal.

Prácticas comunes

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

Tabuladores elásticos

En 2006, se propuso un nuevo método de sangría, llamado tabulaciones elásticas . [ cita necesaria ]

Referencias

  1. ^ "Pestañas versus espacios: una guerra santa eterna". Jwz.org . 5 de enero de 2007 . Consultado el 18 de enero de 2014 .
  2. ^ "Guía de estilo Bash y estándar de codificación" (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}}: Mantenimiento CS1: 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}}: Mantenimiento CS1: copia archivada como título ( enlace )
  5. ^ "Estilo de codificación del kernel 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 del programa C". Departamento de Ciencias de la Computación e Ingeniería de Software de Cal Poly .
  8. ^ "Pautas de estilo de código". Kit web . 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. ^ "Pautas de formato CSS". Drupal.org . 14 de enero de 2013 . Consultado el 18 de enero de 2014 .
  12. ^ "CSS · Guía de estilo · 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 2 espacios a la vez.Esta es una copia en HTML de la versión oficial, que se mantiene en formato XML.
  14. ^ "guía de estilo: 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« Hacer que WordPress sea el núcleo ". Hacer.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. ^ "Pautas de formato de código F#". docs.microsoft.com . Consultado el 14 de octubre de 2020 .
  18. ^ "Go efectivo: el lenguaje de programación Go". golang.org . Consultado el 3 de septiembre de 2017 .
  19. ^ "HaskellStyleGuide - ganeti - Guía de estilo para el código Haskell - Software de gestión de virtualización basado en clúster - Google Project Hosting". Código.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 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". Fuente.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 路 Guía de estilo". 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. ^ Fundación jQuery - jquery.org. "Guía de estilo de JavaScript | Contribuya a jQuery". Contribuir.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 usuarios de lua: 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". Pera.php.net . Consultado el 18 de enero de 2014 .
  33. ^ "Estándar de codificación PHP (borrador) - Colaboradores - Zend Framework Wiki". 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 . Consultado el 18 de enero de 2014 .
  35. ^ "WordPress ›Estándares de codificación PHP« Hacer que WordPress sea el núcleo ". Hacer.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 Ruby impulsada por la comunidad". Github.com . Consultado el 3 de septiembre de 2017 .
  40. ^ "rust: un lenguaje práctico, concurrente y seguro". Github.com . 3 de septiembre de 2017 . Consultado el 3 de septiembre de 2017 .
  41. ^ "Sangría - Documentación de Scala". docs.scala-lang.org . Consultado el 3 de septiembre de 2017 .
  42. ^ "Guía de estilo 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 de formato de documento XML de Google". google.github.io . Google . Consultado el 17 de octubre de 2021 .