Перечисление двоеточие или тире: Где ставится двоеточие — Независимое театральное объединение "Зрительские симпатии"

Содержание

Если в предложении идет перечисление предметов, то надо ставить перед обобщающим словом тире или всё-таки двоеточие? Почему в большинстве книг тире?

Двоеточие ставится перед перечислением, которым заканчивается предложение:
1. Если перечислению предшествует обобщающее слово (а нередко, кроме того, еще слова например, как-то, а именно), например:
Отовсюду поднялись казаки: от Чигирина, от Переяслава, от Батурина, от Глухова, от низовой стороны днепровской и от всех его вepховий и островов.
2. Если перед перечислением нет обобщающего слова, но необходимо предупредить читателя, что далее следует какой-либо перечень, например:
Из-под сена виднелись: самовар, кадка с мороженной формой и еще кой-какие привлекательные узелки и коробочки.
3. Двоеточие ставится перед перечислением, находящимся в середине предложения, если перечислению предшествует обобщающее слово или слова как-то, например, а именно, например:
И все это: и река, и прутья верболоза, и этот мальчишка – напомнило мне далекие дни детства.

Здравствуйте. Один сплошной канцеляризм. Уместен ли он здесь, решайте сами.

С запятой. Пожалуйста.

Возможно.

«Движется в темпе прогресса развития технологий» живо напоминает районную газету начала 1960-х годов; «темп прогресса развития» — один сплошной плеоназм. Так что решайте, корректно ли.

Здравствуйте. Такой вариант возможен.

Театр выйдет на сцену со спектаклем «А Midsummer Night’s Dream, или Сон в летнюю ночь».

+ 4 💬 messages

read all

С разницей. Единственное.

Здравствуйте. Не нужно.

Очень неудачно. «Касательно физики» — неуместный канцеляризм, и вообще смысл предложения не вполне ясен.

В данном контексте — нет.

Двоеточие: когда и где ставить. Примеры замены двоеточия

ПОСМОТРЕТЬ КНИГУ

Большая и умная книга по Insta-постам

То, что нужно компаниям, личным брендам и копирайтерам

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

А что же остается двоеточию? Одни однородные члены с обобщающим словом?

Как бы не так. В некоторых сложных предложениях никак нельзя поставить тире вместо двоеточия. К тому же у этих знаков есть и более глубокие смысловые и интонационные отличия. Давайте разбираться вместе.

Начнем с простого и очевидного.

Двоеточие в простом предложении

1.Самый элементарный случай. Двоеточие ставится перед перечислением и после обобщающего слова

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

2.Двоеточие ставится перед перечислением без обобщающего слова

. Здесь двоеточие становится интонационным знаком, т.е. предупреждает читателя, что далее будут однородные члены, и надо запастись воздухом для «перечислительной» интонации:

На необитаемом острове оказались: два фотографа, SMM-менеджер, коуч копирайтинга, таргетолог и рерайтер.
В огромной сумочке своей подруги он обнаружил: томик Толстого, пудреницу, спортивные штаны, пачку чипсов, вентилятор и крем от загара.

3.Помимо обобщающего слова есть слова-маркеры «например», «как то», «а именно»

. С этими словами перечисление может стоять не только в конце, но и в середине предложения (в этом случае не забываем про тире после перечисления):

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

Зачем нужно двоеточие?

Обучение написанию сочинения – рассуждения в 9 классе: «Зачем нужны двоеточия?»

Цель урока:

1) научить писать сочинение-рассуждение по алгоритму.

2) Формирование коммуникативных и пунктуационных умений и навыков

Задача: написать сочинение-рассуждение.

Опережающее задание: повторить значение понятия «двоеточие» и основные случаи его употребления.

Оборудование: текст, алгоритм написания сочинения-рассуждения, таблицы «Знаки препинания и основные случаи их употребления», «

Структура письменного ответа», «Структура текста-рассуждения».

Ход урока

Знаки препинания – это как нотные знаки.

Они твердо держат текст и не дают ему рассыпаться».

К.Г.Паустовский

Этап актуализации опыта учащихся.

Учитель.

Ребята, сегодня на уроке мы будем учиться писать сочинение-рассуждение на лингвистическую тему: «Зачем нужны двоеточия?» по тексту Н. Думбадзе. Прочитайте текст.

(1) Шла весна, под щедрыми лучами солнца цвела пробужденная природа, а в лесу пели птицы. (2) Вдали, на склонах торжественных гор, паслись стада, и воздух был наполнен весенним ароматом полевых цветов. (3) В школе занятий уже не было, и мы готовились к выпускным экзаменам. (4) Я и Мери с утра шли на край села, к старой заброшенной мельнице, усаживались в тени огромного орехового дерева и занимались.

(5)- Стихи, выбранные к экзамену, ты должен знать наизусть, -говорит Мери. (6) – Вот и послушай- это Галактион:

(7) В сердце мечта таится,

Небо –полоской ясной.

(8) Юноша: «Стой, девица!»

(9) Девушка: «Сгинь, несчастный!»

(10)- Моя бабушка здесь бы сказала: «Чтоб ты провалился сквозь землю, бесстыдник», говорю я.

(11) Я пытаюсь еще что-то сказать про бабушку –Мери смеётся, закрывает мне рот рукой: не мешай, мол. (12) Потом я читаю свои стихи, которые, хотя их и нет в программе, обязательной для изучения, я все-таки прочту на экзамене, а сейчас хочу прочесть Мери:

(13) Через тысячу лет я тебя призываю: иди!

(14) Стану горсткою пепла я в молниях жарких твоих…

(15) Мери сидит, обхватив колени руками, и смотрит куда-то вдаль, в бездонную синеву неба, где, едва касаясь горных вершин, плывут еле заметные белые хлопья облаков.

(16)- Ты, я вижу, опять стихи сочиняешь, стихоплёт?!-раздалось вдруг у самого моего уха.

(17) Я подскочил словно ужаленный и обернулся. (18) Передо мной стоял улыбающийся Илларион.

(19) – Мы к экзаменам готовимся. (20) Здравствуй, Илларион!

(21) – Вижу, профессоры, вижу, как вы готовитесь… (22) Ну, здравствуйте! – Илларион сел.

(23)- Как у вас идут дела?

(24)_ Экзамены заканчиваем, дядя Илларион, ответила Мери.

(25) – Заканчиваете или только начинаете?

(26)- Что ты, Илларион! (27) Остался всего один экзамен!- сказал я.

(28)- Э, дорогой мой, экзамены у вас только начинаются! – улыбнулся Илларион.

(29) – Человеческая жизнь, дети мои дорогие, похожа на мельницу

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

(31) Билась, билась вода, да так и не сумела сдвинуть колесо с места – силенок не хватило. (32) Тогда мы подвели второй рукав реки , и пошло дело! (33) Завертелось колесо, да еще как! (34) Две реки – это надежнее, вернее!. .

(35) – Ты поедешь в город, как школу окончишь, дочка? – вдруг обратился Илларион к Мери.

(36) – вряд ли я поеду, дядя Илларион, я не сумею…

(37) – Ну, тогда еще ничего! (38) Значит, Зурико не сбежит от нас в город!

Учитель.

О чем он?

Ученик.

Текст о сложных взаимоотношениях молодых людей. Главные герои отрывка – молодые люди, которые сдают выпускные экзамены и получают «билет в жизнь». Особую роль играет образ дяди Иллариона-носителя народной житейской мудрости.

Учитель.

Определите тип речи.

Ученик

. Это текст-повествование, так как в тексте рассказывается о событиях в селе в их временной последовательности; сообщается о последовательно сменяющих друг друга действиях (содержание повествования можно передать лишь на нескольких кадрах фотоаппарата).

Учитель.

Каков стиль текста? Докажите свою точку зрения.

Ученик

. Это художественный стиль, так как это отрывок из художественного произведения, этот текст призван воздействовать на воображение читателя.

Учитель.

Какова основная мысль текста?

Ученик.

Основная мысль текста заключена в словах Иллариона, который иносказательно, в аллегорической форме говорит молодым людям, заканчивающим школу, об особенностях взрослой жизни. «Две реки — это надежнее, вернее!».

Учитель.

Как построен текст?

Ученик.

Текст построен с помощью диалога.

Учитель.

Вспомните пожалуйста, как на письме оформляется диалог?

Ученик.

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

Учитель.

Посмотрите внимательно, какие знаки препинания преобладают в тексте?

Ученик.

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

Учитель.

Найдите предложения с двоеточием. Обратимся к вашему домашнему заданию. Напомните мне, что такое двоеточие.

1 ученик

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

Учитель.

Перед вами таблица «Знаки препинания и основные случаи их употребления». Какая функция двоеточий здесь обозначена?

Ученик.

В этой таблице указана разделительная функция двоеточия, оно разделяет обобщающее слово и однородные члены.

Учитель.

Какие случаи употребления двоеточия здесь не указаны?

Ученик.

Мы знаем, что двоеточие ставится

перед перечислением, если ему предшествует обобщающее слово или слова как то, а именно
, например:
«Острогою бьётся крупная рыба как то: щуки, сомы, жерехи, судаки». (Аксаков)
в бессоюзном сложном предложении, если вторая часть раскрывает причину того, о чем заявлено в первой, например: «Учись, мой сын: наука сокращает нам опыты быстротекущей жизни». (А.С. Пушкин)
В бессоюзном сложном предложении, если вторая часть поясняет, раскрывает смысл первой, например: «Свойство зеркальце имело: говорить оно умело». (А.С. Пушкин)
В бессоюзном сложном предложении, если вторая часть дополняет первую, например: «Я огляделся: в ста шагах от меня темнела роща, из которой я только что вышел». (А.Чехов)
После авторских слов, вводящих прямую речь, например: «Смотрю вслед ему и думаю: «Зачем живут такие люди?»
(М. Горький)

Учитель

. Найдите в тексте предложения с двоеточием и определите значение двоеточий, для этого давайте составим таблицу по следующей схеме:

Значение двоеточия

Примеры

Двоеточие оформляет прямую речь, разделяя слова автора и собственно прямую речь.

Вот и послушай- это Галактион:

(7) В сердце мечта таится,

Небо –полоской ясной.

(8) Юноша: «Стой, девица!»

Двоеточие разделяет простые предложения в составе сложного.

(13) Через тысячу лет я тебя призываю: иди!

Учитель.

Сделайте обобщение.

Ученик.

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

Работа над композицией сочинения.

Учитель.

Вспомним, какова структура сочинения-рассуждения? Для этого посмотрим таблицу «Структура текста- рассуждения». Из скольких частей должно состоять сочинение-рассуждение? Назовите эти части.

Ученик.

Сочинение должно состоять из трёх частей: Тезис, доказательства (аргументы, факты, примеры), вывод
.
Учитель.

Как начнем сочинение? Посмотрим в таблицу и вспомним виды вступлений.

Вид тезиса	Примеры
Тезис – утверждение актуальности данного вопроса.	На письме без знаков препинания обойтись невозможно. Они выполняют важную роль в письменной речи.
Тезис — риторическое восклицание.	На письме без знаков препинания не обойтись!
Тезис – риторический вопрос.	Как обойтись без знаков препинания?
Тезис, выраженный цитатным материалом.	Важную роль знаков препинания отметил К. Паустовский: «Они твердо держат текст и не дают ему рассыпаться»
Тезис – небольшое отступление, подводящее к проблеме текста.	Русская пунктуация — сложная система, глубокое овладение ею помогает точно и четко передавать, воспринимать смысл написанного.

1 ученик.

Можно начать с вопросительного предложения, например: «Для чего в тексте нужны двоеточия? Неужели нельзя без них обойтись?»

2 ученик.

Возможно такое вступление:«Постановка двоеточия в тексте всегда вызывает у школьников затруднения, поскольку существует множество условий постановки этого знака препинания. Наша цель- разобраться со значением двоеточия и условиях его постановки на письме».

3 ученик.

«На письме без двоеточий не обойтись! Достаточно вспомнить бессоюзные сложные предложения и оттенки значений его частей, как же разделить их? Только с помощью двоеточия!»

4 ученик.

«Появление двоеточия в русской пунктуации относится к XVII веку. Вначале двоеточие было знаком предупреждения, что за ним следует разъяснение. Сейчас у него появились и другие роли в тексте. Об этом речь пойдет в моем сочинении».

Учитель.

Молодцы, у всех получились вступления, вы продемонстрировали 4 вида вступлений, а вот что получилось у меня.

Вопрос о роли двоеточия в письменной речи и о необходимости знания правил пунктуации, волнующий Антона и Кирилла, возникал и среди моих одноклассников. Мнения наши тоже разделились. Некоторые ребята, в основном те, у кого трудности с русским языком, считают, как и Кирилл, что без двоеточия и прочих знаков можно запросто обойтись, потому что «до XV века обходились, а сейчас их столько»! Другие же, наоборот, уверены, как и Антон, в их необходимости. И действительно, трудно не согласиться с Антоном, ведь у знаков препинания такие важные функции!

Следующий этап работы — основная часть и аргументы. Чтобы выполнить эту работу, вспомните начало урока, где мы определяли функции двоеточий и посмотрите таблицу, которую мы составили по тексту.

Какие аргументы вы можете предложить?

ученик.
Аргумент, пример 1

Во-первых, отделяют прямую речь от слов автора. Пример использования двоеточия можно найти в предложении 8 . (Юноша: «Стой, девица!»)

Аргумент, пример 2

Во-вторых, двоеточие разделяет части сложного предложения. В подтверждение собственных выводов можно привести пример из 13 предложения текста. (Через тысячу лет я тебя призываю: иди!)

Учитель.

В своем сочинении вы можете использовать следующие клише:

Чтобы доказать сказанное, обратимся к … предложению текста.
Пример использования ….. можно найти в предложении … .
В подтверждение собственных выводов можно привести пример из … предложения текста.
Рассмотрим … предложение (слово). В нем использован (-а, -о) …, который (-ая, -ое)… . Это подтверждает вывод о том, что … .

Учитель.

Хорошо, аргументы привели, теперь подумайте, как мы закончим сочинение?

1 ученик.

Прав был К.Паустовский, сравнивая знаки препинания с нотными знаками: они руководят интонацией, помогают автору оформить мысли и передать чувства, а читателю понять их. Без знаков препинания такое общение было бы затруднительным. А сомневающимся можно предложить эксперимент: уберите из текста все двоеточия, запятые, тире, точки – словом, все знаки, попробуйте прочитать. Думаю, вы поймёте, почему в языке возникла система знаков препинания.

2 ученик

. Наверное, не каждый думает так, как я. Многие считают, что знаки препинания, в том числе и двоеточие, вообще не нужны и только усложняют людям жизнь, но ведь они не задумываются, что знаки препинания на письме — это наша интонация в устной речи, некрасива и непонятна неэмоциональная речь, лишенная чувства, логических пауз, поэтому некрасива и письменная речь, лишенная знаков, она уже совсем на нее и не похожа, это всего лишь набор слов.

Учитель.

Прочитайте первое сочинение и проанализируйте его.

1 ученик.

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

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

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

2 ученик.

Мне понравилось в сочинении вступление, однако, здесь отсутствуют аргументы. Можно привести такой аргумент: двоеточия отделяют прямую речь от слов автора. Пример использования двоеточия можно найти в предложении 8 . (
Юноша: «Стой, девица!»)
3 ученик.

