Перейти к основному содержимому

Docusaurus

Генератор статичных сайтов. Подходит для блогов, документаций, даже лендинг страниц. Не требует своего хостинга, легко редактируется с любого устройства. Работает на Vercel, markdown хранится на GitHub

Полезно знать

  • Контент при клике на категорию определяется в файле с {folder_name}/{folder_name}.md
  • Если файл начинается с header 1, то он определяет название страницы
  • При переходе на typesense билд увеличился где-то на 10-20 сек. Думаю, фиксится удалением algolia из пакетов
  • Algolia подтверждала заявку на подключение к ним где-то месяц
  • Для замены стандартной index страницы вроде в static удалил папку pages

Перенос с Ghost

Причины перехода с Ghost: клик

  • Чтобы ссылки с Ghost продолжили работать, нужно было blog поместить на /. Делается через routeBasePath = "/" для presets.blog в конфиге. Без этого ссылки были в site.com/blog/slug
  • В каждом посте сверху файла есть front-matter блок, где в каждом указан slug со старого блога
  • Посты с Ghost экспортировал в Markdown через эту тулзу
  • Посты были экспортированы с неправильной датой. Пришлось добавлять +3 часа через самописный мини-скрипт (или вручную)
  • Во многих постах были огрызки HTML. Их пришлось вручную заменять на markdown (Ctrl + F > <figure, <!--kg-card-begin, <!--kg-card-end)
  • Вручную нужно было искать и заменять __GHOST_URL__ на правильные ссылки
  • Docusaurus впервые в репе деплоился через vercel, но он установил устаревшую версию

Markdown заметки

Выделение строк кода

### This

## Is

# Markdown

---

fux

Admonitions

note

Some content with markdown syntax. Check this api.

tip

Some content with markdown syntax. Check this api.

info

Some content with markdown syntax. Check this api.

caution

Some content with markdown syntax. Check this api.

danger

Some content with markdown syntax. Check this api.