Documents

Les Documents sont des fichiers Markdown appartenant au projet pour les connaissances de projet de forme longue. Le fichier .md fait toujours autorité et reste compatible avec les éditeurs de texte externes.

Propriété et stockage

Tous les Documents résident sous <Project>/ProjectDocuments/. Il n’existe aucun scope de Document Partagé ou Privé. Les dossiers du Content Browser sous /Game/... correspondent aux chemins sous ProjectDocuments/Content/... ; un dossier Developers reste un contexte de projet, pas une propriété privée.

Un Document n’est ni un UAsset, ni un package, ni un redirector, ni un objet d’exécution, ni le propriétaire de données cuites. Locus n’enveloppe jamais le Markdown dans un autre format faisant autorité.

Racines Documents Locus et Content Browser

L’arborescence Documents possède deux racines de présentation sur ce dépôt physique unique :

Documents Locus contient les Documents ordinaires appartenant au projet et stockés en dehors du sous-arbre Content/ réservé. Ces Documents existent uniquement dans Locus et ne sont pas projetés dans le Content Browser d’Unreal.
Navigateur de contenu contient seulement les Documents dont le chemin relatif faisant autorité commence par Content/. Locus masque ce préfixe de stockage interne dans l’arborescence : ProjectDocuments/Content/Blueprints/AI/Behavior.md apparaît sous Content Browser > Blueprints > AI > Behavior et se projette dans le contexte /Game/Blueprints/AI correspondant.

La racine Content Browser est clairsemée et pilotée par les Documents. Elle n’affiche que les dossiers qui contiennent directement un Document Locus projeté, ainsi que les ancêtres nécessaires pour atteindre ces dossiers. Elle ne reflète pas les dossiers /Game sans rapport et supprimer un dossier de présentation dérivé ne supprime ni ne modifie le dossier Unreal correspondant.

La projection suit le chemin relatif faisant autorité, pas l’UI utilisée pour créer le fichier. Un Document découvert au démarrage, créé dans Locus, créé via Add > Locus > Locus Document, importé ou créé via MCP possède la même identité indexée et le même comportement de projection.

Créer et trouver des Documents

Créez sous Documents Locus pour un Document propre à Locus. Créez sous Navigateur de contenu pour un Document mappé qui se projette dans le contexte /Game correspondant. Add > Locus > Locus Document dans un dossier Content Browser pris en charge crée cette même identité mappée. Locus crée un véritable fichier externe .md, masque l’extension dans l’UI normale et ouvre un onglet d’éditeur dédié. Les imports Markdown et les Documents créés via MCP suivent la même politique de création locale Non suivi.

Organisez un nouveau Document avant de l’ajouter au contrôle de source :

Créer → renommer, déplacer et modifier → Marquer pour ajout lorsque le chemin est définitif.

Le espace de travail parcourt les dossiers physiques et prend en charge la recherche par titre/chemin, les filtres d’état, l’actualisation, l’ouverture, le renommage, le déplacement, la suppression, l’extraction, le marquage pour ajout, l’import et l’export. Plusieurs onglets de Document peuvent être ouverts ; l’ouverture d’un chemin déjà ouvert place le focus sur son onglet existant.

Pour importer, utilisez l’action Locus du Content Browser et choisissez un fichier .md UTF-8 valide. Locus préserve ses octets source et ses fins de ligne et utilise un nom numéroté sûr si la destination existe déjà.

La barre d’outils Documents reste sur une seule ligne. Les actions moins prioritaires sont progressivement déplacées vers Autres actions ; Exporter et Actualiser y restent. Les actions de contrôle de source sont absentes lorsqu’aucun fournisseur n’est configuré.

Modifier et enregistrer

Les Documents nouveaux ou vides s’ouvrent en Mode édition ; les Documents remplis s’ouvrent en Mode lecture. Appuyez sur Ctrl+E pour le Mode édition, Ctrl+R pour le Mode lecture et Ctrl+S pour enregistrer. Les Documents utilisent l’enregistrement explicite plutôt que l’enregistrement automatique des Notes.

