Отступ (верстка) - Indentation (typesetting)

В письменной форме многие языки, отступ или же отступ это пустое место в начале строки, сигнализирующее о начале нового пункт. Много компьютерные языки использовали эту технику для обозначения «параграфов» или других логических блоков в программе.

Например, следующие строки имеют отступ от одного до шести пробелы:

Этот абзац имеет отступ в 1 пробел.

Этот абзац имеет отступ в 3 пробела.

Этот абзац с отступом в 6 пробелов.

В компьютерном программировании неологизмы превосходящий, незаметный и почтительный используются для описания разворота процесса отступа, выравнивания текста с полями страницы (или с предыдущими меньшими уровнями отступа).

В справа налево языки (например, иврит и арабский ) отступ используется точно так же, но от правого поля бумаги, где начинается линия.

Отступы при наборе

Существует три основных типа отступов, показанных ниже в отношении границ, представляющих размеры страницы.

А отступ первой строки отступы в первой строке.
Отступ первой строки 2Эм:
Lorem ipsum dolor sit amet, conctetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud упражнение ullamco labouris nisi ut aliquip ex ea Commodo Concequat. Duis aute irure dolor в репрехендерит в сладострастном velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, загорелся in culpa qui officia deserunt mollit anim id est Laborum.
А висячий отступ делает отступ для остального текста, оставляя первую строку на месте.
Висячий отступ в 2 см:
Lorem ipsum dolor sit amet, conctetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud упражнение ullamco labouris nisi ut aliquip ex ea Commodo Concequat. Duis aute irure dolor в репрехендерит в сладострастном velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, загорелся in culpa qui officia deserunt mollit anim id est Laborum.
А отступ блока делает отступ для всего блока текста.
Отступ блока в 2 см слева:
Lorem ipsum dolor sit amet, conctetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud упражнение ullamco labouris nisi ut aliquip ex ea Commodo Concequat. Duis aute irure dolor в репрехендерит в сладострастном velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, загорелся in culpa qui officia deserunt mollit anim id est Laborum.
Отступы с обеих сторон обычно используются для блочные цитаты, здесь показано 2 em слева и справа (что может быть больше справа для определенных строк, в зависимости от переноса слов, если в тексте нет выравнивание по ширине ):
Lorem ipsum dolor sit amet, conctetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud упражнение ullamco labouris nisi ut aliquip ex ea Commodo Concequat. Duis aute irure dolor в репрехендерит в сладострастном velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, загорелся in culpa qui officia deserunt mollit anim id est Laborum.
Пример выровненного по ширине текста цитаты с отступом с обеих сторон на 3 em:
Lorem ipsum dolor sit amet, conctetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud упражнение ullamco labouris nisi ut aliquip ex ea Commodo Concequat. Duis aute irure dolor в репрехендерит в сладострастном velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, загорелся in culpa qui officia deserunt mollit anim id est Laborum.

Отступы в программировании

Основная статья: Стиль отступа

В компьютере языки программирования, отступ используется для форматирования программы исходный код для улучшения читабельности. Отступы обычно используются только программистами; компиляторы и переводчики редко заботится о том, сколько пробел присутствует между операторами программирования. Однако некоторые языки программирования полагаются на использование отступов для разграничения структуры программирования, часто используя вариант вне игры. В Haskell, Оккам, Python, и Я языки программирования полагаются на отступы таким образом.

Споры о том, где делать отступ, использовать ли пробелы или вкладки, и сколько пробелов использовать, часто горячо обсуждается среди программистов, в результате чего некоторые классифицируют отступы как аналог религиозная война.[1] В 2006 году был предложен третий метод вдавливания, названный эластичные петлицы.

Помимо общего отступа утверждений, разные стили отступов скобок обычно используются.

