Оформление текста — различия между версиями
Quilfe (обсуждение | вклад) (уточнение) |
Alaric (обсуждение | вклад) |
||
| (не показано 12 промежуточных версий 2 участников) | |||
| Строка 1: | Строка 1: | ||
| + | {{TechnicalProjectPage}} | ||
{{Ambox|text=Эта статья — о том, как технически оформлять текст на [//lesswrong.ru lesswrong.ru].<br>Где какое оформление уместно, смотрите в статье «[[Автору, переводчику и редактору]]».}} | {{Ambox|text=Эта статья — о том, как технически оформлять текст на [//lesswrong.ru lesswrong.ru].<br>Где какое оформление уместно, смотрите в статье «[[Автору, переводчику и редактору]]».}} | ||
| − | + | [//lesswrong.ru/Переводы Переводы] и некоторые другие тексты размещены в основном пространстве имён сайта под управлением Drupal. Ниже перечислено, как на этой платформе оформлять различные элементы. | |
| + | |||
| + | === Справка по форматированию в целом === | ||
| + | |||
| + | [http://belousovv.ru/markdown_syntax Справочная информация на русском языке] и [https://daringfireball.net/projects/markdown/syntax Справочная информация на английском языке]. | ||
| + | |||
| + | === Ссылки === | ||
| + | Ссылки в Drupal ставятся так: <code>[отображаемый текст](URL)</code>. | ||
| + | |||
| + | В текстах, которые мы переводим, много внутренних ссылок(ссылок на другие тексты, которые есть на сайте, в том числе и ссылки на другие главы из [[Рациональность: от ИИ до зомби|книги «Рациональность: от ИИ до зомби»]]). Внутренние ссылки можно ставить как в Вики: <code><nowiki>[[Название статьи|отображаемый текст]]</nowiki></code>. Однако, в отличие от Вики, Drupal не умеет сохранять ссылки при переименовании, поэтому с этим стоит быть аккуратней. | ||
| + | |||
| + | Даже если вы ставите внутренние ссылки как обычные, стоит убирать из URL начальную часть <code>https://lesswrong.ru</code>, а также, по-возможности, копировать ссылку так, чтобы она выглядела как текст на русском. Это очень помогает тем, кто будет редактировать текст после вас: во-первых, ссылки занимают меньше места, во-вторых, легче понимать, что тут написано. | ||
=== Формулы === | === Формулы === | ||
| Строка 8: | Строка 20: | ||
<!-- что-то не работает :( --> | <!-- что-то не работает :( --> | ||
| − | + | Можно писать в 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-формул минус стоит обозначать не дефисом, а специальным типографским знаком − | + | За пределами TeX-формул минус стоит обозначать не дефисом, а специальным типографским знаком −. |
=== Развёрнутые цитаты === | === Развёрнутые цитаты === | ||
| − | <blockquote>Главная проблема цитат в интернете — никто не | + | <blockquote>Главная проблема цитат в интернете — никто не сомневается в их подлинности.<br /><br /> |
''В. И. Ленин''</blockquote> | ''В. И. Ленин''</blockquote> | ||
| − | + | Цитаты оформляются тегом <code><<nowiki />blockquote>…</blockquote></code>. В Drupal внутри цитаты не работают многие средства оформления. | |
=== Сноски === | === Сноски === | ||
| − | + | Оборачивайте текст сноски в <code>[fn]…[/fn]</code> и вставляйте в то место, где нужно поставить сноску. | |
| − | |||
=== Тире и кавычки === | === Тире и кавычки === | ||
| − | + | Двойные (<code>"</code>) и одинарные (<code>'</code>) прямые кавычки, доступные с клавиатуры, автоматически преобразуются в правильные кавычки первого («…») и второго („…“) уровня соответственно. Три дефиса (<code>---</code>) преобразуются в тире (—). | |
| − | |||
=== Картинки === | === Картинки === | ||
| − | + | На странице редактирования перевода есть раздел "Внутритекстовые иллюстрации". Туда можно загрузить файл и потом вставить ссылку на него в текст: либо кнопкой "Insert", либо добавить <img> или markdown-разметку вручную. | |
=== Экранирование === | === Экранирование === | ||
В Drupal можно экранировать специальные символы, ставя перед ними обратную косую черту. Так стоит делать со знаком доллара (<code>\$</code>), чтобы MathJax не искал формулу, и с десятичной запятой в дробных числах (<code>3\,14159</code>). | В Drupal можно экранировать специальные символы, ставя перед ними обратную косую черту. Так стоит делать со знаком доллара (<code>\$</code>), чтобы MathJax не искал формулу, и с десятичной запятой в дробных числах (<code>3\,14159</code>). | ||
| − | === | + | === Заголовки === |
| − | + | Не надо использовать заголовки первого уровня. Это портит составление оглавлений (как глобальных — при генерации электронных книг), так и локальных в эссе. | |
| − | |||
[[Категория:Работа над переводами]] | [[Категория:Работа над переводами]] | ||
Текущая версия на 15:04, 8 мая 2020
| Это "техническая" страница одного из проектов сообщества 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).
Заголовки[править]
Не надо использовать заголовки первого уровня. Это портит составление оглавлений (как глобальных — при генерации электронных книг), так и локальных в эссе.