Мы знаем, что должно быть 2 аргумента из текста, в качестве второго можно использовать следующее: двоеточие разделяет части сложного предложения. В подтверждение собственных выводов можно привести пример из 13 предложения текста. (
Через тысячу лет я тебя призываю: иди!)
Учитель

. Замечания абсолютно справедливы. Давайте прочитаем и проанализируем второе сочинение.

4 ученик.

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

На письме без двоеточия, как и без других знаков препинания, обойтись невозможно.

Двоеточие останавливает наше внимание, требует паузы и предупредительной интонации. Двоеточие предупреждает: после обобщающего слова обязательно последует ряд однородных членов в предложении, например: «Выступили знакомые подробности: оленьи рога, полки с книгами, зеркало, печь с отдушником»; после слов автора прозвучит прямая речь. Важную роль играет двоеточие в бессоюзных сложных предложениях. Если вторая часть предложения имеет значение причины или значение пояснения, то на границе частей сложного предложения надо поставить двоеточие, например: «Я не ошибся: старик не отказался от предлагаемого стакана». Двоеточие ставится и в тех случаях, когда вторая часть имеет значение изъяснения.

Двоеточие помогает нам избежать тяжеловесности сложноподчиненных предложений: опустить подчинительные союзы. Таким образом, знание правил постановки двоеточия открывает перед нами широкие возможности для творчества, для совершенствования языкового мастерства.

5 ученик.

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

7 ученик.

В этом сочинении использовались хорошие аргументы, но они не имеют никакого отношения к тексту, можно было сделать так: двоеточие предупреждает: после слов автора прозвучит прямая речь, например, эта функция двоеточия прослеживается в предложении 9 (Девушка: «Сгинь, несчастный!»).

Учитель.

Мы прочитали и проанализировали 2 сочинения и сделали соответствующие выводы. Домашним заданием будет написать сочинение-рассуждение на тему «Роль знаков препинания в письменной речи».

Вариант сочинения №1.

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

Во-вторых, двоеточие разделяет части сложного предложения. В подтверждение собственных выводов можно привести пример из 13 предложения текста.

Вариант сочинения №2

На письме без двоеточий обойтись невозможно.

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

Эти случаи употребления можно подтвердить предложениями 8, 7 и 13.

Вопрос о роли двоеточия письменной речи и о необходимости знания правил пунктуации, волнующий Антона и Кирилла, возникал и среди моих одноклассников. Мнения наши тоже разделились. Некоторые ребята, в основном те, у кого трудности с русским языком, считают, как и Кирилл, что без двоеточия и прочих знаков можно запросто обойтись, потому что «до XV века обходились, а сейчас их столько»! Другие же, наоборот, уверены, как и Антон, в их необходимости. И действительно, трудно не согласиться с Антоном, ведь у знаков препинания такие важные функции!

Двоеточие в предложениях с прямой речью

Именно с прямой речью, не с косвенной! Давайте я объясню разницу:

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

Он сказал: «Я никогда не думал, что можно сделать профессиональный сайт за копейки».
Она разочарованно проговорила: «И это все, на что ты способен?».

Двоеточие в сложном предложении

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

Итак, двоеточие ставится, если в придаточном предложении есть:

1.РАЗЪЯСНЕНИЕ

. Между частями можно поставить
«а именно», «то есть»
:

Сложилась непростая ситуация: лендинг он сделал, а форму заявки не настроил.
Ее опасения подтвердились: этот онлайн-курс оказался пустышкой, деньги были потрачены зря.

2.ПРИЧИНА

. Между частями можно поставить
«потому что»
:

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

3.ГЛАГОЛЫ-МАРКЕРЫ

«видеть», «слышать», «смотреть», «знать», «чувствовать» и пр. Такие глаголы указывают на дальнейшее описание увиденного, услышанного и пр. Между частями предложения можно поставить
«что»
:

Он пришел домой и видит: на полу валяются истерзанные ботинки и рассыпанный собачий корм, а виновник погрома весело виляет хвостом.
Она медленно шла по парку и чувствовала: кто-то невидимый внимательно наблюдал за ней.

Двоеточие или тире: когда и что ставить

1.ЛОГИКА.

Очень важно учитывать
логику и смысловые отношения
между частями предложения:

Она развернулась и ушла: их отношения были закончены.
Она ушла, потому что отношения закончились.

*Здесь двоеточие ставится при прямой последовательности. Одно вытекает из другого.

Она развернулась и ушла – их отношения были закончены.

*Их отношения закончились, потому что она ушла. Тире ставится при обратной последовательности.

2.ЭМОЦИИ.

Бывают случаи, когда подстановка союзов и логические размышления не могут облегчить нам задачу в выборе знака: «И тут он слышит (: или –) из кустов доносится плач ребенка».

Глагол-маркер «слышать», возможность вставить союз «что» указывают на двоеточие. Однако и тире не будет ошибкой.

На помощь нам приходит эмоционально-экспрессивная окраска

. Предложения с двоеточием ей НЕ обладают!

Если необходимо просто констатировать факт, то ставим двоеточие: «И тут он слышит: из кустов доносится плач ребенка».
Если надо создать эффект неожиданности, подчеркнуть эмоциональное состояние, отразить быструю смену событий, то ставим тире: «И тут он слышит – из кустов доносится плач ребенка».

Таким образом, у двоеточия есть четкие функции:

перечислить что-то;
завершить слова автора и открыть прямую речь;
разъяснить и объяснить что-то.

Двоеточие не придает предложению дополнительную экспрессивную окраску. Этим и объясняется более редкое использование двоеточия в рекламных текстах и слоганах.
И напротив, тире здесь встречается едва ли не чаще восклицательного знака.

Но именно поэтому в официально-деловых и новостных текстах следует чаще использовать двоеточие, а с тире надо быть очень аккуратными. Чтобы не «накрутить» интригу и саспенс там, где они будут лишними.

Добра вам!

РАЗМЕСТИТЬ ТЕКСТ ДЛЯ РАЗБОРА

У вас есть текст подобного формата?

Бесплатный разбор качества текстов на форуме ForCop

Опечатка? Пожалуйста, выделите её и нажмите Ctrl+Enter. Спасибо!

Ирина Исакова

Филолог, журналист, профессиональный копирайтер.

Двоеточие vs тире

Главная сложность в употреблении двоеточия заключается в том, что иногда бывает легко перепутать этот знак препинания с другим — тире. В последнее время эти знаки часто употребляются параллельно, то есть в одних и тех же случаях может ставиться как тире, так и двоеточие. Например: И судьи решили: если будет дождь, соревнования отменят; Заметил первый камень, решил — здесь клад, стал ковыряться (Тендряков), Конечно, онизменился (: –) сгорбился, поседел, с морщинкамив уголках рта; Вхожу (: –) все тихо; Эти слова при нем не произносите(: –) может обидеться; Всех интересовал только один вопрос (:–) как поскорее выпутаться из создавшегося положения; Это означало одно (:–) нужно расстаться.

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

Об авторе: Етко Анна Геннадиевна, учитель русского языка и литературы.

Когда ставить двоеточие и тире. Когда ставится тире

В статье пойдет речь о том, как оформлять списки и перечни. Какие требования предъявляются с точки зрения пунктуации, удобства восприятия и общего юзабилити.

Обозначение элементов списка

Когда в предложении встречается перечисление существует два варианта его записи:

поставить двоеточие и перечислить составляющие перечня в одну строку, отделяя части запятыми;

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

Второй вариант более предпочтителен с точки зрения восприятия текста и общего внешнего вида. Каждый элемент списка начинается с новой строки (пример 1).

Чтобы сделать визуальное оформление еще понятнее используют маркеры (пример 2). Маркерами выступают цифры арабского или римского алфавита, различные спецсимволы и буквы.

Списки делятся на простые, т.е. состоящие из одного уровня членения текста (см. Примеры 2) и составные, включающие 2 и более уровней (см. Пример 3).

Глубина членения влияет на выбор символов, стоящих в начале каждого элемента списка. Например, четырех уровненный составной список выглядит так:

Т. е. с понижением уровня списка происходит переход от старших маркеров к более младшим. В общем случае иерарких маркеров выглядит следующим образом (от старших к младшим):

1. Римские цифры.
2. Арабские цифры с точкой.
3. Арабские цифры со скобкой.
4. Латинские или русские буквы со скобкой.
5. Спец. символы (тире, звездочки, точки).

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

Правило: если в конце списка стоит «и др.», «и т.д.» или «и т.п.», то такой текст не располагают на отдельной строке, а оставляют в конце предыдущего элемента списка (см. Примеры 4).

Пунктуационное оформление списков (перечней)

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

Другая ситуация с использованием спец. символов. Если перед списком, в котором маркерами выступают спец. символы, стоит двоеточие, то каждый пункт начинается со строчной буквы, а в конце ставится точка с запятой. И только самый последний пункт оканчивается точкой. Так происходит потому, что такой список является одним предложением, представленным в виде перечня для удобства восприятия.

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

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

Если части перечня усложнены (внутри них несколько слов или есть запятые), их лучше отделять точкой с запятой (см. Пример 6).

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

Согласованность элементов списка

Начальные слова каждого элемента списка должны согласовываться между собой в роде, числе и падеже. А также все элементы списка должны согласовываться в роде, числе и падеже со словами (или словом) в предваряющем перечень предложении, после которого стоит двоеточие.

Неправильно:

Последний элемент списка употреблен в ином падеже по сравнению с остальными.

Неправильно:

Данный перечень может показаться безукоризненным, если бы не одно «но». Слово «соблюдение» требует после себя слов в родительном падеже, которые бы отвечали на вопросы «кого? чего?». Поэтому каждая рубрика должна начинаться так:

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

При составлении документов мы часто сталкиваемся со всевозможными перечнями. При этом правил их оформления существует великое множество. Попробуем разобраться в них.

Обозначение элементов списка

Предваряющее перечень предложение и элементы последующего списка (перечисляются после двоеточия) могут писаться в виде единой строки. Но в длинных и сложных списках гораздо удобнее располагать каждый элемент с новой строки. И тут у вас есть выбор: вы можете ограничиться использованием абзацного отступа (Пример 1) или же заменить его на цифру, букву или тире (Пример 2).

Перечни бывают:

простые, т.е. состоящие из одного уровня членения текста (см. Примеры 1 и 2) и

составные, включающие 2 и более уровней (см. Пример 3).

От глубины членения зависит выбор символов, которые будут предварять каждый элемент списка. При оформлении простых перечней можно использовать строчные («маленькие») буквы, арабские цифры или тире.

Гораздо сложнее обстоит дело с составными перечнями. Для большей наглядности сочетания различных символов в списках приведем пример оформления 4-уровневого перечня:

Из данного примера видно, что система нумерации рубрик выглядит следующим образом: заголовок первого уровня оформлен при помощи римской цифры, заголовки второго уровня — при помощи арабских цифр без скобок, заголовки третьего уровня — при помощи арабских цифр со скобками и, наконец, заголовки четвертого уровня оформлены с применением строчных букв со скобками. Если бы данный перечень предполагал еще один, пятый уровень, то его мы оформили бы при помощи тире.

Система нумерации частей составного перечня может состоять только из арабских цифр с точками. Тогда структура построения номера каждого элемента списка отражает его подчиненность по отношению к расположенным выше элементам (происходит наращивание цифровых показателей):

Если в конце списка стоит «и др.», «и т.д.» или «и т. п.», то такой текст не располагают на отдельной строке, а оставляют в конце предыдущего элемента списка (см. Примеры 3 и 4).

Пунктуационное оформление перечней

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

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

Если части перечня состоят из простых словосочетаний или одного слова, они отделяются друг от друга запятыми (см. Пример 5). Если же части перечня усложнены (внутри них есть запятые), их лучше отделять точкой с запятой (см. Пример 6).

Наконец, если части перечня представляют собой отдельные предложения, они друг от друга отделяются точкой:

Иногда перечень оформляется таким образом, что его предваряет целое предложение (или несколько предложений). В этом случае в перечне используются лишь так называемые «низшие» уровни членения (строчные буквы со скобкой или тире), а точки в конце каждой части перечня не ставятся, т.к. в данном случае перечень представляет собой единое предложение:

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

Согласованность элементов списка

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

Также все элементы списка должны быть обязательно согласованы в роде, числе и падеже со словами (или словом) в предваряющем перечень предложении, после которого стоит двоеточие. Давайте вновь рассмотрим пример неправильного составления перечня, чтобы проанализировать ошибки.

Итак, мы привели основные правила построения и оформления перечней, которые помогут сделать ваши документы еще более грамотными.

Итак, двоеточие — это разделительный знак препинания. В отличие от точки, восклицательного и вопросительного знаков и многоточия он не имеет отделительной функции, то есть не отделяет предложения в тексте друг от друга. Двоеточие ставится только внутри предложения, и поэтому указывает на то, что после него высказывание будет продолжено.

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

Так как же правильно употреблять двоеточие, не совершать ошибок и не путать его с другими? Давайте рассмотрим основные случаи.

Двоеточие в простом предложении

Правило 1. Двоеточие в предложении с однородными членами

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

В этом предложении слово повсюду обобщает ряд однородных обстоятельств. Обобщающее слово расположено перед однородными членами, и поэтому после него стоит двоеточие.

Правило 2. Двоеточие в предложениях с уточняющими словами

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

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

Правило 3. Двоеточие в конструкциях с прямой речью

Если прямая речь следует после слов автора, то перед ней ставится двоеточие, причем сама прямая речи заключается в кавычки и первое слово прямой речи пишется с прописной буквы: Учитель сказал: «Здравствуйте, дети!». Также если прямая речь разрывает слова автора в тексте, то перед ней ставится двоеточие, например: Сказав: «Здравствуйте, дети!», учитель вошел в класс. После прямой речи при этом необходимо поставить запятую.

Двоеточие в сложном предложении

Правило 4. Между частями бессоюзного сложного предложения (БСП) может ставиться двоеточие в следующих случаях.

Вторая часть БСП поясняет то, о чем говорилось в первой (между частями предложения можно вставить «а именно» ), например: В народе есть такая примета: ласточки низко летают к дождю; Катя пишет очень грамотно: никогда не делает ошибок в словах, правильно расставляет знаки препинания. В этих бессоюзных сложных предложениях во второй части дается пояснение того, о чем идет речь в первой. Между частями предложений можно вставить «а именно» : В народе есть такая примета (а именно): ласточки низко над водой летают к дождю. Поэтому в приведенных предложениях ставится двоеточие.

Вторая часть БСП раскрывает причину того, о чем говорилось в первой (между частями предложения можно вставить союзы: так как, потому что ), например: Катя пишет очень грамотно: она много читает, учит стихи наизусть, тренирует память; Скоро пойдет дождь: ласточки летают низко над водой. В этих БСП вторая часть обосновывает, указывает на причину того, о чем говорилось в первой. Между частями можно вставить союзы: так как, потому что. Скоро пойдет дождь (потому что): ласточки летают низко над водой. Поэтому в таких предложениях ставится двоеточие.

Вторая часть БСП дополняет, раскрывает то, о чем говорилось в первой (такие предложения синонимичны сложноподчиненным предложениям с придаточным изъяснительным, поэтому между частями БСП можно вставить союз что ). Например: Катя знает: читать книги не только интересно, но и очень полезно для учебы; В народе говорят: ласточки низко над водой к дождю летают. В данных БСП во второй части раскрывается смысл того, о чем идет речь в первой. Если части такого предложения соединить союзом что , то получится сложноподчиненное предложение с изъяснительным придаточным: В народе говорят (что,): ласточки низко над водой к дождю летают. В предложениях такого типа ставится двоеточие.