ЯзыкОтступПримечание
БашварьируетсяРуководство по стилю Фрица Менера[2] предлагает 2, 4 или 8 пробелов и использует 2 во всех примерах. Google использует 2 пробела.[3]
CварьируетсяВ Ядро Linux использует 1 таб.[4] НАСА использует 4 пробела.[5]
C ++варьируетсяGoogle использует 2 пробела.[6]
C #4 местаЗа Microsoft Соглашения о кодировании C #.[7]
CSSварьируетсяDrupal, GitHub, и Google используйте 2 пробела.[8][9][10][11] WordPress использует вкладки.[12]
Delphi2 местаПо умолчанию в RAD Studio.[нужна цитата ]
F #4 местаСогласно руководству по стилю F #.[13]
Идти1 таб.За «Эффективный ход».[14]
HaskellварьируетсяGoogle использует 2 пробела.[15]
HTMLварьируетсяGoogle использует 2 пробела.[10] HTML Tidy по умолчанию 2 пробела.[16]
ЯваварьируетсяOracle использует 4 пробела.[17] Android использует 4 пробела.[18] Наиболее Eclipse IDE компоненты используют вкладки.
JavaScriptварьируетсяДуглас Крокфорд выступает за 4 пробела.[19] GitHub и Google используют 2 пробела.[20][21] jQuery использует вкладки.[22] Fire Fox По умолчанию встроенный jsbeautifier имеет 2 пробела. Встроенный симпатичный принтер в Гугл Хром и Internet Explorer использует 4 пробела.
Юля4 местаРуководство по стилю Per Julia.[23]
Котлин4 местаРуководство по стилю Per Kotlin.[24]
Lua2 местаСогласно Руководству по стилю Lua.[25]
Perl4 местаЗа "perlstyle: руководство по стилям Perl".[26]
PHPварьируетсяDrupal используйте 2 пробела.[27] PEAR и Zend используют 4 пробела.[28][29] CodeIgniter и WordPress используют вкладки.[30][31] PSR-2 определяет 4 пробела.[32]
Python4 местаСогласно PEP-8.[33] (Иногда также используется 1 табуляция, но лучше 4 пробела.)
Рубин2 местаСогласно руководству по стилю Ruby.[34]
Ржавчина4 местаСогласно Руководству по стилю Rust.[35]
Scala2 местаРуководство по стилям Per Scala.[36]
Tcl4 местаСогласно руководству по стилю Tcl.[37]
Visual Basic4 местаЗа Microsoft Соглашения о кодировании Visual Basic.[38]

