---
title: "Gérer un fichier Artidoc"
slug: "gerer-un-fichier-artidoc"
tags: ["Artidoc", "Configuration Document", "Fichier Artidoc"]
updated: 2026-04-27T08:44:48Z
published: 2026-04-27T08:44:48Z
canonical: "help.tuleap.com/gerer-un-fichier-artidoc"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.tuleap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gérer un fichier Artidoc

## La configuration d’un Artidoc

En haut de votre document, vous retrouverez plusieurs fonctionnalités pour organiser votre rédaction :

- Mettre le texte en gras, en italique.
- Faire des listes à puces, numérotées.
- Ajouter/supprimer un lien.
- Ajouter une image.
- Etc…

Vous retrouverez également sur la droite la table des matières qui se remplira automatiquement lors de la rédaction de votre document. Lorsqu’elle est assez longue, il vous suffit de cliquer sur un titre de section afin que Tuleap vous redirige directement à cette section.

![Document editing interface showing formatting options and a table of contents section.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-15 à 16.12.19(1).png)

Grâce au trois petits points en haut vous avez également la possibilité d’ouvrir votre artidoc en plein écran ainsi que de le configurer plus

![Document settings menu for configuring the Artidoc test document interface.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture%20d%E2%80%99e%CC%81cran%202026-01-15%20a%CC%80%2016.38.30.png)

**L’onglet “Sélection du Tracker”** vous permet de changer le tracker sur lequel est basé votre artidoc mais sans supprimer les artifacts créés depuis le document. Vous gardez toute votre rédaction basée sur le tracker précédent.

![Configuration interface for Artidoc, selecting tracker and adding document sections.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-15 à 16.58.36.png)

**L’onglet “Sélection des champs”** s’active lorsque vous avez au moins un artifact créé dans votre document artidoc. Cet onglet vous permet de choisir quels sont les champs que vous souhaitez faire apparaître dans votre artidoc.

![Configuration settings for selecting fields in an artifact tracker interface.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-15 à 17.00.47.png)

Les champs sélectionnés dans cet exemple ressortent bien dans mon artidoc sous mon premier bug. Ils se mettent automatiquement à jour dans votre artidoc s’ils sont changés directement dans le tracker.

![Bug report showing status, remaining effort, close date, and severity details.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-15 à 17.04.33.png)

**L’onglet “Fonctionnalités expérimentales”** vous permet de participer à l’amélioration d’Artidoc en testant l’affichage des versions et en faisant des retours aux équipes de Tuleap. Il vous suffit de cliquer sur le bouton afin d’activer la fonctionnalité.

![Configuration settings for Artidoc with a toggle for version display simulation.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-15 à 17.19.56.png)

> [!NOTE]
> Information
> 
> Les données affichées seront fictives tant que la fonctionnalité n’aura pas été totalement terminée par nos équipes.

![Interface showing version history with options for viewing named versions and artifact history.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-15 à 17.09.03.png)

## La rédaction dans Artidoc

Avec le petit “+” vous pouvez commencer à intégrer des éléments dans votre document :

- **Du texte libre :** ceci vous permet la rédaction de tout texte relié à aucun élément, ni aucun artifact.
- **Créer un “nom du tracker sur lequel est basé l’artidoc” :** ceci vous permet de créer un artifact (dans cet exemple un bug) directement depuis votre document artidoc. Vous retrouverez cet artifact ainsi que tous ses éléments dans le tracker dédié.
- **Importer un “nom du tracker sur lequel est basé l’artidoc” :** ceci vous permet d’importer un artifact déjà existant dans le tracker sur lequel est basé votre artidoc afin de l’intégrer à la documentation.

### **Rédaction de texte libre dans Artidoc**

[Embedded content](https://app.storylane.io/demo/ssgfnir8cu0a?embed=inline)

### **Création d’un artifact depuis Artidoc**

[Embedded content](https://app.storylane.io/demo/oih5nvnjwind?embed=inline)

### **Importation d’un artifact dans Artidoc**

[Embedded content](https://app.storylane.io/demo/ugljnizn1v5a?embed=inline)

Dans chaque artifact de votre document, qu’il soit créé depuis le fichier ou importé, il est possible d'accéder directement à ses informations depuis votre document Artidoc.

[Embedded content](https://app.storylane.io/demo/g3zyhuxotclx?embed=inline)

## Réorganiser votre Artidoc

Depuis la table des matières, vous pouvez faire glisser les éléments afin de réorganiser votre document.

[Embedded content](https://app.storylane.io/demo/lq6t7qfaptvb?embed=inline)

## Suppression d’éléments dans Artidoc

Vous pouvez sans problème supprimer un élément mais **attention, supprimer du texte libre est définitif.**

![Warning message about permanently deleting a section in a document editing interface.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-21 à 15.27.42.png)

Supprimer un artifact supprime en revanche uniquement l’élément dans votre fichier artidoc. **Votre artifact ne sera pas supprimé et vous pourrez le retrouver dans votre tracker dédié.**

![Document interface showing bug details with options to navigate and remove items.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-21 à 15.25.48.png)

Un Tracker est un outil de suivi d'un type d'information qui permet de créer, gérer et suivre un ensemble d'artifacts partageant une même nature.

Dans l'écosystème Tuleap, un artifact est l'unité de base pour suivre le travail. C'est un élément géré dans un "tracker", et englobe tout ce que vous pourriez traditionnellement appeler un "ticket", une "tâche", un "bug", une "exigence", etc.
