# Как работать в $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. ![](https://2423068839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeQCEDjTcBt8BDKqrc9q%2Fuploads%2FgcklqkVpKEfsctYxNOBZ%2Fimage.png?alt=media\&token=89aca619-d519-4393-a821-accd8a703fec) Создание секрета для репозитория
6. ![](https://2423068839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeQCEDjTcBt8BDKqrc9q%2Fuploads%2FceYWHNToitHQPzXb1yah%2Fimage.png?alt=media\&token=d7c45b92-1b21-4b85-bc2c-655773a41978) <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>