Formula Editor

Ce que c'est et pourquoi il existe

Les exigences sur les freins, les capteurs ou les boucles de régulation ont souvent besoin d'une formule : une distance d'arrêt, une tolérance, un filtre. DOORS Next n'a pas d'éditeur de formules. Les équipes collent une capture d'écran de Word, que personne ne peut modifier ensuite sans le fichier d'origine, ou tapent la formule en texte brut, difficile à lire.

Formula Editor vous permet d'écrire la formule en LaTeX dans DOORS Next. Il dessine la formule pendant la frappe et la place dans le module sous forme d'image, soit dans un nouvel artefact après l'artefact sélectionné, soit dans l'artefact sélectionné. Le LaTeX est enregistré avec l'artefact : sélectionner la formule plus tard la rouvre dans l'éditeur.

Problèmes résolus

• Des formules collées en captures d'écran que personne ne peut modifier sans le fichier Word d'où elles viennent.
• Des formules tapées en texte brut, comme s = v^2/(2*mu*g), difficiles à lire dans les revues et les exports.
• Des images de formules qui ne correspondent plus au texte après que l'un des deux a été modifié à la main.
• Passer à un autre outil et recopier des images pour chaque formule nouvelle ou modifiée.

Avantages

• Voir pendant la frappe : l'aperçu dessine la formule pendant que vous écrivez et indique la taille de l'image.
• Modifiable plus tard : le LaTeX est conservé dans l'artefact, donc sélectionner une formule la rouvre et Update dessine une nouvelle image.
• Le texte reste : Update sur un artefact contenant du texte ajoute la formule après le texte et conserve les mots.
• Aucun site externe : la formule est dessinée dans votre navigateur par MathJax ; elle n'est pas envoyée à un éditeur en ligne.
• Erreurs localisées : une accolade manquante ou une commande inconnue s'affiche sous le champ avec le caractère où elle se trouve.

Utilisation

1. Ouvrez un module et sélectionnez un artefact.
2. Saisissez la formule en LaTeX ou cliquez sur les touches sous le champ : fraction, racine, puissance, indice, somme, intégrale, lettre grecque, plus ou moins et matrice. More symbols en affiche 21 de plus. L'aperçu montre l'image et sa taille.
3. Cliquez sur Insert pour ajouter la formule dans un nouvel artefact après l'artefact sélectionné, ou sur Update pour l'écrire dans l'artefact sélectionné. Lisez la confirmation et cliquez sur Insert formula ou Update formula.
4. Le bloc de résultat indique ce qui a été fait, et Log télécharge le rapport de modifications.
5. Pour modifier une formule, sélectionnez-la dans le module. Elle s'ouvre dans le widget (Editing 1531 …) ; modifiez le LaTeX et cliquez sur Update.

Bon à savoir

• Travaillez dans un ensemble de modifications, pour pouvoir l'abandonner si le résultat ne convient pas. Le nouvel artefact est enregistré immédiatement.
• L'image est un PNG enregistré sur le serveur DOORS Next, dessiné au double de sa taille pour rester nette à l'écran et dans les exports. Settings propose trois tailles : S, M et L.
• Le LaTeX est écrit dans un attribut nommé Formula quand le projet en possède un, et toujours dans la description de l'image : une formule se rouvre donc aussi dans un projet sans cet attribut.
• Les nouveaux artefacts reçoivent le type de l'artefact sélectionné. Dans Settings, vous pouvez choisir un autre type d'artefact du projet pour Insert ; le widget le retient par projet. Update conserve le type.
• Si l'image d'une formule a été remplacée à la main, le widget le signale et la confirmation de Update avertit que cette modification sera perdue. Le LaTeX l'emporte toujours.