stringtranslate.com

Отступы (набор текста)

Найдите информацию об отступах в Викисловаре, бесплатном словаре.


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

Во многих языках программирования для разграничения блоков исходного кода используются отступы .

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

Indent — это и существительное, и глагол. Глагол — это действие по форматированию текста, в котором делается отступ, тогда как существительное относится к образующемуся пустому пространству.

Типы

Существует три основных типа отступа: первый ряд, висячий и блочный.

Каждый пример ниже находится в поле, которое представляет границу страницы и использует общее содержимое набора lorem ipsum . Ширина отступа здесь указана в единицах em- пробелов.

При отступе первой строки отступом считается первая строка абзаца.
Отступ первой строки 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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor в осуждении за сладострастие velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint ocaecat cupidatat not proident, sunt in culpa qui officia deserunt mollit anim id est Laborum. 
При висячем отступе отступ делается для всех строк абзаца, кроме первой.
Отступ в 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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor в осуждении за сладострастие velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint ocaecat cupidatat not proident, sunt in culpa qui officia deserunt mollit anim id est Laborum.
При отступе блока весь абзац отступает относительно предыдущего абзаца.
Отступ блока слева 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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor в осуждении за сладострастие velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint ocaecat cupidatat not proident, sunt in culpa qui officia deserunt mollit anim id est Laborum.
Отступы блока с обеих сторон обычно используются для цитаты , здесь показана цитата с отступом в 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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor в осуждении за сладострастие velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint ocaecat cupidatat not proident, sunt in culpa qui officia deserunt mollit anim id est Laborum.
Вот то же самое, что и предыдущее, но выровненное по левому и правому краю:
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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor в осуждении за сладострастие velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint ocaecat cupidatat not proident, sunt in culpa qui officia deserunt mollit anim id est Laborum.

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

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

Пробелы в коде обычно хранятся в виде пробельных символов .

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

Некоторые языки полагаются на отступы для разграничения блочной структуры, часто с помощью правила off-side . Из-за этого требования синтаксиса код должен иметь уровень согласованности, который не требуется в коде языка свободной формы.

Неологизмы outdent , unindent и dedent описывают противоположность отступу — выравнивание текста кода строки по левому краю предыдущей строки .

Вариации

Распространенные вариации в реализации отступов включают: насколько отступать блоку на каждом уровне иерархии кода, обычно измеряется в пробелах, и следует ли хранить пробельные символы как пробелы или символы табуляции . Хотя существуют общие практики, консенсус не является универсальным. [1] Эти вариации обусловлены факторами, которые могут включать, но не ограничиваться: синтаксисом языка, организационным мандатом и личными предпочтениями.

Распространенная практика

В следующей таблице приведены известные практики в отношении отступов кода.

Эластичные табуляторы

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

