Автор рисунка: BonesWolbach

Справка по HTML-редактору библиотеки

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

Абзацы

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

Это первый абзац

Это второй абзац
Это вторая строка всё ещё второго абзаца (потому что пустой строки не было)

А это уже третий абзац

Ещё один способ — обернуть текст, который должен быть отдельным абзацем, в стандартный HTML-тег p:

<p>Это первый абзац</p>
<p>Это второй абзац</p>

Не забывайте делить тексты глав на абзацы! Слипшийся текст неприятно читать.

Обычный перенос строки вместо пустой строки создаёт не новый абзац, а новую строку внутри абзаца; это то же самое, что и Shift+Enter в Microsoft Word и других подобных текстовых процессорах. Также вы можете создать новую строку внутри абзаца, поставив в нужном месте тег <br/>.

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

Не имитируйте «красную строку» с помощью пробелов или &nbsp; в начале строки: выглядеть лучше всё равно не станет, зато вы сломаете упомянутую выше настройку. И не забывайте разделять абзацы именно пустой строкой, а не просто переносом строки.

Спецсимволы

Символы <, > и & являются частью синтаксиса HTML, поэтому, если вы их будете использовать просто так, что-нибудь обязательно сломается. Чтобы использовать эти символы в тексте, их нужно экранировать — записывать с помощью специальных кодов &lt;, &gt; и &amp; соответственно. Например:

&lt; — это знак меньше.<br/>
&gt; — это знак больше.<br/>
&amp; — это амперсанд.<br/>
Создать новую строку внутри абзаца позволяет тег &lt;br/&gt;.

даст следующий результат:

< — это знак меньше.
> — это знак больше.
& — это амперсанд.
Создать новую строку внутри абзаца позволяет тег <br/>.

Разметка текстов, цитаты и прочее

Полужирное начертание:

<strong>Пони — это сила!</strong>
Пони — это сила!

Курсивное начертание:

<em>Пони — это сила!</em>
Пони — это сила!

Соответственно, теги <u>текст</u> и <s>текст</s> делают текст подчеркнутым или зачеркнутым:

текст и текст

blockquote делает из текста цитату:

<blockquote>Dear princess Celestia...</blockquote>
Dear princess Celestia...

<pre>Хитрый код...</pre> — используется, когда речь идет о каком-то коде, в итоге получается:

Хитрый код такой хит... STOP 0x000000CA

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

<em><u>Дружба — это <s>чудо</s> магия!</u></em>
Дружба — это чудо магия!
Можно создать горизонтальную разделительную линию с помощью тега <hr/>.

Списки

Библиотека поддерживает два типа списков: Нумерованные (ol) и ненумерованные (ul).

Нумерованные:

<ol>
<li>Первый элемент</li>
<li>Второй элемент</li>
<li>Третий элемент</li>
<li>...и так далее</li>
</ol>
  1. Первый элемент
  2. Второй элемент
  3. Третий элемент
  4. … и так далее

Ненумерованные:

<ul>
<li>Первый элемент</li>
<li>Второй элемент</li>
<li>Третий элемент</li>
<li>...и так далее</li>
</ul>
  • Первый элемент
  • Второй элемент
  • Третий элемент
  • … и так далее

Размер текста

Для глав доступны три уровня заголовков:

<h3>Заголовок 1</h3>
<h4>Заголовок 2</h4>
<h5>Заголовок 3</h5>

Заголовок 1

Заголовок 2

Заголовок 3

Тегом small можно уменьшить размер текста:

<small>Мелкий текст</small>

Мелкий текст

Тегами sup и sub можно добавить верхний или нижний индекс соответственно:

x<sup>2</sup> - 5x + 6 = 0
x<sub>1</sub> = 3
x<sub>2</sub> = 2
x2 - 5x + 6 = 0
x1 = 3
x2 = 2

Выравнивание

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

Можно выровнять отдельный абзац по центру:

<p align="center">Этот текст будет по центру</p>

Или по правому краю:

<p align="right">Этот текст будет справа, удобно для эпиграфов</p>

Код

<a href="https://everypony.ru">Интересный сайт</a>

создаст ссылку вида:

Интересный сайт

Если вы хотите, чтобы ссылка всегда открывалась в новой вкладке при клике, добавьте атрибут target со значением _blank:

<a href="https://everypony.ru" target="_blank">Интересный сайт, который откроется в новой вкладке</a>
Интересный сайт, который откроется в новой вкладке

Вставка картинки из ссылки:

<img src="https://files.everypony.ru/smiles/not_pony/120.gif" />

Получается примерно так:

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

Сноски