L’éditeur source fournit des commandes pour les titres, l’emphase, le code en ligne et clôturé, les listes ordonnées et non ordonnées, les listes de tâches, les citations, les liens, les tableaux, les lignes horizontales, les références d’assets et les références de Repères. L’Aperçu fractionné présente le tampon non enregistré actuel à côté de la source après un court délai ; ouvrir ou actualiser l’Aperçu n’enregistre pas le fichier.

Dans Modifier, la barre d’outils compacte fournit Titre, Gras, Italique, Code en ligne, Liste non ordonnée, Liste ordonnée, Lien externe, Référence d’asset et Référence de repère ; les autres commandes restent dans Format. Diviser l’aperçu restitue le tampon actuel à côté de la source après un court anti-rebond sans enregistrer ; son diviseur, son état ouvert et son rapport sont des préférences personnelles.

Mode lecture et prise en charge Markdown

Le Mode lecture utilise l’UI Unreal native. Il prend en charge les constructions Markdown nécessaires à la barre d’outils de l’éditeur, notamment les titres, paragraphes, emphase, texte en gras, listes, éléments de tâches en lecture seule, citations, code, liens, tableaux avec alignement, lignes horizontales et texte barré.

Locus ne promet ni un rendu équivalent à celui d’un navigateur ni un rendu Markdown complet. Le HTML brut reste un texte source inerte, JavaScript ne s’exécute jamais, les schémas d’URL dangereux ne sont pas activés et le contenu distant n’est pas récupéré automatiquement. Les liens HTTP et HTTPS ne s’ouvrent qu’après une action explicite de l’utilisateur dans le navigateur du système d’exploitation.

Éditeur de documents Locus montrant un document Markdown de projet en Mode lecture avec titres, liste et tableau — Les Documents conservent Markdown comme source tandis que le Mode lecture présente la structure prise en charge dans l’UI native de l’Editor.

Les références d’assets et de Repères utilisent des libellés lisibles dans la présentation. Un Repère de la carte actuelle peut être focalisé ; un Repère d’une autre carte peut localiser son niveau propriétaire sans le charger automatiquement. Les références manquantes restent inertes et diagnostiquables.

Les références d’actifs résolus, repère, Note, Document et Actor utilisent des étiquettes lisibles. Les références Actor sont créées uniquement en déposant un World Outliner Actor chargé éligible dans un Document en mode édition ; ils ne sont pas proposés par Insérer la référence ou @. Le HTML brut et le JavaScript ne s’exécutent jamais et le contenu distant n’est pas récupéré.

Renommer, déplacer et supprimer

Le renommage et le déplacement restent dans la racine Documents. Pour un Document Non suivi éligible, utilisez Renommer dans la barre d’outils ou le menu contextuel, appuyez sur F2, utilisez Déplacer dans la barre d’outils ou faites-le glisser vers un dossier existant valide. L’espace de travail Documents Locus est l’endroit de référence pour renommer ou déplacer ; l’élément Content Browser est une projection et le renommage direct dans le Content Browser n’est pas pris en charge.

Après Marquer pour ajout, Renommer et Déplacer sont intentionnellement indisponibles. Ils restent aussi indisponibles pour les Documents contrôlés, car Locus ne peut pas garantir un déplacement transactionnel de contrôle de source neutre vis-à-vis du fournisseur. Cette limite de sécurité empêche une modification du système de fichiers de désynchroniser le Document et le contrôle de source. Les Documents ouverts modifiés ou en conflit bloquent également le renommage, le déplacement et la suppression depuis l’espace de travail.

La suppression est définitive, nécessite une confirmation et ne peut pas être annulée par Unreal. Pour les fichiers suivis, Locus valide l’état et fait passer la suppression par le fournisseur actif avant le nettoyage local.