Ссылки

  1. ^ «Табы против пробелов: вечная священная война». Jwz.org . 5 января 2007 г. Получено 18 января 2014 г.
  2. ^ "Руководство по стилю и стандарт кодирования Bash" (PDF) . Lug.fh-swf.de .
  3. ^ "Архивная копия". Архивировано из оригинала 26 июня 2014 года . Получено 23 июня 2014 года .{{cite web}}: CS1 maint: архивная копия как заголовок ( ссылка )
  4. ^ "Архивная копия". Архивировано из оригинала 14 февраля 2015 года . Получено 15 февраля 2015 года .{{cite web}}: CS1 maint: архивная копия как заголовок ( ссылка )
  5. ^ "Linux kernel coding style". Архивировано из оригинала 11 июня 2022 г. Получено 21 июля 2022 г.
  6. ^ "C STYLE GUIDE". Сервер технических отчетов NASA . Август 1994 г.
  7. ^ Стэйли, Клинтон (2006). «Правила стиля программ на языке C». Кафедра компьютерных наук и программной инженерии Калифорнийского политехнического университета .
  8. ^ "Code Style Guidelines". WebKit . 7 ноября 2015 г. Получено 31 декабря 2021 г.
  9. ^ [1] Архивировано 2014-10-06 в Wayback Machine
  10. ^ Билл Вагнер. «Соглашения по кодированию на C# (Руководство по программированию на C#)». Msdn.microsoft.com . Получено 3 сентября 2017 г. .
  11. ^ "Руководство по форматированию CSS". Drupal.org . 14 января 2013 г. Получено 18 января 2014 г.
  12. ^ "CSS · Styleguide · GitHub". Github.com . Получено 18 января 2014 г. .
  13. ^ ab "Google HTML/CSS Style Guide". Google GitHub . Отступы. Архивировано из оригинала 13 марта 2016 г. Получено 13 марта 2016 г. Отступ на 2 пробела за раз.Это HTML-версия официальной версии, которая поддерживается в формате XML.
  14. ^ "styleguide: руководства по стилю для проектов с открытым исходным кодом, созданных Google". Github.com . 3 сентября 2017 г. . Получено 3 сентября 2017 г. .
  15. ^ "WordPress › Стандарты кодирования CSS « ​​Make WordPress Core». Make.wordpress.org . 17 июля 2012 г. . Получено 20 июля 2018 г. .
  16. ^ "Руководство по стилю Object Pascal в Delphi - Использование пробелов" . Получено 13 декабря 2022 г. .
  17. ^ "Руководство по форматированию кода F#". docs.microsoft.com . Получено 14 октября 2020 г. .
  18. ^ "Effective Go – The Go Programming Language". golang.org . Получено 3 сентября 2017 г. .
  19. ^ "HaskellStyleGuide – ganeti – Руководство по стилю для кода Haskell – Программное обеспечение для управления виртуализацией на основе кластера – Google Project Hosting". Code.google.com . 8 января 2014 г. Архивировано из оригинала 27 июня 2013 г. Получено 18 января 2014 г.
  20. ^ "HTML Tidy Configuration Options Quick Reference". Tidy.sourceforge.net . 18 июня 2008 г. Получено 18 января 2014 г.
  21. ^ "Code Conventions for the Java Programming Language: 4. Indentation". Oracle.com . Получено 18 января 2014 г. .
  22. ^ "Руководство по стилю кода для участников | Разработчиков Android". Source.android.com . Получено 18 января 2014 г. .
  23. ^ "Code Conventions for the JavaScript Programming Language". Javascript.crockford.com . 13 ноября 2006 г. Получено 18 января 2014 г.
  24. ^ "JavaScript 路 Styleguide". Github.com . Архивировано из оригинала 15 августа 2013 г. Получено 18 января 2014 г.
  25. ^ "JaveScript Style Rules". Google-styleguide.googlecode.com . Архивировано из оригинала 16 февраля 2014 . Получено 18 февраля 2014 .
  26. ^ jQuery Foundation - jquery.org. "Руководство по стилю JavaScript | Внесите вклад в jQuery". Contribute.jquery.org . Получено 18 января 2014 г. .
  27. ^ "Руководство по стилю · Язык Julia". docs.julialang.org .
  28. ^ «Соглашения о кодировании – Язык программирования Kotlin». Kotlin .
  29. ^ "lua-users wiki: Lua Style Guide". lua-users.org . Получено 3 сентября 2017 г. .
  30. ^ Аллен, Джон (JJ) (ред.). "perlstyle: руководство по стилю Perl". Документация Perl 5 версии 32.1 . Perl Foundation . Получено 19 апреля 2021 г. .
  31. ^ "Стандарты кодирования". Drupal.org . Получено 18 января 2014 г. .
  32. ^ "Руководство :: Отступы и длина строки". Pear.php.net . Получено 18 января 2014 г. .
  33. ^ "PHP Coding Standard (draft) – Contributors – Zend Framework Wiki". Framework.zend.com . Архивировано из оригинала 3 января 2008 . Получено 18 января 2014 .
  34. ^ "Style Guide : CodeIgniter User Guide". Ellislab.com . Архивировано из оригинала 1 июня 2013 . Получено 18 января 2014 .
  35. ^ "WordPress › PHP Coding Standards « Make WordPress Core». Make.wordpress.org . 23 июля 2012 г. . Получено 18 января 2014 г. .
  36. ^ "PHP: Coding Style Guide". Php-fig.org . Архивировано из оригинала 15 марта 2014 года . Получено 18 февраля 2014 года .
  37. ^ "Разметка и форматирование кода – Практика и стиль PowerShell". Практика и стиль PowerShell . Получено 17 октября 2021 г.
  38. ^ "PEP 8 – Руководство по стилю кода Python". Python.org . Получено 3 сентября 2017 г. .
  39. ^ Бацов, Божидар (3 сентября 2017 г.). "ruby-style-guide: Руководство по стилю кодирования Ruby, разработанное сообществом". Github.com . Получено 3 сентября 2017 г. .
  40. ^ "rust: безопасный, параллельный, практичный язык". Github.com . 3 сентября 2017 г. . Получено 3 сентября 2017 г. .
  41. ^ "Отступ – Документация Scala". docs.scala-lang.org . Получено 3 сентября 2017 г. .
  42. ^ "Swift Style Guide". google.github.io . Получено 17 октября 2021 г. .
  43. ^ Рэй Джонсон. "Tcl Style Guide" (PDF) . Tcl.tk . Получено 3 сентября 2017 г. .
  44. ^ «Соглашения о структурном кодировании». msdn.microsoft.com . 4 января 2007 г. Получено 3 сентября 2017 г.
  45. ^ "Руководство по стилю формата документа XML Google". google.github.io . Google . Получено 17 октября 2021 г. .
На Викискладе есть медиафайлы по теме Отступы (набор текста) .