Рекомендации

  1. ^ "Вкладки против пробелов: вечная священная война". Jwz.org. 2007-01-05. Получено 2014-01-18.
  2. ^ "Руководство по стилю Bash и стандарт кодирования" (PDF). Lug.fh-swf.de.
  3. ^ «Архивная копия». Архивировано из оригинал на 2014-06-26. Получено 2014-06-23.CS1 maint: заархивированная копия как заголовок (связь)
  4. ^ «Архивная копия». Архивировано из оригинал на 2015-02-14. Получено 2015-02-15.CS1 maint: заархивированная копия как заголовок (связь)
  5. ^ "ГИД ПО СТИЛЯМ" (PDF). Homepages.inf.ed.ac.uk. Август 1994 г.. Получено 3 сентября 2017.
  6. ^ [1] В архиве 2014-10-06 на Wayback Machine
  7. ^ Билл Вагнер. «Соглашения по программированию на C # (Руководство по программированию на C #)». Msdn.microsoft.com. Получено 3 сентября 2017.
  8. ^ «Рекомендации по форматированию CSS». Drupal.org. Получено 2014-01-18.
  9. ^ «CSS · Руководство по стилям · GitHub». Github.com. Получено 2014-01-18.
  10. ^ а б "Руководство по стилю Google HTML / CSS". Google GitHub. Google. Отступ. Архивировано из оригинал на 2016-03-13. Получено 2016-03-13. Сделайте отступ по 2 пробела за раз. Это HTML-копия официальной версии, которая поддерживается в формате XML.
  11. ^ "styleguide: руководства по стилю для проектов с открытым исходным кодом, созданных Google". Github.com. 3 сентября 2017 г.. Получено 3 сентября 2017.
  12. ^ «WordPress› Стандарты кодирования CSS «Сделайте ядро ​​WordPress». Make.wordpress.org. Получено 2018-07-20.
  13. ^ «Рекомендации по форматированию кода F #». docs.microsoft.com. Получено 14 октября 2020.
  14. ^ "Effective Go - язык программирования Go". golang.org. Получено 3 сентября 2017.
  15. ^ "HaskellStyleGuide - ganeti - Руководство по стилю кода Haskell - Программное обеспечение для управления виртуализацией на основе кластеров - Хостинг Google Project". Code.google.com. 2014-01-08. Архивировано из оригинал 27 июня 2013 г.. Получено 2014-01-18.
  16. ^ «Краткий справочник по параметрам конфигурации HTML Tidy». Tidy.sourceforge.net. 2008-06-18. Получено 2014-01-18.
  17. ^ «Соглашения о коде для языка программирования Java: 4. Отступы». Oracle.com. Получено 2014-01-18.
  18. ^ «Рекомендации по стилю кода для авторов | разработчиков Android». Source.android.com. Получено 2014-01-18.
  19. ^ «Соглашения о коде для языка программирования JavaScript». Javascript.crockford.com. 2006-11-13. Получено 2014-01-18.
  20. ^ «Руководство по стилям JavaScript 路». Github.com. Архивировано из оригинал на 2013-08-15. Получено 2014-01-18.
  21. ^ «Правила стиля JaveScript». Google-styleguide.googlecode.com. Архивировано из оригинал на 2014-02-16. Получено 2014-02-18.
  22. ^ Фонд jQuery - jquery.org. «Руководство по стилю JavaScript | Внесите вклад в jQuery». Contribute.jquery.org. Получено 2014-01-18.
  23. ^ "Руководство по стилю · Язык Джулии". docs.julialang.org.
  24. ^ «Соглашения по кодированию - язык программирования Kotlin». Котлин.
  25. ^ "lua-users wiki: Руководство по стилю Lua". lua-users.org. Получено 3 сентября 2017.
  26. ^ Аллен, Джон (JJ), изд. (2015-06-15). "perlstyle: руководство по стилям Perl". Документация Perl 5 версии 22.0. Фонд Perl. Получено 2016-03-13.
  27. ^ «Стандарты кодирования». Drupal.org. Получено 2014-01-18.
  28. ^ "Руководство :: Отступы и длина строки". Pear.php.net. Получено 2014-01-18.
  29. ^ "Стандарт программирования PHP (черновик) - Участники - Zend Framework Wiki". Framework.zend.com. Архивировано из оригинал на 2008-01-03. Получено 2014-01-18.
  30. ^ «Руководство по стилю: Руководство пользователя CodeIgniter». Ellislab.com. Получено 2014-01-18.
  31. ^ «WordPress› Стандарты программирования PHP «Сделайте ядро ​​WordPress». Make.wordpress.org. Получено 2014-01-18.
  32. ^ «PHP: Руководство по стилю кодирования». Php-fig.org. Архивировано из оригинал на 2014-03-15. Получено 2014-02-18.
  33. ^ «PEP 8 - Руководство по стилю кода Python». Python.org. Получено 3 сентября 2017.
  34. ^ Бацов, Божидар (3 сентября 2017 г.). "ruby-style-guide: Руководство по стилю программирования на Ruby, управляемое сообществом". Github.com. Получено 3 сентября 2017.
  35. ^ "ржавчина: безопасный, одновременный, практичный язык". Github.com. 3 сентября 2017 г.. Получено 3 сентября 2017.
  36. ^ «Отступы - Документация Scala». docs.scala-lang.org. Получено 3 сентября 2017.
  37. ^ Рэй Джонсон. "Руководство по стилю Tcl" (PDF). Tcl.tk. Получено 3 сентября 2017.
  38. ^ «Соглашения о структурированном кодировании». msdn.microsoft.com. Получено 3 сентября 2017.