Éditeur de contenus

Guide d'utilisation

1. Découvrir

1.1. L'interface utilisateur

L'éditeur propose toutes les fonctions nécessaires à la rédaction structurée : il permet de manipuler de l'information et non du formatage ou de la mise en page :

En tant que rédacteur, vous associez de la sémantique à des groupes de mots.
Vous ne travaillez donc pas sur le document tel qu'il sera publié.
La feuille de style de chaque publication exploite cette sémantique pour appliquer le formatage adapté.

	Traitement de l'information
	Structurer les contenus permet également de traiter l'information pour autre chose que du formatage, comme lister les noms de produits cités dans un document.

L'éditeur Calenco comporte plusieurs zones :

Nous pensons que vous n'avez pas à connaître en détail le code pour produire votre documentation. Néanmoins, les documents produits avec Calenco sont conformes au standard XML DocBook.

L'éditeur vous guide donc à chaque étape en garantissant cette conformité.

Lors de l'insertion d'éléments, l'éditeur propose donc des options avec les icônes suivantes. Cliquez sur l’icône correspondant à votre besoin :

Tableau 1. Options d'insertion

L'élément est inséré à cet endroit.


	Une infobulle indique le niveau de la structure où sera inséré l'élément.

L'élément inséré englobe l'élément courant.

L'élément inséré remplace l'élément courant.

L'élément est inséré à cette position dans le texte.

1.2. Manipuler les éléments

Les documents structurés sont constitués d'éléments emboîtés les uns dans les autres. Ces éléments sont représentés sous différents aspects :

l'élément dans le Contexte,
la barre verticale, à gauche de l'élément dans la zone de rédaction,
un élément de l'arborescence dans l'onglet de navigation à gauche.

Vous pouvez sélectionner ces éléments en cliquant sur leur représentation pour effectuer les actions voulues.

2. Structurer

La structure du document est représentée sous forme de table des matières dans la zone de gauche. Cette vue permet de naviguer dans le document et de le modifier.

Cette zone peut être masquée à l'aide de situé eh haut à gauche du logo Calenco, pour agrandir la zone de rédaction.

2.1. Naviguer

Dans la table des matières, cliquez sur un titre pour accéder rapidement au contenu correspondant.


	Utilisez le raccourci clavier Alt+Molette pour plier ou déplier la structure.

2.2. Ajouter des éléments de structure

Vous pouvez insérer les éléments de structure de deux manières :

À partir de la barre d'icônes Structure ;
À partir du menu contextuel de la table des matières.

2.3. Changer le niveau d'une structure

Réorganiser la structure d'un document nécessite parfois de modifier le type d’élément.

Les commandes suivantes permettent de transformer des éléments (partie, chapitre, section) en d'autres éléments suivant que l'élément doit être remonté ou descendu dans la structure.

Il suffit de sélectionner le titre concerné et de lancer la commande :

	Créer un nouveau titre
	Monter un paragraphe consiste à le transformer en section.

2.4. Diviser une structure

Diviser la structure permet de créer deux structures du même type que la structure actuelle : le contenu est réparti dans les 2 structures à partir du curseur.

Consultez la démonstration de l'interface et des fonctionnalités basiques de l'éditeur :

2.5. Transformer une structure

Il est possible de transformer tout un fichier grâce à une feuille de style de transformation.

Dans le menu Outils → Transformer, choisissez la feuille de style correspondant au besoin :

L'éditeur ferme le fichier et le rouvre avec les transformations. L'historique des versions est mis à jour.

Les transformations sont complètement personnalisées et sont le fruit d'un développement.

Veuillez contacter votre interlocuteur NeoDoc habituel (<contact@calenco.com>) pour définir votre besoin.

3. Produire

Les éléments de corps de texte sont accessibles dans le menu Contenu.

3.1. Insérer un tableau

Utilisez la barre d'icônes Tableaux et images pour insérer un tableau.

Utilisez les icônes et pour ajouter ou supprimer des lignes ou des colonnes.

