Rediriger la page d'accueil de chaque sous-catégorie vers le fichier index par défaut pour les catégories de documentation

Contribuer Fonctionnalité
1

Bonjour à l’équipe Discourse,

Nous avons commencé à explorer les Catégories de documentation Discourse. Cela semble très prometteur. Bien joué !

Un point que j’ai remarqué est que la page d’accueil de chaque sous-catégorie affiche actuellement une liste des messages de cette sous-catégorie, triés par « Plus récents » ou selon d’autres options de tri possibles.

Bien que cette approche soit acceptable pour les discussions, j’ai le sentiment qu’elle pourrait dérouter les nouveaux utilisateurs non familiers avec Discourse. Je m’attendais à voir la page d’index comme page d’accueil par défaut. Cela correspondrait également à la barre latérale.

Serait-il possible d’ajouter une option permettant à l’utilisateur de basculer entre les deux ?

Avec les nouveaux paramètres, lorsque l’utilisateur clique sur la sous-catégorie « Intégrations » depuis la page d’accueil de la documentation, il atterrit sur cette page et voit tout le contenu.

image
image1879×817 199 KB

Au lieu de celle-ci :

image
image1879×805 137 KB

Cela devrait faciliter pour les utilisateurs la découverte de la structure des documents et la recherche rapide de ce dont ils ont besoin.

6 « J'aime »
2

Il s’avère que cette demande a déjà été faite ici. Je cherchais dans la mauvaise catégorie ! :man_facepalming:

N’hésitez pas à fermer ou supprimer ce sujet. J’ai ajouté mes commentaires à l’autre message.

6 « J'aime »
3

Sauf que le sujet lié n’est pas un sujet de fonctionnalité suivi par Vote — alors peut-être que votre sujet devrait rester ?

4 « J'aime »
4

J’aimerais également voir apparaître une option intégrée permettant d’ouvrir une catégorie de documentation sur un sujet index par défaut. En attendant, j’utilise le contournement JavaScript suivant :

import { apiInitializer } from "discourse/lib/api";

export default apiInitializer((api) => {

    // Catégories de documentation : rediriger la liste des catégories vers le sujet index

    api.onPageChange(() => {
        
        const currentPath = window.location.pathname;
        const queryParams = window.location.search;
        
        const redirects = {
            
            "/c/category-1-slug/category-1-id": "/t/topic-1-slug/index-topic-1-id",
            "/c/category-2-slug/category-2-id": "/t/topic-2-slug/index-topic-2-id"
        };
        
        if (queryParams.includes("list=true")) return;
        
        const match = Object.keys(redirects).find(cat => currentPath.startsWith(cat));
        
        if (match) {
          const targetTopic = redirects[match];
          
          if (currentPath !== targetTopic) {

            const router = api.container.lookup("router:main");
            router.transitionTo(targetTopic);
          }
        }
    });

});

Pour ouvrir la catégorie de documentation avec la liste classique, ajoutez un paramètre à l’URL :

/c/category-1-slug/category-1-id?list=true
4 « J'aime »
5

Super, ça me paraît mieux. Je suis en train de tester en interne un rendu local de A à Z et l’affichage automatique de la barre latérale dès la première tentative d’accès aux catégories de la documentation dans chaque session, avec la même idée en tête : empêcher les utilisateurs paresseux de se perdre :slight_smile:

2 « J'aime »