mirror of
https://github.com/reonokiy/blog.nokiy.net.git
synced 2025-06-15 19:22:52 +02:00
docs: update theme guide
This commit is contained in:
parent
e5ecbe1341
commit
2d80d7effd
1 changed files with 84 additions and 0 deletions
|
@ -276,3 +276,87 @@ body{color:oklch(25% 0.005 298)} /* Цвет шрифта */
|
||||||
.text-gray{color:oklch(0.25 0.005 298 / 75%)!important} /* Вторичный цвет шрифта */
|
.text-gray{color:oklch(0.25 0.005 298 / 75%)!important} /* Вторичный цвет шрифта */
|
||||||
</style>
|
</style>
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Создание новой статьи
|
||||||
|
|
||||||
|
Создайте новый файл с расширением `.md` или `.mdx` в директории `src/content/posts/`, и добавьте метаданные `Front Matter` в верхней части файла.
|
||||||
|
|
||||||
|
### Front Matter
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
---
|
||||||
|
# Обязательные
|
||||||
|
title: Руководство по теме
|
||||||
|
published: 2025-01-26
|
||||||
|
|
||||||
|
# Опциональные
|
||||||
|
description: Первые 240 символов статьи будут автоматически выбраны в качестве отрывка.
|
||||||
|
updated: 2025-03-26
|
||||||
|
tags:
|
||||||
|
- Тема блога
|
||||||
|
- Руководство
|
||||||
|
|
||||||
|
# Расширенные, опциональные
|
||||||
|
draft: true/false
|
||||||
|
pin: 1-99
|
||||||
|
toc: true/false
|
||||||
|
lang: en/es/ru/zh/zh-tw/ja
|
||||||
|
abbrlink: theme-guide
|
||||||
|
---
|
||||||
|
```
|
||||||
|
|
||||||
|
### Расширенные настройки
|
||||||
|
|
||||||
|
#### draft
|
||||||
|
|
||||||
|
Отметить статью как черновик. Когда установлено значение true, статью нельзя опубликовать, и она доступна только для локального предварительного просмотра. По умолчанию — false.
|
||||||
|
|
||||||
|
#### pin
|
||||||
|
|
||||||
|
Закрепить статью вверху. Чем выше число, тем выше приоритет закрепленной статьи. По умолчанию — 0, что означает отсутствие закрепления.
|
||||||
|
|
||||||
|
#### toc
|
||||||
|
|
||||||
|
Генерировать оглавление. Показывает заголовки от h2 до h4. По умолчанию — true.
|
||||||
|
|
||||||
|
#### lang
|
||||||
|
|
||||||
|
Указывает язык статьи. Можно указать только один язык. Если не указано, статья будет отображаться по умолчанию во всех языковых путях.
|
||||||
|
|
||||||
|
```md
|
||||||
|
# src/config.ts
|
||||||
|
# locale: 'en'
|
||||||
|
# moreLocales: ['es', 'ru']
|
||||||
|
|
||||||
|
# lang: ''
|
||||||
|
src/content/posts/apple.md -> example.com/posts/apple/
|
||||||
|
-> example.com/es/posts/apple/
|
||||||
|
-> example.com/ru/posts/apple/
|
||||||
|
# lang: en
|
||||||
|
src/content/posts/apple.md -> example.com/posts/apple/
|
||||||
|
# lang: es
|
||||||
|
src/content/posts/apple.md -> example.com/es/posts/apple/
|
||||||
|
# lang: ru
|
||||||
|
src/content/posts/apple.md -> example.com/ru/posts/apple/
|
||||||
|
```
|
||||||
|
|
||||||
|
#### abbrlink
|
||||||
|
|
||||||
|
Настраивает URL статьи. Может содержать только строчные буквы, цифры и дефисы `-`.
|
||||||
|
|
||||||
|
```md
|
||||||
|
# src/config.ts
|
||||||
|
# locale: 'en'
|
||||||
|
# moreLocales: ['es', 'ru']
|
||||||
|
# lang: 'es'
|
||||||
|
|
||||||
|
# abbrlink: ''
|
||||||
|
src/content/posts/apple.md -> example.com/es/posts/apple/
|
||||||
|
src/content/posts/guide/apple.md -> example.com/es/posts/guide/apple/
|
||||||
|
src/content/posts/2025/03/apple.md -> example.com/es/posts/2025/03/apple/
|
||||||
|
|
||||||
|
# abbrlink: 'banana'
|
||||||
|
src/content/posts/apple.md -> example.com/es/posts/banana/
|
||||||
|
src/content/posts/guide/apple.md -> example.com/es/posts/banana/
|
||||||
|
src/content/posts/2025/03/apple.md -> example.com/es/posts/banana/
|
||||||
|
```
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue