Documentos
Los Documentos son archivos Markdown propiedad del proyecto para información de proyecto más extensa. El archivo .md es siempre la fuente de referencia y sigue siendo compatible con editores de texto externos.
Propiedad y almacenamiento
Sección titulada «Propiedad y almacenamiento»Todos los Documentos se encuentran bajo <Project>/ProjectDocuments/. No hay ámbitos de Documento Compartido o Privado. Las carpetas de Content Browser bajo /Game/... se asignan a rutas correspondientes bajo ProjectDocuments/Content/...; una carpeta Developers sigue siendo contexto del proyecto, no propiedad privada.
Un Documento no es un UAsset, paquete, redirector, objeto de ejecución ni propietario de datos cocinados. Locus nunca envuelve Markdown en otro formato autoritativo.
Raíces Documentos de Locus y Content Browser
Sección titulada «Raíces Documentos de Locus y Content Browser»El árbol Documentos tiene dos raíces de presentación sobre el mismo repositorio físico:
- Documentos de Locus contiene Documentos normales propiedad del proyecto almacenados fuera del subárbol reservado
Content/. Estos Documentos solo existen en Locus y no se proyectan en el Content Browser de Unreal. - Explorador de contenido contiene únicamente Documentos cuya ruta relativa autoritativa empieza por
Content/. Locus oculta ese prefijo interno en el árbol, de modo queProjectDocuments/Content/Blueprints/AI/Behavior.mdaparece como Content Browser > Blueprints > AI > Behavior y se proyecta en el contexto/Game/Blueprints/AIcorrespondiente.
La raíz Content Browser es dispersa y está impulsada por Documentos. Solo muestra carpetas que contienen directamente un Documento Locus proyectado y los ancestros necesarios para llegar a ellas. No refleja carpetas /Game no relacionadas, y quitar una carpeta de presentación derivada no elimina ni modifica la carpeta Unreal correspondiente.
La proyección sigue la ruta relativa autoritativa, no la interfaz utilizada para crear el archivo. Un Documento descubierto al iniciar, creado en Locus, creado mediante Add > Locus > Locus Documento, importado o creado mediante MCP tiene la misma identidad indexada y el mismo comportamiento de proyección.
Crear y encontrar Documentos
Sección titulada «Crear y encontrar Documentos»Crea bajo Documentos de Locus un Documento exclusivo de Locus. Crea bajo Explorador de contenido un Documento asignado que se proyecta en el contexto /Game correspondiente. Add > Locus > Locus Documento en una carpeta de Content Browser compatible crea esa misma identidad asignada. Locus crea un archivo .md externo real, oculta la extensión en la interfaz normal y abre una pestaña de editor dedicada. Las importaciones Markdown y los Documentos creados mediante MCP siguen la misma política de creación local Sin seguimiento.
Organiza un Documento nuevo antes de añadirlo al control de código fuente:
Crear → cambiar nombre, mover y editar → Marcar para añadir cuando la ruta sea definitiva.
El espacio de trabajo explora carpetas físicas y admite búsqueda por título/ruta, filtros de estado, actualizar, abrir, cambiar nombre, mover, eliminar, reservar, marcar para añadir, importar y exportar. Se pueden abrir varias pestañas de Documentos; al abrir una ruta ya abierta se enfoca su pestaña existente.
Para importar, usa la acción de Locus en Content Browser y elige un archivo .md UTF-8 válido. Locus conserva sus bytes de origen y finales de línea y usa un nombre numerado seguro si el destino ya existe.
La barra de herramientas del Documento sigue siendo una fila. Las acciones de menor prioridad pasan progresivamente a Más acciones; Allí permanecen Exportar y Actualizar. Las acciones de control de código fuente están ausentes cuando no se configura ningún proveedor.
Editar y guardar
Sección titulada «Editar y guardar»Los Documentos nuevos o vacíos se abren en Modo de edición; los que tienen contenido, en Modo de lectura. Pulsa Ctrl+E para Modo de edición, Ctrl+R para Modo de lectura y Ctrl+S para guardar. Los Documentos usan guardado explícito en lugar del guardado automático de las Notas.
El editor de origen ofrece comandos para encabezados, énfasis, código en línea y cercado, listas ordenadas y sin ordenar, listas de tareas, citas, enlaces, tablas, líneas horizontales, referencias de assets y referencias de Pines. La Vista previa dividida muestra el búfer sin guardar junto al origen después de un breve retraso; abrir o actualizar la Vista previa no guarda el archivo.
En Editar, la barra de herramientas compacta proporciona Encabezado, Negrita, Cursiva, Código en línea, Lista con viñetas, Lista ordenada, Enlace externo, Referencia de asset y Referencia de pin; otros comandos permanecen en Formato. Vista previa dividida representa el búfer actual junto a la fuente después de un breve rebote sin guardar; su divisor, estado abierto y proporción son preferencias personales.
Modo de lectura y compatibilidad Markdown
Sección titulada «Modo de lectura y compatibilidad Markdown»El Modo de lectura usa la interfaz nativa de Unreal. Admite las construcciones Markdown necesarias para la barra de herramientas del editor, incluidos encabezados, párrafos, énfasis, texto en negrita, listas, elementos de tarea solo de presentación, citas, código, enlaces, tablas con alineación, líneas horizontales y tachado.
Locus no promete una representación equivalente a la de un navegador ni un Markdown completo. El HTML sin procesar permanece como texto de origen inerte, JavaScript nunca se ejecuta, los esquemas de URL no seguros no se activan y el contenido remoto no se recupera automáticamente. Los enlaces HTTP y HTTPS se abren solo después de una acción explícita en el navegador del sistema operativo.
Las referencias de assets y Pines usan etiquetas legibles en la presentación. Se puede enfocar un Pin del mapa actual; un Pin de otro mapa puede localizar su nivel propietario sin cargarlo automáticamente. Las referencias ausentes permanecen inertes y se pueden diagnosticar.
Las referencias de Activos resueltos, Pin, Nota, Documento y Actor utilizan etiquetas legibles. Las referencias de Actor se crean únicamente colocando un World Outliner Actor cargado y elegible en un Documento en modo de edición; No los ofrecen Insertar Referencia ni @. HTML y JavaScript sin formato nunca se ejecutan y el contenido remoto no se recupera.
Cambiar nombre, mover y eliminar
Sección titulada «Cambiar nombre, mover y eliminar»Cambiar nombre y mover permanecen dentro de la raíz Documentos. Para un Documento Sin seguimiento apto, usa Cambiar nombre en la barra de herramientas o el menú contextual, pulsa F2, usa Mover en la barra o arrástralo a una carpeta existente válida. El espacio de trabajo Documentos de Locus es el lugar autoritativo para cambiar nombre o mover; el elemento de Content Browser es una proyección y no se admite cambiar directamente su nombre desde Content Browser.
Después de Marcar para añadir, Cambiar nombre y Mover dejan de estar disponibles intencionadamente. También siguen sin estar disponibles para Documentos controlados, porque Locus no puede garantizar un movimiento transaccional de control de código fuente neutral para el proveedor. Este límite de seguridad evita que un cambio del sistema de archivos desincronice Documento y control de código fuente. Los Documentos abiertos con cambios sin guardar o en conflicto también bloquean cambiar nombre, mover y eliminar desde el espacio de trabajo.
La eliminación es permanente, requiere confirmación y no se puede deshacer con Unreal. Para archivos controlados, Locus valida el estado y dirige la eliminación mediante el proveedor activo antes de limpiar localmente.
Los cambios de ruta están disponibles solo para Untracked Documento locales o Documento. Cambiar nombre y mover están deshabilitados después de Marcar para añadir o el control del proveedor porque Locus no realiza movimientos de depósito neutrales del proveedor ni transfiere el estado abierto entre rutas.
Exportar
Sección titulada «Exportar»Exporta un Documento seleccionado, una carpeta, todos los Documentos o una copia del editor. La exportación conserva el origen actual —incluido un búfer sin guardar al exportar una copia— y puede conservar la estructura de carpetas. El destino no puede estar dentro de ProjectDocuments; las opciones de colisión son sobrescribir, omitir o crear una copia numerada. Exportar no cambia el Documento de origen, su pestaña ni su estado del control de código fuente.
Recuperación y edición externa
Sección titulada «Recuperación y edición externa»Locus almacena la recuperación de Documentos bajo <Project>/Saved/Locus/Recovery/Documentos/. Un guardado correcto elimina la instantánea correspondiente. Los cambios externos limpios se vuelven a cargar; un cambio externo en conflicto con texto local modificado bloquea el guardado hasta que elijas una resolución segura.
Como .md es autoritativo, se admiten editores externos. Actualiza el descubrimiento después de operaciones externas si el espacio de trabajo no se actualiza con rapidez. Las pestañas del Editor no se restauran automáticamente después de reiniciar Unreal Editor.
Un nuevo Locus Documento prefiere la pila de pestañas activa o activa más recientemente Locus Documento; la misma ruta normalizada enfoca su pestaña existente. Las pestañas permanecen acoplables libremente pero no se restauran después de reiniciar el Editor.
Vista previa del Documento seleccionado
Sección titulada «Vista previa del Documento seleccionado»Seleccionar un Documento muestra una vista previa de Markdown de solo lectura en el panel de detalles del espacio de trabajo. Presenta el archivo guardado y autoritativo; usa el editor dedicado para leer o editar el contenido. Durante una transición breve normal, la vista previa permanece neutral hasta que el contenido seleccionado está listo. Solo una espera superior a aproximadamente un segundo muestra una explicación de carga nativa compacta en lugar de contenido antiguo.
El nombre y la ruta del archivo proporcionan la identidad del Documento en el espacio de trabajo. Un encabezado Markdown es contenido, por lo que cambiar el nombre del archivo actualiza el nombre mostrado sin reescribir un encabezado como # My Title.
En el menú Documento Editor Vista, Tamaño de fuente del origen afecta al editor de código fuente y Tamaño de fuente de lectura afecta la lectura completa y la vista previa dividida. Ctrl+mouse wheel ajusta la vista aplicable.
Control de código fuente
Sección titulada «Control de código fuente»Los Documentos son propiedad del proyecto. Un Documento recién creado permanece Sin seguimiento hasta que eliges explícitamente Marcar para añadir, de modo que pueda organizarse mientras su ruta cambia. Un Documento local o sin seguimiento sigue siendo legítimamente editable en Modo local. Si falla Marcar para añadir, el Markdown válido permanece en su lugar y se puede reintentar.
Un Documento controlado por el depósito permanece legible, pero no puede entrar en Modo de edición autoritativo ni Guardarse hasta que una reserva explícita tenga éxito. Locus mantiene esas acciones no disponibles cuando el Documento está limpio y no reservado, reservado por otro usuario o cliente, desactualizado o desconectado de su proveedor. No ofrece un bypass para hacerlo escribible; Modo de lectura y Exportar copia siguen disponibles cuando corresponde.
Después de reconectar el control de código fuente, actualizar restaura el estado controlado. El Documento permanece en solo lectura hasta que la reserva tenga éxito. Locus no envía, sincroniza, administra changelists ni cambia typemaps. Consulta Control de código fuente, Impacto del proyecto y dependencias y Solución de problemas.
Sin ningún proveedor configurado, Documentos no muestra ningún estado, guía, información sobre herramientas o acción específicos del control de fuente. Un proveedor configurado pero no disponible mantiene protegidos los archivos controlados conocidos.