Utilisez le menu Tableau ou le menu contextuel (clic droit sur la barre grise supérieure, dans une cellule ou sur la barre grise à gauche d'une ligne) pour modifier la structure d'un tableau ou le paramétrage de ses éléments :

Figure 1. Menu contextuel du tableau

Figure 2. Menu contextuel d'une cellule

Figure 3. Menu contextuel d'une ligne

L’icône en haut à gauche < permet d'afficher les repères des lignes et des colonnes : c'est notamment utile pour définir des calculs (Variables et fonctions dans un tableau).

3.1.1. Vérifier la validité des tableaux

Cet outil permet de valider la conformité des tableaux. Cette fonction est notamment utile lorsque vous importez des fichiers comportant des tableaux avec des cellules fusionnées.

Cliquez sur Tableau → Valider les tableaux.
Si au moins un tableau comporte une erreur, un message de ce type avec l'erreur constatée s'affiche à l'écran :
En cliquant sur l'erreur, le tableau correspondant est affiché à l'écran.

La validité des tableaux est vérifiée automatiquement à l'enregistrement.

Ces erreurs ne sont pas bloquantes pour l'édition mais elles le seront vraisemblablement lors de la publication : il est vivement conseillé de les corriger au fur et à mesure.

3.2. Insérer une image

Il est possible d'intégrer dans vos contenus des images. Différents formats sont supportés :

JPEG – format compressé, adapté pour photos.
PNG ou GIF– image matricielle, adaptée pour copies d’écran et graphiques.
SVG – format vectoriel, adapté pour les illustrations.
SVG et traductions
Ce format est supporté par les outils de traduction : cela permet de partager une seule image pour toutes les langues.

	SVG et traductions
Ce format est supporté par les outils de traduction : cela permet de partager une seule image pour toutes les langues.

	Autres formats
	D'autres formats tels que le PDF ou TIFF peuvent être utilisés comme images mais ne sont pas conseillés car pas forcément compatibles avec tous vos formats de publication.

Cliquez sur le menu Tableaux et images, puis choisissez Images ou Picto selon le cas :
Média
Pour insérer une image simple ;
Figure avec titre
Pour insérer une image avec un titre ;
Image cliquable
Pour insérer une image contenant des zones cliquables ;
Dessin
Pour insérer une image modifiable avec l'éditeur d'images de Calenco (format SVG) ;
Picto
Pour insérer un pictogramme ou une image dans le corps du texte.
Indiquez le point d'insertion, puis cliquez sur l'icône pour choisir l'image à intégrer et paramétrer sa publication :
Spécifiez de préférence une taille relative (en pourcentage de la place disponible). En général, la largeur suffit : la hauteur est ajustée proportionnellement.
En sélectionnant l'option vide dans le menu Alignement ou Alignement vertical, l'image sera alignée avec une des trois options paramétrées par défaut dans la feuille de style.
Cliquez sur Choisir l'image.
Sélection de la langue d'import
N'oubliez pas que les images comme les contenus :
sont réparties par langue,
peuvent être filtrées par étiquette pour les retrouver facilement.
Cliquez sur Importer un fichier ici si l'image n'est pas encore enregistrée dans Calenco :
Les images importées seront associées aux étiquettes sélectionnées au moment de l'import.

	Sélection de la langue d'import
N'oubliez pas que les images comme les contenus : sont réparties par langue, peuvent être filtrées par étiquette pour les retrouver facilement.

Vous pouvez également rapatrier une image dans Calenco depuis l'éditeur :

Ouvrez l'image à intégrer sur votre ordinateur.
Copiez l'image dans le presse-papier (clic droit ou Ctrl+C).
Choisissez l'endroit où insérer l'image.
Collez (Ctrl+V ou Cmd+V pour les utilisateurs macOS) l'image dans la zone de rédaction souhaitée.
L'image est enregistrée dans l'espace de langue du document.

3.2.1. Éditeur d'illustrations

L'éditeur d'illustration permet de créer (voir Créer une image annotée et d'éditer des images au format SVG.

Pour accéder à l'éditeur à partir d'une image, cliquez sur Éditer sous le nom de l'image :

Une nouvelle fenêtre d'édition apparaît :

Les fonctions suivantes sont disponibles dans la barre d'icônes à gauche :

Outil de sélection (V)
Outil Zoom
Outil Déplacement
Outil Pinceau (Q)
Outil de ligne/connexion (L)
Outil Rectangle (R)
Outil Cercle (E)
Outil Texte (T)
Bibliothèque de formes
Outil Image
Outil Étoile
Outil Pipette

	Traduction
	Les textes rédigés avec l'éditeur de dessins sont supportés par les outils de traduction : chaque élément texte est un segment de traduction.

3.3. Créer des équations

Une équation est insérée avec le menu Contenu → Équation avec titre.

Cliquez sur l'élément contenant un point d'interrogation ? pour éditer l'équation :

Construisez l'équation avec les différentes fonctionnalités.

Cliquez sur l'équation pour l'éditer.

3.4. Créer une bibliographie

Il existe plusieurs méthodes pour créer une bibliographie.

Procédure 14. Création dans l'interface Calenco

Cliquez sur Créer.
Donnez un titre à la bibliographie.
Choisissez l'élément bibliographie dans Type Contenu réutilisable :
Cliquez sur Créer : l'éditeur de contenus ouvre la bibliographie créée dans un nouvel onglet.

Procédure 15. Création dans un document existant

Ouvrez le document.
Cliquez sur le menu Structure → Bibliographie.
Ajoutez l'élément bibliographie.

3.4.1. Éditer une bibliographie

La bibliographie est constituée des éléments entrée bibliographique.

A la création, l'élément entrée bibliographique est composé de quelques éléments par défaut : auteur, référence, identifiant bibliographique, titre, résumé etc.

Il est possible de composer une entrée de la combinaison d'éléments pertinents pour une bibliographie. Ces éléments se trouvent dans le menu Outils → Insérer un élément (Personnaliser).


	La description des éléments est disponible dans le guide DocBook.

Une référence bibliographique permet de faire le lien entre l'entrée bibliographique et sa référence dans le texte.

Positionnez votre curseur à l'endroit où vous souhaitez insérer la référence bibliographique.
Cliquez sur le menu Liens et références → Référence bibliographique :
Le lien entre la référence et l'entrée bibliographique se fait via l'identifiant de cette dernière.
Si l'entrée bibliographique n'a pas d'identifiant, Calenco en génère un.

3.4.2. Réutiliser une bibliographie

La bibliographie peut être modularisée depuis l'éditeur si elle est créée dans un document existant Modulariser du contenu.


	Si la bibliographie est modularisée, seules les entrées bibliographiques identifiées sont visibles et sélectionnables.

3.4.3. Publier une bibliographie

Il est recommandé de paramétrer la publication avec bibliography.numbered= 1 pour publier un numéro correspondant à chaque référence bibliographique.

Une personnalisation de la feuille de style de publication permet de ne publier que les entrées bibliographiques citées dans le document.

Veuillez contacter votre interlocuteur NeoDoc habituel (<contact@calenco.com>) pour l'activer.

3.5. Créer un glossaire

Il existe plusieurs méthodes pour créer un glossaire.

Procédure 16. Création dans l'interface Calenco

Cliquez sur Créer.
Donnez un titre au glossaire.
Choisissez l'élément glossaire dans Type Contenu réutilisable :
Cliquez sur Créer : l'éditeur de contenus ouvre le glossaire créé dans un nouvel onglet.

Procédure 17. Création dans un document existant

Ouvrez le document.
Cliquez sur le menu Structure → Glossaire.
Ajoutez l'élément glossaire.

Procédure 18. Création d'un glossaire automatique et filtré

Ouvrez le document.
Cliquez sur le menu Structure → Glossaire.
Ajoutez l'élément glossaire vide.
Dans le menu Attributs → role(dans la zone de gauche de l'éditeur) placez « auto ».
Récupérez le lien url du glossaire créé au préalable, modifiez-le en supprimant une partie :
Placez le lien dans le paramètre de publication glossary.collection (Publier un glossaire).
Les termes du glossaire qui ne sont pas cités dans le document ne sont pas publiés.

3.5.1. Éditer un glossaire

Le glossaire est constitué des éléments entrée.

A la création, l'élément entrée est composé des éléments : terme, définition.

Il est possible d'ajouter d'autres éléments optionnels. Ces éléments se trouvent dans le menu Outils → Insérer un élément (Personnaliser).


	La description des éléments est disponible dans le guide DocBook.

L'utilisation de l'élément terme pour des mots ou groupes de mots dans le texte du document permet de faire la référence aux entrées du glossaire.

Sélectionnez le texte à définir comme terme.
Cliquez sur le menu Contenu → Terme.
Les contenus définis comme terme apparaissent en italique dans la publication.

3.5.2. Réutiliser un glossaire

Le glossaire peut être modularisé depuis l'éditeur si elle est créée dans un document existant Modulariser du contenu.

3.5.3. Publier un glossaire

L'utilisation du paramètre glossterm.auto.link= 1 permet de créer un lien entre le mot défini comme terme dans le texte et l'entrée lui correspondant dans le glossaire.

L'utilisation du paramètre glossary.sort= 1 permet de publier les termes du glossaire par ordre alphabétique.

L'utilisation du paramètre glossary.collectionpermet de ne publier que les termes cités dans le document (Procédure 18, « Création d'un glossaire automatique et filtré »).

3.6. Ajouter un titre

Sur les éléments de structure, les titres sont obligatoires.

En rédaction structurée, il est conseillé d'associer un titre aux éléments suivants (même s'ils sont optionnels) : les tableaux, les images, les admonitions, les paragraphes...

Cliquez sur le menu Ajoutez un titre dans le menu contextuel de l'élément ou depuis la barre d’Icônes Contenu → Titre → Ajouter.

3.7. Spécifier des informations

L'élément information, situé tout au début du document, permet de stocker des informations qui ne sont parfois pas publiées (nom de l'auteur, numéro de référence, identifiant de produit, tableau de révisions etc.). Les éléments communément utilisés sont listés dans le menu information.

