Математика для Discourse

[Discourse]

	Краткое описание	Discourse Math использует MathJax (по умолчанию) или KaTeX для отображения математических формул на вашем форуме Discourse.
	Руководство по установке	Этот плагин входит в состав ядра Discourse. Отдельная установка плагина не требуется.

Поскольку это #официальный плагин, поддерживаемый командой Discourse, запросы по #поддержке, #сообщить:об ошибке, #сообщить:об ошибках UX и #запрос:новой функции можно оставить в соответствующих категориях на Meta, добавив соответствующий тег плагина. Нажмите на ссылку ниже, чтобы создать тему.

 Поддержка  Ошибка  UX  Функция

Включение функции математики

Плагин Math можно включить в его настройках, доступных на странице admin/plugins:

Возможности

После включения вы можете отображать формулы в строке текста, заключая их в одиночные $, например: $E=mc^2$.

Для отображения формул блоком заключайте их в $$

$$
\sqrt{(-1)} \; 2^3 \; \sum \; \pi
$$

Discourse Math использует эвристику, чтобы убедиться, что такие предложения, как: «Я потратил 20$ и ещё 100$», не преобразуются в формулы.

Разделители LaTeX

При включении через настройки сайта вы также можете использовать стандартные разделители LaTeX:

• В строке: \(...\) — Пример: \(E=mc^2\)
• Блок: \[...\] — Пример:

  \[
  \frac{1}{2}
  \]
  

AsciiMath (только MathJax)

При использовании MathJax вы можете включить обработку asciimath, которая использует % в качестве разделителя: %E=mc^2%

Интеграция с редактором

В редакторе на панели инструментов есть кнопка Вставить Math с горячей клавишей Shift+M. Она открывает модальное окно, где вы можете:

• Переключаться между режимами в строке и блоком
• Вводить выражение LaTeX
• Просматривать предварительный просмотр и вставлять его в сообщение

В редакторе с форматированием математические выражения отображаются как редактируемые узлы с кнопкой редактирования для изменения выражения.

Поддержка в чате

Математические выражения также отображаются в сообщениях Discourse Chat, используя те же настройки и движок рендеринга.

Движки рендеринга

MathJax (по умолчанию)

• Версия: 4.1
• Форматы вывода: HTML (по умолчанию) или SVG
• Возможности:
  • Контекстное меню (щелчок правой кнопкой мыши по формуле)
  • Расширение доступности для программ чтения с экрана
  • Масштабирование при нажатии Alt+клик (масштаб 175%)
  • Поддержка AsciiMath

KaTeX (альтернатива)

• Возможности:
  • Быстрый рендеринг
  • Расширение Mhchem для химических уравнений
  • Расширение CopyTex — нажмите на формулу, чтобы скопировать исходный код LaTeX в буфер обмена
  • Поддержка перекрестных ссылок с помощью макросов \label, \ref и \eqref

Настройки сайта

Просмотрите все соответствующие настройки сайта, поискав в настройках администратора слово “math”.

Название	Описание
discourse math enabled	Включить плагин Discourse Math (добавляет специальную обработку блоков $ и $$)
discourse math provider	Поставщик рендеринга математики: mathjax (по умолчанию) или katex
discourse math enable latex delimiters	Включить разделители в стиле LaTeX: \(...\) для формул в строке и \[...\] для блочных формул
discourse math mathjax output	Формат вывода MathJax: html (по умолчанию) или svg (только MathJax)
discourse math enable menu	Включить контекстное меню для математических выражений (только MathJax)
discourse math enable accessibility	Включить функции доступности, такие как обогащение текста (только MathJax с меню)
discourse math zoom on click	Масштабирование на 175% при взаимодействии Alt+клик (только MathJax с меню)
discourse math enable asciimath	Включить обработку asciimath с разделителем % (только MathJax)

Размещено у нас? Этот плагин доступен во всех наших тарифах хостинга Math | Discourse - Civilized Discussion