Outstatic CMS для персонального блога на Next.js: Легко и Быстро
- воскресенье, 10 ноября 2024 г. в 00:00:04
Решил сделать небольшой проект для статей.
Для разработки я выбрал Next.js, создал структуру проекта и пошел думать над тем, как мне будет проще и удобнее публиковать и редактировать статьи.
Начал искать подходящую headless CMS. Первое, что выдает поисковик и что у многих на слуху, — это Strapi. Попробовав ее в их тестовой среде, понял, что это мощный инструмент, подходящий для более крупных проектов, где важно уметь управлять всем контентом, однако для небольшого блога с фокусом на статьях Strapi кажется избыточным.
В итоге я продолжил искать и наткнулся на новую, более легковесную CMS — Outstatic, разработанную для управления контентом с использованием Markdown.
О ней и пойдет речь в этой статье.
— это CMS с открытым исходным кодом, которая хранит все ваши данные в виде markdown файлов прямо в проекте. Поэтому она не требует базы данных, не зависит от среды развертывания и не нуждается в отдельной системе контроля версий, что очень удобно.
1) GitHub OAuth
Для того, чтобы Outstatic могла автоматически коммитить все изменения в статьях, нужно подключить к ней авторизацию в GitHub.
Перешел на «Register a new OAuth app»
Application name: имя вашего приложения (app-local)
Homepage URL: URL домашней страницы (http://localhost:3000/)
Authorization callback URL: <Основной путь>/api/outstatic/callback (http://localhost:3000/api/outstatic/callback)
После регистрации сгенерировал новый Client secret и записал его в заметки, он понадобится в env переменных
Обратите внимание, что Github не дает прописать сразу несколько путей для аутентификации, поэтому, для приложения развернутого на сервере, понадобится настроить еще один OAuth app.
2) Устанавливаю Outstatic в проект
npm i outstatic
3) Cоздаю два файла в проекте
/app/outstatic/[[...ost]]/page.tsx
import 'outstatic/outstatic.css';
import { Outstatic } from 'outstatic';
import { OstClient } from 'outstatic/client';
export default async function Page({ params }: { params: { ost: string[] } }) {
const ostData = await Outstatic();
return <OstClient ostData={ostData} params={params} />;
}
/app/api/outstatic/[[...ost]]/route.ts
import { OutstaticApi } from 'outstatic';
export const GET = OutstaticApi.GET;
export const POST = OutstaticApi.POST;
4) Остается прописать .env переменные
OST_GITHUB_ID=GITHUB_OAUTH_APP_ID
OST_GITHUB_SECRET=GITHUB_OAUTH_APP_SECRETN
OST_REPO_SLUG=GITHUB_REPOSITORY_SLUG
# OPTIONAL
OST_REPO_BRANCH=YOUR_GITHUB_REPOSITORY_BRANCH
Вот и все, теперь можно запускать приложение
Переходим на https://localhost:3000/outstatic и авторизуемся через github.
Можно писать свою первую статью (подробнее как это делать тут)
После сохранения статьи она автоматически попадает в репозиторий, но не обновляет файлы локально, поэтому не забывайте пулить изменения, чтобы подтянулись все обновленные markdown файлы.
Теперь стоит задача отобразить список постов и конкретный пост по его id.
Для начала давайте напишем функцию, которая трансформирует наш markdown в html, чтобы отобразить его на странице. Для этого будем использовать unified и remark-parse
Установим все необходимые зависимости
npm i unified remark-parse remark-gfm remark-rehype rehype-sanitize rehype-stringify
Создадим файл
lib/markdownToHtml.ts
import { unified } from 'unified';
import remarkParse from 'remark-parse';
import remarkGfm from 'remark-gfm';
import remarkRehype from 'remark-rehype';
import rehypeSanitize from 'rehype-sanitize';
import rehypeStringify from 'rehype-stringify';
export default async function markdownToHtml(markdown: string) {
const result = await unified()
.use(remarkParse)
.use(remarkGfm)
.use(remarkRehype)
.use(rehypeSanitize)
.use(rehypeStringify)
.process(markdown);
return result.toString();
}
Получение данных
Напишем функцию, которая получит отсортированный список постов по категории, и функцию для получения контента поста. Поле категории я добавил при создании поста в Outstatic (тут об этом подробно написано)
/lib/posts.ts
import { getDocuments, getDocumentBySlug } from 'outstatic/server';
import markdownToHtml from './markdownToHtml';
export function getSortedPostsData({ category }: { category: string; }) {
const allPostsData = getDocuments(category, [
'title',
'status',
'author',
'slug',
'description',
'coverImage',
'publishedAt',
'price',
'category',
'tags',
]);
return allPostsData.sort((a, b) => {
if (a.publishedAt < b.publishedAt) {
return 1;
} else {
return -1;
}
});
}
export async function getPostContent({ category, slug }: { category: string; slug: string }) {
const post = getDocumentBySlug(category, slug, [
'title',
'status',
'author',
'slug',
'description',
'coverImage',
'publishedAt',
'content',
'category',
]);
if (!post) return null;
const content = await markdownToHtml(post.content);
return {
...post,
content,
};
}
Также с Outstatic поддерживает простые запросы на выборку данных (подробнее тут)
Создадим директорию в /app, в которой будут отображаться все наши посты.
/app/posts/page.tsx
import { getSortedPostsData } from '@/lib/posts';
import Image from 'next/image';
import Link from 'next/link';
export default async function Page() {
const allPostsData = getSortedPostsData({
category: 'tilda-widgets',
});
return (
<div>
{allPostsData.map((post) => (
<Link key={post.slug} href={`/${post.category}/${post.slug}`}>
<Image width={200} height={200} src={post.coverImage} alt={post.title} />
</Link>
))}
</div>
);
}
/app/posts/[id]/page.tsx
import { getPostContent } from '@/lib/posts';
import Image from 'next/image';
export default async function Page({ params }: { params: { id: string } }) {
const postInfo = await getPostContent({ category: 'tilda-widgets', slug: params.id });
if (!postInfo) return <p>Такого поста нет</p>;
return (
<div>
<h1>{postInfo.title}</h1>
<Image src={postInfo.coverImage} alt={postInfo.title} width={0} height={0} sizes='100vw' />
<div dangerouslySetInnerHTML={{ __html: postInfo.content ?? '' }}></div>
</div>
);
}
После перезапуска приложения мы должны увидеть список постов и при переходе по нему сам контент поста.
Обратите внимание, что стиль в редакторе и в самом посте будут отличаться, поэтому нужно поработать со стилями. Для отображения блока с кодом можете использовать prismjs.
Вот и все, минимальный функционал для нашего блога готов.
После использования Outstatic из минусов могу выделить следующее:
Невозможно прикрепить несколько изображений к заголовку
Нет автосохранения контента и в целом не всегда уверен, что изменения улетели в гит, поэтому приходится перепроверять перед закрытием
Нет возможности редактировать сам markdown напрямую из редактора
Но несмотря на все эти минусы, считаю, что это очень легковесный и удобный продукт для небольших блогов.
Спасибо за внимание