Articles
Articles sont des mises à jour et des notes que vous pouvez rédiger au sein d'un coffre ou d'une communauté. Ils prennent en charge la mise en forme Markdown, ce qui vous permet de créer un contenu riche et expressif avec des titres, des listes, des liens, des blocs de code, etc.
Créer un article
- Accédez à une page de coffre ou de communauté.
- Ouvrez l'onglet Articles.
- Cliquez sur Nouvel article.
- Entrez un titre et rédigez votre contenu en utilisant l'éditeur Markdown.
- Choisissez un niveau de visibilité (uniquement pour les articles des coffres) :
- Public : tout le monde peut le voir
- Amis : seuls vos amis peuvent le voir
- Privé : seul vous pouvez le voir
- Faculatif : ajoutez des images.
- Cliquez sur Publier.
L'éditeur Markdown
L'éditeur d'article comprend une barre d'outils de formatage et un aperçu en direct, afin que vous puissiez voir exactement à quoi ressemblera votre article avant de le publier.
Barre d'outils
La barre d'outils fournit des boutons pour les formats courants :
| Bouton | Ce qu'il fait | Syntaxe Markdown |
|---|---|---|
| Gras | Met le texte en gras | **texte** |
| Italique | Met le texte en italique | *texte* |
| Titre | Insère un titre | ## texte |
| Lien | Insère une hyperliên | [texte](url) |
| Liste ordonnée | Commence une liste numérotée | 1. élément |
| Liste non ordonnée | Commence une liste à puces | - élément |
| Bloc de code | Insère un bloc de code | ```code``` |
Vous pouvez également sélectionner du texte, puis cliquer sur un bouton de la barre d'outils pour encadrer la sélection avec la syntaxe appropriée.
Mode Aperçu
Cliquez sur le bouton Aperçu pour passer de l'éditeur de texte à un aperçu rendu. L'aperçu se met à jour en temps réel pendant que vous tapez. Rebasculez vers le mode Écriture pour continuer à modifier.
Markdown pris en charge
Les articles prennent en charge les éléments Markdown suivants :
| Élément | Syntaxe | Exemple |
|---|---|---|
| Titres | # H1 à ###### H6 | Titres de section |
| Gras | **gras** | gras |
| Italique | *italique* | italique |
| Barré | ~~biffé~~ | |
| Liens | [texte](url) | Hyperliens cliquables |
| Images |  | Images intégrées |
| Listes ordonnées | 1. élément | Listes numérotées |
| Listes non ordonnées | - élément | Listes à puces |
| Code en ligne | `code` | code |
| Blocs de code | ```lang | Bloc de code multiligne avec coloration syntaxique |
| Citations | > citation | Citations indentées |
| Lignes horizontales | --- | Séparateurs visuels |
| Tableaux | ` | col |
Markdown dans les commentaires
Les commentaires sur les articles prennent également en charge le Markdown, avec quelques restrictions :
- Les titres ne sont pas rendus, la syntaxe des titres s'affiche donc sous forme de texte brut.
- Les images ne sont pas rendues dans les commentaires.
- Tous les autres formats en ligne (gras, italique, code, liens, barré, listes) fonctionnent de la même manière que dans les articles.
Désactiver les commentaires
Les auteurs d'articles peuvent désactiver les commentaires sur leurs propres articles. Ouvrez le dialogue de modification de l'article et activez Désactiver les commentaires. Cela masque la zone de commentaire pour tout le monde, y compris vous, et empêche l'ajout de nouveaux commentaires. Les commentaires existants restent visibles ; en les réactivant, les utilisateurs peuvent à nouveau commenter.
La chronologie des articles
Les articles sont affichés sur une chronologie plutôt que dans une liste plate. Ils s'affichent du plus récent au plus ancien, regroupés sous un titre pour chaque mois, avec le jour de publication de chaque article marqué sur la barre latérale gauche. Les segments pointillés de la barre entre les articles représentent le temps écoulé entre eux, ce qui permet de voir rapidement une année calme.
Un index des années est situé à côté de la chronologie (au-dessus sur les écrans étroits). Cliquez sur une année pour accéder aux articles les plus récents de cette année. La section où vous atterrissez s'illumine brièvement afin qu'il soit facile de voir où vous vous trouvez.
Articles dans votre profil
Votre profil comporte un onglet Articles qui regroupe tous les articles que vous avez publiés, quel que soit le coffre ou la communauté, sur une seule chronologie. Chaque article indique le coffre ou la communauté dans lequel il a été publié, et le nom renvoie à celui-ci.
Les autres utilisateurs voient le même onglet sur votre profil, mais uniquement les articles qu'ils sont autorisés à voir. Un article privé reste le vôtre seul, un article visible par vos amis s'affiche pour vos amis, et les articles des coffres auxquels ils n'ont pas accès n'apparaissent pas.
Limites de contenu
Le contenu d'un article peut contenir jusqu'à 10 000 caractères. L'éditeur affiche un compteur de caractères lorsque vous approchez de la limite.
Compatibilité avec le texte brut
Si vous rédigez un article sans aucune syntaxe Markdown, il s'affichera exactement tel que vous l'avez tapé, avec les sauts de ligne et les espaces blancs préservés. Les articles existants créés avant l'ajout du support Markdown continueront à s'afficher correctement.
Sécurité
Tout le Markdown rendu est nettoyé avant d'être affiché. Cela signifie que :
- Les scripts, les iframes et autres éléments HTML potentiellement dangereux sont automatiquement supprimés.
- Le code HTML brut saisi dans les articles est échappé et affiché sous forme de texte.
- Les attributs de gestionnaires d'événements (comme
onclick) sont supprimés.
Vous n'avez pas à vous soucier de cela en tant qu'utilisateur, car cela se produit automatiquement en arrière-plan.
TIP
Vous pouvez rédiger des articles en texte brut comme auparavant. La mise en forme Markdown est entièrement facultative.