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

Материал из Вики LessWrong.ru
Перейти к: навигация, поиск
м (→‎Ссылки)
(Удаление информации, касающейся Медиавики, поскольку она вынесена на отдельную страницу)
Строка 2: Строка 2:
 
{{Ambox|text=Эта статья — о том, как технически оформлять текст на [//lesswrong.ru lesswrong.ru].<br>Где какое оформление уместно, смотрите в статье «[[Автору, переводчику и редактору]]».}}
 
{{Ambox|text=Эта статья — о том, как технически оформлять текст на [//lesswrong.ru lesswrong.ru].<br>Где какое оформление уместно, смотрите в статье «[[Автору, переводчику и редактору]]».}}
  
−
Энциклопедия LessWrong и рабочие тексты размещены в [[Заглавная страница|Wiki]] проекта под управлением MediaWiki, [//lesswrong.ru/Переводы переводы] и некоторые другие тексты — в основном пространстве имён сайта под управлением Drupal. Ниже перечислено, как оформлять различные элементы там и там. Так можно делать на [//lesswrong.ru lesswrong.ru], а на других площадках у тех же CMS могут быть другие конфигурации, в которых какие-то из этих механизмов не подключены.
+
[//lesswrong.ru/Переводы Переводы] и некоторые другие тексты размещены в основном пространстве имён сайта под управлением Drupal. Ниже перечислено, как на этой платформе оформлять различные элементы.  
  
 
=== Справка по форматированию в целом ===
 
=== Справка по форматированию в целом ===
  
−
* ''Drupal.'' [http://belousovv.ru/markdown_syntax Справочная информация на русском языке] и [https://daringfireball.net/projects/markdown/syntax Справочная информация на английском языке].
+
[http://belousovv.ru/markdown_syntax Справочная информация на русском языке] и [https://daringfireball.net/projects/markdown/syntax Справочная информация на английском языке].
−
* ''MediaWiki.'' [https://www.mediawiki.org/wiki/Help:Formatting/ru Справка:Форматирование] на mediawiki.org.
 
  
 
=== Ссылки ===
 
=== Ссылки ===
−
''Drupal.'' Ссылки в Drupal ставятся так: <code>[отображаемый текст](URL)</code>.  
+
Ссылки в Drupal ставятся так: <code>[отображаемый текст](URL)</code>.  
  
 
В текстах, которые мы переводим, много внутренних ссылок(ссылок на другие тексты, которые есть на сайте, в том числе и ссылки на другие главы из [[Рациональность: от ИИ до зомби|книги «Рациональность: от ИИ до зомби»]]). Внутренние ссылки можно ставить как в Вики: <code>[[Название статьи|отображаемый текст]]</code>. Однако, в отличие от Вики, Drupal не умеет сохранять ссылки при переименовании, поэтому с этим стоит быть аккуратней.
 
В текстах, которые мы переводим, много внутренних ссылок(ссылок на другие тексты, которые есть на сайте, в том числе и ссылки на другие главы из [[Рациональность: от ИИ до зомби|книги «Рациональность: от ИИ до зомби»]]). Внутренние ссылки можно ставить как в Вики: <code>[[Название статьи|отображаемый текст]]</code>. Однако, в отличие от Вики, Drupal не умеет сохранять ссылки при переименовании, поэтому с этим стоит быть аккуратней.
Строка 21: Строка 20:
 
<!-- что-то не работает :( -->
 
<!-- что-то не работает :( -->
  
−
* ''Drupal.'' Можно писать в TeX через [https://www.mathjax.org/ MathJax]. Для внутристрочной формулы заверните её в доллары: <code>$E=mc^2$</code>. Для формулы на отдельной строке — в двойные доллары $$. Если вы не знаете TeX, поможет сервис [http://www.codecogs.com/latex/eqneditor.php http://www.codecogs.com/latex/eqneditor.php].
+
Можно писать в TeX через [https://www.mathjax.org/ MathJax]. Для внутристрочной формулы заверните её в доллары: <code>$E=mc^2$</code>. Для формулы на отдельной строке — в двойные доллары $$. Если вы не знаете TeX, поможет сервис [http://www.codecogs.com/latex/eqneditor.php http://www.codecogs.com/latex/eqneditor.php].
−
* ''MediaWiki.'' Оборачивайте в тег <code><<nowiki />math>…</math></code>, например, <code><<nowiki />math>E=mc^2</math></code><ref>Подробнее: https://meta.wikimedia.org/wiki/Help:Displaying_a_formula</ref>.
 
  
−
За пределами TeX-формул минус стоит обозначать не дефисом, а специальным типографским знаком &minus; (в MediaWiki можно использовать конструкцию <code>&amp;minus;</code>).
+
За пределами TeX-формул минус стоит обозначать не дефисом, а специальным типографским знаком &minus;.
  
 
=== Развёрнутые цитаты ===
 
=== Развёрнутые цитаты ===
Строка 32: Строка 30:
 
''В. И. Ленин''</blockquote>
 
''В. И. Ленин''</blockquote>
  
−
На обеих площадках оформляются тегом <code><<nowiki />blockquote>…</blockquote></code>. В Drupal внутри цитаты не работают многие средства оформления.
+
Цитаты оформляются тегом <code><<nowiki />blockquote>…</blockquote></code>. В Drupal внутри цитаты не работают многие средства оформления.
  
 
=== Сноски ===
 
=== Сноски ===
−
* ''Drupal.'' Оборачивайте текст сноски в <code>[fn]…[/fn]</code>.
+
Оборачивайте текст сноски в <code>[fn]…[/fn]</code>.
−
* ''MediaWiki.'' Оборачивайте текст сноски в <code><<nowiki />ref>…</ref></code>. В статье со сносками должен быть отдельный раздел примечаний, содержащий конструкцию <code><nowiki>{{примечания}}</nowiki></code>, вместо которой подставятся сноски<ref>Выглядит так.</ref>.
 
  
 
=== Тире и кавычки ===
 
=== Тире и кавычки ===
−
* ''Drupal.'' Двойные (<code>"</code>) и одинарные (<code>'</code>) прямые кавычки, доступные с клавиатуры, автоматически преобразуются в правильные кавычки первого («…») и второго („…“) уровня соответственно. Три дефиса (<code>---</code>) преобразуются в тире (—).
+
Двойные (<code>"</code>) и одинарные (<code>'</code>) прямые кавычки, доступные с клавиатуры, автоматически преобразуются в правильные кавычки первого («…») и второго („…“) уровня соответственно. Три дефиса (<code>---</code>) преобразуются в тире (—).
−
* ''MediaWiki.'' Кнопка викификации, доступная в форме редактирования статей, превращает дефисы и двойные прямые кавычки в тире и кавычки-«лапки». Если нужны кавычки второго уровня („…“), проставьте вручную.
 
  
 
=== Картинки ===
 
=== Картинки ===
−
* ''Drupal.'' На странице редактирования перевода есть раздел "Внутритекстовые иллюстрации". Туда можно загрузить файл и потом вставить ссылку на него в текст: либо кнопкой "Insert", либо добавить <img> или markdown-разметку вручную.
+
На странице редактирования перевода есть раздел "Внутритекстовые иллюстрации". Туда можно загрузить файл и потом вставить ссылку на него в текст: либо кнопкой "Insert", либо добавить <img> или markdown-разметку вручную.
−
* ''MediaWiki.'' Пойдите на страницу [[Служебная:Загрузка]] (ссылка на неё есть на каждой странице в боковом меню, "Загрузить файл").
 
  
 
=== Экранирование ===
 
=== Экранирование ===
 
В Drupal можно экранировать специальные символы, ставя перед ними обратную косую черту. Так стоит делать со знаком доллара (<code>\$</code>), чтобы MathJax не искал формулу, и с десятичной запятой в дробных числах (<code>3\,14159</code>).
 
В Drupal можно экранировать специальные символы, ставя перед ними обратную косую черту. Так стоит делать со знаком доллара (<code>\$</code>), чтобы MathJax не искал формулу, и с десятичной запятой в дробных числах (<code>3\,14159</code>).
  
−
=== Примечания ===
 
−
{{примечания}}
 
−
 
−
[[Категория:Вики]]
 
 
[[Категория:Работа над переводами]]
 
[[Категория:Работа над переводами]]

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

 
 Это "техническая" страница одного из проектов сообщества LessWrong. Она создана, чтобы сохранить техническую информацию или интересные идеи для проекта, поэтому не пугайтесь, если вам тут что-нибудь непонятно.
Если вы хотите помочь сообществу, но не знаете, с чего бы начать, загляните на страницу Как помочь сообществу. Если же вы пока просто хотите понять, чем мы тут занимаемся, начните со страницы Если вы хотите узнать о рациональности.
 
 Эта статья — о том, как технически оформлять текст на lesswrong.ru.
Где какое оформление уместно, смотрите в статье «Автору, переводчику и редактору».

Переводы и некоторые другие тексты размещены в основном пространстве имён сайта под управлением 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).

Источник — «https://lesswrong.ru/wiki/index.php?title=Оформление_текста&oldid=2234»