Les changements de chemin sont disponibles uniquement pour les Untracked Document locaux ou. Le renommage et le déplacement sont désactivés après Marquer pour ajout ou le contrôle du fournisseur, car Locus n’effectue pas de déplacements de dépôt indépendants du fournisseur ni ne transfère l’état ouvert entre les chemins.

Exporter

Exportez un Document sélectionné, un dossier, tous les Documents ou une copie de l’éditeur. L’export préserve la source actuelle — y compris un tampon non enregistré lors de l’export d’une copie — et peut préserver la structure des dossiers. La destination ne peut pas se trouver dans ProjectDocuments ; en cas de collision, les choix sont écraser, ignorer ou créer une copie numérotée. L’export ne modifie ni le Document source, ni son onglet, ni son état de contrôle de source.

Récupération et édition externe

Locus stocke la récupération des Documents sous <Project>/Saved/Locus/Recovery/Documents/. Un enregistrement réussi supprime l’instantané correspondant. Les changements externes propres sont rechargés ; un changement externe qui entre en conflit avec un texte local modifié bloque l’enregistrement jusqu’à ce que vous choisissiez une résolution sûre.

Puisque .md fait autorité, les éditeurs externes sont pris en charge. Actualisez la découverte après des opérations de fichier externes si l’espace de travail ne se met pas à jour rapidement. Les onglets de l’éditeur ne sont pas restaurés automatiquement après le redémarrage d’Unreal Editor.

Un nouveau Locus Document préfère la pile d’onglets Locus Document active ou la plus récemment active ; le même chemin normalisé concentre son onglet existant. Les onglets restent librement ancrables mais ne sont pas restaurés après un redémarrage de l’éditeur.

Aperçu du Document sélectionné

La sélection d’un Document affiche un aperçu Markdown en lecture seule dans le panneau de détails de l’espace de travail. Il présente le fichier enregistré et faisant autorité ; utilisez l’éditeur de documents dédié pour lire ou modifier le contenu. Pendant une transition de sélection courte et normale, l’aperçu reste neutre jusqu’à ce que le contenu sélectionné soit prêt. Seule une attente supérieure à environ une seconde affiche une explication de chargement native compacte plutôt que du contenu pas à jour.

Le nom et le chemin du fichier Document fournissent son identité d’espace de travail. Un titre Markdown est du contenu : renommer le fichier met donc à jour son nom affiché sans réécrire un titre tel que # My Title.

Dans le menu Affichage de l’éditeur Document, Taille de police de la source affecte l’éditeur source et Taille de police de lecture affecte l’aperçu complet en lecture et fractionné. Ctrl+mouse wheel ajuste la vue applicable.

Contrôle de source

Les Documents appartiennent au projet. Un Document nouvellement créé reste Non suivi jusqu’à ce que vous choisissiez explicitement Marquer pour ajout, afin de pouvoir l’organiser pendant que son chemin change encore. Un Document local ou non suivi reste légitimement modifiable en Mode local. Si le marquage pour ajout échoue, le Markdown valide reste en place et peut être réessayé.

Un Document contrôlé par un dépôt reste lisible mais ne peut pas entrer en Mode édition faisant autorité ni être Enregistré avant la réussite d’une extraction explicite. Locus garde ces actions indisponibles lorsque le Document est propre et non extrait, extrait par un autre utilisateur ou client, pas à jour ou déconnecté de son fournisseur. Il n’offre aucun contournement Rendre inscriptible ; le Mode lecture et Exporter une copie restent disponibles le cas échéant.

Après la reconnexion du contrôle de source, l’actualisation rétablit l’état contrôlé. Le Document reste en lecture seule jusqu’à la réussite de l’extraction. Locus ne soumet pas, ne synchronise pas, ne gère pas les changelists et ne modifie pas les typemaps. Voir Contrôle de source, Impact du projet et dépendances et Résolution des problèmes.

Sans fournisseur configuré, Documents n’affiche aucun état, guide, info-bulle ou action spécifique au contrôle de source. Un fournisseur configuré mais indisponible protège les fichiers contrôlés connus.