Оформление текста — различия между версиями
Alaric (обсуждение | вклад)  (Раздел "ссылки" в друпале)  | 
				Alaric (обсуждение | вклад)  м (→Ссылки)  | 
				||
| Строка 10: | Строка 10: | ||
=== Ссылки ===  | === Ссылки ===  | ||
| − | + | ''Drupal.'' Ссылки в Drupal ставятся так: <code>[отображаемый текст](URL)</code>. В текстах, которые мы переводим, много внутренних ссылок.    | |
Внутренние ссылки можно ставить как в Вики: <code>[[Название статьи|отображаемый текст]]</code>. Однако, в отличие от Вики, Drupal не умеет сохранять ссылки при переименовании, поэтому с этим стоит быть аккуратней.  | Внутренние ссылки можно ставить как в Вики: <code>[[Название статьи|отображаемый текст]]</code>. Однако, в отличие от Вики, Drupal не умеет сохранять ссылки при переименовании, поэтому с этим стоит быть аккуратней.  | ||
Версия 08:20, 13 июля 2018
| Это "техническая" страница одного из проектов сообщества LessWrong. Она создана, чтобы сохранить техническую информацию или интересные идеи для проекта, поэтому не пугайтесь, если вам тут что-нибудь непонятно.
 Если вы хотите помочь сообществу, но не знаете, с чего бы начать, загляните на страницу Как помочь сообществу. Если же вы пока просто хотите понять, чем мы тут занимаемся, начните со страницы Если вы хотите узнать о рациональности.  | 
| Эта статья — о том, как технически оформлять текст на lesswrong.ru. Где какое оформление уместно, смотрите в статье «Автору, переводчику и редактору».  | 
Энциклопедия LessWrong и рабочие тексты размещены в Wiki проекта под управлением MediaWiki, переводы и некоторые другие тексты — в основном пространстве имён сайта под управлением Drupal. Ниже перечислено, как оформлять различные элементы там и там. Так можно делать на lesswrong.ru, а на других площадках у тех же CMS могут быть другие конфигурации, в которых какие-то из этих механизмов не подключены.
Содержание
Справка по форматированию в целом
- Drupal. Справочная информация на русском языке и Справочная информация на английском языке.
 - MediaWiki. Справка:Форматирование на mediawiki.org.
 
Ссылки
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 можно использовать конструкцию −).
Развёрнутые цитаты
Главная проблема цитат в интернете — никто не сомневается в их подлинности.
В. И. Ленин
На обеих площадках оформляются тегом <blockquote>…</blockquote>. В Drupal внутри цитаты не работают многие средства оформления.
Сноски
-  Drupal. Оборачивайте текст сноски в 
[fn]…[/fn]. -  MediaWiki. Оборачивайте текст сноски в 
<ref>…</ref>. В статье со сносками должен быть отдельный раздел примечаний, содержащий конструкцию{{примечания}}, вместо которой подставятся сноски[2]. 
Тире и кавычки
-  Drupal. Двойные (
") и одинарные (') прямые кавычки, доступные с клавиатуры, автоматически преобразуются в правильные кавычки первого («…») и второго („…“) уровня соответственно. Три дефиса (---) преобразуются в тире (—). - MediaWiki. Кнопка викификации, доступная в форме редактирования статей, превращает дефисы и двойные прямые кавычки в тире и кавычки-«лапки». Если нужны кавычки второго уровня („…“), проставьте вручную.
 
Картинки
- Drupal. На странице редактирования перевода есть раздел "Внутритекстовые иллюстрации". Туда можно загрузить файл и потом вставить ссылку на него в текст: либо кнопкой "Insert", либо добавить <img> или markdown-разметку вручную.
 - MediaWiki. Пойдите на страницу Служебная:Загрузка (ссылка на неё есть на каждой странице в боковом меню, "Загрузить файл").
 
Экранирование
В Drupal можно экранировать специальные символы, ставя перед ними обратную косую черту. Так стоит делать со знаком доллара (\$), чтобы MathJax не искал формулу, и с десятичной запятой в дробных числах (3\,14159).
Примечания
- ↑ Подробнее: https://meta.wikimedia.org/wiki/Help:Displaying_a_formula
 - ↑ Выглядит так.