Оформление текста — различия между версиями

Материал из Вики LessWrong.ru
Перейти к: навигация, поиск
(Удаление информации, касающейся Медиавики, поскольку она вынесена на отдельную страницу)
м (Ссылки: Забытый тэг nowiki)
Строка 11: Строка 11:
 
Ссылки в Drupal ставятся так: <code>[отображаемый текст](URL)</code>.  
 
Ссылки в Drupal ставятся так: <code>[отображаемый текст](URL)</code>.  
  
В текстах, которые мы переводим, много внутренних ссылок(ссылок на другие тексты, которые есть на сайте, в том числе и ссылки на другие главы из [[Рациональность: от ИИ до зомби|книги «Рациональность: от ИИ до зомби»]]). Внутренние ссылки можно ставить как в Вики: <code>[[Название статьи|отображаемый текст]]</code>. Однако, в отличие от Вики, Drupal не умеет сохранять ссылки при переименовании, поэтому с этим стоит быть аккуратней.
+
В текстах, которые мы переводим, много внутренних ссылок(ссылок на другие тексты, которые есть на сайте, в том числе и ссылки на другие главы из [[Рациональность: от ИИ до зомби|книги «Рациональность: от ИИ до зомби»]]). Внутренние ссылки можно ставить как в Вики: <code><nowiki>[[Название статьи|отображаемый текст]]</nowiki></code>. Однако, в отличие от Вики, Drupal не умеет сохранять ссылки при переименовании, поэтому с этим стоит быть аккуратней.
  
 
Даже если вы ставите внутренние ссылки как обычные, стоит убирать из URL начальную часть <code>https://lesswrong.ru</code>, а также, по-возможности, копировать ссылку так, чтобы она выглядела как текст на русском. Это очень помогает тем, кто будет редактировать текст после вас: во-первых, ссылки занимают меньше места, во-вторых, легче понимать, что тут написано.
 
Даже если вы ставите внутренние ссылки как обычные, стоит убирать из URL начальную часть <code>https://lesswrong.ru</code>, а также, по-возможности, копировать ссылку так, чтобы она выглядела как текст на русском. Это очень помогает тем, кто будет редактировать текст после вас: во-первых, ссылки занимают меньше места, во-вторых, легче понимать, что тут написано.

Версия 12:41, 13 июля 2018

Переводы и некоторые другие тексты размещены в основном пространстве имён сайта под управлением Drupal. Ниже перечислено, как на этой платформе оформлять различные элементы.

Справка по форматированию в целом

Справочная информация на русском языке и Справочная информация на английском языке.

Ссылки

Ссылки в Drupal ставятся так: [отображаемый текст](URL).

В текстах, которые мы переводим, много внутренних ссылок(ссылок на другие тексты, которые есть на сайте, в том числе и ссылки на другие главы из книги «Рациональность: от ИИ до зомби»). Внутренние ссылки можно ставить как в Вики: [[Название статьи|отображаемый текст]]. Однако, в отличие от Вики, Drupal не умеет сохранять ссылки при переименовании, поэтому с этим стоит быть аккуратней.

Даже если вы ставите внутренние ссылки как обычные, стоит убирать из URL начальную часть https://lesswrong.ru, а также, по-возможности, копировать ссылку так, чтобы она выглядела как текст на русском. Это очень помогает тем, кто будет редактировать текст после вас: во-первых, ссылки занимают меньше места, во-вторых, легче понимать, что тут написано.

Формулы

Можно писать в TeX через MathJax. Для внутристрочной формулы заверните её в доллары: $E=mc^2$. Для формулы на отдельной строке — в двойные доллары $$. Если вы не знаете TeX, поможет сервис http://www.codecogs.com/latex/eqneditor.php.

За пределами TeX-формул минус стоит обозначать не дефисом, а специальным типографским знаком −.

Развёрнутые цитаты

Главная проблема цитат в интернете — никто не сомневается в их подлинности.

В. И. Ленин

Цитаты оформляются тегом <blockquote>…</blockquote>. В Drupal внутри цитаты не работают многие средства оформления.

Сноски

Оборачивайте текст сноски в [fn]…[/fn].

Тире и кавычки

Двойные (") и одинарные (') прямые кавычки, доступные с клавиатуры, автоматически преобразуются в правильные кавычки первого («…») и второго („…“) уровня соответственно. Три дефиса (---) преобразуются в тире (—).

Картинки

На странице редактирования перевода есть раздел "Внутритекстовые иллюстрации". Туда можно загрузить файл и потом вставить ссылку на него в текст: либо кнопкой "Insert", либо добавить <img> или markdown-разметку вручную.

Экранирование

В Drupal можно экранировать специальные символы, ставя перед ними обратную косую черту. Так стоит делать со знаком доллара (\$), чтобы MathJax не искал формулу, и с десятичной запятой в дробных числах (3\,14159).