Guide de personnalisation des chevalets

Sharly Chess offre la possibilité de générer des chevalets de table standards :

  • chevalets d’échiquier, avec simplement les numéros de table, qui permettent aux joueur·euses de se repérer facilement dans la salle ;
  • chevalets des joueur·euses, qui donne un standing aux évènements et facilitent la saisie des feuilles de partie ;
  • chevalets d’appariement, qui permettent d’afficher sur les tables à la fois les numéros de table et les informations des joueur·euses.

Cette page explique comment personnaliser les chevalets.

L’éditeur de chevalets

Les modèles de chevalets se gèrent depuis le bouton Modèles situé à côté du sélecteur de modèle, dans la section chevalets de la fenêtre Documents. Les modèles sont communs à tous les évènements.

La bibliothèque de modèles liste les modèles intégrés, qui ne peuvent pas être modifiés, et vos modèles personnalisés. Depuis cette page, vous pouvez :

  • créer un nouveau modèle (en choisissant un nom et un type : chevalets de joueur·euses, d’échiquier ou d’appariement) ;
  • dupliquer n’importe quel modèle — la façon habituelle de partir d’un modèle intégré ;
  • importer un modèle partagé par quelqu’un d’autre (un fichier .zip) ou exporter les vôtres ;
  • supprimer un modèle personnalisé ;
  • ouvrir l’éditeur sur un modèle personnalisé.

L’éditeur affiche le chevalet à ses proportions réelles, avec des données d’exemple à la place des champs pour prévisualiser le résultat (et passer d’un·e joueur·euse d’exemple à un·e autre). Vous pouvez :

  • ajouter des éléments de texte et des images (téléversées depuis l’éditeur), puis les déplacer à la souris et ajuster leur largeur en tirant sur leurs bords ;
  • définir les propriétés du chevalet : nom, unité (mm ou pouces), largeur, hauteur, marge intérieure, et s’il est recto verso (pliable) ;
  • définir les propriétés de chaque élément dans le panneau latéral : le texte et ses champs (avec un préfixe et un suffixe optionnels, affichés seulement si le champ a une valeur), la police, la taille, le style (gras, italique, souligné, barré, capitales), l’alignement, les couleurs, l’opacité, les bordures, le point d’ancrage et l’ordre d’empilement ;
  • annuler et rétablir, zoomer, et afficher ou masquer les contours des éléments.

Les modifications sont enregistrées dans le modèle au fur et à mesure : la prochaine génération de chevalets les utilise.

:information_source: L’éditeur écrit les mêmes fichiers de modèle TOML que ceux décrits ci-dessous : un modèle construit dans l’éditeur peut donc toujours être peaufiné à la main — et inversement. Un contenu utilisant des expressions Jinja avancées est affiché tel quel dans l’éditeur et ne peut pas être modifié avec l’éditeur de blocs.

Modifier les modèles à la main

Les modèles personnalisés sont stockés sur le disque, un dossier par modèle. Pour en créer un à la main, il faut :

  • créer le dossier place_cards/ dans le dossier custom
  • créer un dossier dans custom/place_cards, par exemple custom/place_cards/essai
  • créer un modèle (fichier avec l’extension .template) dans ce dossier, par exemple custom/place_cards/essai/echiquiers.template.

Ce fichier au format TOML va vous permettre une personnalisation complète à l’aide de directives très simples.

N’hésitez pas à vous inspirer des modèles déjà existants de Sharly Chess, que vous pouvez télécharger et adapter à vos besoins (voir la bibliothèque de chevalets en bas de cette page).

Propriétés générales des chevalets

