Notes

Les Notes sont des enregistrements externes consultables pour les connaissances du projet. Chaque Note possède un titre et un corps, et peut également contenir des tags et des références d’assets.

Choisir Partagé ou Privé

Scope	Stockage	Comportement du contrôle de source
Partagé	`<Project>/ProjectNotes/`	Utilise le fournisseur Unreal actif lorsqu’il est disponible
Privé	`<Project>/Saved/Locus/PrivateNotes/`	Ne consulte ni ne modifie jamais le fournisseur

Le scope est déterminé par la racine de stockage. Locus ne convertit pas une Note existante entre Partagé et Privé.

Capturer une note rapide

Appuyez sur Ctrl+Alt+N pour ouvrir Capture rapide, une fenêtre compacte qui enregistre une Note Locus ordinaire sans ouvrir l’espace de travail Locus principal. Le raccourci peut être réaffecté dans les paramètres de raccourcis clavier d’Unreal Editor.

Le corps est la saisie principale ; le titre est facultatif.
Chaque ouverture commence en Privé. Partagé est un choix explicite pour chaque capture.
Appuyez sur Ctrl+Enter pour enregistrer. Esc ferme la fenêtre et conserve votre brouillon pour la session actuelle de l’Editor.

Capture rapide joint ce sur quoi vous travaillez sous forme de pastilles de référence visibles et amovibles. Le contexte peut inclure la Note ayant le focus, le Repère sélectionné, le Document ayant le focus, les assets sélectionnés dans le Content Browser et les Actors sélectionnés dans le Level Editor. Les Actors qui ne peuvent pas être référencés sont listés avec la raison et n’empêchent pas l’enregistrement. Le monde actuel enregistré est proposé séparément et n’est joint que si vous choisissez Ajouter. Les règles normales de référence s’appliquent toujours : une Note Partagée ne peut pas faire nouvellement référence à une Note privée ou à un Repère privé.

Prendre une note ouvre Capture rapide avec le contexte pertinent déjà joint. Cette action est disponible depuis le menu Notes Locus du Content Browser, le menu contextuel des Actors du Level Editor, les actions rapides d’un Repère dans le viewport, l’espace de travail Repères, l’espace de travail Locus et l’Éditeur de documents. Une Note prise depuis un Repère est indépendante de ce Repère et de ses commentaires.

Boîte de réception des notes rapides

La Boîte de réception des notes rapides, dans l’espace de travail Notes, affiche vos Captures rapides qui se trouvent encore à la racine de vos Notes, et n’apparaît que lorsqu’elle contient des Notes. Pour chacune, classez-la dans un dossier, choisissez Marquer comme classée pour la garder à la racine et la retirer de la Boîte de réception, ou supprimez-la. La Boîte de réception est uniquement une vue personnelle : chaque Capture rapide est une Note Locus ordinaire, et non un emplacement de stockage ou un type de contenu distinct.

Créer et organiser des Notes

Utilisez Nouvelle note ou Ctrl+N et choisissez un scope. Locus crée un titre par défaut unique, enregistre la Note et commence l’édition du titre. Utilisez Nouveau dossier ou Ctrl+Shift+N pour organiser l’arborescence.

Les dossiers sont une couche d’organisation logique dans un scope. Supprimer un dossier demande confirmation et déplace ses Notes et ses sous-dossiers vers le parent au lieu de supprimer les Notes. Faites glisser des Notes ou des dossiers pour les réorganiser dans le même scope. Cela change l’affectation du dossier de la Note plutôt que son fichier stocké ; l’organisation normale des Notes ne nécessite donc pas de déplacement de fichier dans le contrôle de source. Appuyez sur F2 pour renommer un élément sélectionné et sur Ctrl+D pour dupliquer une Note sélectionnée.

Locus filtre les Note en Privé lors de sa première ouverture pour un projet. Un clic normal sélectionne une ligne ; Ctrl/Shift-click étend la sélection. La barre d’outils Notes reste sur une ligne, déplaçant progressivement les actions Insérer la référence, la portée, puis la création dans le menu points de suspension sur des largeurs étroites.

Espace de travail Notes Locus avec hiérarchie de dossiers, contexte de scope Partagé et Note active — Les Notes organisent les connaissances du projet par dossier et par scope tandis que la Note sélectionnée reste visible pour l’édition.

Modifier et enregistrer

Sélectionnez une Note pour modifier son titre, son corps, ses tags et ses références d’assets. Les balises utilisent des pastilles compactes : saisissez une balise et appuyez sur Enter pour l’ajouter, ou sélectionnez × sur une pastille pour la supprimer. Les balises vides et les doublons insensibles à la casse sont rejetés. Locus enregistre après un court délai d’édition. Appuyez sur Ctrl+S pour écrire immédiatement les changements en attente ou réessayer un enregistrement qui a échoué.