3.8. Insérer une page de fichier PDF

Une page d'un fichier PDF peut être référencée pour être publiée comme une image.

Le PDF est stocké dans Calenco dans la langue adéquate.


	Une fois importé, le fichier PDF n'est visible que par les administrateurs.

La syntaxe pour pointer sur la page souhaitée est la suivante : nom de fichier .pdf#page=numéro de la page

Figure 4. Exemple de référencement d'une page de PDF

3.9. Intégrer un enregistrement audio ou une vidéo

La publication PDF n'est pas adaptée pour intégrer des vidéos et Calenco n'est pas l'endroit où vos contenus seront stockés.

Le plus efficace est de faire référence à une adresse Web où l'enregistrement est stocké et accessible à l'audience ciblée :

Cliquez sur le menu Tableaux et images → Vidéo.
Insérez le lien url intégral dans l'attribut fileref.

Les vidéos sont publiées sous forme de lien (pour les publications PDF) ou dans un lecteur en ligne (pour les publications HTML).

3.10. Migrer du contenu dans Calenco

Sélectionnez le texte dans le fichier source, par exemple un document Word ou une page Web.
Copiez-le (Ctrl+C).
Collez-le dans la zone de rédaction souhaitée (Ctrl+V).
Le texte importé conserve sa structure d'origine.
Pour coller le texte sans mise en forme, utilisez le raccourci Shift+Ctrl+V.

