# 📁 Структура темы 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 # секция (мета-теги, стили) │ │ ├── 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 # Расширение (пустой по умолчанию) │ │ ├── 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` — добавится в `` - `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` для расширения шаблонов > - Переопределение файлов темы в проекте для глубоких изменений