> For the complete documentation index, see [llms.txt](https://lyumihs-organization.gitbook.io/mol-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lyumihs-organization.gitbook.io/mol-doc/faq/kak-rabotat-v-usdmol-s-git.md).

# Как работать в $mol с git?

<details>

<summary>Что нужно клонировать из git, чтобы начать разработку?</summary>

Нужно клонировать рабочее окружение и уже в нём начать работать.

```
git clone https://github.com/hyoo-ru/mam.git ./mam && cd mam
npm install && npm start
```

Подробнее тут: <https://mol.hyoo.ru/#!demo=mol_button_demo/bench=init/Description=Create%20MAM%20project>

</details>

<details>

<summary>Что такое монорепотозиторий и полирепозиторий?</summary>

Подробнее вы можете узнать [здесь](https://mol.hyoo.ru/#!section=articles/author=hyoo-ru/repo=HabHub/article=4/Articles.Datails_text=%D0%9C%D0%BE%D0%BD%D0%BE%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%B8%20%D0%B8%20%D0%BF%D0%BE%D0%BB%D0%B8%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%B8) .\
МАМ поддерживает работу с этими 2 типами репозиториев и предоставляет свои команды npm для работы с ними.

Также можно для лучшего понимания видов репозиториев можно посмотреть данный сайт <https://monorepo.tools/>

</details>

<details>

<summary>Как установить какой-либо модуль, проект?</summary>

Для установки какого-либо модуля в mam достаточно команды

```
yarn start hyoo/app
```

Эта команда установит данную версию модуля в деррикторию mam и все зависимости к нему. <https://github.com/hyoo-ru/apps.hyoo.ru>\
\
Подробнее можете прочитать [здесь](https://mol.hyoo.ru/#!section=articles/author=hyoo-ru/repo=HabHub/article=4/Articles.Datails_text=%D0%9C%D0%BE%D0%BD%D0%BE%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%B8%20%D0%B8%20%D0%BF%D0%BE%D0%BB%D0%B8%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%B8)<br>

</details>

<details>

<summary>Как выложить свой модуль на GitHub Pages?</summary>

Для мола есть инструкция по автоматическому разворачивавнию своего проекта на GitHub Pages.

1. Нужно идти по инструкции в разделе  [Развертывание приложения на Github Pages](https://mol.hyoo.ru/#!section=articles/author=hyoo-ru/repo=HabHub/article=4/Articles.Datails_text=%D0%A0%D0%B0%D0%B7%D0%B2%D0%B5%D1%80%D1%82%D1%8B%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%20%D0%BD%D0%B0%20Github%20Pages)
2. Нужно правильно в настройках GitHub создать токен, дать токену права на пуш в репозитории и добавить секрет к самому репозиторию с проектом.
3. Если не получается самостоятельно, то лучше написать в чат <https://t.me/mam_mol> и спросить по токену. Это занимает 3 минуты, если знаешь как настроить)
4. <https://github.com/Lyumih/analitics-example/blob/main/.github/workflows/deploy.yml> Вот пример созданого файла для развертывания в примере
5. ![](/files/8zJM9hV9IHjoZaCAEs2r) Создание секрета для репозитория
6. ![](/files/c4AiDytZJmNkOwJv1kSc) <https://github.com/settings/tokens> создание токена. Не забудьте выдать правильные права на пуш!

</details>

<details>

<summary>Как работать с  Fork-ом модуля?</summary>

Fork - это копия репозитория, через который вы можете независимо вносить изменения в своём репозитории и потом создавать Pull Requests для внесения этих изменений в основной репозиторий модуля.\
Вы можете ознакомиться с данной темой здесь: <https://www.atlassian.com/ru/git/tutorials/syncing>

Или здесь : <https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks> . Прочтите все разделы Working with fork - это ответит на большинство вопрос связанных с работой fork<br>

</details>