CALS Tables
Le composant CalsTable prend en charge la balise modèle de tableau CALS utilisée par DocBook et DITA : cellules fusionnées, largeurs et alignement par colonne, ainsi qu’un contrôle précis des bordures. Un éditeur graphique de grille intégré au CMS gère la structure (fusion et division de cellules, insertion et suppression de lignes et de colonnes, alignement des cellules et des colonnes) ; vous n’avez donc jamais besoin de modifier manuellement les données du tableau sous-jacent.
- Sélectionnez CALS Table dans la liste Embed.
- Utilisez les commandes Cadre, Titre et Sur toute la page situées en haut pour définir la bordure extérieure, la légende et la largeur du tableau.
- Cliquez sur une cellule pour la sélectionner. Cliquez tout en maintenant la touche Maj enfoncée ou faites glisser pour sélectionner une plage rectangulaire de cellules.
- Cliquez sur Fusionner pour fusionner les cellules sélectionnées, ou sur Diviser pour annuler une fusion. L’option Fusionner n’est disponible que lorsque la sélection forme un rectangle net qui ne traverse pas une cellule déjà fusionnée.
- Utilisez Insérer une ligne au-dessus/en dessous, Supprimer une ligne, Insérer une colonne à gauche/à droite et Supprimer une colonne pour modifier la forme de la grille.
- Utilisez Alignement des cellules, Alignement vertical des cellules et Alignement des colonnes pour définir l'alignement des cellules sélectionnées et de leurs colonnes.
- Double-cliquez sur une cellule pour modifier son contenu. Le contenu des cellules est au format Markdown ; les balises
**gras**,*italique*, les liens et le code en ligne fonctionnent donc tous. Appuyez sur Entrée pour commencer une nouvelle ligne dans une cellule. - Enregistrez vos modifications.
Chaque tableau comporte une section d'en-tête, une section de corps et une section de pied de page, avec un seul ensemble de colonnes. Les fonctionnalités DocBook permettant d'utiliser plusieurs tgroup par tableau et les tableaux imbriqués (entrytbl) ne sont pas prises en charge.
Alignement des cellules
CALS récupère l'alignement d'une cellule à partir du premier des trois emplacements qui en définissent un : la cellule, puis tout span auquel elle appartient, puis sa colonne. L'éditeur enregistre deux de ces trois éléments, à savoir la cellule et la colonne :
- Alignement des cellules définit l'alignement horizontal des cellules sélectionnées.
- Alignement vertical des cellules définit l’alignement vertical des cellules sélectionnées.
- Alignement des colonnes définit l’alignement horizontal de toutes les cellules des colonnes sélectionnées.
Sélectionner Hériter efface un paramètre au lieu de l'enregistrer ; ainsi, une cellule reprend les paramètres de sa colonne, et une colonne ceux de la valeur par défaut du site.
Pour définir cette valeur par défaut, sélectionnez Paramètres dans la liste des collections, ouvrez Tableaux CALS, puis choisissez un Alignement des cellules. Ce paramètre s'applique à tous les tableaux CALS du site, en-têtes compris, et uniquement aux cellules qui ne définissent pas leur propre alignement — l'alignement défini au niveau d'une cellule ou d'une colonne prévaut toujours sur celui-ci. L'option Par défaut du navigateur centre les en-têtes et aligne les cellules du corps à gauche.
Utilisation des variables dans un tableau
Les cellules, les en-têtes et le titre du tableau peuvent tous contenir des variables, qui sont remplacées par la langue de la page sur laquelle elles apparaissent.
- Sélectionnez une cellule, puis choisissez une option dans la liste Variable de cellule pour y ajouter une variable.
- Pour insérer une variable dans la légende, sélectionnez-la dans la liste située à côté du champ Titre.
Ces deux listes ajoutent la variable à la fin du texte ; vous pouvez donc modifier la cellule ou le titre par la suite si vous en avez besoin ailleurs. Le titre prend également en charge le Markdown : les balises **gras** et les liens y fonctionnent donc aussi.
Une variable dont la clé n'existe plus l'indique clairement, tout comme on le ferait dans un paragraphe :
set_key NOT FOUND
La compilation aboutit quand même ; une seule touche mal tapée ne vous empêche donc pas de prévisualiser le site.
Exemple :
Channel | Cadence | Support |
|---|---|---|
Stable | Monthly | Full |
Beta | Weekly | |
Nightly | None | |
Pour en savoir plus sur le modèle sous-jacent, consultez la référence du modèle de tableau CALS ou la documentation sur les tableaux DocBook.