3.11. Insérer une référence croisée

Une référence croisée permet de faire un lien dans le document vers une autre partie du même document.

Positionnez votre curseur à l'endroit où vous souhaitez insérer la référence croisée.
Cliquez sur le menu Liens et références → Référence croisée, ou utilisez les outils rapides à gauche :
1. Les éléments cibles ayant un titre sont listés dans la boîte de dialogue qui apparaît :
  Apprenez comment Ajouter un titre
  Les titres sans identifiant apparaissent en gris avec un message flottant et ne sont pas cliquables.
2. Si vous souhaitez faire référence à un élément non listé, cliquez sur Annuler.
  Assurez-vous que l'élément cible est bien identifié (Identifier).
  Cliquez sur "_specify_" pour ouvrir cette boîte de dialogue :
3. Cliquez sur Choisir pour afficher la liste des éléments identifiés dans le document :
4. Sélectionnez l'identifiant cible.

3.12. Insérer un lien externe

Un lien externe permet de faire une référence à une adresse web.

Sélectionnez le contenu pour lequel vous souhaitez insérer le lien externe.
Cliquez sur Liens et références → Liens → Lien externe. Une boîte de dialogue s'ouvre en vous invitant à insérer un lien url dans le champ dédié :
Validez avec OK.
Le lien est automatiquement placé dans l'attribut href :

3.13. Adapter du contenu (couper/copier/coller)

Sélectionnez l'élément.
Utilisez les raccourcis clavier standards (Ctrl+X ou Ctrl+C puis Ctrl+V) pour déplacer ou dupliquer du contenu.

	Sélection multiple de contenus
	Cliquez sur les barres verticales des éléments à sélectionner en appuyant sur la touche Shift. Il n'est possible de sélectionner que des éléments de même niveau.

3.14. Enrichissement de texte

Le menu Style de texte permet d'associer une sémantique à des mots (élément d'interface, nom de produit...).

Il est possible de définir certaines options d'enrichissement de texte en sélectionnant un texte à la souris :


	Hiérarchie de styles. Pour rendre un texte en italique gras, il faut placer ce texte d'abord dans la balise `gras`, puis dans la balise `italique`.

3.15. Insérer un saut de page manuel

Calenco publie les contenus suivant la logique de la feuille de style : insérer un saut de page manuel force le comportement de la publication.

Sélectionner l'élément avant lequel vous voulez insérer le saut de page manuel.
Insérer → Insérer un saut de page manuel.

3.16. Insérer une liste

Calenco propose trois types de listes (Contenu Listes) :

Liste à puces : les caractéristiques des puces sont gérées par la feuille de style.
Liste ordonnée : le type de numérotation (chiffres, lettres, autre) est géré par la feuille de style.
Liste de définitions.


	Continuer la numérotation d'une liste ordonnée. Pour continuer la numérotation avec l'indice suivant le dernier indice d'une liste précédente, il faut valuer l'attribut `override` du premier élément `listitem` de la deuxième `orderedlist` avec l'indice souhaité.

3.17. Insérer une note de bas de page

Positionnez votre curseur à l'endroit où vous souhaitez insérer la note de bas de page.
Cliquez sur le menu Contenu → Note de bas de page.
Tapez le texte dans la zone dédiée.

Il est possible de faire une référence à la note de bas de page dans un document.

Positionnez votre curseur à l'endroit où vous souhaitez insérer la référence.
Assurez-vous que la note de bas de page cible est bien identifiée (Identifier).
Cliquez sur le menu Liens et références → Référence de note de bas de page :
Sélectionnez la cible souhaitée et validez.

3.18. Insérer un filigrane

Il existe plusieurs méthodes pour publier un document avec un filigrane.

Procédure 19. Méthode 1 : filigrane « draft » par défaut

Sélectionnez le document au niveau de l'élément racine.
Donner la valeur draft à l'attribut status.

Procédure 20. Méthode 2 : filigrane personnalisé

Importez une image qui contient la mention souhaitée pour le filigrane (brouillon, provisoire, préliminaire etc.) au format .png dans votre espace de travail :
- dans la langue Common si la mention reste inchangée pour les versions linguistiques des documents ;
- dans chacune des langues si la mention doit apparaître traduite en langue respective du document.
  Toutes les images doivent avoir le nom de fichier identique à celui de la langue source.
