1.Etiquetas de ayuda
Hola, probablemente acaba de crear una base de datos de hipertexto del sistema "mentor" tras la instalación del módulo utags.
al final del script de creación de la base de datos, se lanza gvim para editar este archivo de ayuda.
gvim es la base sobre la que utags proporciona un sistema de edición y gestión de hipertexto.
Si no está familiarizado con gvim, empiece por mirar . aide vim .
. aide vim es la referencia de una etiqueta de hipertexto mentor que le lleva al archivo de ayuda de vim.
Para acceder a ella, escriba el comando ":ta aide_vim" y pulsa enter o coloca el cursor de texto en la referencia . aide vim escriba shift-$, lo que abrirá una nueva pestaña del archivo de ayuda.
Ahora tienes que aprender a utilizar la herramienta a través de:
de . commandes et macro commandes de navigation dans l'hypertexte
la . présentation de la forme de l'hypertexte
la estructura del . langage de balisage leger mentor que es la estructura de este texto.
la . la méthodologie mentor d édition hypertexte
la . modes de recherche dans l'hypertexte
de . macro commandes d edition de l'hypertexte
de . macro commandes de generation de l'hypertexte
de la . pilotage de la generation de l'hypertexte
de . systemes de sauvegarde des domaines et des fichiers Posteriormente, un segundo componente importante estará disponible en el sistema de mentores : . module tableur base de donnee relationnelle et applications
2.. commandes et macro commandes de navigation dans l'hypertexte : y presentación de la forma de hipertexto
El editor vim tiene una función de navegación por hipertexto que se puede desglosar en comandos :
en el modo de lÃnea de comandos puede acceder a una etiqueta (etiqueta) "sumario" por ejemplo mediante el comando:
:su resumen - una variante es :
:resumen de la etapa que divide la ventana antes de la navegación.
hay un comando de retorno :
:en. que te devuelve a la posición original.
el comando ta sin argumento le hace avanzar en el árbol de navegación :puede navegar por el árbol de navegación mediante secuencias de estos dos comandos.
el árbol de navegación se puede ver con el comando:
:tags - una navegación entre buffers de texto que no es una navegación de hipertexto es el comando:
:e# que va al búfer anterior (cambiar asà que si se repite).
Esto es útil si quiere cambiar entre dos archivos sin cambiar el árbol de navegación del hipertexto.
para facilitar la navegación, estos comandos han sido asignados (pedir :mapa) en las teclas de función de F5 a F8 : (el comando ":map" permite asignar una secuencia de caracterÃsticas de control a otra...
El enfoque más simple del mentor utiliza mapeos que comienzan con el carácter ".comandos y macrocomandos para la navegación por el hipertexto)
2.1.Tabla de teclas de función de navegación
| TF | lÃnea_de_pedido | acción
|
|---|
| F5 | tags | mostrar la pila de etiquetas navegadas (tags'stack)
|
| F6 | po | subir una etiqueta en la pila |
| F7 | ta | avanzar una etiqueta en la pila |
| F8 | e# | cambiar entre dos buffers de texto |
y . mode commande vi el cursor debe estar en la referencia del hipertexto, por ejemplo: sommaire_es
(referencia de hipertexto para el . langage de balisage leger mentor tabla de teclas de función de navegación).
la tecla para la navegación es "ctrl-.]" en un teclado qwerty y ctrl-altgr-] en una azertizacion
que es más complicado y que hemos emulado en altgr-$
(que el $ esté en azerty en el mismo lugar que el ] en qwerty y altgr-$ es en realidad el carácter "¤")
este comando va a la etiqueta referenciada en la misma ventana.
por lo que es el equivalente al comando ":su etiqueta" pero sin tener que escribir la etiqueta en el teclado.
altgr-$ inicia la macro ggt_es (en modo comando escriba ")
la tecla "µ" busca la etiqueta haciendo una división horizontal de la ventana
es por tanto el equivalente al comando ":etiqueta del establo".
µ lanza la macro ght_es (en modo comando escriba "
la macro gvt_es hace un escupitajo vertical de la ventana se asigna a la tecla "§" que no es utilizada por vi.
- los comandos para navegar entre ventanas son :
- ctrl-flecha arriba o ctrl-flecha abajo para la circulación en un solo sentido
en el orden temporal de la división de la ventana.
la tecla shift-$ correspondiente al carácter "£" de navegación por el hipertexto pero abriendo una nueva pestaña.
£ ejecuta la macro gnt_es (en modo comando escriba ") - los comandos para navegar entre las pestañas son :
- abriendo una pestaña ":tabnew" asignado a la macro "
- siguiente pestaña, comando "ctrl-tab"
- pestaña anterior, comando ^ctrl-shift-tab"
El desplazamiento entre pestañas se realiza mediante los siguientes comandos: - ctrl-tab ctrl-shift-tab (los comandos de vi son gt y gT respectivamente)
- tn_es para crear una pestaña vacÃa
- las 3 llaves altgr-$, £ (shif-$) µ y § se eligieron porque no son utilizados por el . mode commande vi
y resulta que son vecinos. * y § se eligen por su posición relativa en el desplazamiento a la derecha para indicar la dirección de la división de la ventana.
- Tenga en cuenta que las letras utilizadas para las macros también son similares, la letra "g"
lo que significa un cambio (Ir a) en el nomenclature_des_macros_es.
(el franglais en las nomenclaturas está claramente asumido - el pragmatismo anglosajón obliga)
2.1.1.Tabla de teclas de control de navegación
| clave | macros | | acción
|
|---|
| altgr-$ | ggt_es | | navegación de hipertexto en el buffer vi actual
|
| µ | ght_es | hacer etiqueta horizontal | navegación por hipertexto haciendo una división horizontal de la ventana |
| £ | gnt_es | | navegación por hipertexto abriendo una nueva pestaña |
| § | gvt_es | | navegación de hipertexto haciendo una división vertical de la ventana |
| | | otras macros vinculadas a archivos especÃficos (ver más abajo) |
|
|---|
| | gsf_es | ir al archivo de resumen | navegación por hipertexto en el resumen del expediente |
| | gsr_es | ir al archivo de referencia del resumen | navegación de hipertexto en el resumen del archivo hasta la ubicación de la referencia de la etiqueta actual |
| | gsg_es | ir al resumen general | navegación por hipertexto en el resumen general (lista de referencias de archivos en la base de datos) |
| | gut_es | ir a las etiquetas | navegación de hipertexto al archivo utags (Ãndice de etiquetas de hipertexto para los archivos de la base de datos) |
| | gag_es | go arbre general | navegación por hipertexto hacia el archivo que contiene el árbol de archivos de la base de datos) |
| | gas_es | ir al árbol de origen | navegación de hipertexto al archivo que contiene el árbol de archivos de la última ejecución de utags) |
| | grc_es | ir a las referencias cruzadas | navegación de hipertexto hacia el archivo de referencias cruzadas:busca la referencia de la etiqueta actual |
. présentation de la forme de l'hypertexte
2.2.Bloque de texto
texte_structuré_es
El bloque de texto es la estructura bajo la cual se almacena un texto.
Se compone de cuatro tipos de elementos delimitados por pares de delimitadores < >, ( ), { } y [ ]
una etiqueta de hipertexto o etiqueta puesta entre los delimitadores "<" et ">", dijo . étiquette mentor
.
que sólo puede contener caracteres alfanuméricos con el carácter de subrayado "_" como separador - un posible . résumé de bloc
o . commentaire mentor
poner entre paréntesis "( )",
el texto real entre llaves "{}" que es el bloque de texto real.
referencias de hipertexto de la forma etiquetas de texto que se utilizan para resaltar el texto en los bloques de texto 2.2.1.Bloque estructural
Por lo tanto, tenemos una forma general:
<etiquette_de_bloc_es>(tÃtulo) [reference_es]
{
...
... [reference_es] ...
...
<etiquette_de_sous_bloc_es>(etiqueta del sub-bloque)
{
...
... [reference_es] ...
...
... <etiquette_dans_texte_es> ...
...
... [reference_es] ...
...
etc....
}
}
que, por lo tanto, pueden anidarse: Un bloque de texto puede contener otros bloques de texto.
Un bloque particular es el bloque de todo el archivo cuya lÃnea de etiqueta contiene:
la etiqueta del nombre del archivo - el tÃtulo del archivo - una referencia al resumen del archivo.
Por lo tanto, la forma de la etiqueta del archivo es 2.2.2.Etiqueta en el texto
.
por ejemplo para un archivo llamado filename.
ext en una :
<nomfichier_extension_es>(tÃtulo del archivo)[nomfichier_extension_es_som]
la macro para generar esta lÃnea es fnt_es para un archivo de texto.
Hay otras macros.
3.áreas de tutorÃa
los archivos de la base de datos están referenciados en archivos con nombre de dominio, con extensión .dom
el dominio raÃz asà que la raÃz.dom es el dominio de más bajo nivel racine_dom_es como su nombre indica.
el dominio contiene la lista de rutas de archivos y posiblemente subdominios.
un subdominio se caracteriza por el carácter @ que precede a la ruta del dominio
para que utags sepa interpretar este archivo como un dominio.
esto forma un árbol jerárquico cuyas ramas son los dominios y las hojas los archivos.
dentro de los archivos este árbol continúa a través de la anidación de bloques de texto gracia
a la etiqueta del bloque.
para añadir sus archivos a la base de datos de mentores, se recomienda crear uno o más dominios
en el dominio_raÃz y editar sus archivos añadiendo su.
Esto se puede hacer automáticamente mediante un comando del shell, por ejemplo en unix:
!!encontrar . -nombre *.* -impresión
ou sous windows:
!!dir /b /l /s *.*
4.Un pequeño recorrido por el hipertexto
utags genera un archivo de resumen cuando analiza un archivo cuya extensión de resumen es ".som" el nombre del resumen del archivo actual es aide_utags_txh.som
para el archivo actual la etiqueta es aide_utags_txh_es_som y se encuentra como se ve en la primera lÃnea del
la macro para el acceso directo al Ãndice es gsf_es
una vez en el resumen elegir una etiqueta para volver al archivo por altgr-$ (pero se incluirá en el árbol de navegación)
o escriba esta macro para acceder al resumen y luego pulse F6 para volver a este archivo o F8 si quiere cambiar fácilmente
en el archivo y su resumen.
utags también genera un resumen general para todos los archivos de la base de datos, para acceder a él utilice la macro gsg_es
el resumen general se compone de bloques de texto cuyas etiquetas son los dominios
y cuyos bloques están compuestos por la lista de archivos o subdominios del.
Es decir, estos bloques son resúmenes de la.
la primera referencia en un bloque de dominio es un enlace al propio archivo de dominio.
si se navega por esta referencia de archivo de dominio, por ejemplo utags_dom_es
verá la lista de las rutas de los archivos. Ignora las lÃneas "CSV" que hacen
parte del siguiente módulo del mentor que se ocupa de los datos estructurados (tablas de datos)
el módulo utags que maneja los llamados datos "no estructurados", es decir, texto
pero a la que el . langage de balisage leger mentor proporciona una estructura.
puede navegar a voluntad por el hipertexto y volver al punto de partida pulsando F6
y volver al árbol de navegación pulsando F7
con todos estos movimientos es posible que necesite almacenar una posición especÃfica en un archivo para volver a ella directamente.
Puede utilizar un vi de marca : mp por ejemplo para marcar con la letra "p" la posición de la lÃnea actual
y recuperarlo después de moverlo por el archivo con el comando 'p'
utags cuando explora el árbol de dominios, genera un número de :
el archivo más importante es el archivo de etiquetas llamado "utags" al que podemos
acceder escribiendo el comando ":sus etiquetas" o la macro gut_es (a partir de ahora
ya no especificaremos en el texto para una macro mentor el ".
el archivo utags tiene la estructura de un archivo de etiquetas como el generado por el comando unix ctags para fuentes en lenguaje C.
puede buscar la ubicación de una etiqueta en el archivo utags con la macro frt_es.
el archivo "tree.txt" al que se puede acceder con el comando gag_es (no, esto no es una broma).
Este archivo muestra todo el árbol de dominios con sus hojas, los archivos,
es decir, para un archivo vemos tanto la ruta del mentor como la del sistema de archivos.
Asà que utags proporciona otra forma de acceder y organizar tus archivos.
Una doble jerarquÃa.
el archivo "source.txt" accedido por gas_es que es el resultado de un comando utags particular
que sólo se ocuparÃa de un dominio o archivo concreto en lugar de la racine_dom_es.
el archivo "urefs" también es muy importante, es la referencia cruzada, es decir
la lista de archivos donde se cita una referencia en un texto.
Si está en una etiqueta, la macro frr_es le permite encontrar donde esta etiqueta
lo cual es conveniente si se quiere eliminar para mantener la coherencia del hipotexto.
Lógicamente, sus referencias también deben ser eliminadas.
Para acceder al archivo urefs sin hacer una búsqueda : ":ta refs"
5.La metodologÃa mentor de la edición de hipertexto
el conocimiento que se tiene de una información también depende de
la forma en que se insertó en el hipertexto.
Por ello, hay que prestar especial atención a la
ámbito de edición de la etiqueta para recuperar la información.
por información se entiende el bloque de texto de una etiqueta de bloque
o la vecindad de una etiqueta en un texto.
lógicamente elegiremos las palabras clave que caracterizan esta información
para formar la etiqueta.
un método también utilizado para formar esta etiqueta es utilizar
una nomenclatura deinfixe_es que son códigos de tres letras
se propone esta nomenclatura, pero se puede ampliar o sustituir
según sus necesidades.
Lo importante es utilizar una nomenclatura, ya que permite clasificar la información
que será más fácil de encontrar porque el número de infijos es limitado.
6.Modos de búsqueda en el hipertexto
hay varios niveles para llegar a la información en el hipertexto
según el conocimiento que se tenga de esta información.
si conoce la etiqueta por completo, la forma más fácil es escribir
la orden : ":su etiqueta"
entonces puede utilizar el resumen general gsg_es si busca un archivo
o el archivo utags_es gut_es si busca un bloque de texto.
entonces sólo tienes que ir al archivo y hacer una búsqueda en vi con el comando
"/cadena/" seguido de enter
la cadena de caracteres puede ser un . expression régulière que permite una búsqueda flexible en elementos sintácticos.
por ejemplo en el archivo utags la búsqueda: /orden.*buffer/ te colocará en la etiqueta . commande de gestion de buffer vi
fdr_es
función de búsqueda en el dominio: realiza una búsqueda de texto completo en todos los archivos de un dominio
utiliza el programa nomfic que crea la lista de ficheros de un dominio teniendo en cuenta recursivamente los subdominios.
NOTA PARA LOS DESARROLLADORES : este documento que contiene enlaces a las fuentes de los archivos de macros de vim o scripts de perl es un ejemplo
cómo enlazar sus fuentes y documentos de especificaciones técnicas con etiquetas en los comentarios,
facilitar la programación con letras.
También el resumen del expediente (gsf_esmodos de búsqueda en el hipertexto) le dará una visión general de su fuente y enlaces a
al código que le interesa. Ejemplo con el programa perl para generar páginas html : mt_to_htm_pl_es_som
( Hay mucho margen de mejora en futuras versiones, como la inclusión de "inside html" en el documento fuente
con el fin de beneficiarse de la.modos de búsqueda en el hipertexto)
Estas funciones aportan una solución práctica al eterno problema del desajuste entre el código y la documentación.
Con la metodologÃa del mentor, la documentación es un código como cualquier otro.
7.Macrocomandos de edición del hipertexto
Se proporcionan macrocomandos para facilitar la edición del formulario de hipertexto :
7.1.. tableau des macro commandes d'edition : para el lenguaje de marcas mentor light
| macro | mnemónica | comentario
|
|---|
| ebia_es | Edición Bloc Inserción de los elogios | inserta un bloque de llaves
|
| ebai_es | Edición de paréntesis de inversión de bloques | inserta corchetes para dividir un bloque |
| ebtb_es | Edición Bloc Tag Build | crea un . bloc structurel completar dejando en edición en la etiqueta |
| ebma_es | Edición Bloc Mise En Accolades | refuerza un bloque de lÃneas seleccionado por F3-F4 |
| ebmp_es | Edición de paréntesis en bloque | pone entre paréntesis un bloque de lÃneas seleccionado por F3-F4 |
| ebm__es | Edición del bloqueo silencioso | hay una serie de macros ebm cuya última letra es . modifieur de bloc |
| etft_es | Edición Tab Fichier Textos | hay una serie de macro etf etf_mac_es cuya última letra es el tipo de archivo fuente |
7.2.Macrocomandos para generar hipertexto
estas macros lanzan, con varias opciones, el programa utags que analiza los archivos del árbol de dominios.
se asignan a las teclas de función F11 Shift-F11 Alt-F11 Ctrl-F11 y Ctrl-Shift-F11.
7.2.1.Tabla de macrocomandos para generar hipertexto
| macro | mnemónica | comentario
|
|---|
| ub_es | Base de UTags | lanza utags para una exploración de toda la base de datos de los archivos modificados desde la última exploración (racine.dom)
|
| ud_es | Utags Domaine | lanza utags para una exploración de los archivos modificados en el dominio actual |
| uf_es | Fichero Utags | lanza utags para el análisis del archivo actual |
| F11_es | ub_es racine.dom | acceso directo ut_es |
| M-F11_es | ud_es racine.general dom | acceso directo ug_es |
| C-F11_es | uf_es archivo | acceso directo uf_es |
el comando más utilizado será sin duda C-F11_es.
Cuando edite un documento creando etiquetas y referencias, utilizará este comando después de guardar los cambios para actualizar la base de datos utags con las nuevas etiquetas y la base de datos urefs con las nuevas referencias.
NOTA : Los comandos descritos aquà se encuentran en el menú Utags de la barra de menú de gvim.
Este menú está diseñado para proporcionar un acceso rápido a la ayuda para recordar los comandos.
NOTA : estos comandos y el lenguaje de marcas mentor light son lo único que necesitas saber para tener una potente herramienta de gestión de información textual que si la integras te servirá de forma consistente y durante mucho tiempo para guardar y utilizar prácticamente toda tu información útil.
8.Control de la generación de hipertexto
el archivo extensio_lst_es contiene una tabla de extensiones de archivo conocidas y sus propiedades utilizadas por el programa utags
el archivo /home/minage/Documents/mt/ht/ref_abs.txt lista las referencias que no tienen las etiquetas correspondientes.
el archivo utags_par_es parámetros que controlan el funcionamiento del programa utags
9.Sistemas de copia de seguridad de dominios y archivos
En el menú Utags hay un submenú "Explotación" que permite guardar o archivar un dominio entero
y también para archivar versiones sucesivas de ficheros.
La opción de menú EnterDomainName se utiliza para introducir el valor de la variable de entorno.
La etiqueta DisplayCurrentDomain muestra el valor de esta variable.
A continuación, nos encontramos con la redacción Dominio.Exportación que llama a la macro fdex_es que a su vez llama al archive_domaine_sh_es
que construye un archivo con el comando "tar" y lo copia en el soporte de copia de seguridad definido por el ARCHISUPP_es
en un directorio con el nombre de la base de datos de los mentores ARCHIDIR_es.
La opción de la redacción.IncrementarDominioDeArchivo dice archive_domaine_sh_es que el nombre del archivo debe incluir un número de incremento
para crear un archivo sucesivo. ejemplo "utags_000.ar", "utags_001.ar"
A continuación aparece un submenú Archivo con las siguientes etiquetas:
- "Archiver" asociado a la macro fiv_es que crea una copia del archivo actual con un nombre que tiene un número incremental. (guión iv_sh_essistemas de copia de seguridad de dominios y archivos).
- "ListerArchive" asociado a la macro fva_es que enumera los diferentes archivos del fichero actual.
- "GoLogArchive" asociado a la macro gla_es que abre un buffer de registro de los diferentes archivos. El registro se puede editar
para rellenar el motivo del archivo en la lÃnea de registro correspondiente al fichero archivado.
10.Módulo de hoja de cálculo de base de datos relacional y aplicaciones
NOTA : pronto se ofrecerá la gestión de datos estructurados.
Este nuevo módulo es la integración de las funciones de la hoja de cálculo y del RDBMS (sistema de gestión de bases de datos relacionales).
Se implementa mediante bloques de texto del tipo CSV cuyas etiquetas son los nombres de las tablas del RDBMS.
También se integrará en este módulo un lenguaje de scripting para programar estos datos.
permitiendo crear rápidamente aplicaciones de cualquier tipo.
Ejemplo concreto de aplicación : generación de una partitura musical de proteodia a partir del código FASTA de una proteÃna : partition_de_la_protéodie_stimulatrice_de_phenylalanine_ammonia_lyase_1_pisum_sativum http://cuántica.
alwaysdata.
net/phenylalanine_ammonia_lyase_1_pisum_sativum_sti_part_txh.
htm