Памятка редактору

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

Физики продолжают шутить

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

Переносы строк

Если у Вас в Блоггере не установлена настройка Используйте теги <br />, это вносит достаточно серьёзные искажения в текст. Поэтому сейчас ни в коем случае нельзя пользоваться draft.blogger.com, июльская версия которого любит сбрасывать настройки и включать визуальный редактор. Если у Вас запустился визуальный редактор, то, как правило, он уже испортил HTML заметки. Лучше всего закрыть страничку без сохранения.

Если использовать для разделения слов перевод строки, то заметка неправильно отображается в живой ленте. Хорошее место для перевода строки — закрывающие блочные тэги, такие как </p> или </h3>. Для удобного редактирования и просмотра длинных строк можно пользоваться текстовым редактором.

Вставка картинок

Не надо доверять браузеру менять разрешение и внешний вид картинки. Тэг <img> может содержать атрибуты alt и title. Остальные атрибуты, такие как border и width, использовать не надо. По умолчанию картинки обтекаются слева, <img class="fleft"> обтекаются справа. Широкие картинки, которые не оставляют достаточно места для обтекания, надо вставлять внутри тэга <p>.

Нельзя называть картинки русскими буквами — URL в PicasaWeb получается нечитабельным. Далее, по умолчанию PicasaWeb генерирует HTTPS URL. Лучше менять в ссылке протокол https:// на http:// — это работает быстрее и более надёжно.

Звоночки

Сложное — всё равно не поймут.

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

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

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

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

Проверьте правописание и форматирование, но не правьте. Вводное слово к разделу отсутствует? Текст, написанный английскими буквами, не оформлен с использованием тэгов <code> и <pre>? Проблемы форматирования — звоночки более серьёзных проблем. Выделите проблемы цветом и пошлите автору, отполированный результат не заставит себя долго ждать.

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

Сайт должен нормально читаться в разных разрешениях. Не надо самостоятельно разбивать эпиграф на строки, для этого предназначен таг <p class="epi">. Данный таг разобъёт текст на строки с учётом разрашения и других особенностей устройства, которое использует читатель для просмотра текста.

Выделять текст нужно редко. Предпочтительным способом выделить текст на сайте является италик (<em>), он не увеличивает вес шрифта, как <strong> и <b>, а также не увеличивает размер текста, как кавычки « и ».

Нельзя использовать тэги <div> и <br />. Список разрешённых тэгов очень мал, это позволяет унифицированно отображать текст на сайте, и, в последствии, добиваться приличного вида текста на мобильных устройствах.

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

Висящие знаки препинания (точки и двоеточия) в названиях и подписях не нужны.

URL сообщения

Необходимо, чтобы он состоял из двух-трёх слов (больше не влезет), являющихся ключевыми.