Настройки проекта


Основное

В настройках можно изменить все параметры, которые были указаны при создании проекта. Доступ к настройкам проекта имеет только владелец, либо назначенный администратор

Редактирование проекта

Также имеются дополнительные поля, которые можно заполнить, например, вы можете указать связанный с проектом сайт.

Сайт проекта

Вы можете изменить Url вашего проекта, однако старый адрес после сохранения перестанет работать. Не изменяйте адрес проекта, если не уверены в последствиях.

URL проекта

Чтобы изменить видимость проекта, нажмите на указанную кнопку. В открывшемся окне измените параметр видимости проекта и введите контрольную строку для подтверждения действия (ее можно скопировать и вставить).

Смена видимости проекта

Передача проекта происходит аналогично процессу смены видимости и требует ввода фразы для подтверждения действия, однако, для передачи проекта новый владелец должен быть участником проекта с правами владельца.

Передача проекта

Управление доступом

Для добавления новых участников проекта откройте вкладку управления доступом. Для поиска пользователя, которого вы собираетесь добавить, нажмите на поле “Пользователь”, откроется выпадающее меню с поиском. Начните вводить имя пользователя или имя профиля, поиск начнется после ввода не менее 3 символов. Далее укажите роль для нового участника вашего проекта. Для удаления пользователей из списка участников, напротив имени пользователя нажмите на кнопку удаления.

Общий доступ проекта

Ветки

Вы можете настроить ветки проекта по умолчанию для вашего проекта. “Стандартная ветка проекта”" - это ветка, которая будет отображена при просмотре проекта. “Рабочая ветка проекта”" - это ветка в которую будут загружаться изменения по умолчанию, если не указана какая-либо другая ветка.

Ветки проекта

Запросы на слияние. Одобрение ответственным

Настройка
  • Данная функция доступна только в Enterprise версии Для активации функции перейдите в настройки проекта, откройте вкладку Запросы на слияние

Для добавления нового правила для одобрения запросов нажмите “Добавить правило”.

approvers

Укажите название для правила, далее выберете ответственных, от которых необходимо подтверждение для слития запроса на слияние. В селекторе “Целевая ветка” необходимо выбрать ветку проекта, для которой будет работать данное правило, например, если выбрать ветку master, то при слитии в данную ветку будет работать данное правило. В поле “Минимальное количество одобрений” введите число одобрений, достаточных для того, чтобы считать запрос на слияние доступным для слияния. Если нет необходимости ожидать одобрения от всех ответственных разработчиков, то можно указать число меньшее, чем количество ответственных в правиле. Нажмите “Добавить правило” для сохранения изменений. Вы можете внести изменения или удалить существующее правило соответствующими кнопками редактирования и удаления. Если вы укажите несколько правил на одну ветку, то необходимо выполнения каждого из этих правил.

Использование

При активном правиле работает ограничение к запросам на слияние, более невозможно слить изменения в ветку, пока необходимое количество ответственных не нажмут на подтверждение запроса, тем самым выразят одобрение к внесенным изменениям. После накопления необходимого количества отметок, разблокируется доступ для слития изменений.

approvers

Вики

Настройка

Чтобы активировать документацию (вики) к проекту, необходимо открыть вкладку на странице проекта с названием “Вики”. На странице будет простой настройщик, в котором необходимо нажать всего одну кнопку “Создать вики”. В вашем профиле или профиле компании появится приватный проект с соответствующим названием.

wiki

В новый Вики проект добавляйте текстовые файлы в разметке markdown, также можете собирать в папки группы файлов (обратите внимание, поддерживаются только папки первого уровня). Стартовый экран инициализируется через добавление в корне файла home.md.

Использование

После добавления достаточного количества страниц с описанием вашего проекта, вики будет доступна на вкладке “Вики” в вашем проекте. Вы можете добавлять новые файлы и редактировать старые, изменения в документации будут опубликованы сразу после загрузки в вики-проект.

  • Вы можете сделать форк от вики-проекта, чтобы предложить свои улучшения к существующей документации.

Чтобы отвязать от проекта вики-проект, необходимо в настройках проекта, в разделе Основное, спуститься к блоку “Опасная зона” и нажать “Отвязать вики-репозиторий”. При этом вики-проект не будет удален, он останется в списке проектов, будет удалена только связь между проектами.

wiki

При передаче проекта с подключенной документацией, передается только сам проект, вики-проект необходимо передавать отдельно от основного.

Git LFS

Git Large File Storage (LFS) заменяет большие файлы, такие как аудио, видео, наборы данных и графики, текстовыми указателями внутри Git, сохраняя при этом содержимое файла на удаленном сервере.

Для установки можете использовать следующие команды:

Homebrew: brew install git-lfs MacPorts: port install git-lfs Для Windows перейдите по ссылке

Загрузите и установите расширение для Git. После загрузки и установки настройте Git LFS для своей учетной записи пользователя, выполнив:

git lfs install

В каждом репозитории, где вы хотите использовать Git LFS, выберите типы файлов, которыми вы хотели бы управлять с помощью Git LFS (или непосредственно отредактируйте .gitattributes). Вы можете настроить дополнительные расширения файлов в любое время.

git lfs track "*.psd" git add .gitattributes

Обратите внимание, что указание типов файлов, которые должен отслеживать Git LFS, само по себе не преобразует какие-либо ранее существовавшие файлы в Git LFS, такие как файлы в других ветвях или в вашей предыдущей истории загрузки. Для этого используйте команду git lfs migrate, которая имеет ряд опций, разработанных в соответствии с различными потенциальными вариантами использования.

Для просмотра указанных расширений для Git LFS используйте команду

git lfs track

Далее просто зафиксируйте и отправьте изменения на GitFlic, например, если ваша текущая ветка называется master:

git add file.psd
git commit -m "Add design file"
git push origin main

Книга проекта

Создание книги

Книга проекта позволяет создать подробную документацю из вашего проекта. Данную документацию можно создать как в виде отдельного репозитория, так и в самом проекте.

Для создания книги перейдите в настройки проекта и откройте вкладку “Книга”. Добавьте текстовый идентификатор для вашей книги и нажмите “Создать”. Вам будет доступна ссылка на вашу книгу, можете добавлять ее к описанию проекта, чтобы пользователи имели прямой доступ к вашей книге.

Создание книги

Для инициализации страницы с книгой в проект необходимо добавить 2 файла: README.md для главной страницы SUMMARY.md для создания оглавления.

Основные файлы

Оформление SUMMARY.md

SUMMARY.md наполняется следующим образом: в файле могут присутствовать заголовки и обязательно ссылки на файлы, указанные разметкой Markdown. пример оформления оглавления ниже

# Документация 

* [Введение](README.md)

## Раздел 1
* [Статья 1](file1.md)
* [Статья 2](file2.md)
* [Подраздел]()
	* [Статья 3](folder/file3.md)
	* [Статья 4](folder/file4.md)

Файлы с документацией можно расположить как в корне, так и папке. Путь в ссылке можно указать относительно файла с заголовками, как указано в примере.

Пример книги GitFlic далее по ссылке.

В данной статье

Документация