phpBB Lab

Support officiel de HUCIAL Markdown

Bienvenue dans l’espace de support officiel de HUCIAL Markdown.

Ce forum est consacré à l’installation, à la configuration, à l’utilisation et au dépannage de l’extension.

HUCIAL Markdown ajoute la prise en charge de Markdown à phpBB tout en conservant le BBCode natif et le fonctionnement habituel du forum.

Vous pouvez ouvrir un sujet pour

• demander de l’aide lors de l’installation ;

• obtenir de l’aide pour la configuration de Markdown dans un forum ;

• signaler un problème de rendu Markdown ;

• signaler un problème avec un bloc de code ;

• signaler un problème de coloration syntaxique ;

• signaler un problème avec les tableaux ou les listes de tâches ;

• signaler un problème lors de l’édition ou de la prévisualisation d’un message ;

• signaler une incompatibilité avec une autre extension ;

• proposer une amélioration ou une nouvelle fonctionnalité ;

• partager un retour d’expérience.

Avant de demander de l’aide

Indiquez autant que possible :

• votre version de HUCIAL Markdown ;

• votre version de phpBB ;

• votre version de PHP ;

• le mode Markdown configuré pour le forum concerné ;

• le comportement attendu ;

• le comportement réellement observé ;

• le contenu Markdown permettant de reproduire le problème ;

• le message d’erreur complet, s’il existe.

Utilisez un titre aussi précis que possible.

Évitez par exemple :

Markdown ne fonctionne pas

Préférez :

Les tableaux Markdown ne s’affichent pas dans la prévisualisation

Publier un exemple Markdown

Pour faciliter le diagnostic, vous pouvez publier directement le contenu qui pose problème.

Exemple :

## Exemple

**Texte en gras**

- Élément 1

- Élément 2

Si le problème concerne un bloc de code, indiquez également le langage utilisé.

Exemple :

<?php

echo 'Bonjour phpBB';

Coloration syntaxique

Si votre problème concerne la coloration syntaxique, indiquez :

• le langage déclaré dans le bloc ;

• le résultat attendu ;

• le résultat obtenu ;

• si la coloration syntaxique est activée dans le panneau d’administration.

HUCIAL Markdown prend notamment en charge des langages courants tels que :

• PHP ;

• HTML et XML ;

• CSS ;

• JavaScript ;

• TypeScript ;

• JSON ;

• YAML ;

• SQL ;

• Bash / Shell ;

• Python ;

• Twig.

Compatibilité avec le BBCode

HUCIAL Markdown ne remplace pas le BBCode de phpBB.

Les deux systèmes peuvent fonctionner en parallèle.

Si votre problème semble provenir d’une interaction entre Markdown et BBCode, fournissez le contenu original complet du message afin que le comportement puisse être reproduit.

Informations confidentielles

Ne publiez jamais de données sensibles dans un sujet public.

Ne publiez notamment pas :

• mots de passe ;

• identifiants de base de données ;

• clés privées ;

• clés API ;

• jetons d’accès ;

• cookies de session ;

• données personnelles ;

• fichiers de configuration contenant des secrets.
  Masquez toujours ces informations avant de publier un log ou un fichier de configuration.

Un problème par sujet

Créez de préférence un sujet distinct pour chaque problème.

Cela permet de garder les discussions lisibles et facilite la recherche de solutions par les autres utilisateurs.

Suggestions et évolutions

Les propositions d’amélioration sont les bienvenues.

Pour proposer une fonctionnalité, indiquez si possible :

1. le besoin rencontré ;

2. le comportement souhaité ;

3. un exemple d’utilisation ;

4. l’intérêt de cette évolution pour les utilisateurs de phpBB.

Les propositions pourront être étudiées pour une future version de HUCIAL Markdown.

À propos de HUCIAL Markdown

HUCIAL Markdown est conçu pour intégrer Markdown à phpBB sans modifier le cœur du forum.

Il conserve le BBCode, la prévisualisation native, les messages existants et permet une configuration indépendante pour chaque forum.

HUCIAL Markdown

Markdown moderne et sécurisé pour phpBB.