Подсветка синтаксиса через PrismJS

Если в документе есть примеры кода, их можно подсветить через PrismJS.

Где взять код PrismJS

Откройте prismjs.com/download, выберите тему, языки и нужные опции, затем скопируйте готовые CSS- и JavaScript-фрагменты.

Куда вставить код

CSS вставьте в пользовательские стили документа. JavaScript вставьте в пользовательские скрипты документа.

Если библиотека подключена на уровне документа, инициализацию важно запускать не только при первой загрузке, но и при переходах между страницами внутри экспортированного файла.

Как перезапускать подсветку

Оберните вызов PrismJS в window.OneFileDocsViewer.onRouteChange. Тогда после открытия другой страницы подсветка применится заново к новому контенту.

const applyPrismHighlight = () => {
  if (window.Prism) {
    window.Prism.highlightAll();
  }
};

window.OneFileDocsViewer.onReady(applyPrismHighlight);
window.OneFileDocsViewer.onRouteChange(applyPrismHighlight);

Если подсветка нужна только на одной странице

Если PrismJS нужен только в одном разделе, его можно добавить не в document-level custom code, а в стили и скрипты конкретного раздела.

В этом случае section script будет выполняться только для этой страницы, и отдельная глобальная подписка на переходы не потребуется.