# Catégories de documentation Discourse

**URL:** https://meta.discourse.org/t/discourse-doc-categories/322376
**Category:** Plugin
**Tags:** official, doc-categories
**Created:** [Août 26, 2024, 11:00 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376 "2024-08-26T23:00:13Z")
**Posts on this page:** 20
**Page:** 6

<div class="post-metadata">

### Author: ![nathank](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nathank/32/290039_2.png) [@nathank](https://meta.discourse.org/u/nathank)
#### Post date: [Septembre 27, 2025, 7:59 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/132 "2025-09-27T07:59:17Z")

</div>

> [@nat](#):
>
> `bundle exec rake doc_categories:build_sidebar`

Je viens de faire cela - cela a donné une erreur légèrement étrange mais a semblé fonctionner correctement :

> root@spokes-web-only:/var/www/discourse# bundle exec rake doc\_categories:build\_sidebar  
> fatal: detected dubious ownership in repository at ‘/var/www/discourse’  
> To add an exception for this directory, call:
> 
> ```plaintext
> git config --global --add safe.directory /var/www/discourse
> 
> ```
> 
> Processing category #21 - Ask the Candidates  
> ⮑ Created 3 sections and 55 links
> 
> Processing category #21 - Ask the Candidates  
> ⮑ Created 3 sections and 55 links

Est-ce que c’est comme ça que ça doit être ?

Et devons-nous changer notre façon d’interagir avec le sujet d’index, ou est-ce que tout cela reste inchangé ?

---

<div class="post-metadata">

### Author: ![nat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nat/32/235063_2.png) [@nat](https://meta.discourse.org/u/nat)
#### Post date: [Septembre 27, 2025, 10:36 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/133 "2025-09-27T10:36:35Z")

</div>

> [@nathank](#):
>
> Est-ce que c’est comme ça que ça doit être ?

Oui, c’est correct et il n’y a rien d’autre à faire 👌🏻

> [@nathank](#):
>
> est-ce que tout est inchangé

Oui, encore.

Dans un avenir proche (🤞🏻), nous travaillerons à l’amélioration de fonctionnalités telles que le tri facile, le réarrangement, la mise à jour avec peut-être une interface utilisateur dédiée. Je ne m’attends pas à ce qu’il y ait d’autres tâches manuelles que les auto-hébergeurs devront effectuer.

---

<div class="post-metadata">

### Author: ![Sailor](https://avatars.discourse-cdn.com/v4/letter/s/a587f6/32.png) [@Sailor](https://meta.discourse.org/u/Sailor)
#### Post date: [Septembre 27, 2025, 10:53 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/134 "2025-09-27T10:53:31Z")

</div>

> [@nat](#):
>
> notre dernière mise à jour

Pouvez-vous clarifier à quelle version du plugin et/ou commit cela s’applique ?

J’utilise Discourse 3.6.0.beta1-dev et aucune mise à jour de plugin n’est disponible pour Documentation Categories, la version du plugin étant 0.0.1 avec le commit [ba90a37](https://github.com/discourse/discourse-doc-categories/commit/ba90a3733614e87e79a03cbba3843ff4d2947498).

---

<div class="post-metadata">

### Author: ![nat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nat/32/235063_2.png) [@nat](https://meta.discourse.org/u/nat)
#### Post date: [Septembre 27, 2025, 11:45 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/135 "2025-09-27T11:45:15Z")

</div>

> [@Sailor](#):
>
> commit [ba90a37](https://github.com/discourse/discourse-doc-categories/commit/ba90a3733614e87e79a03cbba3843ff4d2947498)

Les changements sont environ 7 commits plus récents.

Les changements arrivent dans la même version de Discourse 3.6.0.beta1-dev. Idéalement, la prochaine fois que vous mettrez à jour Discourse lui-même, vous obtiendrez également ces changements.

En général, je ne recommande pas de mettre à jour uniquement le plugin, mais plutôt d’utiliser les méthodes de mise à niveau typiques via l’interface utilisateur ou `./launcher rebuild app`.

---

<div class="post-metadata">

### Author: ![cmdntd](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/cmdntd/32/192008_2.png) [@cmdntd](https://meta.discourse.org/u/cmdntd)
#### Post date: [Septembre 30, 2025, 5:03 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/136 "2025-09-30T05:03:59Z")

</div>

Menu de documentation (à gauche) **ne peut pas s’afficher** dans la dernière version de discourse (3.6.0.beta2)

Pourriez-vous vérifier cela à nouveau ?

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [Septembre 30, 2025, 5:24 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/137 "2025-09-30T05:24:10Z")

</div>

Pour moi, cela fonctionne toujours ici sur Meta.

Avez-vous reconstruit l’index comme décrit ici ?

> [@Discourse Doc Categories](https://meta.discourse.org/t/discourse-doc-categories/322376/130?u=moin):
>
> loudspeaker Updates for self-hosters For self-hosters using this plugin, our most recent update would require a manual rebuild of the index. This would involve running this rake task: bundle exec rake doc\_categories:build\_sidebar # if running the task above fails due to NoDatabaseError, # run with the following for typical self-hosted setups sudo -E -u discourse bundle exec rake doc\_categories:build\_sidebar If you are not able to run this rake task, you may go to each documentation categor…

---

<div class="post-metadata">

### Author: ![cmdntd](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/cmdntd/32/192008_2.png) [@cmdntd](https://meta.discourse.org/u/cmdntd)
#### Post date: [Septembre 30, 2025, 5:31 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/138 "2025-09-30T05:31:05Z")

</div>

> [@nat](#):
>
> `sudo -E -u discourse bundle exec rake doc_categories:build_sidebar`

Merci, c’est bon avec ceci :

`sudo -E -u discourse bundle exec rake doc_categories:build_sidebar`

---

<div class="post-metadata">

### Author: ![nat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nat/32/235063_2.png) [@nat](https://meta.discourse.org/u/nat)
#### Post date: [Octobre 2, 2025, 9:01 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/139 "2025-10-02T09:01:05Z")

</div>

Un message a été divisé en un nouveau sujet : [Diverses suggestions pour améliorer le plugin de catégories de documentation](https://meta.discourse.org/t/various-suggestions-to-improve-the-doc-categories-plugin/384529)

---

<div class="post-metadata">

### Author: ![caue-pareto](https://avatars.discourse-cdn.com/v4/letter/c/ea5d25/32.png) [@caue-pareto](https://meta.discourse.org/u/caue-pareto)
#### Post date: [Novembre 5, 2025, 10:00 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/140 "2025-11-05T10:00:24Z")

</div>

Salut tout le monde,

J’ai essayé de l’installer maintenant, mais il semble que ce plugin ne soit pas compatible avec la version de Discourse que nous utilisons, 3.5.2.

Pouvez-vous confirmer la compatibilité ? Je reçois cette erreur :

```plaintext
5 novembre 2025, 06:55
/var/www/discourse/plugins/discourse-doc-categories/lib/doc_categories/initializers/add_category_extensions.rb:19:in `apply': undefined method `register_category_update_param_with_callback' for an instance of Plugin::Instance (NoMethodError)
discourse
5 novembre 2025, 06:55
**PLUGIN INCOMPATIBLE**
discourse
5 novembre 2025, 06:55
Vous ne pouvez pas démarrer Discourse en raison d'erreurs dans le plugin à
discourse
5 novembre 2025, 06:55
/var/www/discourse/plugins/discourse-doc-categories
discourse
5 novembre 2025, 06:55
Veuillez essayer de supprimer ce plugin et de reconstruire à nouveau !

```

---

<div class="post-metadata">

### Author: ![nat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nat/32/235063_2.png) [@nat](https://meta.discourse.org/u/nat)
#### Post date: [Novembre 5, 2025, 10:02 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/141 "2025-11-05T10:02:55Z")

</div>

Hé, vous devrez d’abord mettre à jour votre instance Discourse car la méthode indiquée n’est disponible que dans une version plus récente.

---

<div class="post-metadata">

### Author: ![caue-pareto](https://avatars.discourse-cdn.com/v4/letter/c/ea5d25/32.png) [@caue-pareto](https://meta.discourse.org/u/caue-pareto)
#### Post date: [Novembre 5, 2025, 10:07 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/142 "2025-11-05T10:07:24Z")

</div>

L’image discourse/discourse:3.5.2 contient-elle ce code mis à jour ? Parce que je l’utilise et je vois qu’il a été mis à jour il y a 10 heures.

---

<div class="post-metadata">

### Author: ![nat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nat/32/235063_2.png) [@nat](https://meta.discourse.org/u/nat)
#### Post date: [Novembre 5, 2025, 10:11 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/143 "2025-11-05T10:11:48Z")

</div>

3.5.2 ne sera pas compatible. Vous aurez besoin au minimum de 3.6.0.beta1.

---

<div class="post-metadata">

### Author: ![sren-1](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sren-1/32/575182_2.png) [@sren-1](https://meta.discourse.org/u/sren-1)
#### Post date: [Décembre 3, 2025, 3:37 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/144 "2025-12-03T15:37:46Z")

</div>

Connaissez-vous un problème avec `3.6.0.beta3-latest` ? Le plugin ne fonctionne plus depuis notre dernière mise à jour depuis `3.6.0.beta1`.

---

<div class="post-metadata">

### Author: ![pacharanero](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pacharanero/32/500583_2.png) [@pacharanero](https://meta.discourse.org/u/pacharanero)
#### Post date: [Décembre 3, 2025, 5:49 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/145 "2025-12-03T17:49:58Z")

</div>

> [@soeren-1](#):
>
> Le plugin ne fonctionne plus depuis notre récente mise à jour de `3.6.0.beta1`.

Avez-vous exécuté la tâche `rake` comme décrit ici ?

> [@Catégories de documentation Discourse](https://meta.discourse.org/t/discourse-doc-categories/322376/130):
>
> loudspeaker Mises à jour pour les auto-hébergeurs Pour les auto-hébergeurs utilisant ce plugin, notre dernière mise à jour nécessiterait une reconstruction manuelle de l’index. Cela impliquerait l’exécution de cette tâche rake : bundle exec rake doc\_categories:build\_sidebar # si l'exécution de la tâche ci-dessus échoue en raison de NoDatabaseError, # exécutez avec la commande suivante pour les configurations auto-hébergées typiques sudo -E -u discourse bundle exec rake doc\_categories:build\_s…

Il existe une alternative (supprimer l’indexation des sujets dans les paramètres de catégorie, cliquer sur enregistrer, puis rajouter) si vous ne pouvez pas effectuer la tâche Rake.

---

<div class="post-metadata">

### Author: ![jordanjay29](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jordanjay29/32/529474_2.png) [@jordanjay29](https://meta.discourse.org/u/jordanjay29)
#### Post date: [Décembre 3, 2025, 6:09 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/146 "2025-12-03T18:09:21Z")

</div>

> [@pacharanero](#):
>
> Il existe une alternative (supprimer l’Index du Sujet dans les Paramètres de la Catégorie, cliquer sur enregistrer, puis rajouter) si vous ne pouvez pas effectuer la tâche Rake.

C’est ce que je dois faire à chaque fois après avoir ajouté un lien vers l’index avec un nom statique dans le format prescrit :

```plaintext
* Texte du Lien : https://meta.discourse.org/t/an-example-link/

```

Sinon, les liens de la barre latérale de la catégorie ne sont pas analysés en leurs titres et restent des URL complètes. Ceci est sur la dernière version de Discourse (2025.12.0-latest au commit 5817b6c).

---

<div class="post-metadata">

### Author: ![pacharanero](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pacharanero/32/500583_2.png) [@pacharanero](https://meta.discourse.org/u/pacharanero)
#### Post date: [Décembre 3, 2025, 6:38 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/147 "2025-12-03T18:38:25Z")

</div>

> [@jordanjay29](#):
>
> les liens de la barre latérale ne sont pas analysés en leurs titres et restent des URL complètes

J’ai également remarqué que cela se produit occasionnellement. Actualiser la page semble résoudre le problème.

(Ceci est différent du plugin qui ne fonctionne pas du tout, ce qui se produit si vous n’avez pas effectué la tâche `rake` ou si vous n’avez pas cyclé le sujet d’index, la même chose m’est arrivée sur un forum où j’avais oublié de le faire)

---

<div class="post-metadata">

### Author: ![jordanjay29](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jordanjay29/32/529474_2.png) [@jordanjay29](https://meta.discourse.org/u/jordanjay29)
#### Post date: [Décembre 3, 2025, 7:08 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/148 "2025-12-03T19:08:27Z")

</div>

> [@pacharanero](#):
>
> Actualiser la page semble résoudre le problème.

Cela n’a pas fonctionné ici. Seul l’ajustement des paramètres de _rake_ ou de catégorie que j’ai cité ci-dessus l’a fait.

---

<div class="post-metadata">

### Author: ![sren-1](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sren-1/32/575182_2.png) [@sren-1](https://meta.discourse.org/u/sren-1)
#### Post date: [Décembre 4, 2025, 8:16 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/149 "2025-12-04T08:16:05Z")

</div>

Merci, je vais et fournirai un retour d’information 🙂

---

<div class="post-metadata">

### Author: ![sren-1](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sren-1/32/575182_2.png) [@sren-1](https://meta.discourse.org/u/sren-1)
#### Post date: [Décembre 4, 2025, 8:28 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/150 "2025-12-04T08:28:22Z")

</div>

> [@pacharanero](#):
>
> Il existe une alternative (supprimer l’Index Topic dans les paramètres de la catégorie, cliquer sur enregistrer, puis le rajouter) si vous ne pouvez pas effectuer la tâche Rake.

Ça a fonctionné, merci beaucoup !

---

<div class="post-metadata">

### Author: ![nat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nat/32/235063_2.png) [@nat](https://meta.discourse.org/u/nat)
#### Post date: [Décembre 30, 2025, 8:45 UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/151 "2025-12-30T08:45:22Z")

</div>

Nous avons eu une mise à jour récente qui pourrait résoudre ce problème. Veuillez nous écrire pour nous faire savoir si cela persiste.

[Page précédente](https://meta.discourse.org/t/discourse-doc-categories/322376.md?page=5)

[Page suivante](https://meta.discourse.org/t/discourse-doc-categories/322376.md?page=7)
