Типографика
Рекомендации по оформлению текстов для тех, кто пишет на Хабр и не только. Обновляются постоянно.
Имена и фамилии
Пишите имена полностью и всегда ставьте их перед фамилией. От отчеств избавляйтесь, они добавляют не уважения, а только визуального мусора. Отчество нужно использовать, когда у человека есть тезка с такой же фамилией и этих двух людей можно спутать.
Нет В. Т. Спиваков Д. Крючков | Да Владимир Спиваков Денис Крючков |
Списки
Если фраза заканчивается списком, ставьте перед ним двоеточие. Каждый пункт в этом случае начинайте со строчной буквы и заканчивайте запятой или точкой с запятой (последний — точкой).
Нет Концепции ФП. Функции высших порядков. Чистые функции. Рекурсия. Подход к вычислению аргументов. | Да Концепции ФП: функции высших порядков, чистые функции, рекурсия, подход к вычислению аргументов. |
Нумерованные и маркированные списки оформляются одинаково. Если пункт списка представляет собой законченное предложение, он начинается с заглавной буквы, а в конце строки ставится точка.
Нет
| Да
|
Ссылки
Не добавляйте кавычки в ссылку.
Нет Группа «Металлика» выступит в «Лужниках» 21 июля. | Да Группа «Металлика» спела новую песню на вчерашнем концерте в «Лужниках». |
Включайте в ссылку слова, которые и в отрыве от предложения дадут понять, о чем идет речь на целевой странице. Если нужно, чуть измените предложение. Но не перебарщивайте.
Нет Менеджеры проектов опубликовали ежегодный отчет об итогах года на своих проектах. Летчики, приютившие медвежонка-сироту, ведут трансляцию его жизни на аэродроме. | Да Менеджеры проектов опубликовали ежегодный отчет об итогах года на своих проектах. Летчики ведут трансляцию жизни медвежонка-сироты, которого приютили на аэродроме. |
В англоязычных текстах не привязывайте начало ссылки к артиклям, вспомогательным словам и формам глагола to be.
Нет The biggest difference for most people is that Apple has cut the price down by $100. | Да The biggest difference for most people is that Apple has cut the price down by $100. |
Кавычки
Открывающих кавычек должно быть столько же, сколько и закрывающих. Если внутри внешних кавычек («елочек») нужны вложенные кавычки, используйте „лапки“ в качестве дополнения.
Нет ОАО «АО «Яндекс» ООО «Компания «Хабр»» | Да ОАО «АО „Яндекс“» ООО «Компания „Хабр“» |
Названия на латинице в русском тексте не заключайте в кавычки — их и так видно в толще кириллицы.
Нет Хабр заключил партнерское соглашение с «RUVDS», компании обменялись совместными пресс-релизами. | Да Хабр заключил партнерское соглашение с RUVDS, компании обменялись совместными пресс-релизами. |
Когда упоминаете Хабр как проект, а не юрлицо, кавычки не нужны. Мы считаем его почти живым, чего и вам желаем!
Нет «Хабр» заключил партнерское соглашение с RUVDS, компании обменялись совместными пресс-релизами. | Да Хабр заключил партнерское соглашение с RUVDS, компании обменялись совместными пресс-релизами. |
Телефоны
Пишите в скобках только ту часть номера, которую можно отбросить. Например, (+7 4012) 23-45-67 — номер в Калининграде. Внутри города можно использовать номер 23-45-67, поэтому код +7 4012 взяли в скобки.
Коды Москвы 495 и 499 — теперь обязательная часть номера. Без них невозможно дозвониться до абонента, поэтому скобки использовать не стоит.
По этой же причине не ставьте скобки в номерах мобильных телефонов и горячих линий.
Нет +7 (495) 381-34-75 +7 1135 41-09-71 факс (8 800) 500-50-50 | Да +7 495 381-34-75 (+7 1135) 41-09-71 — факс 8 800 500-50-50 — для СМИ |
Используйте восьмерку только в номерах горячих линий 8 800 (на такие номера невозможно позвонить из-за границы). В остальных случаях пишите +7.
Нет 8 495 884-13-73 +7 800 500-50-50 | Да +7 495 884-13-73 8 800 500-50-50 |
Записывайте номера телефонов только цифрами, без сокращений и пояснений вроде «тел.», «тлф», «телефон:» — сама форма говорит, что это номер телефона. При этом можно и нужно уточнить, для каких целей используют номер.
Нет Тел: +7 495 381-34-75 Факс: (+7 1135) 41-09-71 Телефон для СМИ: 8 800 500-50-50 | Да +7 495 381-34-75 (+7 1135) 41-09-71 — факс 8 800 500-50-50 — для СМИ |
Адреса
Части адреса указывайте от меньшего к большему.
Нет Россия, Москва Самарская обл., Челно-Вершинский р-н, с. Старое Эштебенькино, ул. Луговая, д. 17 | Да Спартаковский пер, д. 9 с. Старое Эштебенькино, ул. Луговая, д. 17, Челно-Вершинский р-н, Самарская обл. |
Тире и дефисы
Ставьте тире с пробелами с обеих сторон между названиями при указании маршрутов.
Нет «Калининград-Москва-Глазов» «Москва - Сракотан» | Да «Калининград — Ижевск — Глазов» «Москва — Сракотан» |
Временные интервалы обозначаются коротким (его еще называют средним) тире, без пробелов.
Нет 1,5-2 месяца 2005 — 2006 гг. | Да 1,5–2 месяца 2005−2006 гг. |
В названиях конференций и премий, содержащих указание года и состоящих из одного слова без пробелов, используйте дефис. Когда название состоит из нескольких слов, применяйте тире с пробелами.
Нет «Квантовые технологии 2019» «Компьютекс — 2015» | Да «Компьютекс-2015» |
Величины
Приводите величи́ны к одному порядку. Если в тексте написано «Объем отгрузок смартфонов составил 3,5 млн штук», а на картинке «Объем продаж в тыс.», то надо привести всё к «тыс.» или «млн».
Нет В тексте: Объем отгрузок смартфонов составил 3,5 млн штук На графике: Объем продаж в тыс. т | Да В тексте: Объем отгрузок смартфонов составил 3,5 млн штук На графике: Объем продаж в млн т |
В конце сокращений физических величин точка не ставится. В числовых сокращениях точка ставится только тогда, когда отсекается конечная часть слова и последняя буква не используется. Если из слова высечены буквы и слоги с сохранением начальной и конечной букв, точка не нужна.
Нет 10 т. 15 м. 50 см. 300 млн. 1 млрд. 100 тыс | Да 10 т 15 м 50 см 300 млн 1 млрд 100 тыс. |
В конце уточняющих единиц и сокращений ставьте точку.
Нет 700 мм рт ст | Да 700 мм рт. ст. |
Для порядковых числительных в именительном и косвенных падежах используйте наращения, присоединяемые дефисом. Наращение будет однобуквенным, если последней букве предшествует гласный звук: 5-й день [пятый день]; и двубуквенным, если последней букве предшествует согласный: 5-го дня [пятого дня].
Нет На 79-ом году жизни 31-ого числа | Да На 79-м году жизни 31-го числа |
В количественных числительных наращения не используйте никогда.
Нет В 47-ми км отсюда 100-то человек | Да В 47 км отсюда 100 человек |
Не бойтесь записывать словами числа от 0 до 10 включительно.
Нормально Открытие 3 магазинов Apple В комнате было 10 человек | Хорошо Открытие трех магазинов Apple В комнате было десять человек |
При записи сложных слов, одной из частей которых является числительное, не оставляйте никаких наращений и размещайте вторую часть сразу после дефиса.
Нет 5-тимиллиметровый 3 ступенчатый | Да 5-миллиметровый 3-ступенчатый |
Аббревиатуры
Используйте сокращение в тексте только после того, как употребили наименование в полной форме. При этом рядом с полной формой в скобках обязательно укажите аббревиатуру.
Нет Клуб веселых и находчивых ― телевизионные юмористические игры, в которых команды различных коллективов (учебных заведений, вузов, предприятий, городов и так далее) соревнуются в юмористических ответах на заданные вопросы, импровизациях на заданные темы, разыгрывании заранее заготовленных сцен и тому подобного. | Да Клуб веселых и находчивых (КВН) ― телевизионные юмористические игры, в которых команды различных коллективов (учебных заведений, вузов, предприятий, городов и так далее) соревнуются в юмористических ответах на заданные вопросы, импровизациях на заданные темы, разыгрывании заранее заготовленных сцен и тому подобного. |
Даты
В массиве текста используйте формат даты с текстовым написанием месяца.
Нет 21.09.1975 05/01/1993 | Да 21 сентября 1975 1 мая 1993 |
Не используйте ведущий ноль при обозначении дат.
Нет 01 января 2019 | Да 1 января 2019 |
В английских текстах указывайте даты по правилам международного английского языка.
Нет 15 January, 2019 | Да January 15, 2019 |
Числа
Отбрасывайте незначащие нули.
Нет 151,0 млрд куб. м | Да 151 млрд м³ |
Исключение. Оставлять нули в конце дробной части можно, только зная, что число не было предварительно округлено, когда требуется акцентировать внимание на точности приведенного значения.
Разделяйте группы разрядов в целой части, если число состоит из пяти цифр и больше.
Нет 2 800 15600 0,38 100 | Да 2800 15 600 0,38100 |
В русском языке для разделения целой и десятичной части используйте запятую. В английском — точку.
Нет по-русски 0.95 3.14 по-английски 0,95 3,14 | Да по-русски 0,95 3,14 по-английски 0.95 3.14 |