196 lines
10 KiB
Markdown
196 lines
10 KiB
Markdown
# 📁 Структура темы rDedInit
|
|
|
|
## Описание
|
|
|
|
**rDedInit** — русскоязычная тема для блога на базе Hugo, созданная на основе темы PaperMod.
|
|
Этот документ описывает структуру темы и назначение каждого каталога и файла.
|
|
|
|
---
|
|
|
|
## 🗂️ Иерархия файлов
|
|
|
|
```
|
|
rDedInit/
|
|
├── theme.toml # Метаданные темы (название, автор, версия)
|
|
├── LICENSE # Лицензия (MIT)
|
|
├── README.md # Документация темы
|
|
├── STRUCTURE.md # Этот файл — описание структуры
|
|
├── go.mod # Go модуль (зависимости)
|
|
│
|
|
├── assets/ # Исходные файлы стилей и скриптов
|
|
│ ├── css/
|
|
│ │ ├── core/ # Базовые стили темы
|
|
│ │ │ ├── reset.css # Сброс стилей браузера
|
|
│ │ │ ├── theme-vars.css # CSS-переменные (цвета, отступы)
|
|
│ │ │ ├── license.css # Лицензионная информация
|
|
│ │ │ └── zmedia.css # Адаптивность (media queries)
|
|
│ │ │
|
|
│ │ ├── common/ # Стили для компонентов
|
|
│ │ │ ├── 404.css # Страница 404
|
|
│ │ │ ├── archive.css # Архив постов
|
|
│ │ │ ├── footer.css # Подвал сайта
|
|
│ │ │ ├── header.css # Шапка сайта
|
|
│ │ │ ├── main.css # Основная разметка
|
|
│ │ │ ├── post-entry.css # Карточка поста в списке
|
|
│ │ │ ├── post-single.css # Отдельный пост
|
|
│ │ │ ├── profile-mode.css # Режим профиля
|
|
│ │ │ ├── search.css # Страница поиска
|
|
│ │ │ └── terms.css # Страницы таксономий
|
|
│ │ │
|
|
│ │ ├── includes/ # Включаемые стили
|
|
│ │ │ ├── chroma-styles.css # Подсветка синтаксиса (Chroma)
|
|
│ │ │ ├── chroma-mod.css # Модификации подсветки
|
|
│ │ │ └── scroll-bar.css # Стилизация скроллбара
|
|
│ │ │
|
|
│ │ └── extended/ # Для кастомизации пользователем
|
|
│ │ └── blank.css # Пустой файл для ваших стилей
|
|
│ │
|
|
│ └── js/
|
|
│ ├── fastsearch.js # Скрипт быстрого поиска
|
|
│ ├── fuse.basic.min.js # Библиотека Fuse.js для поиска
|
|
│ └── license.js # Лицензионная информация JS
|
|
│
|
|
├── layouts/ # HTML-шаблоны (Go templates)
|
|
│ ├── _default/ # Шаблоны по умолчанию
|
|
│ │ ├── baseof.html # Базовый каркас HTML (наследуются другими)
|
|
│ │ ├── list.html # Список постов (категории, теги, архив)
|
|
│ │ ├── single.html # Отдельная страница поста
|
|
│ │ ├── archives.html # Страница архива
|
|
│ │ ├── search.html # Страница поиска
|
|
│ │ ├── terms.html # Список таксономий
|
|
│ │ ├── rss.xml # RSS-лента
|
|
│ │ └── index.json # JSON для поиска
|
|
│ │
|
|
│ ├── partials/ # Переиспользуемые части шаблонов
|
|
│ │ ├── head.html # <head> секция (мета-теги, стили)
|
|
│ │ ├── header.html # Шапка сайта (меню, логотип)
|
|
│ │ ├── footer.html # Подвал сайта
|
|
│ │ ├── post_meta.html # Мета-информация поста (дата, автор)
|
|
│ │ ├── post_nav_links.html # Навигация между постами
|
|
│ │ ├── toc.html # Оглавление поста
|
|
│ │ ├── cover.html # Обложка поста
|
|
│ │ ├── author.html # Информация об авторе
|
|
│ │ ├── breadcrumbs.html # Хлебные крошки
|
|
│ │ ├── share_icons.html # Иконки шеринга
|
|
│ │ ├── social_icons.html # Соцсети автора
|
|
│ │ ├── edit_post.html # Ссылка на редактирование
|
|
│ │ ├── translation_list.html # Список переводов
|
|
│ │ ├── svg.html # SVG иконки
|
|
│ │ ├── comments.html # Комментарии (если включены)
|
|
│ │ ├── google_analytics.html # Google Analytics
|
|
│ │ │
|
|
│ │ ├── extend_head.html # Расширение <head> (пустой по умолчанию)
|
|
│ │ ├── extend_footer.html # Расширение footer (пустой по умолчанию)
|
|
│ │ │
|
|
│ │ └── templates/ # Вспомогательные шаблоны
|
|
│ │ ├── opengraph.html # Open Graph мета-теги
|
|
│ │ ├── twitter_cards.html # Twitter Cards
|
|
│ │ ├── schema_json.html # Schema.org разметка
|
|
│ │ └── _funcs/ # Вспомогательные функции
|
|
│ │ └── get-page-images.html
|
|
│ │
|
|
│ ├── shortcodes/ # Шорткоды Hugo
|
|
│ │ ├── figure.html # Обёртка для изображений
|
|
│ │ ├── collapse.html # Сворачиваемый блок
|
|
│ │ ├── inTextImg.html # Изображение в тексте
|
|
│ │ ├── rtl.html # Поддержка RTL языков
|
|
│ │ ├── ltr.html # Поддержка LTR языков
|
|
│ │ └── rawhtml.html # Блок чистого HTML
|
|
│ │
|
|
│ ├── 404.html # Страница ошибки 404
|
|
│ └── robots.txt # Файл robots.txt
|
|
│
|
|
├── i18n/ # Переводы интерфейса
|
|
│ ├── ru.yaml # Русский перевод
|
|
│ ├── en.yaml # Английский перевод
|
|
│ └── ... # Другие языки (40+ языков)
|
|
│
|
|
├── images/ # Изображения темы
|
|
│ ├── screenshot.png # Скриншот темы (для каталогов)
|
|
│ └── tn.png # Thumbnail (миниатюра)
|
|
│
|
|
└── public/ # Сгенерированные файлы (не редактировать!)
|
|
└── ... # Содержимое создаётся при сборке темы
|
|
```
|
|
|
|
---
|
|
|
|
## 🔑 Ключевые файлы для кастомизации
|
|
|
|
### CSS-стили
|
|
|
|
| Файл | Назначение |
|
|
|------|------------|
|
|
| `assets/css/core/theme-vars.css` | Цветовая схема, отступы, размеры |
|
|
| `assets/css/extended/blank.css` | Ваши кастомные стили (не изменяет оригинал) |
|
|
| `assets/css/common/header.css` | Стили шапки сайта |
|
|
| `assets/css/common/footer.css` | Стили подвала |
|
|
| `assets/css/common/post-single.css` | Стили отдельного поста |
|
|
|
|
### Шаблоны (Layouts)
|
|
|
|
| Файл | Назначение |
|
|
|------|------------|
|
|
| `layouts/partials/header.html` | Шапка сайта (меню, логотип) |
|
|
| `layouts/partials/footer.html` | Подвал сайта |
|
|
| `layouts/partials/head.html` | Мета-теги, подключение стилей |
|
|
| `layouts/_default/single.html` | Шаблон отдельной страницы |
|
|
| `layouts/_default/list.html` | Шаблон списка постов |
|
|
|
|
### Переводы (i18n)
|
|
|
|
| Файл | Назначение |
|
|
|------|------------|
|
|
| `i18n/ru.yaml` | Русские переводы интерфейса |
|
|
|
|
---
|
|
|
|
## 🎯 Точки расширения
|
|
|
|
### 1. Переопределение шаблонов
|
|
|
|
Создайте файл с тем же путём в вашем проекте:
|
|
```
|
|
ваш-проект/
|
|
└── layouts/
|
|
└── partials/
|
|
└── header.html # Переопределит шаблон темы
|
|
```
|
|
|
|
### 2. Расширение через partials
|
|
|
|
- `layouts/partials/extend_head.html` — добавится в `<head>`
|
|
- `layouts/partials/extend_footer.html` — добавится в footer
|
|
|
|
### 3. Кастомные CSS
|
|
|
|
- `assets/css/extended/blank.css` — ваши стили подключаются автоматически
|
|
|
|
---
|
|
|
|
## 📝 История изменений темы rDedInit
|
|
|
|
| Дата | Версия | Изменения |
|
|
|------|--------|-----------|
|
|
| 27.02.2026 | 1.0.0 | Initial fork на базе PaperMod |
|
|
|
|
---
|
|
|
|
## 🔗 Полезные ссылки
|
|
|
|
- [Документация Hugo](https://gohugo.io/documentation/)
|
|
- [Документация PaperMod](https://github.com/adityatelange/hugo-PaperMod/wiki)
|
|
- [Шаблоны Hugo](https://gohugo.io/templates/introduction/)
|
|
- [CSS-переменные темы](https://github.com/adityatelange/hugo-PaperMod/wiki/Variables)
|
|
|
|
---
|
|
|
|
## 📌 Примечания
|
|
|
|
> ⚠️ **Не редактируйте файлы в `public/`** — они генерируются автоматически при сборке.
|
|
|
|
> 💡 **Для кастомизации используйте:**
|
|
> - `assets/css/extended/blank.css` для стилей
|
|
> - `layouts/partials/extend_*.html` для расширения шаблонов
|
|
> - Переопределение файлов темы в проекте для глубоких изменений
|