В главах рассказа можно делать кликабельные сноски. Это немного сложнее других тегов и делается вот так:

  1. Сперва выбираем какой-нибудь идентификатор сноски из английских букв и цифр, например ft1 — у каждой сноски должен быть свой уникальный идентификатор.
  2. В нужном месте в тексте делаем ссылку на эту сноску, указав выбранный идентификатор, например: <sup><a href="#ft1">[1]</a></sup>
  3. В конце главы (или в любом другом месте на ваш вкус) создаём саму сноску с выбранным идентификатором: <footnote id="ft1">Текст сноски</footnote>

Можно делать сколько угодно сносок; на одну и ту же сноску можно ссылаться несколько раз.

Например, такой текст главы:

Начало текста главы. Здесь какой-то сложный термин<sup><a href="#ft1">[1]</a></sup>, который нужно пояснить.

Продолжение текста и ещё один термин<sup><a href="#ft2">[2]</a></sup>. А здесь старый термин<sup><a href="#ft1">[1]</a></sup>, для которого уже существует сноска.

Конец текста главы.

<hr/>

<footnote id="ft1">Объяснение первого термина.</footnote>

<footnote id="ft2">Объяснение второго термина.</footnote>

даст следующий результат:

На­ча­ло тек­ста гла­вы. Здесь ка­кой-то слож­ный тер­мин[1], ко­то­рый нуж­но по­яс­нить.

Про­дол­же­ние тек­ста и ещё один тер­мин[2]. А здесь ста­рый тер­мин[1], для ко­то­ро­го уже су­ще­ству­ет снос­ка.

Ко­нец тек­ста гла­вы.


, Объ­яс­не­ние пер­во­го тер­ми­на.

Объ­яс­не­ние вто­ро­го тер­ми­на.

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

Импорт форматирования с Google Docs, Microsoft Word и других текстовых процессоров

Из приложений, умеющих помещать HTML-код в буфер обмена, можно копировать форматирование. Делается это просто: выделите текст, скопируйте (Ctrl+C) его и вставьте (Ctrl+V) в поле редактирования текста главы. Сайт автоматически обработает вставленное и приведёт HTML-код к правильному виду.

Например, вот такой текст копируется с Google Docs (кликните для увеличения):

А вот так он будет вставлен в редактор:

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

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

Если вам не нужно переносить оформление и вы хотите вставить текст как просто текст (например, чтобы попробовать примеры кода с этой страницы), вставьте его сперва в какой-нибудь простой текстовый редактор — например, Блокнот, — скопируйте его уже из Блокнота и потом вставьте в редактор.

Неразрывный пробел

Неразрывный пробел &nbsp; может вам пригодиться, если вы хотите запретить перенос текста в каком-то конкретном месте. Инициалы, предлоги, сокращения, номера с единицами изменения и тире со стоящим перед ним словом не должны разрываться, а браузер может их разорвать при нехватке ширины — здесь-то неразрывный пробел и пригодится.

В примере ниже ваш браузер мог перенести что-нибудь неправильно:

— Эй, Умник, мы точно идём в том направлении? Этот ветер меня уже достал, даже твоего хвоста не вижу! — прокричал пони, шедший по центру.

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

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

Спящий рай, глава 1

Но, если расставить неразрывные пробелы в нужных местах:

— Эй, Умник, мы точно идём в&nbsp;том&nbsp;направлении? Этот ветер меня уже достал, даже твоего хвоста не&nbsp;вижу!&nbsp;— прокричал пони, шедший по&nbsp;центру.

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

Ему удалось лишь на&nbsp;секунду взглянуть на&nbsp;светящийся экран перед&nbsp;тем, как его полностью забили песок, снег и&nbsp;пепел.
Пони вполголоса выругался и&nbsp;повернулся по&nbsp;ветру, держа сканер под&nbsp;защитой своего тела.

результат станет получше:

— Эй, Умник, мы точно идём в том направлении? Этот ветер меня уже достал, даже твоего хвоста не вижу! — прокричал пони, шедший по центру.

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

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

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

— Эй, Ум­ник, мы точ­но идём в том на­прав­ле­нии? Этот ве­тер меня уже до­стал, даже тво­е­го хво­ста не вижу! — про­кри­чал пони, шед­ший по цен­тру.

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

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

Предпросмотр

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

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

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

Очень желательно расставлять в тексте правильные кавычки-«ёлочки» и использовать тире (вот такое: —) вместо дефисов (вот таких: -), особенно в диалогах. Для удобства ввода таких символов рекомендуем воспользоваться типографской раскладкой Ильи Бирмана.

...