В первой части предложения опущены глаголы: и увидел, и услышал, и почувствовал , например: Я поднял голову: луч солнца пробивался сквозь облака, озаряя поляну ярким светом; Он обернулся: эхо торопливых шагов раздавалось совсем близко. Данные предложения также являются синонимичными сложноподчиненным с придаточным изъяснительным, в первой части пропущены глаголы типа: и увидел, и услышал, между частями можно вставить союз что. Я поднял голову (и увидел, что) : луч солнца пробивался сквозь облака, озаряя поляну ярким светом.

Двоеточие vs тире

Главная сложность в употреблении двоеточия заключается в том, что иногда бывает легко перепутать этот знак препинания с другим — тире. В последнее время эти знаки часто употребляются параллельно, то есть в одних и тех же случаях может ставиться как тире, так и двоеточие. Например: И судьи решили: если будет дождь, соревнования отменят; Заметил первый камень, решил — здесь клад, стал ковыряться (Тендряков), Конечно, он изменился (: –) сгорбился, поседел, с морщинками в уголках рта; Вхожу (: – ) все тихо; Эти слова при нем не произносите (: – ) может обидеться; Всех интересовал только один вопрос (: – ) как поскорее выпутаться из создавшегося положения; Это означало одно (: – ) нужно расстаться.

Знаки препинания есть не что иное, как система символов, которая используется в различных языках для структурирования письменной речи. Одни и те же пунктуационные знаки в разных языках могут не только ставиться по-другому, но и иметь разные значения.

Поговорим о таком важном знаке препинания, как двоеточие. Этот пунктуационный знак ставится внутри предложения. Двоеточие ставится между частями предложения, которые могут быть или связаны между собой, или отличаться друг от друга. Такой знак можно встретить как в простых предложениях, так и в сложных. Двоеточие акцентирует внимание читателя на том, что следует после него.

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

Если вам необходимо вставить в свое сочинение цитату из какого-то текста, то сначала следует поставить двоеточие, а потом кавычки. Двоеточие в сложных предложениях используется там, где одному из простых предложений требуется пояснение другого. Например: «Всем стало понятно, что преступник все еще находился в помещении: его следы можно было увидеть по всей комнате, но не у двери».

Итак, подытожим. Двоеточие ставится в следующих случаях:

Чтобы акцентировать внимание на одной из частей предложения;

При перечислении однородных членов после обобщающего слова;

Для выделения прямой речи;

Для пояснения одного предложения другим.

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

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

Обозначение элементов списка

Пример 1

Пример 2

Перечни бывают:

простые, т.е. состоящие из одного уровня членения текста (см. Примеры 1 и 2) и

составные, включающие 2 и более уровней (см. Пример 3).

Пример 3

Из данного примера видно, что система нумерации рубрик выглядит следующим образом: заголовок первого уровня оформлен при помощи римской цифры, заголовки второго уровня – при помощи арабских цифр без скобок, заголовки третьего уровня – при помощи арабских цифр со скобками и, наконец, заголовки четвертого уровня оформлены с применением строчных букв со скобками. Если бы данный перечень предполагал еще один, пятый уровень, то его мы оформили бы при помощи тире.

Пример 4

Если в конце списка стоит «и др.», «и т.д.» или «и т.п.», то такой текст не располагают на отдельной строке, а оставляют в конце предыдущего элемента списка (см. Примеры 3 и 4).

Пунктуационное оформление перечней

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

Пример 5

Пример 6

Наконец, если части перечня представляют собой отдельные предложения, они друг от друга отделяются точкой:

Пример 7

Иногда перечень оформляется таким образом, что его предваряет целое предложение (или несколько предложений). В этом случае в перечне используются лишь так называемые «низшие» уровни членения (строчные буквы со скобкой или тире), а точки в конце каждой части перечня не ставятся, т. к. в данном случае перечень представляет собой единое предложение:

Пример 8

Пример 9

Согласованность элементов списка

Пример 10

Пример 11

Среди них двоеточие. Когда ставится двоеточие

Знаки препинания — это система символов, используемых в языке на письме. Одинаковые знаки препинания в разных языках ставятся по-разному и имеют разное значение. В целом, они необходимы, чтобы структурировать письменную речь, ведь в ней не слышно пауз или интонаций, которые мы могли бы произнести вслух в обычной ситуации.

Двоеточие — знак препинания, который ставится внутри предложения. Зачем нужно двоеточие? Оно означает, что части, между которыми оно поставлено, связаны между собой или отличаются друг от друга. Двоеточие используется как в простых, так и в сложных предложениях и призвано заострять внимание на том, что следует за ним.

Зачем нужно двоеточие в письменной речи?

Двоеточие необходимо ставить при перечислении после обобщающего слова «Сколько же в том магазине было видов сладостей: шоколад, тянучка, карамель, мармелад, сладкая вата, булочки с корицей».
Зачем нужно двоеточие? Сочинение, если вы пишете его по литературному произведению, часто требует цитат из первоисточника. В предложениях с прямой речью двоеточие разделяет слова автора и прямую речь. «Я выдержал долгую паузу и сказал: «Он уехал навсегда, он никогда больше сюда не вернется». Вставляя в свое сочинение цитату из текста, поставьте двоеточие, а затем кавычки.
В сложных предложениях двоеточие используется, если одно из простых предложений поясняет или дополняет другое «Он знал, что убийца все еще находится в комнате, у него были на то причины: следы были во всей комнате, кроме дверей».

Итак, если вам потребуется написать сочинение-рассуждение о том, зачем нужно двоеточие, вы сможете объяснить, что оно необходимо, чтобы акцентировать внимание на каких-либо частях предложения, которые отличаются от основного текста. Это перечисление однородных членов предложения после обобщающего слова, выделение прямой речи, пояснение одного предложения другим. А в чем состоит отличие между дроеточием и тире и

§ 159. Двоеточие ставится перед перечислением, которым заканчивается предложение:
1. Если перечислению предшествует обобщающее слово (а нередко, кроме того, еще слова например, как-то, а именно), например:
Отовсюду поднялись казаки: от Чигирина, от Переяслава, от Батурина, от Глухова, от низовой стороны днепровской и от всех его Bepховий и островов.
Гоголь
Выступили знакомые подробности: оленьи рога, полки с книгами, зеркало, печь с отдушником, который давно надо было починить, отцовский диван, большой стол, на столе открытая книга, сломанная пепельница, тетрадь с его почерком.

Л. Толстой
Острогою бьется крупная рыба, как-то: щуки, сомы, жерехи, судаки.
С. Аксаков
2. Если перед перечислением нет обобщающего слова, но необходимо предупредить читателя, что далее следует какой либо перечень, например:
Из-под сена виднелись: самовар, кадка с мороженной формой и еще кой-какие привлекательные узелки и коробочки.
Л. Толстой
§ 160. Двоеточие ставится перед перечислением, находящимся в середине предложения, если перечислению предшествует обобщающее слово или слова как-то, например, а именно, например:
И все это: и река, и прутья верболоза, и этот мальчишка – напомнило мне далекие дни детства.
Первенцев
Я посетил крупнейшие города СССР, а именно: Москву, Ленинград, Баку, Киев – и возвратился на Урал.
О тире после перечисления, стоящего в середине предложения после двоеточия, см. § 174, п. 3, примечание.
§ 161. Двоеточие ставится после предложения, за которым следует одно или несколько предложений, не соединенных с первым посредством cоюзов и заключающих в себе:
а) разъяснение или раскрытие содержания того, о чем говорится в первом предложении, например:
Я не ошибся: старик не отказался от предлагаемого стакана.

Пушкин
Сверх того, заботы большого семейства беспрестанно мучили ее: то кормление грудного ребенка не шло, то нянька ушла, то, как теперь, заболел один из детей.
Л. Толстой
Тут открылась картина довольно занимательная: широкая сакля, которой крыша опиралась на два законченных столба, была полна народа.
Лермонтов
б) основание, причина того, о чем говорится в первом предложении, например:
Не нагнать тебе бешеной тройки: кони сыты, и крепки, и бойки.
Некрасов
Недаром боги греческие признавали над собою неотразимую власть судьбы: судьба – это была та темная граница, за которую не пepecтупало сознание древних.
Белинский
§ 162. Двоеточие ставится между двумя предложениями, не соединенными посредством союзов, если в первом предложении такими глаголами, как видеть, смотреть, слышать, знать, чувствовать и т. п., делается предупреждение, что далее последует изложение какого-нибудь факта или какое-нибудь описание, например:
И вот бакенщик и помощник-киргиз видят: плывут по реке две лодки.

А. Н. Толстой
Пополз я по густой траве вдоль по оврагу, смотрю: лес кончился, несколько казаков выезжают из него на поляну, и вот выскакивает прямо к ним мой Карагез…
Лермонтов
Вот наконец, мы взобрались на Гуд-гору, остановились и оглянулись: на ней висело серое облако, и его холодное дыхание грозило близкой бурею…
Лермонтов
Я знаю: в вашем сердце есть и гордость, и прямая честь.
Пушкин
Павел чувствует: чьи-то пальцы дотрагиваются до его руки выше локтя.
Н. Островский
Но (без оттенка предупреждения):
Слышу, земля задрожала.
Некрасов
§ 163. Двоеточие ставится после предложения, вводящего прямую речь, в частности – прямой вопрос или восклицание, например:
Минуты две они молчали, но к ней Онегин подошел и молвил: «Вы ко мне писали, не отпирайтесь».
Пушкин
По окончании работы Петр спросил Ибрагима; «Нравится ли тебе девушка, с которой ты танцевал менуэт на прошедшей ассамблее?»
Пушкин
А я думал: «Какой это тяжелый и ленивый малый!»
Чехов
Примечание.

Группу предложений, в составе которых есть пря мая речь, следует отличать от сложных предложений с придаточным: перед придаточным ставится, как обычно, запятая, а в конце его – знак, требуемый характером всего сложного предложения, например:
Я думал о том, какой это тяжелый и ленивый малый.
Я старался вспомнить, где был я в этот день ровно год тому назад.
Неужели опять он напомнит о том, что было год тому назад? Как тяжело вспоминать о том, что было в этот ужасный день!

Двоеточие — один из старейших знаков препинания. Ему уже без малого 600 лет, а появилось двоеточие в далёком XV веке, практически сразу после самого первого пунктуационного знака — точки.

У С.Я. Маршака есть стихотворение, которое называется «Знаки препинания» . Так вот двоеточие в этом стихотворении говорит о себе следующие слова:

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

Правило первое. Двоеточие и обобщающие слова

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

Сергей Тимофеевич Аксаков в одном из своих произведений пишет: «Охота с острогою требует трёх условий : тёмной ночи, светлой воды и совершенно ясной погоды «.

Обобщающее словосочетание в этом предложении подчёркнуто одной чертой, а однородные члены предложения — курсивом.

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

Тёмная ночь, светлая вода и совершенно ясная погода — три условия , которые нужны для охоты с острогою.

Правило второе. Двоеточие и бессоюзные сложные предложения

Двоеточие ставится в бессоюзных сложных предложениях в нескольких случаях, а именно: если вторая часть разъясняет или раскрывает содержание первой части, указывает на причину того, о чём идёт речь в первой части, а также предупреждает, что дело на этом не заканчивается. Чтобы запомнить это правило, нужно выучить слова, которыми можно дополнить предложение.

1. Если предложение указывает на причину, то между двумя простыми частями гармонично впишутся союзы потому что и так как . Вспомним всем хорошо известные слова Максима Горького о книгах:

Любите книгу: она поможет вам разобраться в пёстрой путанице мыслей, она научит вас уважать человека.

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

2. Если вторая часть разъясняет первую, то можно поставить слова а именно или как то. Вот пример из произведения А.С. Пушкина:

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

Вместо двоеточия уместно поставить слова а именно .

3. Если в предложении одна часть предупреждает о дальнейшем изложении, то можно поставить слова и увижу что, и услышу, как. Рассмотрим пример из пьесы Николая Островского:

Сами видите: всё вокруг в могущественном движении.

В это предложение мы можем поставить союз что, превратив бессоюзное сложное предложение в сложноподчинённое.

Правило третье: Двоеточие и прямая речь

Наконец я ей сказал: «Хочешь, пойдём прогуляться на вал?»
Он отвернулся и, отходя, пробормотал: «А всё-таки это совершенно против правил».

Правило четвёртое. Двоеточие и заголовки

Двоеточие ставится в заголовках, если они делятся на две части:

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

Вторая часть конкретизирует первую часть.

Например:

Бажов: читатель и книголюб.
Бюджет страны: проблемы и суждения.

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

