Hub documentation

Collections

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Collections

Utilisez les Collections pour regrouper les dépôts du Hub (Models, Datasets, Spaces et Papers) sur une page dédiée.

Collection page

Les collections ont de nombreux cas d'usage :

  • Mettez en avant des dépôts spécifiques sur votre profil personnel ou organisationnel.
  • Séparez les dépôts clés des autres pour les visiteurs de votre profil.
  • Présentez et partagez un projet complet avec ses article(s), jeu(x) de données, modèle(s) et Space(s).
  • Épinglez les éléments que vous trouvez sur le Hub dans des catégories.
  • Disposez d'une page dédiée aux éléments sélectionnés à partager avec les autres.
  • Gérer un groupe de modèles/jeux de données (Équipe & Entreprise)

Il s’agit simplement d’une liste d’utilisations possibles, mais rappelez-vous que les collections ne sont qu’un moyen de regrouper des éléments : utilisez-les de la manière qui convient le mieux à votre cas d’usage.

Créer une nouvelle collection

Il existe plusieurs façons de créer une collection :

  • Pour les collections personnelles : utilisez le bouton + Nouveau sur votre page d’accueil après connexion (1).
  • Pour les collections d’organisation : utilisez le bouton + Nouveau disponible sur la page des organisations (2).

New collection

Il est également possible de créer une collection à la volée lors de l’ajout du premier élément depuis une page de dépôt : sélectionnez + Créer une nouvelle collection dans le menu déroulant. Vous devrez saisir un titre et une courte description pour que votre collection soit créée.

Ajouter des éléments à une collection

Il existe 2 façons d'ajouter des éléments à une collection :

  • Depuis n’importe quelle page de dépôt : utilisez le menu contextuel disponible sur toute page de dépôt, puis sélectionnez Ajouter à une collection pour l’ajouter à une collection (1).
  • Depuis la page de la collection : si vous connaissez le nom du dépôt que vous souhaitez ajouter, utilisez l’option + add to collection dans le menu de droite (2).

Add items to collections

Il est possible d’ajouter des dépôts externes à vos collections, pas seulement les vôtres.

Collaborer sur des collections

Les collections d’organisation constituent un excellent moyen de créer des collections en collaboration. Les membres disposant d’un accès en lecture seule peuvent consulter les collections, mais seuls les membres ayant des permissions d’organisation en écriture (ou supérieures) peuvent créer des collections ou ajouter, modifier et supprimer des éléments. Utilisez la fonctionnalité d’historique pour suivre qui a modifié la collection.

Collection history

Options de collection

Visibilité de la collection

Collections on profiles

Les collections Public s’affichent en haut de votre profil ou de la page de votre organisation et sont consultables par n’importe qui. Les trois premiers éléments de chaque collection sont visibles directement dans l’aperçu de la collection (1). Pour en voir davantage, l’utilisateur doit cliquer pour accéder à la page de la collection.

Définissez votre collection sur privée si vous ne souhaitez pas qu’elle soit accessible via son URL (elle ne sera pas affichée sur votre page de profil/organisation). Pour les organisations, les collections privées ne sont disponibles que pour les membres de l’organisation.

Collections de groupes de contrôle d'accès (Équipe et Entreprise)

Vous pouvez utiliser une collection pour gérer l’accès à tous les modèles/jeux de données qui y appartiennent, ce qui vous permet d’accorder (ou de refuser) l’accès à l’ensemble d’un seul coup.

Cette fonctionnalité est réservée aux abonnés Team & Enterprise : plus d'informations sur les Gating Group Collections sont disponibles dans notre documentation dédiée.

Affecter une collection à un groupe de ressources (Équipe et Entreprise)

Les collections d’organisation peuvent être affectées à un Resource Group pour contrôler quels membres peuvent y accéder, de la même manière que pour les dépôts. Vous pouvez sélectionner un Resource Group lors de la création d’une collection d’organisation, et les membres disposant des autorisations appropriées peuvent ensuite déplacer une collection vers un autre Resource Group depuis le menu de la collection. Les collections privées appartenant à un Resource Group ne sont visibles que par les membres de ce groupe.

Cette fonctionnalité est réservée aux abonnés Team & Enterprise.

L’attribution d’une collection à un groupe de ressources contrôle l’accès à cette collection spécifique. Pour restreindre qui peut créer ou modifier des Collections d’organisation, consultez Accès granulaire aux fonctionnalités (plans Enterprise et supérieurs).

Ordre de vos collections et de leurs éléments

Vous pouvez utiliser les poignées de glisser-déposer dans la liste des collections (à gauche de votre page de collections) pour modifier l’ordre de vos collections (1). Les deux premières collections seront directement visibles sur vos pages de profil/organisation.

Vous pouvez également trier les dépôts au sein d'une collection en faisant glisser les poignées situées à côté de chaque élément (2).

Collections sort

Supprimer des éléments d'une collection

Pour supprimer un élément d'une collection, cliquez sur l'icône de corbeille dans le menu qui s'affiche à droite lorsque vous survolez un élément (1). Pour supprimer l'ensemble de la collection, cliquez sur delete dans le menu de droite (2) - vous devrez confirmer cette action.

Collection delete

Ajouter des notes aux éléments de la collection

Il est possible d’ajouter une note à n’importe quel élément d’une collection pour lui donner plus de contexte (pour les autres, ou comme rappel pour vous-même). Vous pouvez ajouter des notes en cliquant sur l’icône de crayon lorsque vous survolez un élément avec la souris. Les notes sont en texte brut et ne prennent pas en charge le markdown, afin de garder les choses propres et simples. Les URL dans les notes sont converties en liens cliquables.

Collection note

Ajouter des images à un élément de collection

De même, vous pouvez joindre des images à un élément de collection. Cela est utile pour présenter la sortie d'un modèle, le contenu d'un jeu de données, joindre une infographie pour donner du contexte, etc.

Pour commencer à ajouter des images à votre collection, vous pouvez cliquer sur l'icône d'image dans le menu contextuel d'un élément. Le menu s'affiche lorsque vous survolez un élément avec la souris.

Collection image icon

Ensuite, ajoutez des images en les faisant glisser-déposer depuis votre ordinateur. Vous pouvez également cliquer sur la zone grise pour sélectionner des fichiers d’images depuis le système de fichiers de votre ordinateur.

Collection image drop zone with images

Vous pouvez réorganiser les images en les faisant glisser-déposer. Un clic sur une image l’ouvre en mode plein écran.

Collection image viewer

Vos retours sur les collections

Nous travaillons à l’amélioration des collections. Si vous rencontrez des bugs, avez des questions ou souhaitez voir de nouvelles fonctionnalités ajoutées, veuillez publier un message dans la discussion dédiée.

Update on GitHub