Composant des publications Wikifiées

[nathank (Nathan Kershaw)]

Description Simple

Ce composant de thème vous permet de rendre les publications Wiki (et les publications d’Éditions Partagées) plus évidentes.

Les Wikis et les Éditions Partagées sont une fonctionnalité puissante de Discourse, mais de nombreux utilisateurs ne connaissent pas ce concept et trouvent l’interface utilisateur un peu trop subtile. Ce composant rend tout cela parfaitement clair, en regroupant le contenu de Change the style of a wiki post.

Captures d’écran

Description Détaillée

L’installation de ce composant vous permet de contrôler la couleur d’arrière-plan des publications Wiki et d’ajouter du texte à l’icône d’historique/édition en haut à droite de la publication.

Il s’agit d’un fork de discourse-wikified-post-background-color par @pacharanero, intègre des éléments de Change the style of a wiki post et réutilise du code de Personal Message Bubbles par @Rhidian.

Paramètres

Couleur d’arrière-plan des publications Wiki

La couleur d’arrière-plan des publications Wiki peut être définie selon vos préférences. Par défaut, elle est réglée sur ‘highlight’, mais vous pouvez utiliser l’une de ces options :

1. Cela fonctionne mieux lorsqu’une couleur du Thème est choisie (c’est-à-dire primary, secondary, tertiary, etc.), car elles s’adaptent automatiquement au mode sombre.
2. Un nom de couleur reconnu en CSS (par exemple blue, red, yellow, black, etc.)
3. Un code couleur HTML (par exemple #effbfb, etc.)

Couleur d’arrière-plan des Éditions Partagées

Vous pouvez choisir l’une des mêmes options de couleur pour les publications d’Éditions Partagées (voir le Plugin Éditions Partagées)

Texte ajouté pour les publications Wiki

Cela ajoute un petit texte vert (par défaut Publication Wiki) dans le coin supérieur droit de la publication :

Ceci est dynamique et change de couleur avec l’icône d’historique s’il y a eu une modification récente (c’est une coïncidence heureuse non prévue) :

Si vous ne souhaitez aucun texte à cet endroit, supprimez le texte dans le paramètre et enregistrez-le.

Texte ajouté pour les Éditions Partagées

Le texte affiché lorsqu’il s’agit d’une publication d’Éditions Partagées. Il est dans la couleur Danger de votre palette.

Feuille de route

1. Étiqueter automatiquement les sujets avec ‘wiki’

Veuillez faire des suggestions en répondant à cette publication.

	Dépôt	GitHub - nathan-nz/discourse-wikified-posts: This allows you to make Wiki posts more obvious. · GitHub
	Guide d’installation	Comment installer un thème ou un composant de thème
	Nouveau sur les thèmes Discourse ?	Guide de débutant pour utiliser les thèmes Discourse

Installer ce composant de thème

[pacharanero (Marcus Baw)]

Superbes travaux @nathank !
Je vais archiver l’ancien dépôt de couleur d’arrière-plan pour les messages wikifiés, au profit de votre nouvelle version, qui ajoute beaucoup plus de fonctionnalités.

[Zup]

Quelqu’un d’autre rencontre-t-il cette erreur ?

Erreur : Variable non définie : « $Shared-edits-hide ». à la ligne 42 de common.scss >> @if ($Shared_edits_hide == « Yes »){ -----^

[nathank (Nathan Kershaw)]

Je ne peux pas reproduire cela et je ne vois aucun problème évident dans le code. Pouvez-vous nous donner plus d’informations ?

[Zup]

C’est parce que j’avais défini Shared edits hide sur Non. L’erreur est apparue dans les paramètres TC. L’erreur a disparu après l’avoir définie sur Oui.

[nathank (Nathan Kershaw)]

@Zup

C’est parce que j’avais défini « Masquer les modifications partagées » sur Non.

Je ne comprends pas avec « Non » ni « Oui » sur la dernière version bêta de Discourse. Êtes-vous sur une ancienne version de Discourse ? Je n’ai mis aucun contrôle de version dedans, désolé.

[Zup]

Désolé, ma faute - c’était un peu dépassé, ouais. J’ai oublié de tester à nouveau après la mise à jour récente jusqu’à ce que vous le mentionniez. Merci.

[nathank (Nathan Kershaw)]

J’ai mis à jour le composant pour mieux prendre en charge les publications d’éditions partagées.

Cela inclut son adaptation aux changements d’éditions partagées ici :

@Johani

J’ai poussé quelques changements.
DEV: improve interaction between wiki and shared-edit posts by hnb-ku · Pull Request #31 · discourse/discourse-shared-edits · GitHub

[nathank (Nathan Kershaw)]

J’ai apporté une légère modification aux couleurs d’arrière-plan par défaut car j’avais du mal à voir les @mentions.

De plus, la couleur d’arrière-plan des modifications partagées est maintenant par défaut sur tertiary-very-low.

Colour very low

[volanar]

Un excellent composant. Mais il améliore la visibilité uniquement sur la page du sujet. Est-il possible de le modifier pour que l’icône wiki s’affiche sur la page de catégorie, la liste des sujets « récents », « non lus », etc. ?

[nathank (Nathan Kershaw)]

Bonne suggestion, et je suis sûr que c’est possible (PR bienvenus !).

Je m’en occupe en marquant simplement les publications avec #wiki dans mes instances. C’est bien sûr semi-manuel - vous pouvez identifier les publications / sujets wiki par une recherche avancée. Cela a l’avantage supplémentaire de les rendre facilement découvrables via la navigation dans la barre latérale.

Je pensais que ce serait bien d’avoir un marquage automatique des publications wiki dans le cadre de ce composant (ou de faire comme vous suggérez), mais cela ne m’a pas causé assez de problèmes pour que j’y consacre du temps, j’en ai peur.

[Canapin (Coin-coin le Canapin)]

@volanar

Est-il possible de le modifier pour que l’icône wiki s’affiche sur la page de catégorie, la liste des sujets « récents », « non lus », etc. ?

J’ai posé cette question en 2021 ici : Add an icon in front of wikis in the topic list?

La réponse a été :

@Johani

Le wiki est une propriété au niveau du message, pas au niveau du sujet. Il n’est donc pas ajouté au modèle d’élément de liste de sujets. Vous pouvez utiliser une étiquette ou créer une demande de fonctionnalité pour que Discourse ajoute cette classe.

La demande de fonctionnalité :

Add a specific class for wikis (when first post) at the topic list level

Following the suggestion from @Johani here: To which Johani replied: Unfortunately, wiki is a post-level, not a topic-level property. So, It’s not added to the topic list item model. You can use a tag or create a feature request for Discourse to add that class. I suppose the vast majority of wikis are first posts, but I understand the post level issue. However, having the possibility of emphasizing wikis on the topic list would be a neat addition and may incite people to visit them and m…

[thoka (Thomas Kalka)]

Je cherche des conseils sur la façon d’adapter les couleurs d’arrière-plan au mode sombre (automatique).

Actuellement, les couleurs claires et vives que j’ai choisies pour les arrière-plans rendent les publications illisibles en mode sombre.

Serait-il possible d’étendre la palette de couleurs et d’effectuer des calculs de couleurs pour définir les couleurs d’arrière-plan pour les wikis et les pads ?

[thoka (Thomas Kalka)]

Vous pourriez utiliser des balises pour marquer les sujets de « wiki ».
Les balises peuvent être stylisées par CSS, si je me souviens bien.
Vous obtiendriez l’avantage supplémentaire d’une liste / d’une option de détail pour celles-ci.

De plus, une balise wiki pourrait être ajoutée aux sujets incluant automatiquement des wikis avec un plugin.

[nathank (Nathan Kershaw)]

Voici pourquoi je recommande une couleur Scheme :

@nathank

Cela fonctionne mieux lorsqu’une couleur Scheme est choisie (c’est-à-dire primaire, secondaire, tertiaire, etc.), car celles-ci sont réactives au mode sombre automatique.

Si vous souhaitez sortir des sentiers battus avec vos couleurs, vous devrez trouver un moyen astucieux de gérer le mode sombre.

Une fonctionnalité intéressante serait de permettre également la spécification d’une couleur pour le mode sombre. J’examinerai cela lorsque j’aurai un peu de temps libre.

[thoka (Thomas Kalka)]

@nathank

Cela fonctionne mieux lorsqu’une couleur Scheme est choisie (c’est-à-dire primaire, secondaire, tertiaire, etc.), car celles-ci sont réactives au mode sombre automatique.

Bien sûr. Mais ces couleurs sont trop dominantes pour un arrière-plan.
C’est pourquoi je rêvais de quelque chose comme 10% de couleur Scheme mélangé à 90% d’arrière-plan. Je suppose que SASS (ou quelque chose de similaire) n’est pas disponible en frontend.
Mais une magie CSS comme celle-ci fonctionnerait-elle ?

Mise à jour : rgba(0, 255, 0, 0.1) fonctionne très bien en mode sombre et clair.

[Canapin (Coin-coin le Canapin)]

@thoka

Je suppose que SASS (ou quelque chose de similaire) n’est pas disponible dans le frontend.
Mais est-ce qu’une magie CSS comme ceci fonctionnerait ?

Les fonctions SASS sont disponibles dans la section de personnalisation du thème, elles sont compilées lorsque vous enregistrez vos modifications. Vous ne pouvez cependant pas utiliser les fonctions SASS sur des variables de thème ou CSS.
Si vous souhaitez utiliser une fonction SASS sur une couleur de votre palette de couleurs, vous devez utiliser la variable SASS correspondante.

Fonctionnera

body {
    background: darken($secondary, 10%);
}

Ne fonctionnera pas

body {
    background: darken($my_theme_variable, 10%);
}

Ne fonctionnera pas

body {
    background: darken(var(--secondary), 10%);
}

Et sur le papier, je pense que ce que votre lien décrit devrait fonctionner.

[nathank (Nathan Kershaw)]

@Canapin

Les fonctions SASS sont disponibles dans la section de personnalisation du thème, elles sont compilées lorsque vous enregistrez vos modifications.

C’est peut-être une piste à explorer. Voici un guide (pour ma propre référence) sur l’utilisation de la fonction SASS mix() :

Manipulate Color with Ease | Sass and Compass for Designers