Например, так:) или:(.

Итак, подытожим. Двоеточие ставится в следующих случаях:

Чтобы акцентировать внимание на одной из частей предложения;

При перечислении однородных членов после обобщающего слова;

Для выделения прямой речи;

Для пояснения одного предложения другим.

Обозначение элементов списка

Пример 1

Пример 2

Перечни бывают:

простые, т.е. состоящие из одного уровня членения текста (см. Примеры 1 и 2) и

составные, включающие 2 и более уровней (см. Пример 3).

Пример 3

Пример 4

Если в конце списка стоит «и др.», «и т.д.» или «и т.п.», то такой текст не располагают на отдельной строке, а оставляют в конце предыдущего элемента списка (см. Примеры 3 и 4).

Пунктуационное оформление перечней

Пример 5

Пример 6

Наконец, если части перечня представляют собой отдельные предложения, они друг от друга отделяются точкой:

Пример 7

Пример 8

Пример 9

Согласованность элементов списка

Пример 10

Пример 11

7.17 Двоеточие в простом и сложном предложениях

Видеоурок: Двоеточие и тире в предложениях разных типов

Лекция: Двоеточие в простом и сложном предложениях

Случаи написания двоеточия

1. В предложении с однородными членами, если:

обобщающее слово стоит впереди однор. членов. Пример: Мама занесла в комнату фрукты: бананы, яблоки и мандарины. О: О, О и О.
при перечислении, которое находится в середине предложения, если до перечисления есть обобщающее слово либо как-то, например, а именно. Пример: Андрей побывал во многих странах, а именно: в Англии, Австрии, Германии, Франции. О, а именно: О, О, О, О.

2. В предложении с прямой речью (ПР):

Слова автора стоят перед ПР, следовательно, ставим двоеточие и ПР пишем с большой буквы в кавычках:

Наташа с восхищением воскликнула: «Прелестные горы!».
А: «ПР!».
Наташа устало промолвила: «Горы прелестны».
А: «ПР».
Наташа поинтересовалась: «Горы красивы?».
А: «ПР?».
Наташа грустно продолжила: «Горы прелестны, но…».
А: «ПР…».

ПР стоит внутри слов автора, тогда после слов автора ставится двоеточие; затем в повествовательном предложении: кавычки, прямая речь с большой буквы, кавычки, запятая, тире, слова автора с маленькой буквы:

Валера устало промолвил: «Закрой за мной дверь», — и вышел.

А: «ПР», — а.

Часть слов автора относятся к первой половине ПР, а другая часть — ко второй, следовательно, после слов автора ставим двоеточие и тире:

«Как красивы эти горы! — воскликнула Наташа и спросила: — А какова их высота?».
«ПР! — а: — ПР?».

3. В предложении с цитатой, если она оформлена в виде ПР. Примеры:
«Краткость — сестра таланта» — писал А.П.Чехов.
А.П.Чехов писал: «Краткость — сестра таланта».

4. В сложном бессоюзном предложении, если:

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

Берегите природу¹: (= потому что) она зависит от нашего отношения к ней².
Кузнецов испугался¹: (= так как) он представил Наташу наедине с Силакцевым².

второе предложение поясняет содержание первого (между ними можно использовать а именно). Пример: В голове моей крутились новые мысли¹: (=а именно) я раздумывала о поездке в Дербент, воображала примерку нового платья²…

второе предложение дополняет первое (между ними можно использовать что; и вижу, как). Примеры:

Я сразу почувствовала¹: (=что) ноги мои становятся ватными²…
Подняла голову¹: (= и вижу, как) по лазурному небу плывут облака².

ПУНКТУАЦИЯ. Обобщим? Обобщающие слова при однородных членах предложения

Вспомним элементарные вещи: обобщающим называют слово, которое характеризует все названные предметы в совокупности. Такие слова в предложении идут рука об руку с однородными членами. Пунктуацию при их написании вы тоже помните с детства: если однородные члены следуют после обобщающего слова, за ним ставится двоеточие; если же однородность присутствует перед обобщающим словом, перед ним рисуют тире. Если же обобщающие слова размещены по обе стороны от однородных членов (или когда предложение сразу после перечисления не заканчивается), знаки совмещаются.

А теперь внимание – важные нюансы.

1. Слова «как-то, например, то есть, а именно». Может, вы и не замечали, но они весьма часто встречаются перед однородными членами. Так вот – их надлежит отделять запятой, а после них ставить двоеточие. Как-то так: «Любим мы грибы, а именно: белые, рыжики, польские».

2. Отделение только тире. Двоеточие после обобщающего слова может быть заменено на тире, если перечисление является уточнением основной мысли предложения: «Свинководы всех стран – Хрюляндии, Пятачковии, Копытляндии – соединяйтесь».

3. Употребление запятых. С ними все не так просто, как кажется на первый взгляд. Сразу отметим: никакого отношения к обобщающим словам они не имеют. Однако есть ситуации, когда запятые присутствуют в тексте по другим причинам – скажем, из-за придаточного предложения. Тогда от них отказываться не стоит, и надлежит нам их ставить, руководствуясь общими правилами пунктуации.

Возьмем хотя бы предложение: «Уважение, которое выказывали Василию Ивановичу рядовые граждане: бизнесмены, политики, директора, – было поистине безграничным. » Обратите внимание на подчеркнутые запятые – они выделяют именно придаточное предложение. Да и в любой аналогичной ситуации запятые ставить нужно, невзирая на однородные члены, так что будьте бдительны.

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

5. Двоеточие без обобщающего слова. Да, такое тоже возможно. Иногда определенного обобщающего слова в предложении нет, но обобщающая интонация прослеживается. Или же читателя надо предупредить, что начнется перечисление. И здесь двоеточие тоже ставят – это не ошибка. Например: «На скале расписались: Вася, Сеня, Аристарх и не терпящий анонимности смельчак Голопупенко».

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

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

Что такое Em Dash и когда его использовать? | Знаки препинания

Что такое Эм Дэш? Знаки препинания играют важную роль в передаче информации и выражений. Они обозначают паузы, ударение, разделение и даже тон в конкретном тексте. Эти знаки препинания включают точки, запятые, вопросительные и восклицательные знаки, чтобы назвать наиболее распространенные. Но знаете ли вы о некоторых знаках препинания, которые обычно не используются на письме, но имеют широкий спектр применения? Одним из них является так называемое длинное тире.

Что такое Эм Дэш?

Во-первых, длинное тире — это длинное тире (—), которое отличается от других дефисов и тире с точки зрения назначения и внешнего вида. Говорят, что оно названо так потому, что имеет ту же ширину, что и буква М. Слово «эм» на самом деле является типографской единицей измерения. Это указывает на то, что ширина печатного материала равна его размеру в пунктах или высоте.

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

Когда использовать Em Dash?

Вместо скобок

Пара круглых скобок используется при включении случайной или дополнительной информации.Длинные тире могут заменять пару скобок. Выбор того, что больше подходит, зависит от формальности и акцента текста в скобках. Длинные тире менее формальны, чем круглые скобки. Используйте пару коротких тире, если хотите привлечь внимание читателя к дополнительной идее. Это делает больший акцент на включенной информации. Когда включение указано в конце предложения, используется только один тире. Тем не менее, если вы хотите более тонко отобразить мысль, то просто используйте скобки.

Пример: Учительница — замещающая — на удивление строгая для своего первого дня в классе.

Вместо толстой кишки

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

Пример: Я знаю, что ты сейчас чувствуешь — сожаление.

вместо запятой

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

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

Отметьте прилагательные запятыми

Хотя длинные тире не подходят для использования между перечисляемыми терминами, их можно использовать до и после перечисления.Перечисления иногда бывают в форме прилагательных. Аппозитив — это существительное или именная группа, которая переименовывает другое существительное рядом с ним. Запятые обычно используются для выделения прилагательных. Но если идеи уже разделены запятыми, добавление тех же знаков препинания может запутать читателя. Таким образом, в этом случае вы можете вместо этого поставить пару коротких тире.

Пример: Трое из них — Блоссом, Бабблз и Лютик — победили Моджо Джоджо.

Для внезапных перерывов

Длинное тире или пара тире могут указывать на внезапный перерыв в мысли или прерывание утверждения. Этот стиль широко используется в свободном и творческом письме, прежде всего в цитатах или диалогах в рассказе или романе. Это изображает, что у писателя или говорящего произошел резкий сдвиг в мыслях или мнении.

Пример: Как мне ответить на это — неважно, теперь я понял.

Указать пропущенные неизвестные слова

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

Пример: «Я не к—— ж—— вы т—— о——т», — слышу я неслышимый голос.

Эм Дэш | Инфографика

Пин

Quia — KYBD: Справочники пунктуации

A	B
Используйте апостроф в качестве обозначения футов в счетах или таблицах или в качестве обозначения минут. (В качестве обозначения секунд и дюймов можно использовать кавычки.)	Пример: 12′ x 16′ 3’54» 8’6″ x 10’8″
Используйте апостоф в качестве символа для обозначения пропуск букв или цифр (как в сокращениях). для их значения: добавьте апостроф и s. В рыночных котировках образуйте множественное число цифр, добавляя только s.	6’s A’s Five’s ABC’s Century Fund 4s
Используйте апостроф, чтобы показать принадлежность: Добавьте апостроф и s к (a) существительному в единственном числе и (b) существительному во множественном числе, которое не оканчивается на s.	Пример: мужские часы женская обувь велосипед для мальчика
Используйте апостроф и s к имени собственному одного слога, который заканчивается на s.	Пример: Bess’s Cafeteria счет Джонса
Используйте апостроф ТОЛЬКО после (a) существительных во множественном числе, оканчивающихся на s, и (b) имени собственного, состоящего из более чем одного слога, оканчивающегося на s или z.	Пример: лагерь для мальчиков Дом Адамса Отчет Мелендеса
Добавьте апостроф после последнего существительного в ряду, чтобы указать на совместное или совместное владение двух или более лиц; однако добавьте притяжательный падеж к каждому из существительных, чтобы показать отдельное владение двумя или более лицами.	Пример: экспедиция Льюиса и Кларка, отчеты менеджера и казначея
Используйте двоеточие, чтобы ввести перечисление или список.	Пример: Это мои любимые поэты: Шелли, Китс и Фрост.
Используйте двоеточие, чтобы ввести вопрос или длинную прямую цитату.	Пример: Это вопрос: Вы готовились к тесту?
Используйте двоеточие между часами и минутами, выраженными цифрами.	Пример: 10:15 12:00 16:30
Используйте запятую (или запятые) после (а) вводных слов, фраз или предложений и (б) слов в серии.	Пример: Если можете, попробуйте посетить Чикаго, Сент-Луис и Даллас.
Используйте запятую, чтобы выделить краткие прямые цитаты.	Пример: Она сказала: «Если постараешься, сможешь достичь своей цели».
Используйте запятую перед и после (а) слов, которые встречаются вместе и относятся к одному и тому же человеку, предмету или идее, и (б) слов прямого обращения.	Пример: Кларисса, президент нашего класса, сделает отчет.
Используйте запятую для выделения неограничительных предложений (необходимых для смысла предложения), но не ограничительных предложений (необходимых для смысла).	Пример: Ваш отчет, посвященный этой проблеме, великолепен.
Используйте запятую, чтобы отделить день от года и город от штата.	Пример: 4 июля 2003 г. Нью-Хейвен, Коннектикут
Используйте запятую для разделения двух или более параллельных прилагательных (прилагательные, которые можно разделить словом «и» вместо запятой.	группа молодых, лица пожилого и среднего возраста
Не используйте запятые для разделения прилагательных, настолько тесно связанных друг с другом, что кажется, что они образуют единый элемент с изменяемым существительным.	Пример: дюжина больших красных роз маленькая квадратная коробка
Используйте запятую, чтобы разделить (a) несвязанные группы цифр, которые соединяются вместе, и (b) целые числа на группы по три цифры в каждой (однако ПОЛИТИКА, ГОД , СТРАНИЦА, КОМНАТА, ТЕЛЕФОН и большинство СЕРИЙНЫХ НОМЕРОВ показаны без запятых).	Пример: В течение 2001 г. 1750 автомобилей были застрахованы по полису 806423. стр. 1042 Комната 1184 (213) 825-2626
Для выделения используйте тире.	Пример: Обледенелая дорога, скользкая, как рыба, представляла опасность.
Используйте тире, чтобы указать на изменение мнения.	Пример: Мы можем совершить путешествие по Востоку, но я забегаю вперед.
Используйте тире для введения имени автора, когда оно следует за прямой цитатой.	Пример: «Нажать не ту клавишу — все равно, что ударить меня». —Armour
Используйте тире для определенных специальных целей.	Пример: «Ну… э-э-э», — пробормотал он.
Используйте восклицательный знак после выразительных междометий.	Пример: Вау! Привет! Что за день!
Используйте восклицательный знак после предложений, которые явно восклицательные.	«Я не пойду!» сказала она с решимостью. Как приятно было увидеть вас в Новом Орлеане на прошлой неделе!
Используйте дефис для соединения составных чисел от двадцати одного до девяноста девяти, которые вводятся как слова.	сорок шесть пятьдесят восемь свыше семидесяти шести
Используйте дефис для соединения сложных прилагательных перед существительным, которое они изменяют как единое целое.	Пример: хорошо продуманные планы на шестилетний период большинство в две трети
Используйте дефис после каждого слова цифры в ряду слов или цифр, которые изменяют одно и то же существительное (подвешенный перенос).	Пример: бронирование билетов первого, второго и третьего классов
Используйте дефис для написания слова или имени.	Пример: s-e-p-a-r-a-t-e
Используйте дефис для образования некоторых составных существительных.	Пример: WLW-TV учитель-консультант AFL-CIO
Используйте круглые скобки, чтобы заключить скобки или пояснения и дополнительную информацию.	Пример: Поправки (Приложение А) прилагаются.
Используйте круглые скобки для заключения идентифицирующих букв или цифр в списках.	Пример: Отметьте следующие факторы: (1) период времени, (2) ставка заработной платы и (3) характер обязанностей
Используйте круглые скобки, чтобы заключить числа, следующие за прописанными суммами, чтобы придать дополнительную ясность или подчеркнуть .	Пример: Общая сумма вознаграждения составляет пятьсот долларов (500 долларов США).
Используйте вопросительный знак в конце предложения, которое является прямым вопросом; однако используйте точку после запроса в форме вопроса.	В какой день вы планируете уехать в Гонолулу? Не могли бы вы отправить это письмо для меня, пожалуйста.
Используйте кавычки для заключения прямых цитат.	Пример: Он сказал: «Я буду там в восемь часов».
Используйте кавычки для заключения в кавычки названий статей и других частей полных публикаций, коротких стихотворений, названий песен, телевизионных программ и неопубликованных работ, таких как диссертации и диссертации.	Пример: «Улица Сезам» «Чикаго» Сэндберга «Тема Лауры» «Она написала убийство»
Используйте кавычки для заключения специальных слов или фраз или придуманных слов.	Процедура «включения» «Закон Мерфи»
Используйте точку с запятой для разделения двух или более независимых предложений в сложносочиненном предложении, когда союз опущен.	Пример: Критиковать легко; быть конструктивным не так просто.
Используйте точку с запятой для разделения независимых предложений, когда они соединены союзным наречием (Однако, следовательно, и т. д.)	Пример, я могу идти; однако я должен извиниться.
Используйте точку с запятой для разделения фраз или предложений (особенно если они содержат запятые), которые начинаются с двоеточия.	Пример: Были избраны следующие должностные лица: Лу Мин, президент; Лиза Штейн, вице-президент; Хуан Рамос, секретарь.
Используйте точку с запятой перед аббревиатурой или словом, которое вводит поясняющее утверждение.	Пример: Она организовала свою работу; например, размещение работы в папках разного цвета для обозначения степени срочности.
Используйте подчеркивание для названий полных сочинений, таких как книги, журналы и газеты.(Такие заголовки также можно набирать ЗАГЛАВНЫМИ БУКВАМИ без подчеркивания.)	Пример:
Используйте подчеркивание, чтобы привлечь внимание к специальным словам или фразам (или вы можете использовать кавычки). ПРИМЕЧАНИЕ. Используйте непрерывное подчеркивание, если каждое слово не должно рассматриваться отдельно.	Пример:

Перечисление WdSeparatorType (Word) | Документы Майкрософт

Статья
13. 09.2021
2 минуты на чтение

Полезна ли эта страница?

да Нет

Любая дополнительная обратная связь?

Отзыв будет отправлен в Microsoft: при нажатии кнопки отправки ваш отзыв будет использован для улучшения продуктов и услуг Microsoft.Политика конфиденциальности.

Представлять на рассмотрение

В этой статье

Указывает тип разделителя между элементами.

Имя	Значение	Описание
wdSeparatorColon	2	Двоеточие.
wdSeparatorEmDash	3	Подчеркнутое тире.
вдсепараторендаш	4	Стандартная черточка.
wdSeparatorHyphen	0	Дефис.
вдсепараторпериод	1	Точка.

Поддержка и обратная связь

Есть вопросы или отзывы об Office VBA или этой документации? См. раздел Поддержка и отзывы Office VBA, чтобы узнать, как вы можете получить поддержку и оставить отзыв.

НППЭС Реестр НПИ

Реестр NPI (National Provider Identifier) позволяет вам искать поставщиков в системе NPPES (Национальный план и система регистрации поставщиков). Вся информация, производимая Реестром НКО, предоставляется в соответствии с Уведомление о распространении данных NPPES. Плата за использование реестра NPI не взимается.

Дополнительные ресурсы CMS

Поиск записей NPI

Поиск записей NPI о поставщиках медицинских услуг, введя критерии поиска. Ниже описаны поля критериев поиска, которые можно ввести:

Номер NPI: Введите номер NPI для поиска конкретного NPI. При вводе других критериев поиска не требуется.
NPI Тип: Поиск можно уточнить для поиска только Индивидуальные (Тип 1) НФУ или только Организация (Тип 2) НКО; или поиск может включать все NPI (как индивидуальные, так и организации), выбрав Any .Выберите нужное значение из выпадающего списка. Тип NPI не может быть единственным введенным критерием поиска. Поиск по типу НФУ и стране приемлемо, если выбранная страна не является United Штаты . При поиске по типу НКО и стране США , хотя бы одно другое поле критерия поиска кроме того, государство должно быть введено.
Таксономия Описание: Поиск провайдеров по их таксономии, введя описание таксономии.
Название организации: Это поле относится только к Организационные провайдеры. Это поле позволяет использовать следующие специальные символы: амперсанд, апостроф, двоеточие, запятая, косая черта, дефис, левая и правая круглые скобки, точка, знак фунта стерлингов, кавычка и точка с запятой. NPPES выполняет поиск как по названию организации, так и по другим названиям организаций. связанные с NPI, такие как Doing Business As или прежнее юридическое название компании; поэтому результаты, отображаемые в результатах поиска в реестре NPI страница может содержать название организации, отличное от введенного в критерий поиска Название организации.
Имя: Это поле относится только к физическим лицам Провайдеры. В этом поле разрешены следующие специальные символы: амперсанд, апостроф, двоеточие, запятая, косая черта, дефис, левый и правый круглые скобки, точка, знак фунта стерлингов, кавычки и точка с запятой.
Фамилия: Это поле относится только к физическим лицам Провайдеры. В этом поле разрешены следующие специальные символы: амперсанд, апостроф, двоеточие, запятая, косая черта, дефис, левый и правый круглые скобки, точка, знак фунта стерлингов, кавычки и точка с запятой.
Город: Город, связанный с практикой поставщика адрес местонахождения. Для поиска военного адреса введите APO или FPO в поле City. Это поле позволяет использовать следующие специальные символы: амперсанд, апостроф, двоеточие, запятая, косая черта, дефис, левые и правые круглые скобки, точка, знак решетки, кавычки и точка с запятой.
Штат: Штат, связанный с практикой поставщика адрес местонахождения.Это поле нельзя использовать в качестве единственного критерия поиска. Если это поле используется, по крайней мере одно другое поле, помимо типа NPI и Country, должны быть заполнены. Выберите желаемое состояние из выпадающего списка список.
Страна: Страна, связанная с адрес местонахождения практики. Это поле можно использовать как единственный критерий поиска до тех пор, пока выбранное значение не является ни США, ни , ни Любой . При выборе США в качестве критерий поиска, по крайней мере еще одно поле критерия поиска, кроме NPI Тип и состояние должны быть введены. Выберите нужную страну из выпадающего списка список.
Почтовый индекс: Почтовый индекс, связанный с адрес места нахождения провайдера.
Тип адреса: Первичный и вторичный адреса, связанные с адресом места нахождения поставщика медицинских услуг. Должен использоваться с городом, штатом, страной и/или почтовым индексом.
Точное совпадение: Если установить (отметить) флажок, поиск будет возвращать только те NPI, данные NPI которых точно соответствуют введенным критериям поиска.
Примеры:
- Smith вводится в поле Фамилия, результаты поиска будут содержать только Провайдеры с фамилией Смит , и не будет включать имена, начинающиеся с Smith, например, Smiths или Smithson и т. д.
- Боб введен в первое поле Имя, результаты поиска будут включать только Провайдеры с именем Боб и не включает Провайдеров с именем Роберт , Бобби , Роб , Робби и т. д.

Навигация по страницам:

Кнопка Поиск : Выполняет поиск по критериям введены в поля выше.
Кнопка «Очистить »: очищает все критерии поиска. поля.
Гиперссылка NPPES : переход к системе NPPES Login страница, на которой поставщики могут подавать заявки и управлять своими NPI.
Загрузки Гиперссылка: переход к CMS Страница распространения данных, содержащая информацию о NPPES. Загружаемые файлы .Загружаемый файл NPPES предназначен для этих пользователей. если вам нужен доступ к полному файлу для распространения данных NPPES, пожалуйста, не стесняйтесь используйте ежемесячный загружаемый файл NPPES. Файл можно найти на Общественный Страница распространения данных. Пожалуйста, не забудьте прочитать Факты о Загружаемый файл, прежде чем пытаться загрузить фактический файл. АЭС Загружаемый файл очень большой (превышает 4 ГБ) и предназначен для загружаются лицами, обладающими необходимыми техническими знаниями.
Гиперссылка API : переход к NPPES API Страницы справки.NPPES Read API облегчает чтение общедоступных информация, связанная с NPI (идентификатор национального поставщика). Все информация, создаваемая NPPES Read API, предоставляется в соответствии с Уведомление о распространении данных NPPES.

Страницы справки реестра NPI

Руководство по стилю Kotlin | Разработчики Android

Этот документ служит полным определением стандартов кодирования Google для Android для исходного кода на языке программирования Kotlin.Исходный файл Kotlin описывается как выполненный в стиле Google Android, если и только если он соответствует приведенным здесь правилам.

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

Последнее обновление: 2021-05-19

Исходные файлы

Все исходные файлы должны иметь кодировку UTF-8.

Именование

Если исходный файл содержит только один класс верхнего уровня, имя файла должно отражать имя с учетом регистра плюс расширение .kt . В противном случае, если исходный файл содержит несколько объявлений верхнего уровня, выберите имя который описывает содержимое файла, применить PascalCase и добавить расширение .kt .

// МойКласс.kt
класс МойКласс { }

// Бар.кт
класс Бар { }
весело Runnable.toBar(): Bar = // …

// Карта.кт
fun  Set.map(func: (T) -> O): List = // …
fun  List.map(func: (T) -> O): List = // …

Специальные символы

Пробельные символы

Помимо последовательности конца строки, Символ горизонтального пробела ASCII (0x20) единственный символ пробела, который появляется где-либо в исходном файле. Это означает, что:

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

Специальные управляющие последовательности

Для любого символа, имеющего специальную управляющую последовательность. (\b , \n , \r , \t , \' , \", \, и \$), эта последовательность используется, а не соответствующий Unicode (например, ) побег.

символы, отличные от ASCII

Для остальных символов, отличных от ASCII, либо действительный символ Unicode, (т. е.например, ∞ ) или эквивалентный escape-код Unicode (например, > ). Выбор зависит только от того, какой делает код легче читать и понимать. Экранирование Unicode не рекомендуется для печатных символов в любом месте и настоятельно не рекомендуются за пределами строковых литералов и комментариев.

Пример	Обсуждение
`знач. единица Сокращение = "мкс"`	Лучший: совершенно ясно даже без комментариев.
`val unitAbbrev = "\u03bcs" // мкс`	Плохо: нет причин использовать экранирование с печатным символом.
`val unitAbbrev = "\u03bcs"`	Плохо: читатель понятия не имеет, что это такое.
`возврат "\ufeff" + содержимое`	Хорошо: используйте escape-последовательности для непечатаемых символов и при необходимости прокомментируйте.

Структура

А .kt состоит из следующего по порядку:

Заголовок об авторских правах и/или лицензии (необязательно)
Аннотации на уровне файла
Заявление о пакете
Заявления об импорте
Объявления верхнего уровня

Каждую из этих секций разделяет ровно одна пустая строка.

Авторское право / Лицензия

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

/*
 * Copyright 2017 Google, Inc.*
 * ...
 */

Не используйте стиль KDoc или однострочный комментарий.

/**
 * Copyright 2017 Google, Inc.
 *
 * ...
 */

// Copyright 2017 Google, Inc. 
//
// ...

Аннотации на уровне файла

Аннотации с «файлом» цель использования сайта помещаются между любым комментарием заголовка и объявлением пакета.

Заявление о пакете

Оператор package не имеет ограничений по столбцам и никогда не переносится на новую строку.

Заявления об импорте

Операторы импорта для классов, функций и свойств группируются в единый список и сортируются в кодировке ASCII.

Импорт подстановочных знаков (любого типа) запрещен.

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

Объявления верхнего уровня

Файл .kt может объявлять один или несколько типов, функций, свойств или типов. псевдонимы на верхнем уровне.

Содержимое файла должно быть сосредоточено на одной теме. Примеры этого будет один общедоступный тип или набор функций расширения, выполняющих одна и та же операция на нескольких типах приемников. Несвязанные объявления должны быть разделены на свои собственные файлы и публичные объявления в одном файле должно быть сведено к минимуму.

Никаких явных ограничений на количество и порядок содержимого файл.

Исходные файлы обычно читаются сверху вниз, что означает, что порядок в в целом, следует учитывать, что вышестоящие декларации будут информировать понимания тех, кто ниже.Различные файлы могут выбрать для заказа их содержание разное. Точно так же один файл может содержать 100 свойств, еще 10 функций и еще один класс.

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

Член класса, заказывающий

Порядок членов внутри класса соответствует тем же правилам, что и в верхнем уровне. декларации.

Форматирование

Брекеты

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

если (string.isEmpty()) вернуть

вал результат =
    if (string.isEmpty()) DEFAULT_VALUE иначе строка

когда (значение) {
    0 -> возврат
    // …
}

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

если (строка.isEmpty())
    возврат // НЕПРАВИЛЬНО!

если (string.isEmpty()) {
    возврат // Хорошо
}

Непустые блоки

Брекеты

следуют стилю Кернигана и Ритчи («египетские брекеты») для непустые блоки и блочные конструкции:

Без разрыва строки перед открывающей фигурной скобкой.
Разрыв строки после открывающей фигурной скобки.
Разрыв строки перед закрывающей фигурной скобкой.
Разрыв строки после закрывающей фигурной скобки, только если эта фигурная скобка завершает Оператор или завершает тело функции, конструктора или именованного класса .Например, без разрыва строки после фигурной скобки, если за ней следует иначе или запятая.

вернуть работоспособный {
    пока (условие()) {
        фу()
    }
}

возвращаемый объект: MyClass() {
    переопределить удовольствие foo() {
        если (условие()) {
            пытаться {
                что-то()
            } поймать (e: Исключение проблемы) {
                восстанавливаться()
            }
        } иначе, если (другое условие()) {
            что-то другое()
        } еще {
            Последняя вещь()
        }
    }
}

Несколько исключений для классы перечисления приведены ниже.

Пустые блоки

Пустой блок или блочная конструкция должны быть в стиле K&R.

пытаться {
    сделай что-нибудь()
} catch (e: Exception) {} // НЕПРАВИЛЬНО!

пытаться {
    сделай что-нибудь()
} поймать (е: Исключение) {
} // Хорошо

Выражения

Условие if/else , используемое в качестве выражения, может опускать фигурные скобки , только , если все выражение помещается в одну строку.

val value = if (string.isEmpty()) 0 else 1 // Хорошо

значение = если (строка.isEmpty()) // НЕПРАВИЛЬНО!
    0
еще
    1

val value = if (string.isEmpty()) { // Хорошо
    0
} еще {
    1
}

Отступ

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

Одна инструкция в строке

За каждым оператором следует разрыв строки. Запятые не используются.

Обвязка строк

Код имеет максимальное количество столбцов в 100 символов. За исключением случаев, указанных ниже, любая строка, превышающая этот предел, должна быть перенесена на новую строку, как описано ниже.

Исключения:

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

Куда сломать

Основная директива переноса строк: предпочитать разрыв на более высоком синтаксическом уровне. Также:

При разрыве строки в имени оператора или инфиксной функции разрыв наступает после имени оператора или инфиксной функции.
При разрыве строки на следующих «операторных» символах разрыв стоит перед символом:
- Разделитель точек ( . , ?. ).
- Два двоеточия ссылки на элемент ( :: ).
Имя метода или конструктора остается прикрепленным к открывающей скобке ( ( ), которая следует за ним.
Запятая ( , ) остается присоединенной к лексеме, которая предшествует ей.
Лямбда-стрелка ( -> ) остается прикрепленной к предшествующему ей списку аргументов.

Примечание: Основная цель переноса строк — получить понятный код, а не обязательно код, умещающийся в наименьшее количество строк.

Функции

Если сигнатура функции не помещается на одной строке, разбейте каждое объявление параметра на отдельную строку. Параметры, определенные в этом формате, должны использовать один отступ (+4).Закрывающая скобка ( ) ) и возвращаемый тип размещаются на отдельной строке без дополнительного отступа.

весело  Iterable.joinToString(
    разделитель: CharSequence = ", ",
    префикс: CharSequence = "",
    постфикс: CharSequence = ""
): Нить {
    // …
}

Функции выражения

Если функция содержит только одно выражение, ее можно представить в виде функция выражения.

переопределить удовольствие toString(): String {
    верни "Привет"
}

переопределить удовольствие toString(): String = "Эй"

Свойства

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

private val defaultCharset: Charset? знак равно
    EncodingRegistry.getInstance().getDefaultCharsetForPropertiesFiles(файл)

Свойства, объявляющие функцию get и/или set , должны помещать каждое в свою строку с нормальным отступом (+4). Отформатируйте их по тем же правилам как функции.

каталог var: Файл? = ноль
    установить (значение) {
        // …
    }

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

val defaultExtension: String get() = "kt"

Пробел

Вертикальный

Появляется одна пустая строка:

Между последовательными членами класса: свойства, конструкторы, функции, вложенные классы и т.д.
- Исключение: Пустая строка между двумя последовательные свойства (без другого кода между ними) является необязательным. Такие пустые строки используются по мере необходимости для создания логические группы свойств и связанных свойств с их резервным имуществом, если таковое имеется.
- Исключение: Пустые строки между константами перечисления закрыты ниже.
Между операторами, по мере необходимости для организации кода на логические подразделы.
Необязательно перед первым оператором функции, перед первым членом класса или после последнего члена класса (ни поощряется, ни обескураживает).
В соответствии с требованиями других разделов этого документа (например, раздел Структура).

Несколько последовательных пустых строк разрешены, но не поощряются или когда-либо требуется.

Горизонтальный

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

Разделение любого зарезервированного слова, например , если , вместо или поймать из открытой скобки ( ( ), которая следует за ним в этой строке.
```
// НЕПРАВИЛЬНЫЙ!
для (я в 0..1) {
}
 
```
```
// Хорошо
для (я в 0..1) {
}
 
```
Разделение любого зарезервированного слова, например else или поймать , из закрывающая фигурная скобка ( } ), которая предшествует ему в этой строке.
```
// НЕПРАВИЛЬНЫЙ!
}еще {
}
 
```
```
// Хорошо
} еще {
}
 
```

Перед любой открывающей фигурной скобкой ( { ).

// НЕПРАВИЛЬНЫЙ!
если (список.isEmpty()){
}

// Хорошо
если (список.isEmpty()) {
}

С обеих сторон любого бинарного оператора.

// НЕПРАВИЛЬНЫЙ!
значение два = 1+1

// Хорошо
значение два = 1 + 1

Это также относится к следующим «операторским» символам: Но нет:

два двоеточия ( :: ) ссылки на элемент.
```
// НЕПРАВИЛЬНЫЙ!
val toString = Any :: toString
 
```
```
// Хорошо
val toString = Any::toString
 
```

разделитель точек ( . ).

// НЕПРАВИЛЬНЫЙ
Это . нанизывать()

// Хорошо
это.toString()

оператор диапазона ( .. ).

// НЕПРАВИЛЬНЫЙ
 for (i in 1 .. 4) print(i)

 // Хорошо
 для (i в 1..4) print(i)

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

// НЕПРАВИЛЬНЫЙ!
класс Foo: работающий

// Хорошо
класс Foo: работающий

// НЕПРАВИЛЬНЫЙ
весело  max(a: T, b: T)

// Хорошо
весело  max(a: T, b: T)

// НЕПРАВИЛЬНЫЙ
fun  max(a: T, b: T), где T: Comparable

// Хорошо
fun  max(a: T, b: T), где T : Comparable

После запятой (, ) или двоеточия (:).

// НЕПРАВИЛЬНЫЙ!
значение oneAndTwo = listOf (1,2)

// Хорошо
значение oneAndTwo = listOf (1, 2)

// НЕПРАВИЛЬНЫЙ!
класс Foo: работающий

// Хорошо
класс Foo: работающий

С обеих сторон двойной косой черты ( // ), с которой начинается комментарий в конце строки. Здесь допускается использование нескольких пробелов, но это не обязательно.
```
// НЕПРАВИЛЬНЫЙ!
var debugging = false//отключено по умолчанию
 
```
```
// Хорошо
var debugging = false // отключено по умолчанию
 
```

Это правило никогда не интерпретируется как требующее или запрещающее дополнительный пробел в начале или конце строки; он касается только внутреннее пространство.

Специальные конструкции

Классы перечисления

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

enum class Ответ {ДА, НЕТ, МОЖЕТ БЫТЬ}

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

класс перечисления Ответ {
    ДА,
    НЕТ,

    МОЖЕТ БЫТЬ {
        переопределить fun toString() = """¯\_(ツ)_/¯"""
    }
}

Поскольку классы enum являются классами, применяются все остальные правила форматирования классов.

Аннотации

Аннотации членов или типов размещаются на отдельных строках непосредственно перед аннотированной конструкцией.

@Retention(ИСТОЧНИК)
@Target(ФУНКЦИЯ, PROPERTY_SETTER, ПОЛЕ)
класс аннотации Глобальный

Аннотации без аргументов можно размещать в одной строке.

@JvmField @Volatile
вар одноразовый: Одноразовый? = ноль

Если присутствует только одна аннотация без аргументов, его можно поместить на той же строке, что и объявление.

@Volatile var одноразовый: одноразовый? = ноль

@Test fun selectAll() {
    // …
}

@[...] синтаксис может использоваться только с явной целью использования сайта и только для объединение 2 или более аннотаций без аргументов в одной строке.

@field:[JvmStatic Volatile]
вар одноразовый: Одноразовый? = ноль

Неявные возвращаемые значения/типы свойств

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

переопределить удовольствие toString(): String = "Эй"
// становится
переопределить удовольствие toString() = "Эй"

private val ICON: Icon = IconLoader.getIcon("/icons/kotlin.png")
// становится
private val ICON = IconLoader. getIcon("/icons/kotlin.png")

При написании библиотеки сохраняйте явное объявление типа, когда это часть общедоступного API.

Именование

Идентификаторы используют только буквы и цифры ASCII и, в небольшом числе случаев, указанных ниже, символы подчеркивания.Таким образом, каждому допустимому имени идентификатора соответствует регулярное выражение \w+ .

Специальные префиксы или суффиксы, как показано в примерах name_ , mName , s_name и kName , не используются, за исключением случая резервные свойства (см. Поддерживающие свойства).

Имена пакетов

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

// Хорошо
пакет ком. пример.deepspace
// НЕПРАВИЛЬНЫЙ!
пакет com.example.deepSpace
// НЕПРАВИЛЬНЫЙ!
пакет com.example.deep_space

Имена типов

Имена классов записываются в PascalCase и обычно являются существительными или существительными. фразы. Например, Character или ImmutableList . Имена интерфейсов могут также быть существительными или именными словосочетаниями (например, List ), но иногда могут быть прилагательными или прилагательными словосочетаниями вместо этого (например, Readable ).

Имена тестовых классов начинаются с имени класса, который они тестируют, и заканчивая Test .Например, HashTest или HashIntegrationTest .

Имена функций

Имена функций записываются в верблюжьем регистре и обычно представляют собой глаголы или глагольные фразы. Например, sendMessage или stop .

Разрешено использование символов подчеркивания в именах тестовых функций для разделения логических компонентов имени.

@Test fun pop_emptyStack() {
    // …
}

Функции, аннотированные @Composable , которые возвращают Unit , написаны в стиле PascalCase и названы существительными, как если бы они были типами.

@составной
весело NameTag (имя: строка) {
    // …
}

Имена функций не должны содержать пробелов, так как это поддерживается не во всех случаях. платформе (в частности, это не полностью поддерживается в Android).

// НЕПРАВИЛЬНЫЙ!
fun `проверить все возможные случаи`() {}
// В ПОРЯДКЕ
весело testEveryPossibleCase() {}

Имена констант

Имена констант используют UPPER_SNAKE_CASE: все буквы верхнего регистра, со словами, разделенными символом подчеркивания. Но что именно является константой ?

Константы — это val свойства без пользовательской функции get , содержимое которой глубоко неизменны и чьи функции не имеют обнаруживаемых побочных эффектов.Этот включает неизменяемые типы и неизменяемые коллекции неизменяемых типов а также скаляры и строки, если они помечены как const . Если какой-либо из экземпляров наблюдаемое состояние может меняться, оно не является константой. Просто намереваясь никогда не мутировать объект недостаточно.

константное значение ЧИСЛО = 5
val NAMES = listOf("Алиса", "Боб")
val AGES = mapOf("Алиса" до 35, "Боб" до 32)
val COMMA_JOINER = Joiner.on(',') // Объединение неизменяемо
значение EMPTY_ARRAY = arrayOf()

Эти имена обычно являются существительными или словосочетаниями.

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

Константы, которые являются скалярными значениями, должны использовать константу модификатор.

Непостоянные имена

Непостоянные имена пишутся в camelCase. Они применяются к свойствам экземпляра, локальным свойствам и именам параметров.

переменная val = "var"
val nonConstScalar = "неконстантный"
val mutableCollection: MutableSet = HashSet()
val mutableElements = listOf(mutableInstance)
val mutableValues = mapOf («Алиса» в mutableInstance, «Боб» в mutableInstance2)
val logger = Logger.getLogger(MyClass::class.java.name)
val nonEmptyArray = arrayOf("эти", "можно", "изменить")

Эти имена обычно являются существительными или словосочетаниями.

Свойства основы

Когда резервное имущество необходимо, его название должно точно совпадать с названием недвижимого имущества кроме префикса с подчеркиванием.

частный var _table: Карта? = ноль

таблица значений: Карта
    получить() {
        если (_таблица == ноль) {
            _table = хэш-карта ()
        }
        вернуть _table ?: бросить AssertionError()
    }

Введите имена переменных

Каждая переменная типа имеет имя в одном из двух стилей:

Одна заглавная буква, за которой может следовать одна цифра (например, E , T , X , T2 )
Имя в форме, используемой для классов, за которой следует заглавная буква. письмо T (например, RequestT , FooBarT )

Верблюжий чемодан

Иногда существует более одного разумного способа преобразовать английскую фразу в верблюжий регистр, например, когда присутствуют аббревиатуры или необычные конструкции, такие как «IPv6» или «iOS». Для повышения предсказуемости используйте следующую схему.

Начиная с прозаической формы имени:

Преобразуйте фразу в обычный ASCII и удалите все апострофы. Например, «алгоритм Мюллера» может стать «алгоритмом Мюллера».
Разделите этот результат на слова, разделив их на пробелы и любые оставшиеся знаки препинания (обычно дефисы). Рекомендуется: , если какое-либо слово уже имеет общеупотребительный вид в верблюжьем регистре, разбить его на составные части (например,ж., «AdWords» становится «рекламными словами»). Обратите внимание, что такое слово, как «iOS», на самом деле не в верблюжьем регистре как таковое; это противоречит любому соглашению, поэтому эта рекомендация не применяется.
Теперь все строчными буквами (включая акронимы), затем выполните одно из следующих действий:
- Первый символ каждого слова в верхнем регистре для перевода в паскаль.
- Первый символ каждого слова в верхнем регистре, кроме первого символа yield верблюжий случай.
Наконец, соедините все слова в один идентификатор.

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

Прозаическая форма	Правильно	Неверно
«XML HTTP-запрос»	`XmlHttpRequest`	`XMLHTTPRequest`
«ID нового клиента»	`новый идентификатор клиента`	`новыйCustomerID`
«внутренний секундомер»	`внутренний секундомер`	`внутренний секундомер`
«поддерживает IPv6 на iOS»	`поддерживает IPv6OnIos`	`поддерживает IPv6OnIOS`
«Импортер YouTube»	`Импортер YouTube`	`Ютуб Импортер` *

(* Допустимо, но не рекомендуется. )

Примечание: Некоторые слова в английском языке написаны через дефис неоднозначно: for пример «непустой» и «непустой» оба верны, поэтому имена методов checkNonempty и checkNonEmpty также верны.

Документация

Форматирование

В этом примере показано основное форматирование блоков KDoc:

/**
 * Здесь написано несколько строк текста KDoc,
 * завернутый нормально…
 */
забавный метод (аргумент: строка) {
    // …
}

…или в этом однострочном примере:

/** Особенно короткий фрагмент KDoc. */

Базовая форма всегда приемлема. Однострочная форма может быть заменяется, когда весь блок KDoc (включая маркеры комментариев) может уместиться в одну строку. Обратите внимание, что это применимо только при отсутствии блочные теги, такие как @return .

Пункты

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

Блочные теги

Любой из используемых стандартных «блочных тегов» появляется в заказе @конструктор , @приемник , @параметр , @свойство , @возврат , @ выдает , @see , и они никогда не появляются с пустым описанием. Если тег блока не помещается на одной строке, строки продолжения имеют отступ в 4 пробела от позиции @ .

Фрагмент сводки

Каждый блок KDoc начинается с фрагмента краткой сводки. Этот фрагмент очень важно: это единственная часть текста, которая появляется в определенных контекстах, таких как индексы классов и методов.

Это фрагмент — именная или глагольная группа, а не полное предложение. Оно не начинается с « `Фу` это... «, или « Этот метод возвращает... «, и при этом он не должен образовывать полное повелительное предложение, например « Сохранить запись. «. Тем не менее, фрагмент написан с большой буквы и знаки препинания, как если бы это было законченное предложение.

Использование

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

Исключение: не требующие пояснений функции

KDoc необязателен для «простых, очевидных» функций, таких как getFoo и такие свойства, как foo , в тех случаях, когда действительно и действительно нечего сказать, кроме как «Возвращает foo».

Неуместно цитировать это исключение, чтобы оправдать исключение соответствующих информация, которая может понадобиться обычному читателю.Например, для функция с именем getCanonicalName или свойство с именем canonicalName , не опускайте его документацию (с тем обоснованием, что в нем будет сказано только /** Возвращает каноническое имя. */ ), если у типичного читателя может не быть представление о том, что означает термин «каноническое имя»!

Исключение: переопределяет

KDoc не всегда присутствует в методе, который переопределяет метод супертипа.

Компоненты

STK для Java 2021 r3

Iso8601Format | Компоненты STK для Java 2021 r3

В вашем браузере отключен JavaScript.

Сводка констант Enum

Константы перечисления
Константа перечисления и описание
`БАЗОВЫЙ` Полная дата и время ISO8601 в базовом формате, в котором отсутствуют разделители тире и двоеточие, используемые между компонентами даты и времени.
`КОМПАКТНЫЙ` Кратчайший способ точного представления даты и времени в формате ISO8601.
`РАСШИРЕННЫЙ` Полная дата и время ISO8601 в расширенном формате, в котором между компонентами даты и времени используются разделители тире и двоеточие.

- Деталь константы Enum
  - БАЗОВЫЙ
```
 общедоступный статический окончательный вариант Iso8601Format BASIC 
```
    Полная дата и время ISO8601 в базовом формате, в котором отсутствуют разделители тире и двоеточие, используемые между компонентами даты и времени.
  - РАСШИРЕННЫЙ
```
 общедоступный статический окончательный формат Iso8601 EXTENDED 
```
    Полная дата и время ISO8601 в расширенном формате, в котором между компонентами даты и времени используются разделители тире и двоеточие.
  - КОМПАКТНЫЙ
```
 общедоступный статический окончательный Iso8601Format COMPACT 
```
    Кратчайший способ точного представления даты и времени в формате ISO8601.
- Описание метода
  - значение
```
 public static Iso8601Format valueOf(String name) 
```
    Возвращает константу перечисления этого типа с указанным именем. Строка должна точно соответствовать идентификатору, используемому для объявления константа перечисления в этом типе. (Посторонние пробельные символы не разрешено.)
    Параметры:
    имя — имя возвращаемой константы перечисления.
    Возвратов:
    константа перечисления с указанным именем
    Результатов:
    IllegalArgumentException — если у этого типа перечисления нет константы с указанным именем
    NullPointerException — если аргумент равен нулю
  - жетфромвалуе
```
 @Nonnull
общедоступный статический Iso8601Format getFromValue (целое значение) 
```
    Получить константу перечисления, связанную с заданным числовым значением.
    Параметры:
    значение — числовое значение.
    Возвратов:
    Константа перечисления, связанная со значением.
  - getDefault
```
 @Nonnull
общедоступный статический Iso8601Format getDefault() 
```
    Получить константу перечисления, которая считается значением по умолчанию.
    Возврат:
    Константа перечисления по умолчанию.

Справочное руководство по многоразовой конфигурации

— CircleCI

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

Примечания по многократно используемой конфигурации

Установите интерфейс командной строки CircleCI, чтобы у вас был доступ к команде процесса CircleCI config (необязательно). Эта команда позволяет увидеть расширенную конфигурацию со всеми обработанными многократно используемыми ключами. Инструкции и советы по установке см. в документации Использование CLI CircleCI.
Для многоразовых элементов конфигурации CircleCI требуется файл версии : 2.1 .circleci/config.yml .
Имена команд, заданий, исполнителей и параметров должны начинаться с буквы и могут содержать только строчные буквы ( a - z ), цифры ( 0 - 9 ), символы подчеркивания ( _ ) и дефисы ( - ).

`Использование объявления параметров`

  Параметры объявляются по имени в задании, команде или исполнителе. Непосредственные дочерние элементы ключа  параметров  представляют собой набор ключей на карте. Параметры конвейера определяются на верхнем уровне конфигурации проекта. Дополнительные сведения о параметрах конвейера см. в руководстве «Переменные конвейера».
 В следующем примере команда с именем  приветствие  разработана с одним параметром с именем от  до  .Параметр от  до  используется в шагах для эха  Hello  обратно пользователю.
  версия: 2.1
commands: # многократно используемая команда с параметрами
  приветствие:
    параметры:
      к:
        по умолчанию: "мир"
        тип: строка
    шаги:
      - запустить: echo "Привет <>"
вакансии:
  моя работа:
    докер:
      - образ: cimg/base: стабильный
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
    шаги:
      - приветствие:
          кому: "Мое имя"
рабочие процессы:
  мой рабочий процесс:
    вакансии:
      - моя работа


  
 Синтаксис параметра 
 Параметр может иметь следующие непосредственные дочерние ключи:
 Имя ключа  Описание  Значение по умолчанию
 описание  Дополнительно. Используется для создания документации для вашего шара.  н/д
 тип  Обязательно. Подробности см. в разделе Типы параметров   в разделе ниже.  н/д
 по умолчанию  Значение параметра по умолчанию. Если параметр отсутствует, подразумевается, что этот параметр является обязательным.  н/д
 Типы параметров 
 В этом разделе описаны типы параметров и их использование.
 Типы параметров, поддерживаемые шарами:
  струна 
  логический 
  целое число 
  перечисление 
  исполнитель 
  ступени 
 имя переменной среды
 Типы параметров, поддерживаемые параметрами конвейера:
  струна 
  логический 
  целое число 
  перечисление 
 Строка 
 Основные параметры строки описаны ниже:
  версия: 2. 1
команды:
  копирование-уценка:
    параметры:
      назначения:
        описание: каталог назначения
        тип: строка
        по умолчанию: документы
    шаги:
      - выполнить: cp *.md << параметры.назначение >>
  
 Строки должны быть заключены в кавычки, если в противном случае они представляли бы другой тип (например, логический или числовой) или если они содержат символы, имеющие особое значение в YAML, особенно двоеточие. Во всех остальных случаях кавычки необязательны.Пустые строки обрабатываются как ложные значения при оценке , когда предложения , а все остальные строки обрабатываются как истинные. Использование строкового значения без кавычек, которое YAML интерпретирует как логическое значение, приведет к ошибке типа.
 Булево значение 
 Логические параметры полезны для условий:
  версия: 2.1
команды:
  нпм-установить:
    параметры:
      чистый:
        описание: выполнить чистую установку
        тип: логический
        по умолчанию: ложь
    шаги:
      - когда:
          условие: << параметры. чистый >>
          шаги:
            - запустить: npm чистая установка
      - когда:
          состояние:
            не: << параметры.чистый >>
          шаги:
            - запустить: установка нпм
  
 Оценка логических параметров основана на значениях, указанных в YAML 1.1:
 Верно:  y   да   верно   на 
 Ложь:  нет   нет   ложь   выкл 
   Примечание:   Логические значения могут быть возвращены как «1» для True и «0» для False.
 Версии приведенных выше значений, написанные заглавными и прописными буквами, также допустимы.
 Целое число 
 Используйте тип параметра  integer  для передачи числового целочисленного значения. В следующем примере целочисленный тип   используется для заполнения значения параллелизма   в задании.
  версия: 2. 1
вакансии:
  строить:
    параметры:
      п:
        тип: целое число
        по умолчанию: 1
    параллелизм: << параметры.p >>
    машина: правда
    шаги:
      - проверить
рабочие процессы:
  рабочий процесс:
    вакансии:
      - строить:
          р: 2
  
 Перечисление 
 Параметр  enum  может быть списком любых значений.Используйте тип параметра  enum , если вы хотите принудительно указать, что значение должно быть одним из определенного набора строковых значений. В следующем примере параметр  enum  используется для объявления целевой операционной системы для двоичного файла.
  версия: 2.1

команды:
  список-файлы:
    параметры:
      Операционные системы:
        по умолчанию: "линукс"
        описание: Целевая операционная система для двоичного файла heroku. Должен быть один из "linux", "darwin", "win32".
        тип: перечисление
        перечисление: ["linux", "darwin", "win32"]
  
 Следующее объявление типа  enum  недопустимо, так как значение по умолчанию не объявлено в списке перечислений.
  версия: 2.1

команды:
  список-файлы:
    параметры:
      Операционные системы:
        тип: перечисление
        по умолчанию: "windows" #неверное объявление по умолчанию, которое не отображается в списке перечислений, разделенных запятыми
        перечисление: ["дарвин", "линукс"]
  
 Исполнитель 
 Используйте тип параметра  executor , чтобы разрешить инициатору задания решать, на каком исполнителе оно будет выполняться.
  версия: 2.1

исполнители:
  ксениальный:
    параметры:
      некоторое значение:
        тип: строка
        по умолчанию: фу
    окружающая обстановка:
      SOME_VAR: << параметры.какое-то значение >>
    докер:
      - изображение: убунту:xenial
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
  бионический:
    докер:
      - изображение: убунту: бионический
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта

вакансии:
  контрольная работа:
    параметры:
      е:
        тип: исполнитель
    исполнитель: << параметры. e >>
    шаги:
      - запустить: некоторые тесты

рабочие процессы:
  рабочий процесс:
    вакансии:
      - контрольная работа:
          е: бионический
      - контрольная работа:
          е:
            Имя: Ксениал
            некоторое значение: foobar
  
 шагов 
 Шаги используются, когда у вас есть задание или команда, которые должны сочетать предопределенные и определенные пользователем шаги.При передаче в вызов команды или задания шаги, передаваемые в качестве параметров, всегда определяются как последовательность, даже если указан только один шаг.
  версия: 2.1

команды:
  запустить-тесты:
    параметры:
      после отложений:
        description: "Шаги, которые будут выполняться после установки зависимостей, но до запуска тестов"
        тип: шаги
        дефолт: []
    шаги:
      - запустить: сделать отпечатки
      - шаги: << параметры.after-deps >>
      - запустить: сделать тест
  
 В следующем примере показано, что шаги, переданные в качестве параметров, задаются как значение объявления  шагов  в задании  шагов  .
  версия: 2.1

команды:
  запустить-тесты:
    параметры:
      после отложений:
        description: "Шаги, которые будут выполняться после установки зависимостей, но до запуска тестов"
        тип: шаги
        дефолт: []
    шаги:
      - запустить: сделать отпечатки
      - шаги: << параметры.after-deps >>
      - запустить: сделать тест

вакансии:
  строить:
    машина: правда
    шаги:
      - прогоны-тесты:
          после отложений:
            - выполнить: echo "Зависимости установлены"
            - run: echo "А теперь я прогоню тесты"
  
 Вышеприведенное разрешается в следующее:
  версия: 2.1
шаги:
  - запустить: сделать отпечатки
  - выполнить: echo "Зависимости установлены"
  - run: echo "А теперь я прогоню тесты"
  - запустить: сделать тест
  
 Имя переменной среды 
 Параметр имени переменной среды (  env_var_name  ) представляет собой строку, которая должна соответствовать регулярному выражению POSIX_NAME (например, не должно быть пробелов или специальных символов). Параметр  env_var_name  — это более значимый тип параметра, который позволяет CircleCI проверять, может ли переданная строка использоваться в качестве имени переменной среды.Дополнительные сведения о переменных среды см. в руководстве по использованию переменных среды.
 В приведенном ниже примере показано, как использовать тип параметра  env_var_name  для развертывания на AWS S3 с повторно используемым заданием  сборки . В этом примере показано использование переменных среды  AWS_ACCESS_KEY  и  AWS_SECRET_KEY  с параметрами  ключ доступа  и  секретный ключ . Таким образом, если у вас есть задание развертывания, которое запускает  s3cmd  , можно создать повторно используемую команду, которая использует необходимую проверку подлинности, но выполняет развертывание в пользовательской корзине.
 Исходный файл  config.yml :
  версия: 2.1

вакансии:
  строить:
    докер:
    - изображение: ubuntu: последний
      авторизация:
        имя пользователя: mydockerhub-пользователь
        пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
    шаги:
    - бегать:
        команда: |
          s3cmd --access_key ${FOO_BAR} \
                --secret_key ${BIN_BAZ} \
                лс s3://некоторые/где
рабочие процессы:
  рабочий процесс:
    вакансии:
    - строить
  
 Новая конфигурация . yml  файл:
  версия: 2.1

вакансии:
   строить:
     параметры:
       ключ доступа:
         тип: env_var_name
         по умолчанию: AWS_ACCESS_KEY
       Секретный ключ:
         тип: env_var_name
         по умолчанию: AWS_SECRET_KEY
       команда:
         тип: строка
     докер:
       - изображение: ubuntu: последний
         авторизация:
           имя пользователя: mydockerhub-пользователь
           пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
     шаги:
       - запустить: |
           s3cmd --access_key ${<< параметры.ключ доступа >>} \\
                 --secret_key ${<< параметры.секретный ключ >>} \\
                 << параметры.команда >>
рабочие процессы:
  рабочий процесс:
    вакансии:
      - строить:
          ключ доступа: FOO_BAR
          секретный ключ: BIN_BAZ
          команда: ls s3://some/where
  
 Создание многократно используемых команд 
 Команды объявлены в ключе  commands  файла  config. yml . В следующем примере определяется команда  sayhello  , которая принимает строковый параметр от  до  :
  версия: 2.1

команды:
  скажи привет:
    description: "Очень простая команда для демонстрационных целей"
    параметры:
      к:
        тип: строка
        по умолчанию: "Мир"
    шаги:
      - запустить: echo Hello << параметры.к >>
  
 команды  ключ Команда определяет последовательность шагов как карту, которая должна выполняться в задании, что позволяет повторно использовать одно определение команды в нескольких заданиях.
 Ключ  Обязательно  Тип  Описание
 ступени  Д  Последовательность  Последовательность шагов, выполняемых внутри задания, вызывающего команду.
 параметры  Н  Карта  Карта ключей параметров. Подробнее см. в разделе Синтаксис параметров.
 описание  Н  Строка  Строка, описывающая назначение команды. Используется для создания документации.
 Вызов многократно используемых команд 
 Повторно используемые команды вызываются с определенными параметрами как шаги внутри задания.При использовании команды шаги этой команды вставляются в то место, где вызывается команда. Команды можно использовать только как часть последовательности из  шагов  в задании.
 В следующем примере используется та же команда из предыдущего примера —  sayhello  — и она вызывается в задании  myjob  , передавая ей значение параметра от  до :
  версия: 2.1

команды:
  скажи привет:
    description: "Очень простая команда для демонстрационных целей"
    параметры:
      к:
        тип: строка
        по умолчанию: "Мир"
    шаги:
      - запустить: echo Hello << параметры. к >>

вакансии:
  моя работа:
    докер:
      - изображение: "cimg/база: стабильная"
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
    шаги:
      - sayhello: # вызвать команду "sayhello"
          к: "Лев"
  
 Вызов других команд в команде 
 Команды могут использовать другие команды в рамках выполнения. Например, если команда объявлена внутри шара, она может использовать другие команды в этом шаре.Он также может использовать команды, определенные в других импортированных вами шарах (например,  some-orb/some-command ).
 Специальные ключи 
 CircleCI имеет несколько специальных ключей, доступных для всех клиентов CircleCI.com и доступных по умолчанию в установках сервера CircleCI. Примеры этих ключей:
  касса 
  setup_remote_docker 
  persist_to_workspace 
  Примечание:  Специальные клавиши можно переопределить с помощью пользовательской команды.
 Примеры использования команд 
 Ниже приведен пример части шара  aws-s3 , где определена команда с именем  sync :
  версия: 2.1
# сфера Aws-s3
команды:
  синхронизировать:
    description: "Простая инкапсуляция выполнения синхронизации s3"
    параметры:
      от:
        тип: строка
      к:
        тип: строка
      перезаписать:
        по умолчанию: ложь
        тип: логический
    шаги:
      - бегать:
          имя: Развернуть на S3
          команда: aws s3 sync << параметры.из >> << параметры.в >><<# параметры.перезаписать >> --delete<>"
  
 Чтобы вызвать эту команду  sync  в файле 2.1  .circleci/config.yml , см. следующий пример:
  версия: 2.1

шары:
  aws-s3: кругci/[email protected]

вакансии:
  деплой2с3:
    докер:
      - изображение: cimg/<язык>:<ТЕГ версии>
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
    шаги:
      - aws-s3/синхронизация:
          от: . на: "s3://mybucket_uri"
          перезаписать: правда

рабочие процессы:
  сборка-тестирование-развертывание:
    вакансии:
      - деплой2с3
  
 Определение задания  сборки :
  версия: 2.1

шары:
  aws-cli: кругци/[email protected]
  aws-s3: кругci/[email protected]

вакансии:
  строить:
    исполнитель: aws-cli/по умолчанию
    шаги:
      - проверить
      - запустить: mkdir ведро && echo "lorum ipsum" > ведро/build_asset.txt
      - aws-s3/синхронизация:
          из: ведро
          to: "s3://my-s3-bucket-name/prefix"
          перезаписать: правда
      - aws-s3/копировать:
          из: ведро/build_asset.текст
          на: "s3://my-s3-bucket-name"
          аргументы: --dryrun
  
 Создание многоразовых исполнителей 
 Исполнители определяют среду, в которой будут выполняться шаги задания. При объявлении задания   в конфигурации CircleCI вы определяете тип среды выполнения ( docker ,  машина ,  macos  и т. д.) для запуска, а также любые другие параметры для этой среды, в том числе: переменные для заполнения, какую оболочку использовать, какой размер  resource_class  использовать и т. д.
 Объявления исполнителя за пределами  заданий  могут использоваться всеми заданиями в области действия этого объявления, что позволяет повторно использовать одно определение исполнителя в нескольких заданиях.
 Определение исполнителя включает один или несколько из следующих ключей:
  докер  или  машина  или  macos 
  окружающая среда 
  рабочий_каталог 
  корпус 
  класс_ресурсов 
 В следующем примере  my-executor  используется для запуска задания  my-job  .
  версия: 2.1
исполнители:
  мой-исполнитель:
    докер:
      - изображение: cimg/ruby:2. 5.1-браузеры
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
вакансии:
  моя работа:
    исполнитель: мой-исполнитель
    шаги:
      - запустить: эхо вне исполнителя
  
 исполнители  ключ Исполнители определяют среду, в которой будут выполняться шаги задания, что позволяет повторно использовать одно определение исполнителя в нескольких заданиях.
 Параметры Ключ  Обязательно  Тип  Описание
 докер  Да ⁽¹⁾  Список  Параметры для исполнителя  docker .
 класс_ресурсов  Н  Строка  Объем ЦП и ОЗУ, выделенный каждому контейнеру в задании. (Доступно только с исполнителем  docker )  Примечание:  Для доступа к этой функции требуется платная учетная запись. Клиенты с платными планами на основе контейнеров могут запросить доступ, отправив запрос в службу поддержки.
 машина  Да ⁽¹⁾  Карта  Опции для  станка  исполнитель.
 макос  Да ⁽¹⁾  Карта  для исполнителя  macOS .
 корпус  Н  Строка  Оболочка, используемая для выполнения команды на всех этапах.Может быть переопределен оболочкой   на каждом этапе.
 рабочий_каталог  Н  Строка  Каталог, в котором выполняются шаги.
 окружающая среда  Н  Карта  Карта имен и значений переменных среды.
 Пример:
  версия: 2. 1
исполнители:
  мой-исполнитель:
    докер:
      - изображение: cimg/ruby:2.5.1-браузеры
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта

вакансии:
  моя работа:
    исполнитель: мой-исполнитель
    шаги:
      - запустить: эхо вне исполнителя
  
 Вызов многоразовых исполнителей 
 В следующем примере передается  my-executor  в качестве значения  имени  ключа под  исполнителем  — этот метод в основном используется при передаче параметров вызовам исполнителя:
  версия: 2.1

исполнители:
  мой-исполнитель:
    докер:
      - изображение: cimg/ruby:2.5.1-браузеры
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта

вакансии:
  моя работа:
    исполнитель:
      имя: мой-исполнитель
    шаги:
      - запустить: эхо вне исполнителя
  
 Также можно позволить шару определять исполнителя, используемого всеми его командами. Это позволяет пользователям выполнять команды этого шара в среде выполнения, определенной автором шара.
 Пример использования исполнителя, объявленного в 
 config.yml , с матричными заданиями. В следующем примере объявляется исполнитель Docker с образом узла  node-docker  . Теговая часть строки изображения параметризуется параметром  версии . Параметр  версии  также включен в задание  test , чтобы его можно было передать через задание исполнителю, когда задание вызывается из рабочего процесса.
 При вызове задания  test  в рабочем процессе  matrix-tests  матричные задания используются для одновременного запуска задания несколько раз, каждое с другим набором параметров.Приложение Node протестировано на многих версиях Node.js:
.  версия: 2.1

исполнители:
  node-docker: # объявляет многоразовый исполнитель
    параметры:
      версия:
        описание: "тег версии"
        по умолчанию: "lts"
        тип: строка
    докер:
      - изображение: cimg/node:< version>>
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта

вакансии:
  контрольная работа:
    параметры:
      версия:
        описание: "тег версии"
        по умолчанию: "lts"
        тип: строка
    исполнитель:
      имя: узел-докер
      версия: <<параметры.версия>>
    шаги:
      - проверить
      - бег: эхо "как дела?"

рабочие процессы:
  матричные тесты:
    вакансии:
      - контрольная работа:
          матрица:
            параметры:
              версия:
                - 13.11.0
                - 12.16.0
                - 10.19.0
  
 Использование исполнителей, определенных в сфере 
 Вы также можете обратиться к исполнителям из других сфер. Пользователи шара могут вызывать его исполнителей. Например,  foo-orb  может определить исполнителя  bar :
  версия: 2.1
# Ямл из foo-orb
исполнители:
  бар:
    машина: правда
    окружающая обстановка:
      RUN_TESTS: фубар
  
  baz-orb  также может определить исполнителя  bar :
  версия: 2. 1
# Ямл из баз-орба
исполнители:
  бар:
    докер:
      - образ: cimg/base: стабильный
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
  
 Вы можете использовать любой исполнитель из вашего файла конфигурации с:
  версия: 2.1
# config.yml
шары:
  foo-шар: пространство имен/foo@1
  baz-orb: someothernamespace/[email protected]
вакансии:
  какая-то работа:
    executor: foo-orb/bar # исполнитель с префиксом
  какая-то другая работа:
    executor: baz-orb/bar # исполнитель с префиксом
  
  Примечание:   foo-orb/bar  и  baz-orb/bar  — разные исполнители. Они оба имеют местное имя  или  относительно своих сфер, но они являются независимыми исполнителями, определенными в разных сферах.
 Переопределение ключей при вызове исполнителя 
 При вызове исполнителя в задании   любые ключи в самом задании переопределяют ключи вызываемого исполнителя. Например, если ваше задание объявляет строфу  docker , она будет использоваться целиком, а не в вашем исполнителе.
  Примечание:  Карты переменных среды   являются аддитивными. Если исполнитель   имеет одну из тех же переменных среды  , что и задание  , будет использоваться значение в задании. Дополнительную информацию см. в руководстве по использованию переменных среды.
  версия: 2.1

исполнители:
  узел:
    докер:
      - изображение: cimg/узел: lts
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
    окружающая обстановка:
     ENV: ки

вакансии:
  строить:
    докер:
      - образ: cimg/base: стабильный
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
    # Приведенный ниже исполнитель теста будет перезаписан более явным исполнителем "docker".Любые env vars будут добавлены.
    исполнитель: узел
    шаги:
      - запустить: echo "Узел не будет установлен."
  
 Приведенная выше конфигурация будет иметь следующий вид:
  версия: 2.1
вакансии:
  строить:
    докер:
      - образ: cimg/base: стабильный
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
    окружающая обстановка:
     ENV: ci # От исполнителя.
    шаги:
      - выполнить: echo "Узел не будет установлен."
  
 Создание параметризованных заданий 
 Можно вызывать одно и то же задание более одного раза в разделе рабочих процессов  config.yml  , передавая все необходимые параметры в виде подключа к заданию. Подробную информацию об использовании синтаксиса см. в разделе параметров выше.
 Пример определения и вызова параметризованного задания в  config.yml  :
  версия: 2.1

вакансии:
  sayhello: # определяет параметризованное задание
    описание: Задание, которое мало что делает, кроме демонстрации того, как выглядит параметризованное задание.
    параметры:
      чего-чего:
        описание: "С кем поздороваемся?"
        по умолчанию: "Мир"
        тип: строка
    машина: правда
    шаги:
      - запустить: echo "Привет << параметры.скажи что >>"

рабочие процессы:
  строить:
    вакансии:
      - sayhello: # вызывает параметризованное задание
          сказать что: все
  
  Примечание.  При многократном вызове одного и того же задания с параметрами в любом количестве рабочих процессов имя сборки будет изменено (например,  sayhello-1  ,  sayhello-2  и т. д.). Чтобы номера сборки не добавлялись, используйте ключ имени  . Назначаемое имя должно быть уникальным, иначе к имени задания все равно будут добавляться числа.Например:
  рабочих процессов:
  строить:
    вакансии:
      - скажи привет:
          имя: build-sayhello
          сказать что: все
  развертывать:
    вакансии:
      - скажи привет:
          имя: развертывание-sayhello
          сказать что: все
  
 Задания, определенные в сфере 
 Если задание объявлено внутри сферы, оно может использовать команды в этой сфере или глобальные команды. Невозможно вызывать команды вне области объявления задания.
  привет-сфера 
  версия: 2.1
# частичный yaml от hello-orb
вакансии:
  скажи привет:
    параметры:
      чего-чего:
        описание: "С кем поздороваемся?"
        по умолчанию: "Мир"
        тип: строка
    машина: правда
    шаги:
      - сказать:
          saywhat: "<< параметры.saywhat >>"
команды:
  чего-чего:
    параметры:
      чего-чего:
        тип: строка
    шаги:
      - запустить: echo "<>"
  
  Конфигурация с использованием hello-orb 
  # конфиг.yml
версия: 2.1
шары:
  привет-сфера: somenamespace/hello-orb@volatile
рабочие процессы:
  строить:
    вакансии:
      - привет-сфера/привет:
          сказать что: все
  
 Использование параметров в исполнителях 
 Чтобы использовать параметры в исполнителях, определите параметры под данным исполнителем. Когда вы вызываете исполнителя, передайте ключи параметров в виде карты ключей в объявлении исполнителя : , каждый из которых имеет значение передаваемого параметра.
 Параметры в исполнителях могут быть типа  string  ,  enum  или  boolean  .Значения по умолчанию могут быть предоставлены с дополнительным ключом  по умолчанию .
 Пример конфигурации сборки с использованием параметризованного исполнителя 
  версия: 2.1
исполнители:
  питон:
    параметры:
      тег:
        тип: строка
        по умолчанию: последний
      мой спецвариант:
        тип: строка
    докер:
      - изображение: cimg/python:<< параметры.тег >>
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
    окружающая обстановка:
      MYPRECIOUS: << параметры.мой спецвар >>
вакансии:
  строить:
    исполнитель:
      имя: питон
      тег: "2.7"
      мояспециальнаявар: "мояспециальнаязначение"
  
 Вышеприведенное разрешится следующим образом:
  версия: 2.1
вакансии:
  строить:
    шаги: []
    докер:
      - изображение: cimg/python:2.7
        авторизация:
          имя пользователя: mydockerhub-пользователь
          пароль: $DOCKERHUB_PASSWORD # ссылка на env-var контекста/проекта
    окружающая обстановка:
      MYPRECIOUS: "моя особая ценность"
  
 Объем параметров 
 Параметры входят в область действия только в задании или команде, которые их определили.Если вы хотите, чтобы задание или команда передавали свои параметры вызываемой команде, они должны быть переданы явно.
  версия: 2.1
вакансии:
  скажи привет:
    параметры:
      чего-чего:
        описание: "С кем поздороваемся?"
        по умолчанию: "Мир"
        тип: строка
    машина: правда
    шаги:
      - сказать:
          # Так как команда "say" не определяет значение по умолчанию
          # значение для параметра "saywhat", оно должно быть
          # передается вручную
          что сказать: << параметры.сказать что >>
команды:
  сказать:
    параметры:
      чего-чего:
        тип: строка
    шаги:
      - запустить: echo "<>"
рабочие процессы:
  строить:
    вакансии:
      - скажи привет:
          сказать что: все
  
 Многократный вызов одного и того же задания 
 Одна конфигурация может вызывать задание несколько раз. Во время обработки конфигурации во время загрузки сборки CircleCI будет автоматически генерировать имена, если они не указаны, или вы можете явно назвать повторяющиеся задания с помощью ключа  имени .
  Примечание:  Вы должны явно назвать повторяющиеся задания, если повторяющееся задание должно быть выше другого задания в рабочем процессе. Например, если задание используется с ключом  требует  вызова задания в рабочем процессе, вам нужно будет явно назвать его.
  версия: 2.1
рабочие процессы:
  строить:
    вакансии:
      - загрузка
      # Это не требует явного имени, так как у него нет нижестоящих зависимостей
      - скажи привет:
          сказать что: все
          требует:
            - загрузка
      # Требуется явное имя для saygoodbye, чтобы оно требовалось как зависимость задания
      - скажи привет:
          имя: СэйХеллоЧад
          сказать что: Чад
      # Использует явно определенный "привет"
      - попрощаться:
          требует:
            - Скажи приветЧад
  
 Использование предварительного и последующего шагов 
 Каждый вызов задания может опционально принимать два специальных аргумента:  прешагов  и  постшагов  .Шаги под  до шагов  выполняются перед любыми другими шагами задания. Шаги под номером  после шагов  выполняются после всех остальных шагов.
 Предварительные и последующие шаги позволяют выполнять шаги в заданном задании без изменения задания. Это полезно, например, для выполнения пользовательских шагов настройки перед выполнением задания.
 Определение предварительных и последующих шагов 
 В следующем примере определяются предварительные и последующие шаги в задании  bar  рабочего процесса  build :
  # конфиг.yml
версия: 2.1
вакансии:
  бар:
    машина: правда
    шаги:
      - проверить
      - бегать:
          команда: эхо "строительство"
      - бегать:
          команда: эхо "тестирование"
рабочие процессы:
  строить:
    вакансии:
      - бар:
          предварительные шаги:
            - бегать:
                команда: echo "установить пользовательскую зависимость"
          пост-шаги:
            - бегать:
                команда: echo "загрузить артефакт на s3"
  
  Примечание:  Ключи  прешаги  и  постшаги  в заданиях доступны в версии конфигурации 2.1 и позже.
 Определение условных шагов 
 Условные шаги выполняются только в том случае, если условие выполняется во время компиляции конфигурации до запуска рабочего процесса. Это означает, например, что вы не можете использовать условие для проверки переменной среды, поскольку они не внедряются до тех пор, пока ваши шаги не будут запущены в оболочке вашей среды выполнения.
 Условные шаги могут располагаться везде, где обычный шаг может и может использовать только значения параметров в качестве входных данных.
 Например, шар может определить команду, которая выполняет набор шагов , если  вызывается с  myorb/foo: { dostuff: true }  , но не  myorb/foo: { dostuff: false }  .
 Кроме того, автор шара может определить условные шаги в ключе  шагов  Задания или Команды.
  # Внутри config.yml
версия: 2.1
вакансии:
  моя работа:
    параметры:
      предустановка-foo:
        тип: логический
        по умолчанию: ложь
    машина: правда
    шаги:
      - запустить: echo "предустановка - это << параметры.preinstall-foo >>"
      - когда:
          условие: << параметры.preinstall-foo >>
          шаги:
            - запустить: эхо "предварительно установить"
      - пока не:
          условие: << параметры.предустановка-foo >>
          шаги:
            - запустить: эхо "не предустанавливать"
рабочие процессы:
  рабочий процесс:
    вакансии:
      - моя работа:
          предустановка-foo: ложь
      - моя работа:
          предустановка-foo: правда
      - myjob # Пустая строка ложна
  
  Примечание.  Условные шаги доступны в конфигурации версии 2.1 и выше.
  когда  шаг

Имя ключа	Описание	Значение по умолчанию
описание	Дополнительно. Используется для создания документации для вашего шара.	н/д
тип	Обязательно. Подробности см. в разделе Типы параметров в разделе ниже.	н/д
по умолчанию	Значение параметра по умолчанию. Если параметр отсутствует, подразумевается, что этот параметр является обязательным.	н/д

Ключ	Обязательно	Тип	Описание
ступени	Д	Последовательность	Последовательность шагов, выполняемых внутри задания, вызывающего команду.
параметры	Н	Карта	Карта ключей параметров. Подробнее см. в разделе Синтаксис параметров.
описание	Н	Строка	Строка, описывающая назначение команды. Используется для создания документации.

Ключ	Обязательно	Тип	Описание
докер	Да ⁽¹⁾	Список	Параметры для исполнителя `docker` .
класс_ресурсов	Н	Строка	Объем ЦП и ОЗУ, выделенный каждому контейнеру в задании. (Доступно только с исполнителем `docker` ) Примечание: Для доступа к этой функции требуется платная учетная запись. Клиенты с платными планами на основе контейнеров могут запросить доступ, отправив запрос в службу поддержки.
машина	Да ⁽¹⁾	Карта	Опции для `станка` исполнитель.
макос	Да ⁽¹⁾	Карта	для исполнителя `macOS` .
корпус	Н	Строка	Оболочка, используемая для выполнения команды на всех этапах.Может быть переопределен оболочкой на каждом этапе.
рабочий_каталог	Н	Строка	Каталог, в котором выполняются шаги.
окружающая среда	Н	Карта	Карта имен и значений переменных среды.

Под ключом при находятся подразделы условие и шаги .Шаги подраздела выполняются, только если условие оценивается как истинное значение.

Ключ	Обязательно	Тип	Описание
состояние	Д	Логика	Логический оператор
шагов	Д	Последовательность	Список шагов, которые нужно выполнить, если условие истинно.

кроме шаг

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

Ключ	Обязательно	Тип	Описание
состояние	Д	Логика	Логический оператор
шагов	Д	Последовательность	Список шагов, которые нужно выполнить, если условие ложно.

`Написание встроенных шаров`

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

Чтобы написать встроенный шар, поместите элементы шара под ключ этого шара в разделе конфигурации шаров объявления. Например, если вы хотите импортировать один шар для использования внутри другого встроенного шара, конфигурация может выглядеть так, как показано ниже, в котором встроенный шар мой-шар импортирует узел шар:

.  версия: 2.1

шары:
  мой шар:
    шары:
      узел: кругци/узел@3.0
    команды:
      моя_команда:
        шаги:
          - run: echo "Выполнить мои тесты"
    вакансии:
      моя работа:
        executor: node/default # Исполнитель Node orb
        шаги:
          - проверить
          - моя_команда
          - store_test_results:
              путь: тест-результаты

рабочие процессы:
  главный:
    вакансии:
      - моя-сфера/моя_работа

  
 См. также 
 См. Примеры конфигураций для некоторых примеров конфигураций, которые вы можете использовать в своей собственной конфигурации CircleCI.No related posts.