📁 Структура темы 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

🔗 Полезные ссылки

📌 Примечания

⚠️ Не редактируйте файлы в public/ — они генерируются автоматически при сборке.

💡 Для кастомизации используйте:

assets/css/extended/blank.css для стилей

layouts/partials/extend_*.html для расширения шаблонов

Переопределение файлов темы в проекте для глубоких изменений

10 KiB Raw Blame History