From d0c4ea2766ac405df37cfe9fef2e62656a68af63 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=A0=D0=B5=D1=87=D0=BA=D0=B8=D0=BD=D0=B0=20=D0=95=D0=BB?= =?UTF-8?q?=D0=B5=D0=BD=D0=B0=20=D0=92=D0=B0=D0=BB=D0=B5=D1=80=D1=8C=D0=B5?= =?UTF-8?q?=D0=B2=D0=BD=D0=B0?= Date: Tue, 27 May 2025 11:55:48 +0000 Subject: [PATCH] Edit CONTRIBUTING.md --- CONTRIBUTING.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 08dac4f..ea3d869 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -49,16 +49,30 @@ - Текстовый редактор с поддержкой синтаксиса `markdown`. Рекомендуется использовать VSCode. 1. Клонируйте репозиторий в директорию на вашем компьютере. -2. Откройте содержимое директории проекта в редакторе. +2. Откройте репозиторий в VSCode. 3. В VSCode откройте терминал. 4. Установите `npm` командой: ```sh npm install ``` - Данный шаг выполняется единожды, чтобы установить `npm` в директории проекта для запуска сборки портала документации. + Данный шаг выполняется единожды, чтобы установить `npm` в репозитории для запуска сборки портала документации. 5. Запустите сборку документации командой в терминале: ```sh npm run dev ``` 6. В результате выполнения команды сформирована ссылка на портал документации вида: http://localhost:5173/docs/. Откройте ссылку в браузере для просмотра портала документации. Ссылка будет доступна только с вашего компьютера. + +### Вопросы и ответы + +**Не устанавливается `npm`** + +Если при выполнении команды `npm install` не проходит проверка сертификатов, то выполните следующее: + +1. В файл `.npmr` c самой первой строчкой добавить `cafile=VimpelcomCAG2.pem`. Файл `.npmr` должен выглядеть так: +```text +cafile=VimpelcomCAG2.pem +registry=https://nexus.vimpelcom.ru/repository/npm-all/ +``` +2. В корень репозитория положить файл сертификата `VimpelcomCAG2.pem`. Файл можно скачать: https://git.vimpelcom.ru/products/vega/frontend/-/blob/beecloud99/VimpelcomCAG2.pem?ref_type=heads. +3. Повторите установку `npm`. \ No newline at end of file