Dans la publication, personnalisez les paramètres de la feuille de style :
Paramétrage de la mention du filigrane
- draft.watermark.image=brouillon.png, si l'image se trouve dans la langue Common ;
- draft.watermark.image=fr/brouillon.png pour les publications en français (ou code langue équivalent à d'autres langues nécessaires).
Activation du filigrane
- draft.mode=yes pour publier le filigrane sur toutes les pages du document ;
- draft.mode=no pour désactiver le filigrane pour tout le document ;
- draft.mode=maybe pour publier le filigrane uniquement pour les éléments de structure du document pour lesquels l'attribut status comporte la valeur draft.
Figure 5. Paramétrage de la publication avec le filigrane personnalisé

4. Identifier

Identifier un élément est utile pour le réutiliser ou pour y faire référence.

Il existe plusieurs méthodes pour identifier un élément :

Éditez les propriétés de l'élément et entrez un identifiant manuellement :
Sélectionnez l'élément et cliquez dans le menu contextuel Copier comme élément réutilisable.

5. Réutiliser

5.1. Modulariser du contenu

Cette fonctionnalité permet d'externaliser un élément de structure (section, chapitre, partie...) de votre document pour pouvoir le réutiliser dans d'autres documents.

Sélectionnez l'élément à modulariser ;
Cliquez sur Modulariser :
1. soit dans le Contexte avec un clic droit sur l'élément sélectionné ;
2. soit dans la table des matières avec un clic droit sur l'élément sélectionné.
Un nouveau fichier est créé dans Calenco avec cet élément et son contenu, dans la langue du document courant.
Un fond de couleur met en évidence l'inclusion.
Pour modifier un module, faites un clic droit sur l'inclusion et cliquez sur Ouvrir.

5.2. Réutiliser des contenus

5.2.1. Réutiliser des modules

Les modules (Chapitre, section, annexe etc.) n'ont pas besoin d'être identifiés pour être réutilisés.

Il existe plusieurs méthodes de réutilisation des modules.

Procédure 21. Méthode 1

Dans l'éditeur, sélectionnez le module à réutiliser.
Cliquez sur Éditer puis sur Copier comme élément réutilisable [Alt+C].
Dans le document cible, indiquez le point d'insertion et faites venir l'inclusion avec Ctrl+V.

Procédure 22. Méthode 2

Dans l'éditeur, sélectionnez le module à réutiliser.
Dans le Contexte, cliquez droit sur le nom de l'élément sélectionné et cliquez sur Copier comme élément réutilisable.
Dans le document cible, indiquez le point d'insertion et faites venir l'inclusion avec Ctrl+V.

Procédure 23. Méthode 3

Dans le document cible, cliquez sur en haut à droite dans l'en-tête pour sélectionner un module.
Sélectionnez le module souhaité et cliquez sur OK.
Il est possible de filtrer les fichiers grâce aux étiquettes.
Le menu déroulant Afficher permet d'afficher le nom ou le label des fichiers.
Dans une nouvelle fenêtre qui s'ouvre, cliquez sur l'élément et indiquez le point d'insertion.
Insérez l'élément grâce au système de flèches Tableau 1, « Options d'insertion ».

5.2.2. Réutiliser des fragments

Les éléments comme fragments du contenu (paragraphe simple, image, tableau etc.) doivent être identifiés pour être réutilisés.

Il existe plusieurs méthodes de réutilisation des fragments.

Procédure 24. Méthode 1


	Assurez-vous que l'élément à réutiliser est bien identifié (Identifier).

Dans le document cible, cliquez sur en haut à droite dans l'en-tête pour sélectionner un fichier contenant des contenus réutilisables.
Il est possible de filtrer les fichiers grâce aux étiquettes.
Le menu déroulant Afficher permet d'afficher le nom ou le label des fichiers.
Sélectionnez le fichier souhaité et cliquez sur OK. Une nouvelle fenêtre s'ouvre.
Si le fichier contient beaucoup d'éléments réutilisables, vous pouvez les filtrer.
Cliquez sur l'élément et indiquez le point d'insertion. Insérez l'élément grâce au système de flèches Tableau 1, « Options d'insertion ».
Cliquez sur Rafraîchir pour mettre à jour la liste d'éléments.

Procédure 25. Méthode 2


	En utilisant cette méthode, l'identifiant se crée de manière automatique.

Dans la bibliothèque des éléments réutilisables, sélectionnez l'élément souhaité.
Dans le menu contextuel, sélectionnez Copier comme élément réutilisable.
Dans le document cible, indiquez le point d'insertion et faites venir l'inclusion avec Ctrl+V.

5.3. Vérifier les inclusions manquantes

Procédure 26. Dans l'éditeur

A l'ouverture du document, une fenêtre Erreurs d'inclusion apparaît avec la liste des inclusions manquantes :
Les inclusions manquantes venant des espaces partagés sont également prises en compte.
Cliquez sur chaque ligne de la liste pour aller à l'inclusion concernée.
Cliquez sur le label du document source dans l'inclusion cassée pour ouvrir ce document et analyser et corriger l'erreur.

Procédure 27. Dans la publication

Référez-vous à Gérer les publications, la partie Interprétation du statut de la publication.

6. Paramétrer

Un paramètre permet d'utiliser une valeur à plusieurs endroits d'un document.

La valeur du paramètre est exploitée lors de la publication : paramétrer des contenus permet de maximiser leur réutilisation.

Pour insérer un paramètre :

Spécifier un identifiant sur l'élément contenant le texte à réutiliser. Il s'agit souvent d'un élément de l'en-tête du document comme un nom de produit, un numéro de version, etc.
Positionnez le curseur là où vous souhaitez insérer le paramètre.
Dans la barre d'icônes, cliquez sur Liens et références → Variables.
Indiquez l'identifiant (Identifier) de la variable dans le fond noir de l'élément.

6.1. Calculer

Un calcul peut être inséré via le menu Style de texte → Formule.

Pour éditer la formule, cliquez sur le signe « Σ ».

Contenu de la boîte de dialogue

Vous pouvez attribuer un identifiant à ce calcul. Cela vous permettra éventuellement de réutiliser son résultat dans un autre calcul.
Une liste cliquable des variables pouvant être référencées dans la formule.
Pour qu'un élément apparaisse dans cette liste, les conditions suivantes doivent être remplies :
- L'élément doit contenir un nombre. Notez que, pour plus de souplesse, les caractères non numériques sont ignorés. Par exemple, le texte « 12 € » sera identifié comme le nombre 12.
- Le séparateur de décimale (si présent) doit correspondre au langage déclaré sur l'élément racine du document (par exemple la virgule pour le français).
- L'élément doit avoir un identifiant (il suffit de le déclarer comme élément réutilisable pour cela).
Un champ texte pour entrer la formule de calcul.
En dessous de ce champ texte, un bouton permettant de tester la formule.
Un champ permettant de spécifier le nombre de décimales voulues pour le résultat.

	Mise à jour des calculs
	Les formules sont actualisées en temps réel au fur et à mesure des modifications des chiffres de base dans le document. Utilisez l'icône pour rafraîchir le document si besoin.

6.1.1. Syntaxe

Lors de la rédaction de la formule, les constantes numériques doivent être rédigées au format anglo-saxon (le séparateur de décimales doit être ".").

6.1.1.1. Opérateurs

+ : Addition
- : Soustraction
* : Multiplication
/ : Division
% : Modulo

6.1.1.2. Fonctions et constantes

Tableau 2. Constantes

Constante	Description
E	Nombre d'Euler, la base des logarithmes naturels, environ 2,718.
LN2	Logarithme naturel de 2, environ 0,693.
LN10	Logarithme naturel de 10, environ 2,302.
LOG2E	Logarithme de base 2 de E, environ 1,442.
LOG10E	Logarithme de base 10 de E, environ 0,434.
PI	Quotient de la circonférence d'un cercle par son diamètre, environ 3,14159.
SQRT1_2	Racine carrée de 1/2 ; équivalent de 1 sur la racine carrée de 2, environ 0,707.
SQRT2	Racine carrée de 2, environ 1,414.

	Précision
	La précision des fonctions mathématiques dépend notamment de l'implémentation. Cela signifie que différents navigateurs peuvent fournir des résultats différents. On peut même avoir un même moteur JavaScript qui, sur des architectures et/ou des systèmes d'exploitation différents, fournit des résultats différents.

Fonctions

abs(x): Retourne la valeur absolue d'un nombre.
acos(x): Retourne l'arc cosinus d'un nombre.
acosh(x): Retourne l'arc cosinus hyperbolique d'un nombre.
asin(x): Retourne l'arc sinus d'un nombre.
asinh(x): Retourne l'arc sinus hyperbolique d'un nombre.
atan(x): Retourne l'arc tangente d'un nombre.
atanh(x): Retourne l'arc tangente hyperbolique d'un nombre.
atan2(y, x): Retourne l'arc tangente du quotient de ses arguments.
cbrt(x): Renvoie la racine cubique d'un nombre.
ceil(x): Retourne le plus petit entier supérieur ou égal à la valeur passée en paramètre.
clz32(x): Renvoie le nombre de zéros qui préfixent un entier sur 32 bits.
cos(x): Retourne le cosinus d'un nombre.
cosh(x): Renvoie le cosinus hyperbolique d'un nombre.
exp(x): Renvoie l'exponentielle d'un nombre (soit Enombre) avec E la constante d'Euler (2,718...).
expm1(x): Renvoie le résultat de 1 moins l'exponentielle d'un nombre.
floor(x): Retourne le plus grand entier inférieur ou égal à la valeur passée en paramètre.
fround(x): Renvoie le nombre flottant exprimé sur 32 bits le plus proche de l'argument.
hypot([x[,y[,…]]]): Retourne la racine carré de la somme des carrés des arguments.
imul(x, y): Retourne le résultat de la multiplication d'entiers sur 32 bits.
log(x): Retourne le logarithme naturel (loge) d'un nombre.
log1p(x): Retourne le logarithme naturel de 1 + un nombre.
log10(x): Retourne le logarithme en base 10 d'un nombre.
log2(x): Retourne le logarithme en base 2 d'un nombre.
max([x[,y[,…]]]): Retourne la plus grande valeur d'une liste de nombres.
min([x[,y[,…]]]): Retourne la plus petite valeur d'une liste de nombres.
pow(x,y): Retourne le calcul de x à la puissance y (x correspond à la base et y à l'exposant).
random(): Retourne un nombre pseudo-aléatoire compris entre 0 (inclus) et 1 (exclu).
round(x): Retourne l'arrondi d'un nombre.
sign(x): Retourne le signe d'un nombre, indiquant s'il est positif, négatif ou égal à zéro.
sin(x): Retourne le sinus d'un nombre.
sinh(x): Retourne le sinus hyperbolique d'un nombre.
sqrt(x): Retourne la racine carrée d'un nombre.
tan(x): Retourne la tangente d'un nombre.
tanh(x): Retourne la tangente hyperbolique d'un nombre.
trunc(x): Retourne la partie entière d'un nombre (la partie décimale est retirée).

6.1.1.3. Variables et fonctions dans un tableau

Si un calcul est inséré dans un tableau, sa formule peut référencer les valeurs numériques présentes dans le tableau. Les cellules du tableau sont identifiées via leurs coordonnées. Les colonnes sont identifiées par des lettres majuscules. Les lignes sont identifiées par des nombres.

Cliquez sur l’icône en haut à gauche d'un tableau pour afficher les coordonnées de ses cellules.

Par exemple, pour ajouter 1 au nombre contenu dans la cellule de la troisième colonne, deuxième ligne :

C2 + 1

Pour obtenir la racine carrée du nombre contenu dans la cellule de la quatrième colonne, deuxième ligne :

sqrt(D2)

Fonction somme. La fonction somme (sum) doit recevoir en paramètre les coordonnées de la cellule de départ et les coordonnées de la cellule d'arrivée, séparées par le caractère ":". Exemples :

sum(B2:B13)

sum(B3:C4)

6.1.1.4. Exemples

cos(PI)

Résultat : -1.

cos(PI) + monIdentifiant

Résultat : 0 si la variable ayant pour identifiant monIdentifiant contient le texte "1".

7. Profiler

Le profilage permet de spécifier le « contexte » relatif à un contenu spécifique, le « profil » de cette information. Par exemple sur le manuel d'entretien d'un véhicule, un chapitre peut être spécifique à une variante (moteur thermique, électrique ou hybride). Ou bien encore pour spécifier que certaines informations sont confidentielles.

Ceci permet de gérer toutes les variantes d'un même document depuis une source unique, tout en se laissant la possibilité de générer une publication finale pour chaque variante.

Une autre utilisation de cette fonctionnalité consiste à modifier la mise en page selon le profil de l'information (les informations confidentielles seront encadrées en rouge par exemple).

Préparez l'étape de profilage en lisant la rubrique Personnaliser les attributs.

7.1. Profiler des contenus

Pour conditionner la publication d'un contenu ou le typer pour qu'un traitement particulier soit réalisé lors de la publication :

Sélectionnez l'élément et utilisez le menu contextuel Filtrage :
Cochez les cas d'utilisation correspondant au contenu sélectionné :


	Vous trouverez la liste des attributs de profilage dans la documentation officielle de DocBook (en anglais).


	Les éléments profilés sont représentés avec un fonds de couleur. Les attributs de profilage sont signalés dans la liste des attributs par le même fond de couleur :

Il n'est pas toujours possible de définir une liste de valeurs pour un attribut donné.

Dans ce cas, entrez les valeurs directement depuis la zone d'édition des attributs ou dans la boite de dialogue Propriétés si l'attribut a été sélectionné pour être rapidement accessible (voir Personnaliser les attributs).

Consultez la démonstration du Profilage des contenus :

7.2. Rechercher un élément par attribut

Lancez la commande Outils → Recherche d'éléments par attributs.
Sélectionnez un attribut proposé puis une valeur : les éléments dont l'attribut sélectionné a la valeur sélectionnée sont listés.
Cliquez sur l'un des éléments pour l'afficher dans la zone d'édition.

8. Commenter

Calenco permet d'annoter des documents, sans que cela impacte la publication. Cela est notamment utile lors de l'utilisation du workflow, pour que chaque intervenant puisse contribuer, sans pour autant impacter directement le résultat final.

Dans la zone de gestion de contenu, vous pouvez commenter des éléments afin de garder une trace des modifications apportées ou suggérées sans avoir été implémentées.

8.1. Créer

Sélectionnez le contenu que vous voulez commenter et cliquez sur Nouveau.
Renseignez le champ de commentaire. Les informations s'enregistrent automatiquement.
Double-cliquez sur pour modifier un commentaire existant.
Cliquez sur la croix grise en haut à droite d'un commentaire pour le supprimer.

8.2. Localiser

Cliquez sur pour ouvrir la liste de commentaires.
Cliquez sur pour localiser le commentaire voulu. Le contenu concerné par ce commentaire apparaît sur un fond jaune pendant quelques secondes.

8.3. Interagir

Double-cliquez sur pour répondre à un commentaire.

Les personnes intervenant sur un document peuvent réagir aux commentaires de façons suivantes :

Cliquez sur le statut pour accepter le commentaire,
Cliquez sur le statut pour rejeter le commentaire,
Répondez dans le champ dédié si besoin.

9. Collaborer

Cette fonction est une option qui dépend de votre abonnement.

Veuillez contacter votre interlocuteur NeoDoc habituel (<contact@calenco.com>) pour l'activer.

L'éditeur web de Calenco est collaboratif. Plusieurs utilisateurs peuvent modifier un fichier en même temps. Les utilisateurs éditant un fichier sont symbolisés par une pastille avec les 2 premières lettres du prénom des utilisateurs en haut à droite de l'onglet. Par exemple, ci-dessous Ma et Ly :

En passant le curseur de votre souris sur l'une des icônes, l'adresse mail de l'utilisateur apparaît :

Lorsque plusieurs utilisateurs éditent simultanément un fichier, ils ne peuvent modifier les mêmes blocs de contenus.

La présence d'un des utilisateurs sur un bloc de contenu le grisera et la barre verticale grise à gauche de ce bloc deviendra violette, empêchant toute modification par les autres utilisateurs :

9.1. Signature électronique

Cette fonctionnalité est une option qui fonctionne en lien avec votre compte DocuSign.

Après avoir souscrit l'abonnement à cette fonctionnalité dans le menu Administration → Mon abonnement, le responsable du compte client peut activer l'option via le menu Administration → Espaces de travail dans Actions → Fonctionnalités.

Calenco permet à un maximum de 5 signataires de signer électroniquement un document, en lien avec DocuSign.

Il suffit d'insérer dans le texte aux emplacements requis les mots clés suivant : $$signature1$$ , $$signature2$$ ,$$signature3$$, $$signature4$$ ou $$signature5$$.

Figure 6. DocuSign propose au signataire de signer en lieu et place des mots clés

10. Gérer les contenus

10.1. Modifier le label d'un fichier

Cette fonctionnalité permet de distinguer deux documents ayant le même titre.

Au-dessus du Contexte, cliquez sur l'icône d'édition à droite du nom du contenu :
Entrez le nom du label souhaité.
Le label du document concerné est actualisé.

10.2. Sauvegarder automatiquement

Pour activer la sauvegarde automatique, cochez la case correspondante :


	La sauvegarde automatique se déclenche toutes les trois minutes.

10.3. Rechercher/Remplacer

Une fonction pour rechercher et remplacer des termes est disponible.

Cliquez sur Editer → Rechercher/Remplacer :
Une nouvelle fenêtre s'ouvre :
Renseignez les champs voulus et recherchez les termes souhaités en cliquant sur Suivant pour les afficher les uns après les autres.

11. Personnaliser

Vous pouvez composer les fonctions du menu Mes raccourcis avec des éléments particuliers.

Choisissez le menu Outils → Insérer un élément
Une barre de recherche vous permet de rapidement trouver des éléments.
Cliquez sur l'icône à droite de l'élément à ajouter dans le menu Mes raccourcis.
La description des éléments est disponible dans le guide DocBook.

12. Aller plus vite

Alt+C

Copier un élément comme référence

Ctrl+Alt+C

Afficher les spécifications de colonne

Ctrl+V

Coller un élément

Ctrl+Shift+V

Coller un élément en texte brut

Shift+Alt+V

Copier la référence d'un élément avec proposition d'insertion


	Cette fonctionnalité est nécessaire lors du collage d'une référence d'élément à proximité d'inclusions.

Alt+Mollette

Déplie et replie la table des matières.

Ctrl+I

Remonte un titre d'un niveau dans la structure d'un document.

Ctrl+U

Descend un titre d'un niveau dans la structure d'un document.

Ctrl+B

Si possible, divise l'élément de structure à partir du curseur en deux structures du même type.

Ctrl+E

Supprime les balises de mise en forme englobant l'élément courant.

Transforme un inlinemediaobject en mediaobject.

Ctrl+Backspace

Supprime les mots entiers à gauche du curseur.

Tab

Crée une liste sur le paragraphe courant ou ajoute le paragraphe dans la liste précédente.

Tab+Shift

Déplace le paragraphe d'un niveau dans une liste à puce.


	Spécifiez de préférence une taille relative (en pourcentage de la place disponible). En général, la largeur suffit : la hauteur est ajustée proportionnellement.


	En sélectionnant l'option vide dans le menu Alignement ou Alignement vertical, l'image sera alignée avec une des trois options paramétrées par défaut dans la feuille de style.


	Les images importées seront associées aux étiquettes sélectionnées au moment de l'import.


	L'image est enregistrée dans l'espace de langue du document.


	Les contenus définis comme `terme` apparaissent en italique dans la publication.


	Pour coller le texte sans mise en forme, utilisez le raccourci Shift+Ctrl+V.


	Les titres sans identifiant apparaissent en gris avec un message flottant et ne sont pas cliquables.


	Toutes les images doivent avoir le nom de fichier identique à celui de la langue source.


	Cliquez sur Rafraîchir pour mettre à jour la liste d'éléments.


	Les inclusions manquantes venant des espaces partagés sont également prises en compte.


	Apprenez comment Ajouter un titre