# Коллекции

Используйте Collections для группировки репозиториев с Hub (Models, Datasets, Spaces и Papers) на отдельной странице.

![Collection page](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collection-intro.webp)

У коллекций множество сценариев использования:

- Выделите конкретные репозитории на вашем личном или организационном профиле.
- Выделите ключевые репозитории от остальных для посетителей вашего профиля.
- Представление и публикация полного проекта с его статьями, наборами данных, моделями и Spaces.
- Добавляйте найденные на Hub элементы в категории.
- Есть отдельная страница с отобранными материалами, которыми можно поделиться с другими.
- Управление доступом к группе моделей/датасетов (Team & Enterprise)

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

## Создание новой коллекции

Существует несколько способов создать коллекцию:

- Для личных коллекций: используйте кнопку **+ New** на главной странице после входа в систему (1).
- Для коллекций организаций: используйте кнопку **+ New**, доступную на странице организаций (2).

![New collection](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collection-new.webp)

Также можно создать коллекцию на лету при добавлении первого элемента со страницы репозитория: выберите **+ Create new collection** в выпадающем меню. Для создания коллекции необходимо ввести заголовок и краткое описание.

## Добавление элементов в коллекцию

Существует 2 способа добавить элементы в коллекцию:

- С любой страницы репозитория: используйте контекстное меню, доступное на любой странице репозитория, затем выберите **Добавить в коллекцию**, чтобы добавить его в коллекцию (1).
- Со страницы коллекции: если вы знаете имя репозитория, который хотите добавить, используйте вариант **+ add to collection** в меню справа (2).

![Add items to collections](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collection-add.webp)

В ваши коллекции можно добавлять не только собственные, но и внешние репозитории.

## Совместная работа над коллекциями

Коллекции организации — отличный способ совместно создавать коллекции. Участники с доступом только на чтение могут просматривать коллекции, но только участники с правами организации на запись (или более высокими) могут создавать коллекции, а также добавлять, редактировать и удалять элементы. Используйте **функцию истории**, чтобы отслеживать, кто редактировал коллекцию.

![Collection history](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collection-history.webp)

## Варианты сбора

### Видимость коллекции

![Collections on profiles](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collection-profile.webp)

Коллекции **Public** отображаются вверху страницы вашего профиля или организации и доступны для просмотра всем. Первые 3 элемента каждой коллекции видны непосредственно в предпросмотре коллекции (1). Чтобы увидеть больше, пользователю нужно перейти на страницу коллекции.

Сделайте вашу коллекцию **приватной**, если вы не хотите, чтобы к ней можно было получить доступ по её URL (она не будет отображаться на вашей странице профиля/организации). Для организаций приватные коллекции доступны только членам организации.

### Коллекции с ограничением доступа (команды и предприятия)

Вы можете использовать коллекцию, чтобы [управлять](https://huggingface.co/docs/hub/en/models-gated) доступом ко всем моделям/наборам данных, входящим в неё, что позволяет предоставлять (или отказывать) доступ ко всем из них одним действием.

Эта функция доступна только подписчикам [Team & Enterprise](https://huggingface.co/docs/hub/en/enterprise): подробную информацию о Gating Group Collections можно найти в [нашем специальном документе](https://huggingface.co/docs/hub/en/enterprise-gating-group-collections).

### Назначение коллекции в группу ресурсов (Team & Enterprise)

Коллекции организации можно назначить в [группу ресурсов](./security-resource-groups) для управления доступом членов к ним, аналогично тому, как это делается с репозиториями. При создании коллекции организации можно выбрать группу ресурсов, а члены с соответствующими правами доступа могут позже переместить коллекцию в другую группу ресурсов через меню коллекции. Приватные коллекции, принадлежащие группе ресурсов, видны только членам этой группы.

Эта функция доступна только подписчикам [Team & Enterprise](https://huggingface.co/docs/hub/en/enterprise).

> [!NOTE]
> Назначение коллекции в группу ресурсов управляет доступом к *конкретной коллекции*. Чтобы ограничить, кто может создавать или редактировать коллекции организации, см. [Granular feature access](./security-resource-groups#granular-feature-access) (тарифные планы Enterprise и выше).

### Сортировка ваших коллекций и их элементов

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

Вы также можете сортировать репозитории внутри коллекции, перетаскивая маркеры рядом с каждым элементом (2).

![Collections sort](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collection-sort.webp)

### Удаление элементов из коллекции

Чтобы удалить элемент из коллекции, наведите курсор на элемент и нажмите на значок корзины в меню, которое появится справа (1). Чтобы удалить всю коллекцию, нажмите «Удалить» в меню справа (2) — потребуется подтвердить это действие.

![Collection delete](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collection-delete.webp)

### Добавление заметок к элементам коллекции

К любому элементу в коллекции можно добавить заметку, чтобы дать больше контекста (для других или как напоминание самому себе). Чтобы добавить заметку, наведите курсор на элемент и нажмите на иконку карандаша. Заметки представляют собой обычный текст и не поддерживают разметку Markdown, чтобы всё оставалось чистым и простым. URL-адреса в заметках преобразуются в кликабельные ссылки.

![Collection note](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collection-note.webp)

### Добавление изображений в элемент коллекции

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

Чтобы начать добавлять изображения в вашу коллекцию, нажмите на значок изображения в контекстном меню элемента. Меню появляется при наведении курсора мыши на элемент.

![Collection image icon](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collections-image-button.webp)

Затем добавьте изображения, перетащив их с компьютера. Также можно щёлкнуть по серой области, чтобы выбрать файлы изображений из файловой системы компьютера.

![Collection image drop zone with images](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collections-image-gallery.webp)

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

![Collection image viewer](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/collections-image-viewer.webp)

## Ваша обратная связь по коллекциям

Мы работаем над улучшением коллекций, поэтому, если у вас есть ошибки, вопросы или предложения по новым функциям, пожалуйста, оставьте сообщение в [посвящённом обсуждении](https://huggingface.co/spaces/huggingface/HuggingDiscussions/discussions/12).