La présentation Lisible par défaut affiche les références d’assets comme des libellés. La présentation Source expose la forme des tokens écrits. Modifiez la valeur par défaut, la taille de police et le retour à la ligne dans Paramètres.

Rechercher des Notes

La recherche textuelle correspond aux titres, corps, tags, libellés d’assets et chemins d’objets d’assets. Combinez-la avec des filtres de scope, de tag ou d’asset sélectionné. Plusieurs tags sélectionnés utilisent une correspondance AND et la correspondance des tags ne tient pas compte de la casse.

Utilisez l’action contextuelle du Content Browser Afficher les Notes de projet associées pour filtrer l’asset sélectionné. Créer une Note de projet crée une Note Partagée ou Privée associée au contexte du Content Browser.

De riches références

Utilisez Insérer la référence pour rechercher un actif, repère, Note ou Document. Vous pouvez également saisir @ lorsque cela est pris en charge ou faire glisser un élément Locus ou un actif Content Browser pris en charge dans un texte modifiable. Les ressources sont localisées ou ouvertes dans l’éditeur, les Note sont sélectionnés dans l’espace de travail Note, les Document s’ouvrent dans un onglet de l’éditeur Document et les repère utilisent la navigation normale.

Pour créer une référence Actor, faites glisser exactement un Actor chargé éligible du World Outliner vers un Note modifiable. L’identité utilise le monde racine enregistré et le GUID Actor, et non son étiquette. Les Actor ne sont pas proposés par Insérer la référence ou @ ; les références manquantes ou malformées restent visibles pour le diagnostic.

Les Note partagés ne peuvent pas faire référence à nouveau aux Note privés ou aux repère privés. Les Note privés peuvent faire référence à du contenu partagé ou privé.

Récupération et changements externes

Les instantanés de récupération sont stockés séparément de la Note faisant autorité :

récupération Partagée : <Project>/Saved/ProjectNotes/Recovery/
récupération Privée : <Project>/Saved/Locus/Recovery/PrivateNotes/

Lorsqu’une récupération est disponible, examinez-la avant de choisir Restaurer, Restaurer comme nouvelle Note ou Abandonner. Si un fichier change en dehors de Locus alors que vous avez des modifications non enregistrées, Locus bloque le remplacement silencieux et propose des actions sûres comme recharger le disque, enregistrer le texte local comme nouvelle Note, copier le texte local ou comparer les deux versions. Une Note propre modifiée à l’extérieur est actualisée depuis le disque.

Supprimer des Notes

Supprimer les Notes sélectionnées demande confirmation et supprime définitivement leurs fichiers externes ; le système d’annulation d’Unreal ne peut pas les restaurer. Lorsque le contrôle de source est actif, Locus refuse les états de suppression dangereux, comme le checkout d’un autre utilisateur, un fichier pas à jour ou un état impossible à vérifier.

Contrôle de source et Mode local

Les Notes privées restent toujours neutres vis-à-vis du fournisseur. Sélectionner, ouvrir ou lire une Note Partagée propre et contrôlée ne l’extrait pas. Elle reste en lecture seule jusqu’à l’action Extraire ; une extraction réussie active l’édition, tandis qu’un échec laisse la Note protégée sans contournement Rendre inscriptible.

Une nouvelle Note Partagée est d’abord écrite localement puis marquée pour ajout ; si l’opération du fournisseur échoue, le fichier local valide reste disponible et l’action peut être réessayée.

Sans fournisseur actif, les Notes Partagées nouvelles ou non suivies restent modifiables en Mode local. Une Note déjà contrôlée par le dépôt reste protégée jusqu’au retour du fournisseur et à son extraction explicite. Locus ne soumet pas, ne synchronise pas, ne gère pas les changelists et ne modifie pas les typemaps du dépôt. Voir Contrôle de source et Résolution des problèmes.

Sans fournisseur configuré, Notes n’affiche aucun état de contrôle de source, aucune info-bulle, aucune instruction ou action. Avec un fournisseur configuré, Afficher le statut du Contrôle de source contrôle uniquement les indicateurs de rangée compacts sans modifier le retour de sécurité requis ou l’éligibilité à l’action.

Limitations actuelles

L’organisation d’une Note reste dans son scope Partagé ou Privé existant.
Les références d’assets ne chargent pas les assets uniquement pour lister ou rechercher des Notes.
La prise en charge du contrôle de source est limitée par le fournisseur Unreal actif et l’état de fichier qu’il signale.

La création de Actor est limitée à un World Outliner Actor chargé éligible déposé dans un Note modifiable. La liste ou la recherche de références ne charge pas les ressources, les niveaux ou les Actor.