Initial project ALT Mobile Wiki

2024-04-02 08:50:25 +03:00 · 2024-04-02 08:50:25 +03:00 · cb8c9a2113
commit cb8c9a2113
parent e9def6667f
37 changed files with 2431 additions and 0 deletions
--- a/.gitignore
+++ b/.gitignore
@ -0,0 +1,3 @@
+node_modules
+.vitepress/dist
+.vitepress/cache
--- a/.vitepress/config.mts
+++ b/.vitepress/config.mts
@ -0,0 +1,69 @@
+import { defineConfig } from 'vitepress'
+import { nav, sidebar } from './data/navigations'
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+  title: "ALT Mobile Wiki",
+  titleTemplate: ':title — ALT Mobile Wiki',
+  description: "официальная библиотека знаний операционной системы ALT Mobile",
+  base: '/ALTMobileWiki/',
+  srcDir: './docs',
+  locales: {
+    root: {
+      label: 'Русский',
+      lang: 'ru',
+      themeConfig: {
+        nav: nav.root,
+        sidebar: sidebar.root,
+        docFooter: {
+          prev: 'Предыдущая страница',
+          next: 'Следующая страница'
+        },
+        editLink: {
+          pattern: 'https://github.com/OlegShchavelev/ALTRegularGnomeWiki/edit/main/docs/:path',
+          text: 'Предложить изменения на этой странице'
+        },
+        lastUpdated: {
+          text: 'Последнее обновление',
+          formatOptions: {
+            dateStyle: 'medium',
+            timeStyle: 'medium'
+          }
+        },
+        returnToTopLabel: 'Наверх',
+        sidebarMenuLabel: 'Меню',
+        outlineTitle: 'Оглавление',
+        notFound: {
+          title: 'Страница не найдена',
+          quote: 'Похоже, что вы перешли по неверной или устаревшей ссылке. Вы можете воспользоваться поиском.',
+          linkText: 'Вернуться на главную'
+        }
+      },
+    },
+    en: {
+      label: 'Английский',
+      lang: 'en',
+      themeConfig: {
+        nav: nav.en,
+        sidebar: sidebar.en
+      }
+    }
+  },
+  vite: {
+    ssr: {
+      noExternal: [
+        '@nolebase/vitepress-plugin-enhanced-readabilities',
+      ],
+    },
+  },
+  themeConfig: {
+    // https://vitepress.dev/reference/default-theme-config
+    logo: { src: '/logo.svg', width: 36, height: 36, alt: "ALT Mobile Wike" },
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/OlegShchavelev/ALTMobileWiki' }
+    ],
+    outline: {
+      level: [2, 3],
+    },
+  }
+})
--- a/.vitepress/data/contributions.ts
+++ b/.vitepress/data/contributions.ts
@ -0,0 +1,10 @@
+export const contributions = [
+    {
+      avatar: 'https://avatars.githubusercontent.com/u/20732384?v=4',
+      name: 'Олег Щавелев',
+      title: 'Разработчик',
+      links: [
+        { icon: 'github', link: 'https://github.com/OlegShchavelev' }
+      ]
+    },
+]
--- a/.vitepress/data/navigations.ts
+++ b/.vitepress/data/navigations.ts
@ -0,0 +1,65 @@
+export const nav = {
+    'root': [
+        { text: 'Главная', link: '/' },
+        { text: 'Документация', link: '/wiki/' },
+        {
+            text: 'О проекте', items: [
+                { text: 'О проекте', link: '/projects/about/' },
+                { text: 'Участники', link: '/projects/contributions/' }
+            ]
+        },
+    ],
+    'en': [
+        { text: 'Home', link: '/en/' },
+        { text: 'Documentation', link: '/en/wiki/' },
+        {
+            text: 'About project', items: [
+                { text: 'About project', link: '/en/projects/about/' },
+                { text: 'Contributions', link: '/en/projects/contributions/' }
+            ]
+        },
+    ]
+}
+
+export const sidebar = {
+    'root': [
+        {
+            items: [
+                {
+                    text: 'Установка и обновление', base: '/instalations', items: [
+                        { text: 'Загрузчик', link: '/booting/' },
+                        { text: 'ALT Mobile', link: '/alt-mobile/' }
+                    ],
+                    collapsed: true
+                }, {
+                    text: 'Програмное обеспечение', base: '/apps', items: [
+                        { text: 'Amberol', link: '/amberol/' }
+                    ],
+                    collapsed: true
+                }, {
+                    text: 'Популярные вопросы и ответы', link: '/faq/'
+                }]
+        }
+    ],
+    'en': [
+        {
+            base: '/en',
+            items: [
+                {
+                    text: 'Installation and update', base: '/en/instalations', items: [
+                        { text: 'The loader', link: '/booting/' },
+                        { text: 'ALT Mobile', link: '/alt-mobile/' }
+                    ],
+                    collapsed: true
+                }, {
+                    text: 'Software', base: '/en/apps', items: [
+                        { text: 'Amberol', link: '/amberol/' }
+                    ],
+                    collapsed: true
+                }, {
+                    text: 'Frequently asked questions', link: '/faq/'
+                }
+            ]
+        }
+    ],
+}
--- a/.vitepress/theme/components
+++ b/.vitepress/theme/components
@ -0,0 +1,38 @@
+<template>
+    <VPTeamPage>
+        <VPTeamPageTitle>
+            <template v-if="frontmatter.title" #title>
+                {{ frontmatter.title }}
+            </template>
+        </VPTeamPageTitle>
+        <VPTeamMembers :members="members" />
+    </VPTeamPage>
+</template>
+
+<script setup>
+import { contributions } from '../../data/contributions';
+
+import { VPTeamPage, VPTeamPageTitle, VPTeamMembers } from 'vitepress/theme';
+import { useData } from 'vitepress'
+const { frontmatter } = useData();
+
+const { members, size } = defineProps({
+    size: {
+        type: String,
+        default: 'medium',
+    },
+    members: {
+        type: Object,
+        default: () => {
+            return contributions ?? [];
+        },
+    },
+});
+
+</script>
+
+<style scoped>
+.VPTeamPage {
+    margin: 0;
+}
+</style>
--- a/.vitepress/theme/index.ts
+++ b/.vitepress/theme/index.ts
@ -0,0 +1,33 @@
+// https://vitepress.dev/guide/custom-theme
+import { h } from 'vue'
+import type { Theme } from 'vitepress'
+import DefaultTheme from 'vitepress/theme'
+
+import AMWTeamMembers from './components /AMWTeamMembers.vue'
+
+import {
+  NolebaseEnhancedReadabilitiesMenu,
+  NolebaseEnhancedReadabilitiesScreenMenu
+} from '@nolebase/vitepress-plugin-enhanced-readabilities'
+
+import type { Options } from '@nolebase/vitepress-plugin-enhanced-readabilities'
+import { InjectionKey } from '@nolebase/vitepress-plugin-enhanced-readabilities'
+import { options as NolebaseEnhancedReadabilitiesOptions } from './plugins/enhanced-readabilities/index'
+
+import './styles/style.css'
+import './styles/theme.css'
+import '@nolebase/vitepress-plugin-enhanced-readabilities/dist/style.css'
+
+export default {
+  extends: DefaultTheme,
+  Layout: () => {
+    return h(DefaultTheme.Layout, null, {
+      'nav-bar-content-after': () => h(NolebaseEnhancedReadabilitiesMenu), 
+      'nav-screen-content-after': () => h(NolebaseEnhancedReadabilitiesScreenMenu)
+    })
+  },
+  enhanceApp({ app, router, siteData }) {
+    app.provide(InjectionKey, NolebaseEnhancedReadabilitiesOptions as Options)
+    app.component('AMWTeamMembers', AMWTeamMembers);
+  }
+} satisfies Theme
--- a/.vitepress/theme/plugins/enhanced-readabilities/index.ts
+++ b/.vitepress/theme/plugins/enhanced-readabilities/index.ts
@ -0,0 +1,66 @@
+export const options = {
+    locales: {
+        'ru': {
+            title: {
+              title: 'Повышенная читаемость'
+            },
+            layoutSwitch: {
+              title: 'Измените внешний вид страницы',
+              titleHelpMessage: 'Измените стиль оформления ALT Gnome Wiki, выбирите максимально удобный вариант зависмости от размера вашего экрана и типа устройства.',
+              optionFullWidth: 'Полноэкранный',
+              optionFullWidthAriaLabel: 'Полноэкранный',
+              titleScreenNavWarningMessage: 'Изменить внешний вид страницы недоступен на экране мобильного устройства',
+              optionFullWidthHelpMessage: 'Боковая панель и область содержимого занимают всю ширину экрана.',
+              optionSidebarWidthAdjustableOnly: 'Боковая панель с пользовательской настройкой',
+              optionSidebarWidthAdjustableOnlyAriaLabel: 'Боковая панель с пользовательской настройкой',
+              optionSidebarWidthAdjustableOnlyHelpMessage: 'Увеличьте ширину боковой панели, максимальная ширина боковой панели может изменяться, но ширина области содержимого останется прежней.',
+              optionBothWidthAdjustable: 'Полноэрканный с пользовательской настройкой',
+              optionBothWidthAdjustableAriaLabel: 'Полноэрканный с пользовательской настройкой',
+              optionBothWidthAdjustableHelpMessage: 'Управляется шириной боковой панели, и шириной содержания документа. Настройте желаемую ширину максимальной ширины боковой панели и содержимого документа.',
+              optionOriginalWidth: 'Оригинальная ширина',
+              optionOriginalWidthAriaLabel: 'Оригинальная ширина',
+              optionOriginalWidthHelpMessage: 'Оригинальная ширина размера страницы, предусмотренная разработчиками VitePress',
+              pageLayoutMaxWidth: {
+                title: 'Измените максимальную ширину страницы',
+                titleAriaLabel: 'Измените максимальную ширину страницы',
+                titleHelpMessage: 'Отрегулируйте точное значение ширины страницы ALT Gnome Wiki, чтобы адаптироваться к различным потребностям чтения и экранам.',
+                titleScreenNavWarningMessage: 'Максимальная ширина макета страницы недоступна на экране мобильного устройства.',
+                slider: 'Отрегулируйте максимальную ширину страницы',
+                sliderAriaLabel: 'Отрегулируйте максимальную ширину страницы',
+                sliderHelpMessage: 'Расположенный ползунок, позволяющий пользователю выбирать и настраивать желаемую ширину страницы, может быть изменен в зависимости от размера вашего экрана.',
+              },
+              contentLayoutMaxWidth: {
+                title: 'Измените максимальную ширину содержания',
+                titleAriaLabel: 'Измените максимальную ширину содержания',
+                titleHelpMessage: 'Отрегулируйте точное значение ширины содержимого документа в макете ALT Gnome Wiki, чтобы адаптироваться к различным потребностям чтения и экранам.',
+                titleScreenNavWarningMessage: 'Максимальная ширина макета содержимого недоступна на экране мобильного устройства.',
+                slider: 'Отрегулируйте максимальную ширину содержимого',
+                sliderAriaLabel: 'Отрегулируйте максимальную ширину содержимого',
+                sliderHelpMessage: 'Расположенный ползунок, позволит пользователю выбирать и настраить желаемую ширину содержимого, может быть изменен в зависимости от размера вашего экрана.',
+              }
+            },
+            spotlight: {
+              title: 'Фокус',
+              titleAriaLabel: 'Фокус',
+              titleHelpMessage: 'Выделите строку, на которой в данный момент находится курсор мыши, в содержимом, для удобства пользователей, у которых могут возникнуть трудности с чтением и фокусировкой.',
+              titleScreenNavWarningMessage: 'Фокус недоступен на экране мобильного устройства.',
+              optionOn: 'Включить',
+              optionOnAriaLabel: 'Включить',
+              optionOnHelpMessage: 'Включите фокус.',
+              optionOff: 'Выключить',
+              optionOffAriaLabel: 'Выключить',
+              optionOffHelpMessage: 'Выключите фокус.',
+              styles: {
+                title: 'Стиль фокуса',
+                titleHelpMessage: 'Измените стиль фокуса(подсветки)',
+                optionUnder: 'Under',
+                optionUnderAriaLabel: 'Under',
+                optionUnderHelpMessage: 'Добавьте сплошной цвет фона под зависающим элементом, чтобы выделить место, где в данный момент находится курсор',
+                optionAside: 'Aside',
+                optionAsideAriaLabel: 'Aside',
+                optionAsideHelpMessage: 'Добавьте фиксированную линию сплошным цветом в сторону элемента наведения курсора, чтобы выделить место, где в данный момент находится курсор'
+              }
+            }
+          }
+    }
+} 
--- a/.vitepress/theme/styles/style.css
+++ b/.vitepress/theme/styles/style.css
@ -0,0 +1,139 @@
+/**
+ * Customize default theme styling by overriding CSS variables:
+ * https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/vars.css
+ */
+
+/**
+ * Colors
+ *
+ * Each colors have exact same color scale system with 3 levels of solid
+ * colors with different brightness, and 1 soft color.
+ * 
+ * - `XXX-1`: The most solid color used mainly for colored text. It must
+ *   satisfy the contrast ratio against when used on top of `XXX-soft`.
+ *
+ * - `XXX-2`: The color used mainly for hover state of the button.
+ *
+ * - `XXX-3`: The color for solid background, such as bg color of the button.
+ *   It must satisfy the contrast ratio with pure white (#ffffff) text on
+ *   top of it.
+ *
+ * - `XXX-soft`: The color used for subtle background such as custom container
+ *   or badges. It must satisfy the contrast ratio when putting `XXX-1` colors
+ *   on top of it.
+ *
+ *   The soft color must be semi transparent alpha channel. This is crucial
+ *   because it allows adding multiple "soft" colors on top of each other
+ *   to create a accent, such as when having inline code block inside
+ *   custom containers.
+ *
+ * - `default`: The color used purely for subtle indication without any
+ *   special meanings attched to it such as bg color for menu hover state.
+ *
+ * - `brand`: Used for primary brand colors, such as link text, button with
+ *   brand theme, etc.
+ *
+ * - `tip`: Used to indicate useful information. The default theme uses the
+ *   brand color for this by default.
+ *
+ * - `warning`: Used to indicate warning to the users. Used in custom
+ *   container, badges, etc.
+ *
+ * - `danger`: Used to show error, or dangerous message to the users. Used
+ *   in custom container, badges, etc.
+ * -------------------------------------------------------------------------- */
+
+ :root {
+  --vp-c-default-1: var(--vp-c-gray-1);
+  --vp-c-default-2: var(--vp-c-gray-2);
+  --vp-c-default-3: var(--vp-c-gray-3);
+  --vp-c-default-soft: var(--vp-c-gray-soft);
+
+  --vp-c-brand-1: var(--vp-c-indigo-1);
+  --vp-c-brand-2: var(--vp-c-indigo-2);
+  --vp-c-brand-3: var(--vp-c-indigo-3);
+  --vp-c-brand-soft: var(--vp-c-indigo-soft);
+
+  --vp-c-tip-1: var(--vp-c-brand-1);
+  --vp-c-tip-2: var(--vp-c-brand-2);
+  --vp-c-tip-3: var(--vp-c-brand-3);
+  --vp-c-tip-soft: var(--vp-c-brand-soft);
+
+  --vp-c-warning-1: var(--vp-c-yellow-1);
+  --vp-c-warning-2: var(--vp-c-yellow-2);
+  --vp-c-warning-3: var(--vp-c-yellow-3);
+  --vp-c-warning-soft: var(--vp-c-yellow-soft);
+
+  --vp-c-danger-1: var(--vp-c-red-1);
+  --vp-c-danger-2: var(--vp-c-red-2);
+  --vp-c-danger-3: var(--vp-c-red-3);
+  --vp-c-danger-soft: var(--vp-c-red-soft);
+}
+
+/**
+ * Component: Button
+ * -------------------------------------------------------------------------- */
+
+:root {
+  --vp-button-brand-border: transparent;
+  --vp-button-brand-text: var(--vp-c-white);
+  --vp-button-brand-bg: var(--vp-c-brand-3);
+  --vp-button-brand-hover-border: transparent;
+  --vp-button-brand-hover-text: var(--vp-c-white);
+  --vp-button-brand-hover-bg: var(--vp-c-brand-2);
+  --vp-button-brand-active-border: transparent;
+  --vp-button-brand-active-text: var(--vp-c-white);
+  --vp-button-brand-active-bg: var(--vp-c-brand-1);
+}
+
+/**
+ * Component: Home
+ * -------------------------------------------------------------------------- */
+
+:root {
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: -webkit-linear-gradient(
+    120deg,
+    #bd34fe 30%,
+    #41d1ff
+  );
+
+  --vp-home-hero-image-background-image: linear-gradient(
+    -45deg,
+    #bd34fe 50%,
+    #47caff 50%
+  );
+  --vp-home-hero-image-filter: blur(44px);
+}
+
+@media (min-width: 640px) {
+  :root {
+    --vp-home-hero-image-filter: blur(56px);
+  }
+}
+
+@media (min-width: 960px) {
+  :root {
+    --vp-home-hero-image-filter: blur(68px);
+  }
+}
+
+/**
+ * Component: Custom Block
+ * -------------------------------------------------------------------------- */
+
+:root {
+  --vp-custom-block-tip-border: transparent;
+  --vp-custom-block-tip-text: var(--vp-c-text-1);
+  --vp-custom-block-tip-bg: var(--vp-c-brand-soft);
+  --vp-custom-block-tip-code-bg: var(--vp-c-brand-soft);
+}
+
+/**
+ * Component: Algolia
+ * -------------------------------------------------------------------------- */
+
+.DocSearch {
+  --docsearch-primary-color: var(--vp-c-brand-1) !important;
+}
+
--- a/.vitepress/theme/styles/theme.css
+++ b/.vitepress/theme/styles/theme.css
@ -0,0 +1,104 @@
+@import url('https://fonts.googleapis.com/css2?family=Manrope:wght@400;500;800&display=swap');
+
+
+:root {
+    --vp-nav-logo-height: 36px;
+    --vp-font-family-base: 'Manrope', sans-serif;
+}
+
+/**
+ * Colors
+ * -------------------------------------------------------------------------- */
+
+:root {
+
+    --vp-c-blue: #3584e4;
+    --vp-c-blue-light: #62a0ea;
+    --vp-c-blue-lighter: #99c1f1;
+    --vp-c-blue-dark: #1c71d8;
+    --vp-c-blue-darker: #1a5fb4;
+    --vp-c-blue-dimm-1: rgba(53, 132, 228, 0.05);
+    --vp-c-blue-dimm-2: rgba(53, 132, 228, 0.2);
+    --vp-c-blue-dimm-3: rgba(53, 132, 228, 0.5);
+
+    --vp-c-green: #33d17a;
+    --vp-c-green-light: #57e389;
+    --vp-c-green-lighter: #8ff0a4;
+    --vp-c-green-dark: #2ec27e;
+    --vp-c-green-darker: #26a269;
+    --vp-c-green-dimm-1: rgba(51, 209, 122, 0.05);
+    --vp-c-green-dimm-2: rgba(51, 209, 122, 0.2);
+    --vp-c-green-dimm-3: rgba(51, 209, 122, 0.5);
+
+    --vp-c-yellow: #f6d32d;
+    --vp-c-yellow-light: #f8e45c;
+    --vp-c-yellow-lighter: #f9f06b;
+    --vp-c-yellow-dark: #f5c211;
+    --vp-c-yellow-darker: #e5a50a;
+    --vp-c-yellow-dimm-1: rgba(246, 211, 45, 0.05);
+    --vp-c-yellow-dimm-2: rgba(246, 211, 45, 0.2);
+    --vp-c-yellow-dimm-3: rgba(246, 211, 45, 0.5);
+
+    --vp-c-orange: #ff6600;
+    --vp-c-orange-light: #ff8533;
+    --vp-c-orange-lighter: #ff9966;
+    --vp-c-orange-dark: #e65c00;
+    --vp-c-orange-darker: #cc5200;
+    --vp-c-orange-dimm-1: rgba(255, 102, 0, 0.05);
+    --vp-c-orange-dimm-2: rgba(255, 102, 0, 0.2);
+    --vp-c-orange-dimm-3: rgba(255, 102, 0, 0.5);
+
+    --vp-c-red: #e01b24;
+    --vp-c-red-light: #ed333b;
+    --vp-c-red-lighter: #f66151;
+    --vp-c-red-dark: #c01c28;
+    --vp-c-red-darker: #a51d2d;
+    --vp-c-red-dimm-1: rgba(224, 27, 36, 0.05);
+    --vp-c-red-dimm-2: rgba(224, 27, 36, 0.2);
+    --vp-c-red-dimm-3: rgba(224, 27, 36, 0.5);
+}
+
+/**
+ * Component: Home
+ * -------------------------------------------------------------------------- */
+
+:root {
+    --vp-home-hero-name-color: transparent;
+    --vp-home-hero-name-background: -webkit-linear-gradient(120deg,
+            #c061cb 30%,
+            #62a0ea);
+
+    --vp-home-hero-image-background-image: linear-gradient(-45deg,
+            #c061cb 50%,
+            #62a0ea 50%);
+    --vp-home-hero-image-filter: blur(40px);
+}
+
+/**
+ * Custom block
+ * -------------------------------------------------------------------------- */
+
+.custom-block {
+    border: 4px solid transparent;
+}
+
+:root {
+    --vp-custom-block-info-border: var(--vp-c-blue-dimm-2);
+    --vp-custom-block-info-bg: var(--vp-c-blue-dimm-1);
+    --vp-custom-block-info-text: var(--vp-c-neutral);
+
+    --vp-custom-block-tip-border: var(--vp-c-green-dimm-2);
+    --vp-custom-block-tip-bg: var(--vp-c-green-dimm-1);
+    --vp-custom-block-tip-text: var(--vp-c-neutral);
+
+    --vp-custom-block-warning-border: var(--vp-c-yellow-dimm-2);
+    --vp-custom-block-warning-bg: var(--vp-c-yellow-dimm-1);
+    --vp-custom-block-warning-text: var(--vp-c-neutral);
+
+    --vp-custom-block-danger-border: var(--vp-c-red-dimm-2);
+    --vp-custom-block-danger-bg: var(--vp-c-red-dimm-1);
+    --vp-custom-block-danger-text: var(--vp-c-neutral);
+
+    --vp-custom-block-details-border: var(--vp-c-divider);
+    --vp-custom-block-details-bg: var(--vp-c-bg-soft-up);
+}
--- a/docs/apps/amberol/index.md
+++ b/docs/apps/amberol/index.md
@ -0,0 +1,36 @@
+---
+appstream: 
+    id: io.bassi.Amberol
+    name: Amberol
+---
+
+# Amberol
+
+Amberol стремится быть максимально компактным, ненавязчивым и простым. Он не управляет вашей музыкальной коллекцией, не позволяет вам управлять плейлистами, не позволяет вам редактировать метаданные для ваших песен, не показывает вам тексты ваших песен.
+
+Amberol воспроизводит музыку и ничего больше.
+
+## Установка из репозитория
+
+Существует несколько способов установки Amberol на ALT Mobile:
+
+<!--@include: @apps/parts/install/software-repo.md-->
+
+**Установка через терминал**
+
+Ввод терминальных команд осуществляется через вириртуальный терминал Консоль или через удаленное подключение по протоколу SSH:
+
+```shell
+su -
+apt-get install amberoll
+```
+
+## Установка c помощью Flatpak
+
+При наличии пакета Flatpak, можно установить Amberol одной командой. Ввод терминальных команд осуществляется через вириртуальный терминал Консоль или через удаленное подключение по протоколу SSH:
+
+```shell
+flatpak install io.bassi.Amberol
+```
+
+<!--@include: @apps/parts/install/software-flatpak.md-->
--- a/docs/apps/parts/install/software-flatpak.md
+++ b/docs/apps/parts/install/software-flatpak.md
@ -0,0 +1,3 @@
+:::tip Удобнее через Центр приложений :thinking:
+Перейдите по ссылке для <a :href="'appstream://' + $frontmatter?.appstream?.id">установки {{ $frontmatter?.appstream?.name }}</a>, затем в браузере подтвердите операцию «открыть приложение». После этого откроется Центр приложений, выберите в нём источник **«Flathub»** и нажмите кнопку «скачать»
+::: 
--- a/docs/apps/parts/install/software-repo.md
+++ b/docs/apps/parts/install/software-repo.md
@ -0,0 +1,6 @@
+
+**Установка с помощью Центра приложений**
+
+:::info В три клика :blush:
+Перейдите по ссылке <a :href="'appstream://' + $frontmatter?.appstream?.id">установить {{ $frontmatter?.appstream?.name }}</a> и подтвердите в браузере операцию «открыть приложение» Откроется Центр приложений, выберите в нём cоответствующий источник, и нажмите кнопку «скачать»
+::: 
--- a/docs/download/index.md
+++ b/docs/download/index.md
@ -0,0 +1,3 @@
+# Скачать ALT Mobile
+
+<!--@include: @parts/blocks/constructing.md-->
--- a/docs/en/apps/amberol/index.md
+++ b/docs/en/apps/amberol/index.md
@ -0,0 +1,36 @@
+---
+appstream: 
+    id: io.bassi.Amberol
+    name: Amberol
+---
+
+# Amberol
+
+Amberol strives to be as compact, unobtrusive and simple as possible. It does not manage your music collection, does not allow you to manage playlists, does not allow you to edit metadata for your songs, does not show you the lyrics of your songs.
+
+Amberol plays music and nothing else.
+
+## Installation from the repository
+
+There are several ways to install Amberol on ALT Mobile:
+
+<!--@include: @en/apps/parts/install/software-repo.md-->
+
+**Installation via the terminal**
+
+The execution of terminal commands is carried out through a virtual terminal Console or through a remote SSH connection:
+
+```shell
+su -
+apt-get install amberol
+```
+
+## Installation using Flatpak
+
+If you have the Flatpak package, you can install Amberol with one command. Terminal commands are entered via the virtual terminal Console or via a remote SSH connection:
+
+```shell
+flatpak install io.bassi.Amberol
+```
+
+<!--@include: @en/apps/parts/install/software-flatpak.md-->
--- a/docs/en/apps/parts/install/software-flatpak.md
+++ b/docs/en/apps/parts/install/software-flatpak.md
@ -0,0 +1,3 @@
+:::tip Through the Application Center :thinking:
+Follow the link for <a :href="'appstream://' + $frontmatter?.appstream?.id">install {{$frontmatter?.appstream?.name }}</a>, then confirm the "open application" operation in the browser. After that, the Application Center opens, select the source **"Flathub"** in it and click the "download" button
+::: 
--- a/docs/en/apps/parts/install/software-repo.md
+++ b/docs/en/apps/parts/install/software-repo.md
@ -0,0 +1,5 @@
+**Installation using the Application Center**
+
+:::info In three clicks :blush:
+Follow the link <a :href="'appstream://' + $frontmatter?.appstream?.id">install {{$frontmatter?.appstream?.name }}</a> and confirm the "open application" operation in the browser, the Application Center will open, select the appropriate source in it, and click the "download" button
+::: 
--- a/docs/en/download/index.md
+++ b/docs/en/download/index.md
@ -0,0 +1,3 @@
+# Download ALT Mobile
+
+<!--@include: @en/parts/blocks/constructing.md-->
--- a/docs/en/faq/index.md
+++ b/docs/en/faq/index.md
@ -0,0 +1,13 @@
+# Frequently asked questions
+
+## Basic information
+
+### I found a bug in the program. How do I report it?
+
+You need to create a ticket in [ALT Linux BugZilla](https://bugzilla.altlinux.org) for the problematic component and describe in detail the essence of the problem. If necessary, developers can request more detailed information, as well as logs of the system.
+
+## Package manager and package installation
+
+### Which package manager is used in ALT Mobile
+
+By default, the package manager **apt** is used
--- a/docs/en/index.md
+++ b/docs/en/index.md
@ -0,0 +1,24 @@
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+title: Main
+hero:
+  name: "ALT Mobile Wiki"
+  tagline: the official knowledge library of the ALT Mobile operating system
+  actions:
+    - theme: brand
+      text: Download
+      link: /en/download/
+    - theme: alt
+      text: Documentation
+      link: /en/wiki/
+
+features:
+  - title: Feature A
+    details: Lorem ipsum dolor sit amet, consectetur adipiscing elit
+  - title: Feature B
+    details: Lorem ipsum dolor sit amet, consectetur adipiscing elit
+  - title: Feature C
+    details: Lorem ipsum dolor sit amet, consectetur adipiscing elit
+---
+
--- a/docs/en/instalations/alt-mobile/index.md
+++ b/docs/en/instalations/alt-mobile/index.md
@ -0,0 +1,7 @@
+# Instalition ALT Mobile
+
+<!--@include: @en/parts/blocks/constructing.md-->
+
+## Installation ALT Mobile on Pinephone / Pinephone Pro
+
+<!--@include: @en/parts/blocks/constructing.md-->
--- a/docs/en/instalations/booting/index.md
+++ b/docs/en/instalations/booting/index.md
@ -0,0 +1,7 @@
+# Installing or update loader
+
+<!--@include: @en/parts/blocks/constructing.md-->
+
+## Installing Tow-Boot
+
+<!--@include: @en/parts/blocks/constructing.md-->
--- a/docs/en/parts/blocks/constructing.md
+++ b/docs/en/parts/blocks/constructing.md
@ -0,0 +1,3 @@
+:::warning 🚧 Constructing
+Nice to meet you! But sorry, this page is still under construction. If you don’t find the information you are interested in, you can first find the content you are interested in in the navigation in the sidebar to start reading.
+:::
--- a/docs/en/projects/about/index.md
+++ b/docs/en/projects/about/index.md
@ -0,0 +1,15 @@
+# About the project
+
+We present to your attention the documentation of **ALT Mobile**.
+
+This is an Open Source project hosted on GitHub. Such placement allows everyone to supplement the pages of the "Documentation", make forks, clone the project, saving and changing it to their liking.
+
+## The principle of operation
+
+**ALT Mobile Wiki** runs on VitePress technology. These are static text files with the md extension, with some "beautifying" additions from VitePress. Unlike the "dry" markup language md, we get the opportunity to place emoticons, highlight and focus on important code elements, add beautiful colored Warning blocks and many more delicious and bright things.
+
+The documentation portal is linked to our GitHub repository. Offer your edits in the form of a Pull Request and after approval they will instantly appear on the site.
+
+## Authors and participants of the project
+
+The project **ALT Mobile Wiki** belongs to the Russian-speaking community **ALT Linux Team**, is developed and maintained on a voluntary basis. Each of the community members is an equal co-owner of the project and makes their own contribution.
--- a/docs/en/projects/contributions/index.md
+++ b/docs/en/projects/contributions/index.md
@ -0,0 +1,6 @@
+---
+layout: page
+title: Contributions
+---
+
+<AMWTeamMembers />
--- a/docs/en/wiki/index.md
+++ b/docs/en/wiki/index.md
@ -0,0 +1,3 @@
+# Documentation
+
+<!--@include: ./../parts/blocks/constructing.md-->
--- a/docs/faq/index.md
+++ b/docs/faq/index.md
@ -0,0 +1,13 @@
+# Популярные вопросы и ответы
+
+## Основная информация
+
+### Я нашёл ошибку в программе. Как мне сообщить о ней?
+
+Необходимо создать тикет в [ALT Linux BugZilla](https://bugzilla.altlinux.org/) для проблемного компонента и подробно описать суть возникшей проблемы. При необходимости разработчики могут запросить более подробную информацию, а также журналы работы системы.
+
+## Пакетный менеджер и установка пакетов
+
+### Какой менеджер пакетов используется в ALT Mobile
+
+По-умолчанию, используется пакетный менеджер **apt**
--- a/docs/index.md
+++ b/docs/index.md
@ -0,0 +1,24 @@
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+title: Главная
+hero:
+  name: "ALT Mobile Wiki"
+  tagline: официальная библиотека знаний операционной системы ALT Mobile
+  actions:
+    - theme: brand
+      text: Cкачать
+      link: /download/
+    - theme: alt
+      text: Документация
+      link: /wiki/
+
+features:
+  - title: Преимущество A
+    details: Пользователь очень важен, за пользователем последует пользователь
+  - title: Преимущество B
+    details: Пользователь очень важен, за пользователем последует пользователь
+  - title: Преимущество C
+    details: Пользователь очень важен, за пользователем последует пользователь
+---
+
--- a/docs/instalations/alt-mobile/index.md
+++ b/docs/instalations/alt-mobile/index.md
@ -0,0 +1,7 @@
+# Установка ALT Mobile
+
+<!--@include: @parts/blocks/constructing.md-->
+
+## Установка ALT Mobile на Pinephone / Pinephone Pro
+
+<!--@include: @parts/blocks/constructing.md-->
--- a/docs/instalations/booting/index.md
+++ b/docs/instalations/booting/index.md
@ -0,0 +1,7 @@
+# Загрузчик
+
+<!--@include: @parts/blocks/constructing.md-->
+
+## Установка Tow-Boot
+
+<!--@include: @parts/blocks/constructing.md-->
--- a/docs/parts/blocks/constructing.md
+++ b/docs/parts/blocks/constructing.md
@ -0,0 +1,3 @@
+:::warning 🚧 В разарботке
+К сожалению, эта страница еще находится в разработке. Если вы не нашли нужную информацию, вы можете воспользоваться меню навигации на боковой панели, чтобы начать чтение.
+:::
--- a/docs/projects/about/index.md
+++ b/docs/projects/about/index.md
@ -0,0 +1,15 @@
+# О проекте
+
+Представляем вашему вниманию документацию **ALT Mobile**.
+
+Это Open Source проект, размещенный на GitHub. Такое размещение, позволяет каждому дополнять страницы «Документации», делать форки, клонировать проект, сохраняя и изменяя по своему вкусу.
+
+## Принцип работы
+
+**ALT Mobile Wiki** работает на технологии VitePress. Это статичные текстовые файлы, c расширением md, с некоторыми «украшающими» добавками от VitePress. В отличии от «сухого» языка разметки md - мы получаем возможности размещать смайлики, подсвечивать и фокусироваться на важных элементах кода, добавлять красивые цветные Warning-блоки и еще много вкусного и яркого.
+
+Портал с документацией связан с нашим GitHub репозиторием. Предлагайте Ваши правки в виде Pull Request и после одобрения они мгновенно окажутся на сайте.
+
+## Авторы и участники проекта
+
+Проект **ALT Mobile Wiki** принадлежит русскоязычному сообществу  **ALT Linux Team**, разрабатывается и поддерживается на добровольной основе. Каждый из участников сообщества является равноправным совладельцем проекта и вносит свой посильный вклад.
--- a/docs/projects/contributions/index.md
+++ b/docs/projects/contributions/index.md
@ -0,0 +1,6 @@
+---
+layout: page
+title: Участники
+---
+
+<AMWTeamMembers />
--- a/docs/public/logo.svg
+++ b/docs/public/logo.svg
--- a/docs/public/robots.txt
+++ b/docs/public/robots.txt
@ -0,0 +1,2 @@
+User-agent: *
+Disallow: /
--- a/docs/wiki/index.md
+++ b/docs/wiki/index.md
@ -0,0 +1,3 @@
+# Документация
+
+<!--@include: @parts/blocks/constructing.md-->
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@ -0,0 +1,11 @@
+{
+  "devDependencies": {
+    "@nolebase/vitepress-plugin-enhanced-readabilities": "^1.27.2",
+    "vitepress": "^1.0.2"
+  },
+  "scripts": {
+    "docs:dev": "vitepress dev",
+    "docs:build": "vitepress build",
+    "docs:preview": "vitepress preview"
+  }
+}