Pour ajouter une entrée dans Annuaire, al faut pouvoir créer une catégorie, puis appliquer parmi les #a-propos-du-forum:modeles celui adapté à la destination, et le remplir.
1. Depuis la page d’accueil du forum
Si vous pouvez créer une catégorie vous verrez le bouton 
2. Création de la catégorie
Dans le formulaire, commencez par choisir la catégorie parente (Annuaire) puis l’icone ou l’emoji correspondant au type d’entrée :
| Type | Tag | Icône ou emoji |
|---|---|---|
| Maison d’édition | editions | icône book |
| Librairie | librairie | emoji books |
| Logiciel | logiciel | icône code |
| Bibliothèque | bibliothèque | ? |
| Fédération | fédération | ? |
| Syndicat | syndicat | ? |
C’est important de commencer par saisir ces deux informations dans cet ordre en raison d’un bug dans l’interface (qui sera sans doute réglé à la prochaine version).
Ensuite saisir le nom de la catégorie ; pour les maisons d’édition ou les distributaires disposant d’un GLN, nous recommandons d’utiliser le « nom abrégé » sur dilicom pour l’identifiant de la catégorie, en minuscules. Cela pourra faciliter les recherches et l’intégration par la suite.
2.1. Dans l’onglet sécurité
- Réduire les permissions de « tous » à « Voir » en cliquant sur « Répondre » (oui, ce n’est pas évident) ;
- Ajouter le groupe « h.qui » (hôtes de l’annuaire) avec toutes les permissions
- Enregistrez la catégorie.
3. Créer le groupe correspondant
Voir la documentation sur les groupes pour choisir le préfixe approprié. Par exemple, si vous ajoutez une maison d’édition nommé les Éditions de l’exemple, avec un « nom abrégé » EXEMPLE dans le Fichier Exhaustif du Livre (FEL), vous allez créer le groupe @e.exemple avec pour nom « Éditions de l’exemple » et pour description « Groupe des #qui:exemple. »
#qui:exemple créera un lien automatique vers la catégorie que nous venons de créer.
Le groupe appartiendra à la personne qui en a fait la demande (si elle est bien responsable de l’entité correspondante) ou au compte @system.
Si l’entité possède un nom de domaine qu’elle utilise pour ses courriels, vous pouvez ajouter ce domaine pour que les personnes inscrites au forum avec une adresse de courriel correspondante soient automatiquement ajoutées à ce groupe.
Ensuite, sauvez le groupe et revenez à la catégorie en cliquant le lien dans sa description, puis la clé à molette pour éditer de nouveau la catégorie…
4. Effectuer les réglages de la catégorie
- Ajouter les permissions pour le groupe associé que vous venez de créer, dans l’onglet « Sécurité » ; il devrait avoir les mêmes accès que @h.qui (tout).
- Dans l’onglet « Paramètres » vous pouvez ajouter ces deux groupes comme « modérateurs » ; en passant, vous pouvez coche « Autoriser la modification illimitée du premier message par son propriétaire »
- Si vous avez un logo à votre disposition, vous pouvez l’ajouter dans l’onglet « Images ».
- Enregistrez les modifications !
5. Modification de la description
Dans l’onglet « Général » vous trouverez le bouton « Modifier la description ». Cliquer ce bouton vous amènera au sujet épinglé créé par défaut pour la catégorie.
- Modifiez le titre pour qu’il lise « À propos des Éditions de l’exemple » (plutôt que de la catégorie…)
- Ajouter les étiquettes a-propos et l’étiquette correspondant au type de l’entrée dans l’annuaire.
- Effacer l’ensemble du corps du message et remplacez-le par le modèle correspondant. Pour ce faire, cliquez la roue (icône tout à droite de la barre du composeur (
) puis « Insérer un modèle » ; cliquer l’icône tout à droite de la liste des modèles correspondant…) - Suivez les instructions du modèle et remplissez la page
- Une fois sauvegardée, changez le propriétaire de la page pour lu responsable du groupe ou le compte @system.
6. Activer la fédération
Si le forum est public et que la catégorie comporte un actaire ActivityPub (par exemple, un compte Mastodon ou Pixelfed), alors vous pouvez activer l’actaire de la catégorie et « suivre » le compte existant : toute annonce faite sur les fées diverses par ce compte seront relayées dans la catégorie, sans travail supplémentaire pour l’entité visée par l’entrée dans l’annuaire. 
L’activation de la fédération fera l’objet d’un tutoriel spécifique.
Cette documentation est destinées à @staff. Toutefois, vous êtes invitæs à l’améliorer en posant vos questions et proposant des modifications en réponse à ce sujet.
