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

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

Версия 08:33, 13 июля 2018

Энциклопедия LessWrong и рабочие тексты размещены в Wiki проекта под управлением MediaWiki, переводы и некоторые другие тексты — в основном пространстве имён сайта под управлением Drupal. Ниже перечислено, как оформлять различные элементы там и там. Так можно делать на lesswrong.ru, а на других площадках у тех же CMS могут быть другие конфигурации, в которых какие-то из этих механизмов не подключены.

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

Ссылки

Drupal. Ссылки в Drupal ставятся так: [отображаемый текст](URL). В текстах, которые мы переводим, много внутренних ссылок.

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

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

Формулы

  • Drupal. Можно писать в TeX через MathJax. Для внутристрочной формулы заверните её в доллары: $E=mc^2$. Для формулы на отдельной строке — в двойные доллары $$. Если вы не знаете TeX, поможет сервис http://www.codecogs.com/latex/eqneditor.php.
  • MediaWiki. Оборачивайте в тег <math>…</math>, например, <math>E=mc^2</math>[1].

За пределами TeX-формул минус стоит обозначать не дефисом, а специальным типографским знаком − (в MediaWiki можно использовать конструкцию &minus;).

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

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

В. И. Ленин

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

Сноски

  • Drupal. Оборачивайте текст сноски в [fn]…[/fn].
  • MediaWiki. Оборачивайте текст сноски в <ref>…</ref>. В статье со сносками должен быть отдельный раздел примечаний, содержащий конструкцию {{примечания}}, вместо которой подставятся сноски[2].

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

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

Картинки

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

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

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

Примечания

  1. Подробнее: https://meta.wikimedia.org/wiki/Help:Displaying_a_formula
  2. Выглядит так.