---
title: "Documentation — Rattachement à des livrets"
module: wiki
type: functional
status: active
updated: 2026-09-02
---

# Documentation — Rattachement à des livrets

> Rattacher une documentation à un ou plusieurs livrets, depuis la fiche ou la liste, pour qu'elle
> apparaisse dans leur sommaire.

## Description

Un **livret** agrège des contenus de documentation pour produire un document structuré, consultable
et exportable en PDF. Le rattachement décrit ici est le sens **documentation → livrets** : depuis
une documentation, on choisit les livrets dans lesquels elle doit figurer.

La documentation n'est jamais dupliquée : le livret se contente de **pointer** vers elle. Une
modification de la documentation se reflète donc immédiatement dans tous les livrets qui la
contiennent, et la détacher n'efface rien.

Le sens inverse — depuis un livret, choisir les documentations de son sommaire — reste l'écran
« Documentations » de la sidebar d'un livret.

## Accès

- **Module** : `Wiki` (ID `14170101`).
- **Trois points d'entrée**, tous ouvrant la même fenêtre :
  - sidebar de la fiche : ligne **« Livrets »**, qui affiche aussi le nombre de rattachements ;
  - fiche de lecture (`/wiki/{id}`) : lien **« Voir les livrets rattachés »** de l'encart bleu,
    présent seulement si la documentation est déjà dans au moins un livret ;
  - liste des documentations : entrée **« Livrets rattachés »** du menu d'une carte.
- **Pré-requis** : droit `U` (modification) sur la documentation — l'auteur passe toujours.
  Le rattachement demande en plus le droit `C`, le détachement le droit `D`.

## Fonctionnalités

### Rattacher

- Sélecteur multiple **« Choisir des livrets… »**, puis bouton **« Ajouter »**.
- La liste ne propose que les livrets **rattachables** : ceux de l'entité courante, non archivés,
  pas déjà rattachés, et jamais la documentation elle-même si c'est un livret.
- Une notification confirme le rattachement. Si la sélection contenait des livrets devenus
  indisponibles entre-temps, ils sont ignorés et la notification le dit.
- La documentation est ajoutée **en fin de sommaire** du livret ; l'ordre se règle ensuite par
  glisser-déposer depuis le livret.

### Consulter

- La fenêtre liste les livrets rattachés avec leur **statut** (Actif, Brouillon, À valider,
  Archivé) et leur date de dernière modification.
- Bouton d'ouverture du livret dans un nouvel onglet, pour aller le modifier.
- Le compteur de la sidebar se met à jour immédiatement après un ajout ou un retrait, sans
  rechargement de la page.

### Détacher

- Bouton **détacher** sur la ligne du livret → **boîte de confirmation** → la documentation sort du
  sommaire de ce livret.
- Le détachement n'efface pas la documentation, et le rattachement peut être refait.

## Visibilité & droits

- Seuls les livrets de l'**entité courante** sont proposés et affichés : un livret d'un autre
  client n'est ni rattachable ni visible, même si un rattachement existait en base.
- Un livret **archivé** déjà rattaché reste affiché — signalé comme tel, pour pouvoir le détacher —
  mais ne peut plus être choisi pour un nouveau rattachement.
- Une documentation **archivée** ou d'une autre entité n'ouvre pas la fenêtre.

## Voir aussi

- [Livret — Rattachement de schémas](booklet-schema-attachment.md) — le même geste pour un schéma
  Draw.io.
- [Livret — En-têtes](booklet-headers.md).
- Doc technique : `.claude/technical-docs/wiki/booklet-wiki-attachment.md`.