Ага ...  |  другие тексты

Си-дизайн

дизайн  | 

На портале «Самиздат» (Samlib.ru) Максим Мошков не публикует единого строгого стандарта W3C в виде свода законов — вместо этого действуют технические ограничения парсера (конвертора) СИ, требования к «чистоте» кода для корректной конвертации в электронные форматы (FB2, EPUB) и рекомендации из официального раздела Редактора и справочного раздела «Инфо».

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


1. Базовая структура и запрещенные элементы

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

  • Служебные теги удаляются. Теги <html>, <head>, <title>, <body>, а также декларация <!DOCTYPE> при закачке автоматически вырезаются парсером. Писать их не нужно — в окно публикации (или в загружаемый файл) помещается только «тело» произведения.
  • Запрет на скрипты и внешние стили. Любые JavaScript-вставки (<script>, обработчики событий вроде onclick), фреймы, а также блоки <style> и подключение внешних таблиц стилей (<link rel="stylesheet">) пресекаются и удаляются сервером.
  • Запрет HTML в мета-полях. Нельзя использовать HTML-теги в полях «Заголовок» (название произведения) и «Имя автора» — разметка там не сработает или будет искажена. Допускается легкое базовое форматирование только в аннотациях.
  • Отказ от «грязного» HTML из MS Word. Администрация настоятельно не рекомендует сохранять документ в Word как «Веб-страницу» и заливать такой HTML. Word генерирует огромный объем мусорных тегов и стилей, из-за чего файл «тяжелеет», плохо открывается и некорректно переваривается конверторами СИ.

2. Абзацы и «красная строка» (актуальный стандарт СИ)

Исторически главной проблемой HTML на «Самиздате» был абзацный отступ, так как движок вырезает пользовательский CSS.

  • Новый официальный стандарт (с октября 2026 года). В глобальный header страниц СИ внедрен встроенный стиль p {margin: 0 0 0.1em 0; text-indent: 1.5em;}. Теперь тег <p> автоматически оформляет абзац «книжной» красной строкой без лишних пустых отступов между строками.
  • Отказ от <dd> в пользу <br>&emsp;. Ранее типовая верстка СИ использовала нецелевой тег <dd>&nbsp;&nbsp;. Сейчас сам движок при автоконвертации заменил его на связку <br>&emsp; (перенос строки + длинный пробел). В разделе Редактора (статья «Отступы») приведены три рекомендуемых варианта:
    • <br>&nbsp; — короткий отступ;
    • <br>&emsp; — нормальный отступ;
    • <p> — длинный отступ (стандартная книжная красная строка).

3. Допустимые теги форматирования текста

Для оформления произведения разрешен и корректно обрабатывается базовый набор тегов HTML 4:

  • Начертание шрифта: <b> (полужирный), <i> (курсив), <u> (подчеркнутый), <s> (зачёркнутый), <tt> (моноширинный), <sup> (верхний индекс), <sub> (нижний индекс), <big> и <small>. Важно соблюдать строгую вложенность закрывающих тегов (например, <b><i>текст</i></b>).
  • Заголовки и блоки: <h1>—<h6> для структурирования глав, <div> и <center> для выравнивания (align="left|right|center|justify"), <blockquote> для выделения крупных цитат с отступами по краям, <hr> для горизонтальных разделительных линий.
  • Стихи и преформатированный текст: Тег <pre> сохраняет авторские пробелы и переносы строк (полезно для «лесенок»), но отображается моноширинным шрифтом и фиксирует ширину блока. Альтернатива для стихов — таблица без границ (border="0").
  • Списки: Упорядоченные <ol>, неупорядоченные <ul> и элементы <li>.
  • Управление переносами: <nobr> (запрет переноса строки) и <wbr> (точка допустимого переноса).

4. Особенности работы с тегом <font> и цветами

  • Ограничение атрибута face. Парсер СИ пропускает смену гарнитуры шрифта только в том случае, если название шрифта состоит из одного слова и написано без кавычек (например, <font face=Arial> или Tahoma, Verdana, Courier, Georgia). Если взять название в кавычки () или указать шрифт из нескольких слов (Times New Roman), фильтр безопасности СИ удалит атрибут face.
  • Размер и цвет. Разрешены относительные и абсолютные размеры (size="1"..7 или size="+1", size="-1"), а также цвет в HEX-формате (color="#000000").
  • Фон страницы. Поскольку тег <body> удаляется, задать цвет фона для всего произведения можно только обернув весь текст в таблицу: <table border="0" width="100%" bgcolor="#цвет"><tr><td>...</td></tr></table>.

5. Спецсимволы, кавычки и кодировки

  • Кавычки. При загрузке файлов из текстовых редакторов автоконвертор СИ удаляет типографские «фигурные» кавычки, из-за чего прямая речь остается вообще без кавычек. Рекомендуется предварительно заменять их на прямые (") либо использовать HTML-коды «елочек» (&#171; и &#187;).
  • Цифровые коды вместо мнемоник. Если автор планирует править текст через встроенный браузерный редактор [Textedit], спецсимволы лучше задавать цифровыми кодами (&#151; для длинного тире, &#160; для неразрывного пробела, &#8470; для знака №), так как текстовые мнемоники (&mdash;, &nbsp;) при повторном открытии в Textedit преобразуются в символы и могут быть испорчены при сохранении. Знак номера № напрямую с клавиатуры парсер также часто коверкает.

6. Ссылки, сноски и иллюстрации

  • Ссылки и якоря. Разрешен тег <a href="...">. Для создания оглавлений и сносок внутри текста используются парные якоря: <a name="metka"></a> в месте назначения и <a href="#metka">ссылка</a> в тексте. Вложенные друг в друга теги <a> запрещены.
  • Иллюстрации. Картинки загружаются отдельно через интерфейс произведения («Загрузить иллюстрации» в форматах .jpg или .gif). В текст они вставляются тегом <img src="имя_файла.jpg">. Рекомендуется всегда указывать реальные размеры width и height, а также border="0" (особенно если картинка обернута в ссылку).

7. Совместимость с автогенерацией FB2 и EPUB

На СИ работает автоматическая конвертация авторских HTML-текстов в форматы FB2 (через движок pandoc -f html -t fb2) и EPUB. Чтобы книга корректно собиралась в электронные форматы и не вызывала сбоев конвертора:

  • Избегайте сложной многоуровневой табличной верстки для основного текста (таблицы допустимы для эпиграфов, стихов или оформления плашек, но ломают чтение на ридерах при злоупотреблении).
  • Используйте стандартные заголовки (<h1>—<h3>) для названия глав — pandoc распознает их и автоматически строит интерактивное оглавление в FB2 и EPUB.
  • Следите за размером исходного HTML-файла (генерация FB2 отключена для файлов тяжелее 15 МБ и легче 3 КБ) и длиной имени файла (ограничение СИ — не более 35 символов).

Главное правило публикации на СИ

Если файл готовится в HTML вручную или в специализированном редакторе, при загрузке через форму «Добавить произведение» необходимо выбирать тип файла «Просто текст» (а не MS Word) и следить за соответствием кодировки (Windows-1251 или UTF-8), чтобы сервер не запустил повторную авторазметку поверх ваших тегов.