Docs / Guides
Page traduite automatiquement
Voir et restaurer l'historique d'une clé dans Studio
Lis comment une traduction a changé de commit en commit et recharge une valeur antérieure dans l'éditeur depuis l'onglet History de Verbatra Studio.
Utilise-le quand une traduction a été reformulée et que tu veux retrouver l'ancienne formulation, ou pour voir qui a changé une clé et quand. Il lit git. Studio n'indexe, ne commite et ne revient jamais sur rien : restaurer ne fait que remplir l'éditeur avec l'ancien texte, et tu l'enregistres comme n'importe quelle modification.
Ouvre l'onglet History
Démarre Studio (Review in Studio), ouvre une clé dans Translations et choisis History à côté de Locales. Choisis la locale si le projet en a plusieurs. Studio ne lit l'historique de cette clé dans git que lorsque tu ouvres l'onglet.
La liste commence par Working tree (uncommitted) quand le fichier sur le disque diffère du dernier commit. En dessous, du plus récent au plus ancien, vient chaque commit qui a changé la valeur de la clé dans cette locale, vingt lignes à la fois et avec Show N more pour le reste. Chaque ligne montre :
| Élément | Ce qu'il t'apprend |
|---|---|
| Auteur, date, hash court, objet | le commit, avec le nom de l'auteur et jamais l'e-mail |
| Origin | qui a écrit la valeur, selon ce qui a été enregistré avec ce commit, omis si cet enregistrement n'a pas pu être lu |
| Valeur | le texte à ce commit, dans la langue et le sens d'écriture de la locale, jamais tronqué |
| Changes from the previous value | mots ajoutés ou retirés, marqués par un soulignement et un barré en plus de la couleur, et lus à voix haute « added » et « removed » |
Tout est du texte brut, jamais du balisage. Une clé qui apparaît dans une valeur, un objet ou un nom d'auteur est remplacée par [REDACTED].
Restaure une valeur antérieure
- Appuie sur Restore sur une ligne. L'éditeur s'ouvre sur Locales avec cette valeur comme brouillon. Rien n'est encore écrit.
- Lis le brouillon et appuie sur Save. Les vérifications habituelles s'exécutent, y compris les espaces réservés et l'ICU, et un refus s'affiche tel quel, le fichier restant intact. Une valeur enregistrée reçoit l'origine
human.
Si tu as des modifications non enregistrées, Studio demande d'abord. Save draft, then restore garde ton brouillon puis charge l'ancienne valeur, Discard draft and restore l'abandonne et Keep editing laisse tout comme avant. Dans l'éditeur de Review, la question se trouve en haut de la boîte de dialogue et Discard draft and restore est le seul moyen de remplacer le brouillon.
Une ligne n'a pas de Restore, et dit pourquoi, quand sa valeur est celle que la clé a maintenant, quand Studio n'a pas encore lu la valeur actuelle ou n'a pas pu, et quand la valeur ressemble à une clé d'API : History n'affiche pas cette valeur et on ne peut pas la restaurer d'ici.
Une clé de pinnedKeys est réservée à une personne : une restauration enregistrée depuis Studio passe, alors que la modification d'un agent est refusée.
Quand la source a changé
Si le texte source a changé depuis ce commit, Restore demande d'abord une confirmation, et si Studio ne peut pas le dire (le fichier de verrou de ce commit n'a pas pu être lu ou n'a pas d'entrée pour la clé), il le dit. À l'enregistrement, la clé compte alors comme à jour par rapport à la source actuelle et la valeur entre dans la mémoire de traduction, si bien qu'une ancienne formulation peut être réutilisée pour des clés proches. Cancel ou Échap laisse tout comme avant.
Sache ce que la liste omet
Studio ne présente jamais une liste partielle comme complète. Un avis apparaît quand :
- des commits plus anciens n'ont pas été lus, à cause de la limite de commits, d'un clone superficiel ou du budget de lecture ;
- le fichier d'un commit n'a pas pu être lu ni analysé, ou la valeur était trop longue, et Studio compte combien ;
- le fichier sur le disque n'a pas pu être comparé au dernier commit, par exemple pendant un conflit de fusion.
Studio examine d'abord 50 commits. Si cette limite a raccourci la liste, l'avis le dit et Read further back en lit jusqu'à 200 en une étape ; ensuite l'avis dit seulement que Studio ne lit pas plus loin. Chaque autre cause a son propre avis, et Read further back n'apparaît pour aucune d'elles. Une liste vide dit si elle est vide ou seulement la part que Studio a lue. Les renommages ne sont pas suivis, les modifications jamais commitées sont manquées, une clé renommée dans la source paraît nouvelle et un changement arrivé par fusion apparaît sur le commit de fusion.
Quand git manque, que le dossier n'est pas un dépôt ou que git le refuse, Studio le dit en une phrase. Une lecture qui échoue ou dépasse le délai affiche Retry et garde la dernière liste.
Sache à quel point elle est à jour
L'onglet relit quand un fichier de locale, de verrou ou de provenance change, quand l'index de git ou HEAD change et quand tu reviens à l'onglet Studio. Les lectures sont espacées, si bien qu'une série de commits n'inonde pas Studio. Une lecture en arrière-plan ne déplace jamais ton focus.
Dans l'éditeur de Review, Show history ouvre la même liste pour cette entrée, relit de la même façon, et Restore remplit son champ.
Les mêmes lectures existent sous forme de keyHistory, pour un client MCP et pour un agent de navigateur.