From a3abb2a97185fb852de3de18335ebeeb887dede0 Mon Sep 17 00:00:00 2001 From: Vladimir Eremin Date: Mon, 26 Jan 2026 01:37:10 +0300 Subject: [PATCH] docs: Update docs structure for the monorepo setup --- services/docs/content/en/_index.md | 13 +++--- services/docs/content/en/root/_index.md | 12 +++++ .../content/en/{ => root}/recipes/_index.md | 4 +- .../en/{ => root}/recipes/initial-setup.md | 0 services/docs/content/ru/_index.md | 13 +++--- services/docs/content/ru/root/_index.md | 12 +++++ .../content/ru/{ => root}/recipes/_index.md | 2 +- .../ru/{ => root}/recipes/xray-setup.md | 0 services/docs/hugo.yaml | 44 +++++-------------- 9 files changed, 49 insertions(+), 51 deletions(-) create mode 100644 services/docs/content/en/root/_index.md rename services/docs/content/en/{ => root}/recipes/_index.md (80%) rename services/docs/content/en/{ => root}/recipes/initial-setup.md (100%) create mode 100644 services/docs/content/ru/root/_index.md rename services/docs/content/ru/{ => root}/recipes/_index.md (87%) rename services/docs/content/ru/{ => root}/recipes/xray-setup.md (100%) diff --git a/services/docs/content/en/_index.md b/services/docs/content/en/_index.md index caf7832..24b220f 100644 --- a/services/docs/content/en/_index.md +++ b/services/docs/content/en/_index.md @@ -1,12 +1,11 @@ --- -title: "Ermnvldmr Root Documentation" -description: "Documentation for the root.ermnvldmr.com infrastructure" -type: docs +title: "ermnvldmr.com Documentation" --- -Various notes made during the development of personal infrastructure. +# Documentation Portal -## Sections +Welcome to the unified documentation for ermnvldmr.com services and infrastructure. -- **[Recipes](/recipes/)** -- Step-by-step instructions, -that I don't want to remember each time I need one. +{{< cards >}} + {{< card link="root" title="root.ermnvldmr.com" icon="server" subtitle="Documentation for root.ermnvldmr.com infrastructure" >}} +{{< /cards >}} diff --git a/services/docs/content/en/root/_index.md b/services/docs/content/en/root/_index.md new file mode 100644 index 0000000..062110b --- /dev/null +++ b/services/docs/content/en/root/_index.md @@ -0,0 +1,12 @@ +--- +title: "root.ermnvldmr.com" +description: "Documentation for the root.ermnvldmr.com infrastructure" +type: docs +--- + +Various notes made during the development of personal infrastructure. + +## Sections + +- **[Recipes](recipes/)** -- Step-by-step instructions, +that I don't want to remember each time I need one. diff --git a/services/docs/content/en/recipes/_index.md b/services/docs/content/en/root/recipes/_index.md similarity index 80% rename from services/docs/content/en/recipes/_index.md rename to services/docs/content/en/root/recipes/_index.md index e402a35..0f6e653 100644 --- a/services/docs/content/en/recipes/_index.md +++ b/services/docs/content/en/root/recipes/_index.md @@ -10,11 +10,11 @@ that I don't want to remember each time I need one. ## What's in here -### [Initial Host Setup](/recipes/initial-setup) (EN only) +### [Initial Host Setup](initial-setup/) (EN only) Setting up a new host on Debian from scratch. -### [Xray Client Setup](/ru/recipes/xray-setup) (RU only) +### [Xray Client Setup](/ru/root/recipes/xray-setup/) (RU only) Setting up xray client without any further usage in mind. diff --git a/services/docs/content/en/recipes/initial-setup.md b/services/docs/content/en/root/recipes/initial-setup.md similarity index 100% rename from services/docs/content/en/recipes/initial-setup.md rename to services/docs/content/en/root/recipes/initial-setup.md diff --git a/services/docs/content/ru/_index.md b/services/docs/content/ru/_index.md index eb4b2ed..0065c9b 100644 --- a/services/docs/content/ru/_index.md +++ b/services/docs/content/ru/_index.md @@ -1,12 +1,11 @@ --- -title: "root.ermnvldmr.com" -description: "Документация к инфраструктуре root.ermnvldmr.com" -type: docs +title: "Документация ermnvldmr.com" --- -Различные заметки, сделанные в процессе разработки этой инфраструктуры. +# Портал документации -## Разделы +Добро пожаловать в единую документацию сервисов и инфраструктуры ermnvldmr.com. -- **[Рецепты](/recipes/)** -- Пошаговые инструкции, -которые мне не хочется изобретать каждый раз снова. +{{< cards >}} + {{< card link="root" title="root.ermnvldmr.com" icon="server" subtitle="Документация инфраструктуры root.ermnvldmr.com" >}} +{{< /cards >}} diff --git a/services/docs/content/ru/root/_index.md b/services/docs/content/ru/root/_index.md new file mode 100644 index 0000000..9064a10 --- /dev/null +++ b/services/docs/content/ru/root/_index.md @@ -0,0 +1,12 @@ +--- +title: "root.ermnvldmr.com" +description: "Документация к инфраструктуре root.ermnvldmr.com" +type: docs +--- + +Различные заметки, сделанные в процессе разработки этой инфраструктуры. + +## Разделы + +- **[Рецепты](recipes/)** -- Пошаговые инструкции, +которые мне не хочется изобретать каждый раз снова. diff --git a/services/docs/content/ru/recipes/_index.md b/services/docs/content/ru/root/recipes/_index.md similarity index 87% rename from services/docs/content/ru/recipes/_index.md rename to services/docs/content/ru/root/recipes/_index.md index e5bb776..5b9f9b2 100644 --- a/services/docs/content/ru/recipes/_index.md +++ b/services/docs/content/ru/root/recipes/_index.md @@ -10,6 +10,6 @@ type: docs ## Что здесь -### [Настройка xray-клиента](/recipes/xray-setup) +### [Настройка xray-клиента](xray-setup/) Настройте xray-client без какого-либо дальнейшего предназначения. diff --git a/services/docs/content/ru/recipes/xray-setup.md b/services/docs/content/ru/root/recipes/xray-setup.md similarity index 100% rename from services/docs/content/ru/recipes/xray-setup.md rename to services/docs/content/ru/root/recipes/xray-setup.md diff --git a/services/docs/hugo.yaml b/services/docs/hugo.yaml index ac993c6..76306f2 100644 --- a/services/docs/hugo.yaml +++ b/services/docs/hugo.yaml @@ -1,32 +1,20 @@ -baseURL: 'https://docs.root.ermnvldmr.com' +baseURL: 'https://docs.ermnvldmr.com' defaultContentLanguage: 'en' defaultContentLanguageInSubdir: true -title: 'root.ermnvldmr.com' -description: 'Documentation for the root.ermnvldmr.com infrastructure' +title: 'ermnvldmr.com' +description: 'Documentation for ermnvldmr.com services and infrastructure' # Multilingual configuration languages: en: languageCode: 'en-us' languageName: 'English' - title: 'root.ermnvldmr.com' - description: 'Documentation for the root.ermnvldmr.com infrastructure' + title: 'ermnvldmr.com' + description: 'Documentation for ermnvldmr.com services and infrastructure' weight: 1 contentDir: 'content/en' menu: main: -# - name: Architecture -# url: /en/architecture/ -# weight: 10 -# - name: Operations -# url: /en/operations/ -# weight: 20 -# - name: Concepts -# url: /en/concepts/ -# weight: 30 - - name: Recipes - url: /en/recipes/ - weight: 40 - name: Search weight: 50 params: @@ -34,25 +22,13 @@ languages: ru: languageCode: 'ru' languageName: 'Русский' - title: 'root.ermnvldmr.com' - description: 'Документация для инфраструктуры root.ermnvldmr.com' + title: 'ermnvldmr.com' + description: 'Документация для сервисов и инфраструктуры ermnvldmr.com' weight: 2 contentDir: 'content/ru' menu: main: - - name: Архитектура - url: /ru/architecture/ - weight: 10 - - name: Операции - url: /ru/operations/ - weight: 20 - - name: Концепции - url: /ru/concepts/ - weight: 30 - - name: Рецепты - url: /ru/recipes/ - weight: 40 - - name: Поиск + - name: Search weight: 50 params: type: search @@ -64,7 +40,7 @@ enableGitInfo: true # Hextra theme parameters params: - description: "Documentation for the root.ermnvldmr.com infrastructure" + description: "Documentation for ermnvldmr.com services and infrastructure" # Search configuration search: @@ -94,7 +70,7 @@ params: # Edit page configuration editURL: enable: true - base: "https://github.com/deytenit/root.ermnvldmr.com/edit/trunk/docs/content" + base: "https://github.com/deytenit/www.ermnvldmr.com/edit/main/services/docs/content" page: width: wide