Name Meaning
type Le type de chevalet :<ul><li>player (chevalet de joueur·euse, par défaut)</li><li>board (chevalet d’échiquier)</li><li>pairing (chevalet d’appariement)</li></ul>
name Le nom du modèle, utilisé pour choisir parmi les modèles existants (par défaut le nom du fichier de modèle).
unit L’unité de mesure utilisée pour dimensionner la carte et positionner les éléments : mm (millimètre, par défaut) ou in (pouce).
padding L’espace intérieur des chevalets (pour faciliter la découpe), par ex. 2.5.
crop_marks Les marques de coupe : corners (par défaut), border ou none.
font Un fichier de police TrueType (ce fichier doit être présent dans le dossier custom/place_cards/fonts.
css Du code CSS additionnel.

Toutes les propriétés sont optionnelles, on utilisera par exemple :

type = "player"
name = "Chevalets de joueur·euses"
creator = "Moi <moi@home.org>"
unit = "mm"
padding = 2.5
crop_marks = "corners"
font = "my_font.ttf"
css = "body { background-color: #ddd }"

Ou plus simplement :

type = "player"
name = "Chevalets nominatifs"

:warning: L’utilisation de la propriété css est réservée aux utilisateur·ices avancé·es.

Éléments des chevalets

Un chevalet est composé d’un ensemble d’éléments, tous configurables :

  • des textes formatés (text = "...") ;
  • des images (image = "...").

Chaque élément est défini dans une section à son nom (lettres, chiffres et tirets, ci-dessous elo) :

[elo]
text = ""
bold = true
h_align = "right"

Éléments textuels

Les élements textuels peuvent afficher les informations des joueur·euses, ainsi que d’autres informations sur l’échiquier (pour les chevalets d’échiquier et d’appariement), le tournoi et l’évènement :

Information Signification Disponibilité
event.name Le nom de l’évènement toujours
event.start La date de début de l’évènement (utiliser event.start.year\|month\|day) toujours
event.stop La date de fin de l’évènement (utiliser event.stop.year\|month\|day) toujours
tournament.name Le nom du tournoi toujours
tournament.start La date de début du tournoi (utiliser tournament.start.year\|month\|day) toujours
tournament.stop La date de fin du tournoi (utiliser tournament.stop.year\|month\|day) toujours
board.number Le numéro de l’échiquier board, pairing
board.white_player Le joueur avec les Blancs pairing
board.black_player Le joueur avec les Noirs pairing
player.full_name Le nom complet du·de la joueur·euse (dépendant de la langue) player
player.first_name Le prénom du·de la joueur·euse player
player.last_name Le nom de famille du·de la joueur·euse player
player.rating Le classement du·de la joueur·euse, utilisé pour les appariements du tournoi player
player.rating_type Le type de classement du·de la joueur·euse (F=FIDE, N=National, E=Estimé) player
player.year_of_birth L’année de naissance du·de la joueur·euse player
player.gender Le genre du·de la joueur·euse, sur une lettre player
player.title Le titre FIDE du·de la joueur·euse, le cas échéant player
player.federation La fédération du·de la joueur·euse, sur trois lettres player
player.federation_flag Le drapeau de la fédération du·de la joueur·euse player
player.club Le club du·de la joueur·euse, le cas échéant player
player.category La catégorie du·de la joueur·euse player

:information_source: Il est possible d’accéder aux informations des joueur·euses board.white_player et board.black_player pour les chevalets d’appariement, par exemple board.white_player.full_name.

:information_source: Les plug-ins peuvent ajouter des informations supplémentaires à celles proposées ci-dessus.

Images

Des images peuvent être ajoutées sur les chevalets, par exemple :

[logo]
image = "logo.jpg"
width = 20
h_align = "right"
v_align = "bottom"

:information_source: Les images doivent être stockées dans un dossier images au même niveau que le fichier de modèle.

Formatage des chevalets

Styles

Des styles peuvent être appliqués :

  • à tous les éléments (déclaration dans l’entête du fichier TOML) ;
  • individuellement à chacun des éléments (dans la section de l’élément).
font_size = 14.0
bold = false
italic = false
h_align = "left"
v_align = "top"
h_pos = 0.0
v_pos = 0.0

Génération recto-verso en miroir

Pour des chevalets symétriques recto-verso, il suffit de cocher la case correspondante dans le dialogue de génération des documents et les éléments entrés seront automatiquement dupliqués et affichés de chaque côté du chevalet.

Génération recto-verso différenciée

Pour des chevalets recto-verso différenciés, il suffit d’indiquer pour les éléments à générer sur le verso la propriété side = back (par défaut, la valeur est side = front).

Référence des propriétés des éléments

Styles (modèles et élements)

Nom Signification
font_size La taille de la police (unité : pt).
bold true pour une police grasse, false sinon.
italic true pour une police penchée, false sinon.
h_align L’alignement horizontal : left (par défaut), center ou right.
v_align L’alignement vertical : top (par défaut), middle ou bottom.
h_pos Le positionnement horizontal (par rapport à la marge ou au center).
v_pos Le positionnement vertical (par rapport à la marge ou au milieu).
v_pos Le positionnement vertical (par rapport à la marge ou au milieu).
opacity L’opacité, de 0.0 (transparent) à 1.0 (totalement opaque).
background_color La couleur de fond (#nnn, #nnnnnn, color, rbg(nnn, nnn, nnn), …).
color La couleur (texte seulement).
width La largeur du chevalet ou de l’élément.
height La hauteur du chevalet ou de l’élément.

Élements seulement

Nom Signification
display true pour afficher l’élément, false pour la cacher.
max_width La largeur maximale.
rotate La rotation de l’élément (en degrés).
text Le texte de l’élément.
preview_text Le texte utilisé en prévisualisation.
image Le nom du fichier d’image (doit être dans le sous-dossier images).
side front pour faire figurer l’élément sur le recto (par défaut), back pour le verso.

Export des chevalets

Si vous souhaitez envoyer les chevalets que vous avez générés (par exemple pour les confier à quelqu’un pour l’impression), il suffit d’enregistrer le fichier HTML produit (tous les éléments y compris les images et les polices sont contenues dans un seul fichier HTML).

Bibliothèque de chevalets

la bibliothèque ci-dessous comprend les chevalets standards de Sharly Chess et quelques exemples. N’hésitez pas à contribuer en nous envoyant vos plus beaux chevalets !

Chevalets des joueur·euses - Standard

  • Origine : inclus dans Sharly Chess
  • Création : Sharly Chess <support@sharly-chess.com>
  • Dimension (mm) : 116.0x36.0
  • Télécharger

Chevalets des joueur·euses - Standard (pas de drapeau)

  • Origine : inclus dans Sharly Chess
  • Création : Sharly Chess <support@sharly-chess.com>
  • Dimension (mm) : 116.0x36.0
  • Télécharger

Chevalets des joueur·euses - Domloup

  • Origine : exemple
  • Création : Pascal AUBRY <pascal.aubry@echecs35.fr>
  • Dimension (mm) : 116.0x36.0
  • Télécharger

Chevalets des échiquiers - Numéro

  • Origine : inclus dans Sharly Chess
  • Création : Sharly Chess <support@sharly-chess.com>
  • Dimension (mm) : 48.0x36.0
  • Télécharger

Chevalets des échiquiers - Numéro (tournoi devant)

  • Origine : inclus dans Sharly Chess
  • Création : Sharly Chess <support@sharly-chess.com>
  • Dimension (mm) : 48.0x36.0
  • Télécharger

Chevalets des échiquiers - Numéro (double-face, tournoi au dos)

  • Origine : inclus dans Sharly Chess
  • Création : Sharly Chess <support@sharly-chess.com>
  • Dimension (mm) : 48.0x36.0
  • Télécharger

Chevalets des échiquiers - Texte

  • Origine : inclus dans Sharly Chess
  • Création : Sharly Chess <support@sharly-chess.com>
  • Dimension (mm) : 116.0x36.0
  • Télécharger

Chevalets des échiquiers - Texte (tournoi devant)

  • Origine : inclus dans Sharly Chess
  • Création : Sharly Chess <support@sharly-chess.com>
  • Dimension (mm) : 116.0x36.0
  • Télécharger

Chevalets des échiquiers - Texte (double-face, tournoi au dos)

  • Origine : inclus dans Sharly Chess
  • Création : Sharly Chess <support@sharly-chess.com>
  • Dimension (mm) : 116.0x36.0
  • Télécharger

Chevalets des échiquiers - Domloup

  • Origine : exemple
  • Création : Pascal AUBRY <pascal.aubry@echecs35.fr>
  • Dimension (mm) : 116.0x36.0
  • Télécharger

Chevalets d’appariement - Standard

  • Origine : inclus dans Sharly Chess
  • Création : Sharly Chess <support@sharly-chess.com>
  • Dimension (mm) : 148.5x50.0
  • Télécharger

Chevalets d’appariement - Standard (pas de drapeau)

  • Origine : inclus dans Sharly Chess
  • Création : Sharly Chess <support@sharly-chess.com>
  • Dimension (mm) : 148.5x50.0
  • Télécharger