Что это такое?
Nextra — это простой, мощный и гибкий фреймворк для генерации сайтов, в котором есть всё то, что вы любите в Next.js: вы пишете контент на Markdown/MDX, а он превращает его в сайт — обычно документацию или блог.
Nextra — это простой, мощный и гибкий фреймворк для генерации сайтов, в котором есть всё то, что вы любите в Next.js: вы пишете контент на Markdown/MDX, а он превращает его в сайт — обычно документацию или блог.Это хостинговый сервис или то, что я добавляю в свой проект?Это фреймворк, на котором вы строите сайт, а не сервис: репозиторий устроен как основой пакет плюс отдельные темы (например, тема для документации), так что вы собираете собственный сайт на базе Next.js.
Это фреймворк, на котором вы строите сайт, а не сервис: репозиторий устроен как основой пакет плюс отдельные темы (например, тема для документации), так что вы собираете собственный сайт на базе Next.js.С чего мне начать?В README есть ссылка на документацию по использованию; чтобы разрабатывать сам Nextra, включите Corepack и затем выполните pnpm install в репозитории.
В README есть ссылка на документацию по использованию; чтобы разрабатывать сам Nextra, включите Corepack и затем выполните pnpm install в репозитории.Что должно быть установлено, чтобы это запустилось?Окружение Node.js: проект собирается с помощью pnpm (предоставляется через Corepack) внутри PNPM Workspaces, а сборками управляет Turborepo.
Окружение Node.js: проект собирается с помощью pnpm (предоставляется через Corepack) внутри PNPM Workspaces, а сборками управляет Turborepo.Есть ли подводные камни при доработке под себя?Если вы обновляете основные пакеты (core) или темы, нужна пересборка — либо держите включённым режим watch для Nextra и темы в отдельных терминалах.
Если вы обновляете основные пакеты (core) или темы, нужна пересборка — либо держите включённым режим watch для Nextra и темы в отдельных терминалах.Где будет работать получившийся сайт?На выходе получается веб-сайт: сайт на Next.js, который вы разворачиваете и хостите в интернете, как любой другой сайт.
На выходе получается веб-сайт: сайт на Next.js, который вы разворачиваете и хостите в интернете, как любой другой сайт.Там есть готовые темы?В репозитории разрабатывается тема для документации (nextra-theme-docs) и хранятся примеры сайтов для документации, блога и настройки i18n (swr-site); их можно запустить локально через pnpm-скрипты вроде dev:theme-docs.
В репозитории разрабатывается тема для документации (nextra-theme-docs) и хранятся примеры сайтов для документации, блога и настройки i18n (swr-site); их можно запустить локально через pnpm-скрипты вроде dev:theme-docs.Могу ли я видеть изменения контента прямо во время написания?Да — в локальном примере любое изменение в example/docs мгновенно перерисовывается; изменения в core или теме требуют пересборки или режима watch.
Да — в локальном примере любое изменение в example/docs мгновенно перерисовывается; изменения в core или теме требуют пересборки или режима watch.Это давно существующий, проверенный проект?Да: он ведёт историю с июня 2020 года, у него около 13,9 тыс. звёзд на GitHub, он не переведён в архив, и по нему работают CI-воркфлоу для линта, тестов и релизов.
Да: он ведёт историю с июня 2020 года, у него около 13,9 тыс. звёзд на GitHub, он не переведён в архив, и по нему работают CI-воркфлоу для линта, тестов и релизов.What are similar projects?docusaurus, NotionNext, fumadocs, docs, hexo, next.js, umi, astro
docusaurus, NotionNext, fumadocs, docs, hexo, next.js, umi, astroWhich topics is it in?mdx, blog, pnpm, static-site-generator, themes, monorepo, i18n, nextjs, documentation, markdown, web-development, framework
mdx, blog, pnpm, static-site-generator, themes, monorepo, i18n, nextjs, documentation, markdown, web-development, framework