Guide d'utilisation du forum

CODEX DISCOURSUM - Guide de compréhension supérieure (sur iunctis)

Discourse est un forum qui offre beaucoup de possibilités ; de la mise en forme à l’intégration de média en passant par les options poussées et les raccourcis clavier, tout est fait pour se sentir à l’aise. Mais comme pour toutes les nouvelles choses, il faut un temps d’adaptation et d’apprentisage, c’est pour cela que nous avons crée ce Codex Discoursum, pour vous aider à prendre en main ce brillant outils qu’est Discourse afin de profiter pleinement d’iunctis.


MESSAGES


Mise en forme (markdown, html, bbcode)


iunctis.fr et Discourse en général utilisent plusieurs types de langages de mise en forme. Cela va du langage Markdown (utilisé sur reddit par exemple), html (langage principal des sites internet) ou les BBcodes (des forums anciennes générations comme phpBB, IPB, etc.).

Voici un listing des codes utilisables sur ce forum :

Fonctions basiques

  • Mettre en gras

  • **Texte** / __Texte__

  • <b>Texte</b> / <strong>Texte</strong>

  • [b]Texte[/b]

  • Mettre en italique

  • *Texte* / _Texte_

  • <i>Texte</i>

  • [i]Texte[/i]

  • Souligner

  • [u]Texte[/u]

  • Barrer

  • <s>Texte</s>

  • [s]Texte[/s]

  • Surligner

  • [su]Texte[/su]

  • Colorer un texte

  • [color=red]Texte[/color] / [color=#FF3300]Texte[/color]

  • <font color=red>Texte</font>

  • Ajouter une URL

  • [Titre du lien](http://lien)

  • <a href="http://">Titre du lien</a>

  • [url=http://]Titre du lien[/url]

  • Ajouter une image

  • Mettez le lien de l’image seul sur une ligne

  • <img src="http://lien">

  • [img]http://lien[/img]

  • Barre verticale

  • ----- / _____ (seul sur une ligne)

  • <hr>

  • Flouter un texte (fonctionne aussi pour les images)

  • [spoiler]Texte[/spoiler]


Titres, sous-titres, tailles du texte

  • Balises titres (hiérarchisation) : pour aider au référencement, un système de hiérarchisation des titres a été mis en place sur Internet.

  • <h1>Titre</h1> / # Titre pour le titre principal

  • <h2>Titre</h2> / ## Titre pour le sous-titre ou les titres de chapitres

  • <h3>Titre</h3> / ### Titre pour les sous-rubriques ou des titres mineurs.

  • etc.

  • Taille du texte

  • [size=7]Texte[/size] taille maximale autorisée

  • [size=6]Texte[/size]

  • [size=5]Texte[/size]

  • [size=4]Texte[/size]

  • [size=3]Texte[/size]

  • Texte de taille normale entre 2 et 3

  • [size=2]Texte[/size]

  • [small]Texte[/small] / [size=1]Texte[/size]


Alignement, positionnement

  • Centrer

  • <div align="center">Texte ou image</div>

  • [center]Texte[/center]

  • Aligner à droite

  • <div align="right">Texte ou image</div>

  • [right]Texte[/right]

  • Justifier un texte

  • <div align="justify">Texte ou image</div>

  • [justify]Texte[/justify]

  • Élément flottant (float) : permet de placer un élément à gauche ou à droite de votre paragraphe principal pour une meilleure utilisation de l’espace.

  • [floatl]Texte ou image[/floatl] pour un élément placé à gauche

  • [floatr]Texte ou image[/floatr] pour un élément placé à droite


Fonctions plus complexes


  • Cacher du texte

  • <details><summary>Texte visible</summary>Texte caché</details>

  • [details=Texte visible]Texte caché[/details]

  • Redimensionner une image

  • ![image|16x09](https://lien-image) le premier chiffre correspond à la largeur en pixels, le second à la hauteur, en pixels.

  • <img src="lien image" width="500" height="500" /> width correspond à la largeur en pixels, height à la hauteur, en pixels.

  • Créer un ancrage (consultez le guide dédié pour plus d’explications)

  • [**Texte**](#Ancre) point d’ancrage 1

  • <a name="Ancre"></a> destination de l’ancre


Ajouter une image dans votre message


Uploader une image

Rien de plus simple. Pour heberger une image et la partager, il vous suffit de cliquer sur le bouton « Joindre un fichier » et de vous laisser guider.


L’intégration d’images déjà hébergées

Il y a une multitude d’options pour intégrer une image chez nous si l’image est déjà hébergée ailleurs que sur notre site. Chacune à ses avantages et c’est plus ou moins compliqué. Je vais en expliquer deux ici, les plus simples.

Si vous souhaitez simplement partager une image, le plus simple est de copier le lien de cette image dans l’éditeur de texte, tout simplement. Pas besoin de balises. Nada !. Le lien de l’image doit simplement être seul sur une ligne de votre message.

La seconde option est tout aussi « basique », elle est un peu pour les nostalgiques, il faut simplement trouver le bon bouton dans l’éditeur de texte afin d’ouvrir la balise. Le voila :


Ajouter une vidéo


Grace à notre moteur Discourse, nous avons la possibilité d’intégrer nativement des vidéos de formats différents. De Youtube à Dailymotion en passant par Vine, vous pouvez aussi intégrer directement des vidéos au format .mp4 et .webm, il y a beaucoup de possibilités. Le plus beau ? Il n’y a rien a faire, juste a copier le lien, c’est tout.

Pour Youtube, rien de plus simple le lien de la page suffit, mais pour d’autres hébergeurs, il est préférable de faire un clic droite directement sur la vidéo pour récuperer le lien grâce à l’option ; Copier l’adresse de la vidéo

Exemple pour un lien Youtube :

https://www.youtube.com/watch?v=ShyB5h9p7jk

Il sera intégré comme ça sur iunctis :


Ouvrir un sondage


Créer un sondage sur iunctis.fr est très simple, un outil a été créé pour cela. Cliquez sur la dernière icône de la barre de formatage et cliquez sur l’option Créer un sondage :

Vous pourrez en quelques clics créer un sondage simple (un choix unique parmi x options), un sondage à nombres (exemple donner une note entre 0 et 10) ou un sondage à choix multiples (choisir une ou plusieurs options parmi votre liste de choix).

Les votes peuvent être publics ou non.


Faire un tableau


Il est possible de créer un tableau de façon assez simple, il suffira d’utiliser le caractère | (Alt Gr + touche 6) et d’avoir de la logique.

Pour ce guide, on va utiliser un tableau à trois colonnes, mais vous pouvez en faire avec le nombre que vous souhaitez. Sachez juste qu’un tableau avec trop de colonnes pourrait ne pas s’afficher correctement.

Le tableau s’organise assez simplement, chaque | va définir une colonne, et entre chaque | vous y insérez le contenu que vous voulez.

Mais d’abord, il faut créer les intitulés des colonnes, il vous faudra deux lignes, la première indique les intitulés, la seconde marque la séparation avec le reste du tableau. Et on le verra un peu plus loin, cette ligne de démarcation va gérer les alignements :

| Colonne 1 | Colonne 2 | Colonne 3|
|---|---|---|

Voici notre base pour le tableau :

Colonne 1 Colonne 2 Colonne 3

On va à présent ajouter une première ligne :

| Colonne 1 | Colonne 2 | Colonne 3|
|---|---|---|
| A1 | B1 | C1 |
Colonne 1 Colonne 2 Colonne 3
A1 B1 C1

Sachez que vous pouvez intégrer au tableau des images ou des emojis. La largeur des colonnes va s’adapter toute seule à son contenu.


Pour bien montrer le reste du remplissage, on va ajouter une deuxième ligne

| Colonne 1 | Colonne 2 | Colonne 3|
|---|---|---|
| A1 | B1 | C1 |
| A2 | B2 | C2 |
Colonne 1 Colonne 2 Colonne 3
A1 B1 C1
A2 B2 C2

C’est assez simple !

Il est à noter que si vous voulez insérer une case vide, vous devez tout de même créer les démarcations |. Laissons la case B2 vide pour voir :

| Colonne 1 | Colonne 2 | Colonne 3|
|---|---|---|
| A1 | B1 | C1 |
| A2 |  | C2 |
Colonne 1 Colonne 2 Colonne 3
A1 B1 C1
A2 C2

Parlons alignement maintenant : comme je l’ai indiqué, la deuxième ligne avec les tirets gère la démarcation entre l’en-tête du tableau et son contenu, mais il permet aussi de définir l’alignement : gauche, centré ou à droite, pour cela il suffit d’ajouter : à gauche des tirets pour un alignement à gauche, à gauche et à droite pour un centrage, et à droite pour l’alignement à droite :

| Aligné à gauche | Centré | Aligné à droite|
|:---|:---:|---:|
| Jean-Luc Mélenchon | Emmanuel Macron | François Fillon |
| :jlm3: | :macron: | :fillon2: |

Cela donne :

Aligné à gauche Centré Aligné à droite
Jean-Luc Mélenchon Emmanuel Macron François Fillon
:jlm3: :macron: :fillon2:

Si vous voulez importer facilement un tableau Excel ou un fichier csv, vous pouvez utiliser l’outil Tables Generator. Il automatise la mise en forme du tableau en markdown (le langage qu’utilise Discourse).

Voilà vous savez tout ce qu’il y a à savoir sur la construction d’un tableau !


Créer un sommaire


Sur iunctis, on aime parfois créer des sujets très denses, avec une présentation détaillée et ordonnée. Avec Discourse, il est possible de créer un sommaire au sein même d’un message pour permettre de vous amener à un endroit précis. Façon répertoire, sommaire ou pour chapitrer un récit, vous pouvez adapter cette fonction appelée ancrage en html de toutes les façons que vous souhaitez.

Pour des raisons logiques (il y a déjà un sommaire sur ce message) nous ne pouvons pas vous monter comment faire un sondage ici, mais le guide est disponible sur ce sujet :


ASTUCES DU FORUM


Mentions


Mention d’utilisateurs

Sur iunctis, il est possible de faire une mention à un membre pour attirer son attention. Avec une simple mention @Tyler ou @Steven, le membre concerné recevra une notification.


Mention de groupes

De manière similaire, il est possible de faire une mention groupée pour éviter d’interpeller plusieurs personnes concernées une à une. Avec une simple mention @Admin ou @Staff, chaque membre du groupe concerné recevra une notification.

Nous avons mis à profit cette option pour faciliter le travail des gestionnaires de pronostics ou fantasy diverses. Par exemple, en participant à la Fantasy League de Tennis, Matthe utilise la mention @Tennis, et chaque membre du groupe recevra une notification, comme s’il avait été mentionné individuellement.


Désépingler un sujet


Dans la liste des messages récents et dans certaines rubriques, il y a des sujets épinglés. Pour une mise en avant temporaire ou définitive de sujets importants, ils resteront en permanence tout en haut de cette liste.

Vous pouvez à votre guise désépingler ces sujets s’ils ne sont pas importants pour vous ou si la disposition vous convient mieux sans.

Pour cela, rien de plus simple, il vous suffit de cliquer sur l’icône en forme d’épingle, et il sera dorénavant affiché comme un sujet normal.


Lien rapide vers une catégorie


Autre fonction méconnue, le hashtag catégorie peut s’avérer pratique pour éviter des allers-retours sur le forum pour donner un lien vers une rubrique.

Si dans un sujet quelconque, vous êtes amenés à mentionner une rubrique, il vous suffit de faire un hashtag # et avec le menu contextuel, vous pourrez facilement trouver la rubrique à partager. Par exemple, si je veux vous envoyer vers la rubrique jeux vidéo du forum, au lieu d’aller faire un copier-coller du lien de la rubrique, je peux faire ça : Jeux vidéo

Note : le hashtag est aussi utilisé pour une mise en forme du texte, ainsi le hashtag de catégorie ne peut fonctionner en tout début de ligne, faites un espace puis le hashtag.


Choisir l’extrait d’un sujet


Lorsque l’on met un sujet en épingle ou qu’on fait un lien vers un autre sujet du forum, il y a un texte qui accompagne cette action. Par défaut, ce sont les premiers caractères d’un sujet. Sur Discourse, il est possible de choisir quel texte sera mis en avant. Pour nos topic live foot, on donne en général les affiches du jour, pour une série, cela peut être son synopsis.

Pour choisir un extrait, vous devez le mettre dans la balise suivante :

<span class='excerpt'></span>

Voici un exemple concret, dans ce sujet, j’ai mis le synopsis en avant :


Navigation rapide entre les catégories


Vous êtes sans doute nombreux à utiliser ce menu mais il est toujours bon de le rappeler, s’il existe une page catégories qui rappelle les forums « classiques », on dispose aussi d’un menu de navigation rapide pour accéder aux rubriques de votre choix. Que ce soit en ouvrant le menu hamburger ou le menu déroulant des catégories, vous accéderez rapidement aux sujets de votre choix.



RÉGLAGES DES PRÉFÉRENCES


Accéder aux préférences


Les préférences permettent de personnaliser votre profil, ajouter un fond d’écran à votre carte d’utilisateur ou votre profil et aussi régler des options.

Pour y accéder c’est très simple, ouvrez le menu où apparaît votre avatar et allez dans les Préférences ou cliquez directement sur ce lien.

 


Avatars et fonds d’écran


  • Avatar : trois options sont disponibles. Utiliser l’image générée par le forum (première lettre de votre pseudo devant un fond coloré), utiliser votre image Gravatar ou charger une image depuis votre PC. Pour une utilisation optimale, votre image doit avoir la même largeur et la même hauteur. Si vous avez besoin d’aide, consultez le sujet Place graphisme. Si vous ne connaissez pas Gravatar, c’est un site utilisé par de nombreux blogs ou forums pour gérer un avatar. Une fois inscrits, chargez votre avatar, et il apparaîtra sur les sites compatibles.

  • Arrière plan de profil : Cette image apparaît en en-tête de votre page de profil. Les dimensions varient en fonction des options que vous remplissez. Par défaut, la taille recommandée est de 1110 pixels de large, et 420 pixels de haut. Mais si vous remplissez beaucoup d’infos dans A propos de moi et vos séries, films, jeux préférés, il faudra une image plus grande en hauteur.

  • Arrière plan de la carte d’utilisateur : Sur le forum, lorsque que vous cliquez sur un pseudo, une fenêtre s’ouvre, c’est la carte d’utilisateur. Vous pouvez utiliser une image de fond d’écran sur celle-ci. Les dimensions de base sont de 580 pixels de large, et 306 pixels de haut.

Les options suivantes sont des informations qui apparaîtront sur votre carte d’utilisateur et/ou votre profil. L’intitulé est clair.


Courriels


Voici les options disponibles :

  • Inclure les réponses précédentes en bas des courriels
  • Inclure un extrait du message auquel il a été répondu dans les courriels
  • M’envoyer un courriel quand quelqu’un m’envoie un message privé
  • M’envoyer un courriel quand quelqu’un me cite, répond à mon message ou mentionne mon @pseudo ou m’invite à rejoindre un sujet
  • Recevoir des notifications par email même lorsque je suis actif sur le site
  • Lorsque je ne visite pas le site, m’envoyer un courriel avec un résumé des sujets et réponses populaires

La cinquième option, vous permet de ne pas recevoir de mails lorsque vous êtes sur le site, elle est intéressante car les mails sont généralement faits pour se rappeler de consulter le forum, ou vous rappeler d’un message que vous avez suivi, mais si vous êtes présents en direct pour le suivre, ils sont inutiles. Activer cette option permet déjà de limiter l’envoi de mails par notre application, mais soulage aussi votre boîte mail.


Autres options


Voici quelques compléments d’informations sur d’autres options disponibles.

  • Concernant les notifications, nous vous conseillons ces réglages si vous voulez ne rien louper sur le forum :


    Cela permet, si vous le souhaitez, de suivre au mieux tous les sujets du forum, repérer les nouveaux sujets postés, ou avoir le compteur de messages non lus des sujets que vous avez déjà ouverts.

  • Ouvrir tous les liens externes dans un nouvel onglet : au lieu de forcer la main, vous avez le choix, désactiver cette option permet d’avoir une navigation fluide sur un seul onglet, s’il y a un lien vers un autre site il s’ouvre dans la même fenêtre. Pratique sur mobiles notamment. En ouvrant dans de nouveaux onglets vous pouvez continuer votre lecture du sujet et regarder le lien plus tard, sur une autre fenêtre.

  • Proposer la citation du texte surligné : en sélectionnant un bout de texte d’un message sur iunctis, il est possible d’avoir un bouton Citer qui apparaisse. Pratique pour citer un extrait sans avoir à citer tout un message, cette option fonctionnent évidemment bien mieux sur PC, si vous utilisez majoritairement tablette ou mobile, l’apparition de ce bouton peut s’avérer désagréable à l’utilisation.

  • Faire apparaître le nombre de sujets récemment créés ou mis à jour sur l’icône navigateur : cette fonction n’est pas compatible avec tous les navigateurs. Dans votre navigateur, vous pourrez voir le nombre de sujets créés ou MAJ dans le titre de l’onglet.

  • Ne pas se déplacer à mon nouveau message après avoir répondu : une fois que vous avez posté un message, vous êtes redirigez dessus, c’est pratique pour se relire, ou voir s’il n’y a pas un problème d’affichage. Cependant, comme vous le savez, vous pouvez écrire un message et continuer à naviguer sur le forum, visiter d’autres sujets, en activant cette option, vous pourrez écrire votre message, le poster, et continuer à lire sans être dérangé;

  • Autoriser les autres utilisateurs à consulter les modifications de mes messages : lorsqu’un message est édité, le staff a généralement accès à un historique des modifications, vous pouvez choisir, ou non de donner la possibilité de consulter l’historique à tout le monde.


Catégories


Vous pouvez enfin surveiller les sujets d’une catégories (vous recevrez une notification à chaque message posté sur les sujets de cette catégorie), les suivre (les nouveaux messages seront considérés comme non lus, même sans avoir ouvert le sujet), masquer une vous ne vous intéresse pas (ils n’apparaîtront pas dans le listing des sujets Récents).

Pour plus d’infos sur le suivi des sujets, je vous renvoie vers le guide de Tyler :

Guide conçu par Steven et Tyler - iunctis.fr

2 « J'aime »

Le guide a du être reposté en raison d’un soucis technique (venant des sondages), on en a profité pour refaire certaines parties.

  • Les images ont été refaites pour utiliser le thème par défaut (thème clair)
  • Des parties ont été simplifiées ou réécrites
  • Le guide pour créer un tableau a été ajouté.

Le site tables generator intègre une option pour traduire en format markdown (le langage utilisé dans les messages Discourse) un tableau, le Markdown Tables Generator. Vous pouvez le créer à partir de rien, importer un tableau excel ou un fichier csv. C’est un outil très pratique qui peut simplifier la création de longs tableaux !

http://www.tablesgenerator.com/markdown_tables

3 « J'aime »

:bave: