aide utags
aide_utags_txh_pt_som
Etiquetas de ajuda
1.Etiquetas de ajuda
Olá, provavelmente acabou de criar uma base de dados de hipertexto do sistema "mentor" após a instalação do módulo utags.
no final do guião de criação da base de dados, o gvim é lançado para editar este ficheiro de ajuda.
gvim é a base sobre a qual o utags fornece um sistema de edição e gestão de hipertexto.
Se não está familiarizado com gvim, comece por olhar para aide_vim_pt.
aide_vim_pt é a referência de uma etiqueta de hipertexto de mentor que o leva ao ficheiro de ajuda vim.
Para aceder a ele ou digite o comando ":ta aide_vim" e prima enter ou coloque o cursor do texto na referência aide_vim_pt tipo shift-$ que abrirá um novo separador para o ficheiro de ajuda.
Agora precisa de aprender como utilizar a ferramenta através de:
Posteriormente, um segundo componente principal estará disponÃvel no sistema mentor : . module tableur base de donnee relationnelle et applications
2.. commandes et macro commandes de navigation dans l'hypertexte : e apresentação da forma de hipertexto
O editor vim tem uma função de navegação por hipertexto que pode ser decomposta em comandos :
em modo de linha de comando, pode aceder a uma etiqueta (etiqueta) "sumário"^ por exemplo pelo comando:
:o seu resumo - uma variante é :
:sta resumo que divide a janela antes da navegação.
há um comando de retorno :
:em. o que o leva de volta à posição original.
o comando ta sem argumentos move-o para a frente na árvore de navegação :pode navegar na árvore de navegação através das sequências destes dois comandos.
a árvore de navegação pode ser visualizada com o comando:
:tags - uma navegação entre buffers de texto que não é uma navegação por hipertexto é o comando:
:e# que vai para o amortecedor anterior (mudar para que, se o repetir).
Isto é útil se quiser alternar entre dois ficheiros sem alterar a árvore de navegação de hipertexto.
para facilitar a navegação, estes comandos foram mapeados (encomenda :mapa) sobre as teclas de função de F5 a F8 : (o comando ":map" permite mapear uma sequência de caracterÃsticas de controlo noutra...
a abordagem mais simples do mentor utiliza mapeamentos que começam com o carácter ".comandos e macro comandos para navegação em hipertexto)
2.1.Tabela de teclas de função de navegação
| TF | order_line | acção
|
|---|
| F5 | etiquetas | exibir a pilha de etiquetas pesquisadas (pilha de etiquetas)
|
| F6 | po | subir uma etiqueta na pilha |
| F7 | ta | avançando um rótulo na pilha |
| F8 | e# | alternar entre dois amortecedores de texto |
e mode_commande_vi_pt o cursor deve estar sobre a referência do hipertexto, por exemplo: sommaire_pt
(referência de hipertexto para o langage_de_balisage_leger_mentor_pttabela de teclas de função de navegação).
a chave para a navegação é "ctrl-.]" num teclado qwerty e ctrl-altgr-] sobre um azerty
que é mais complicado e que nós emulámos em altgr-$
(os $ estarem no azerty no mesmo lugar que o ] em qwerty e altgr-$ é na realidade o caracter "¤"^)
este comando vai para a etiqueta referenciada na mesma janela.
por isso é o equivalente do comando ":a sua etiqueta" mas sem ter de escrever a etiqueta no teclado.
altgr-$ inicia a macro ggt_pt (em modo de comando tipo ")
a tecla "µ" procura a etiqueta fazendo uma divisão horizontal da janela
é portanto o equivalente do comando ":etiqueta do sta".
µ lança a macro ght_pt (em modo de comando tipo "
a macro gvt_pt faz uma saliva vertical da janela que é mapeada para a chave "§" que não é usada pela vi.
- os comandos para navegar entre janelas são :
- ctrl-arrow para cima ou ctrl-arrow para baixo para o tráfego unidireccional
na ordem temporal da divisão das janelas.
a chave shift-$ correspondente à navegação de hipertexto de caracteres "£"^ mas abrindo um novo separador.
£ gere a macro gnt_pt (em modo de comando tipo ") - os comandos para navegar entre as abas são :
- abrir um separador ":tabnew" mapeado para a macro "^
- próximo separador, comando "ctrl-tab"^
- separador anterior, comando "ctrl-shift-tab"^
A movimentação entre separadores é feita através dos seguintes comandos: - ctrl-tab ctrl-shift-tab (os comandos vi são gt e gT respectivamente)
- tn_pt para criar um separador vazio
as 3 chaves altgr-$, £ (shif-$) µ e § foram escolhidos porque não são utilizados pelo mode_commande_vi_pt e são por acaso vizinhos.
* e § são escolhidos pela sua posição relativa no turno certo para indicar a direcção da divisão da janela.
Note que as letras usadas para as macros são também semelhantes, a letra "g"^ significando um deslocamento (ir) no nomenclature_des_macros_pt.
(o franglais nas nomenclaturas é claramente assumido - o pragmatismo anglo-saxónico obriga)
2.2.Tabela de chaves de controlo de navegação
| chave | macros | | acção
|
|---|
| altgr-$ | ggt_pt | | navegação em hipertexto no actual tampão vi
|
| µ | ght_pt | fazer etiqueta horizontal | navegação por hipertexto, fazendo uma divisão horizontal da janela |
| £ | gnt_pt | | navegação por hipertexto, abrindo um novo separador |
| § | gvt_pt | | navegação por hipertexto, fazendo uma divisão vertical da janela |
| | | outras macros ligadas a ficheiros especÃficos (ver abaixo) |
|
|---|
| | gsf_pt | ir ficheiro de resumo | navegação por hipertexto no resumo do ficheiro |
| | gsr_pt | ir ficheiro de referência resumido | navegação por hipertexto no resumo do ficheiro para a localização da referência da etiqueta actual |
| | gsg_pt | ir resumo geral | navegação por hipertexto no resumo geral (lista de referências de ficheiros na base de dados) |
| | gut_pt | go tags | navegação em hipertexto para o ficheiro utags (Ãndice de etiquetas de hipertexto para ficheiros na base de dados) |
| | gag_pt | go arbre general | navegação em hipertexto para o ficheiro que contém a árvore de ficheiros na base de dados) |
| | gas_pt | go árvore de origem | navegação em hipertexto para o ficheiro contendo a árvore de ficheiros da última execução de utags) |
| | grc_pt | fazer referência cruzada | navegação por hipertexto para o ficheiro de referência cruzada:procura a referência do rótulo actual |
présentation_de_la_forme_de_l_hypertexte_pt
3.Bloco de texto
texte_structuré_pt
A moldura de texto é a estrutura sob a qual um texto é armazenado.
É composto por quatro tipos de elementos delimitados por pares de delimitadores < >, ( ), { } e [ ]
uma etiqueta de hipertexto ou etiqueta colocada entre os delimitadores "<" et ">", disse . étiquette mentor
.
que só pode conter caracteres alfanuméricos com o carácter sublinhado "_"^ como separador - um possÃvel . résumé de bloc
ou . commentaire mentor
colocado entre parênteses "( )",
o texto actual entre parênteses "{}" que é o verdadeiro bloco de texto.
referências de hipertexto do formulário etiquetas de texto que são utilizadas para destacar o texto nos blocos de texto 3.1.Estrutura em blocol
Temos, portanto, uma forma geral:
<etiquette_de_bloc_pt>(tÃtulo) [reference_pt]
{
...
... [reference_pt] ...
...
<etiquette_de_sous_bloc_pt>(etiqueta de sub-bloco)
{
...
... [reference_pt] ...
...
... <etiquette_dans_texte_pt> ...
...
... [reference_pt] ...
...
etc...
}
}
que pode, portanto, ser aninhada: Um bloco de texto pode conter outros blocos de texto.
Um determinado bloco é o bloco de todo o ficheiro cuja linha de etiqueta contém:
a etiqueta do nome do ficheiro - o tÃtulo do ficheiro - uma referência ao resumo do ficheiro.
A forma da etiqueta do ficheiro é portanto 3.2.Etiqueta no texto
.
por exemplo, para um ficheiro com o nome de ficheiro.
ext sobre um :
<nomfichier_extension_pt>(tÃtulo do ficheiro)[nomfichier_extension_pt_som]
a macro para gerar esta linha é fnt_pt para um ficheiro de texto.
Existem outras macros.
- os ficheiros da base de dados são referenciados em ficheiros com o nome de domÃnio, com extensão .dom
- o domÃnio raiz assim raiz.dom é o domÃnio de nÃvel mais baixo racine_dom_pt como o seu nome sugere.
- o domÃnio contém a lista de caminhos de ficheiros e possivelmente subdomÃnios.
- um sub-domÃnio é caracterizado pelo carácter @ que precede o caminho do domÃnio
para que os utags saibam analisar este ficheiro como um domÃnio.
- isto forma uma árvore hierárquica cujos ramos são os domÃnios e deixa os ficheiros.
dentro dos ficheiros esta árvore continua através do ninho de blocos de texto graça
para a etiqueta do bloco.
- para adicionar os seus ficheiros à base de dados do mentor, recomenda-se a criação de um ou mais domÃnios
no domÃnio_raiz e editar os seus ficheiros adicionando o seu.
Isto pode ser feito automaticamente através de um comando shell, por exemplo no unix:
!!encontrar . -nome *.* -impressão
ou sous janelas:
!!dir /b /l /s *.*
- utags gera um ficheiro de resumo quando analisa um ficheiro a extensão do resumo é ".som" o nome do resumo do ficheiro actual é aide_utags_txh.som
- para o ficheiro actual a etiqueta é aide_utags_txh_pt_som e é encontrado como visto na primeira linha do
- a macro para acesso directo ao Ãndice é gsf_pt
- uma vez no resumo escolha uma etiqueta para voltar ao ficheiro por altgr-$ (mas isto será incluÃdo na árvore de navegação)
- ou digite esta macro para aceder ao resumo e depois prima F6 para voltar a este ficheiro ou F8 se quiser mudar facilmente
no ficheiro e o seu resumo.
- utags também gera um resumo geral para todos os ficheiros da base de dados, para aceder à mesma utilizando a macro gsg_pt
- o resumo geral é composto por blocos de texto cujos rótulos são os domÃnios
e cujos blocos são compostos pela lista de ficheiros ou sub-domÃnios do.
Ou seja, estes blocos são resumos do.
- a primeira referência num bloco de domÃnio é um link para o próprio ficheiro de domÃnio.
- se navegar através da referência deste ficheiro de domÃnio, por exemplo utags_dom_pt
verá a lista de caminhos de ficheiros. Ignorar as linhas "CSV"^ que fazem
parte do próximo módulo mentor que lida com dados estruturados (quadros de dados)
o módulo utags que trata os chamados dados " não estruturados, ou seja, texto
mas para o qual o langage_de_balisage_leger_mentor_pt fornece uma estrutura.
- pode navegar à vontade no hipertexto e regressar ao seu ponto de partida pressionando F6
e voltar à árvore de navegação pressionando F7
- com todos estes movimentos pode precisar de armazenar uma posição especÃfica num ficheiro para regressar directamente a ele.
Pode usar um vi de marca : mp por exemplo para marcar com a letra "p"^ a posição da linha actual
e recuperá-lo depois de o mover pelo ficheiro com o comando 'p'.
- utags ao digitalizar a árvore de domÃnio, gera um número de :
- o ficheiro mais importante é o ficheiro de etiquetas chamado "utags"^ ao qual podemos
acesso digitando o comando ":as suas etiquetas" ou a macro gut_pt (a partir de agora
não especificaremos mais no texto para um macro mentor o ".
- o ficheiro utags tem a estrutura de um ficheiro de tags como gerado pelo comando unix ctags para fontes da linguagem C.
- pode pesquisar a localização de uma etiqueta no ficheiro utags com a macro frt_pt.
- o ficheiro "tree.txt" que pode ser acedido com o comando gag_pt (não, isto não é uma brincadeira).
Este ficheiro mostra a árvore de domÃnio inteira com as suas folhas, os ficheiros,
ou seja, para um ficheiro vemos tanto o caminho do mentor como o caminho do sistema de ficheiros.
Assim, o utags oferece outra forma de aceder e organizar os seus ficheiros.
Uma dupla hierarquia.
- o ficheiro "source.txt" acedido por gas_pt que é o resultado de um determinado comando utags
que apenas trataria de um domÃnio ou ficheiro especÃfico em vez do racine_dom_pt.
- o ficheiro "urefs" é também muito importante, é a referência cruzada, ou seja
a lista de ficheiros em que uma referência é citada num texto.
Se estiver numa etiqueta, a macro frr_pt permite encontrar onde este rótulo
é utilizado, o que é conveniente se o quiser remover para manter a consistência do hypetext.
Logicamente, as suas referências também devem ser eliminadas.
Para aceder ao ficheiro urefs sem fazer uma pesquisa : ":ta refs"
- o conhecimento que se tem sobre um item de informação também depende de
a forma como foi inserida no hipertexto.
- por este motivo, deve ser dada especial atenção ao
possibilidade de editar o rótulo para recuperar a informação.
- por informação entendemos o bloco de texto de uma etiqueta de bloco
ou a vizinhança de um rótulo num texto.
- escolheremos logicamente as palavras-chave que caracterizam esta informação
para formar o rótulo.
- um método também utilizado para formar este rótulo é o de utilizar
uma nomenclatura deinfixe_pt que são códigos de três letras
- esta nomenclatura é proposta, mas pode estendê-la ou substituÃ-la
de acordo com as suas necessidades.
O importante é utilizar uma nomenclatura, uma vez que esta permite a categorização da informação
o que será mais fácil de encontrar, porque o número de infixos é limitado.
- há vários nÃveis para alcançar informação em hipertexto
de acordo com o conhecimento que se tem desta informação.
- se conhece completamente o rótulo, então a forma mais fácil é escrever
a encomenda : ":o seu rótulo"
- então pode usar o resumo geral gsg_pt se estiver à procura de um ficheiro
ou o ficheiro utags_pt gut_pt se estiver à procura de um bloco de texto.
- depois basta ir para o ficheiro e fazer uma pesquisa vi com o comando
"/cadeia/" seguido por enter
- a cadeia de caracteres pode ser uma expression_régulière_pt que permite uma pesquisa flexÃvel sobre elementos sintácticos.
por exemplo, no ficheiro utags a pesquisa: /ordem.*buffer/ irá colocá-lo no rótulo commande_de_gestion_de_buffer_vi_pt
- fdr_pt
- função de pesquisa de domÃnio - efectua uma pesquisa de texto completo de todos os ficheiros de um domÃnio
utiliza o programa nomfic que cria a lista de ficheiros de um domÃnio, tendo em conta de forma recorrente os sub-domÃnios.
NOTA PARA PROGRAMADORES : este documento contendo links para as fontes dos ficheiros de macro vim ou scripts perl é um exemplo
como ligar as suas fontes e documentos de especificação técnica com etiquetas nos comentários,
facilitando a programação com letras.
Também o resumo do ficheiro (gsf_ptmodos de pesquisa em hipertexto) dar-lhe-á uma visão geral da sua fonte e links para
para o código em que está interessado. Exemplo com o programa perl para gerar páginas html : mt_to_htm_pl_pt_som
( Há muito espaço para melhorias em versões futuras, como a inclusão de " no documento de origem html" no documento de origem
a fim de beneficiar do.modos de pesquisa em hipertexto)
Estas funções proporcionam uma solução prática para o eterno problema da descoordenação entre o código e a documentação.
Com a metodologia do mentor, a documentação é um código como qualquer outro.
São fornecidos comandos macro para facilitar a edição do formulário de hipertexto :
1.. tableau des macro commandes d'edition : para a linguagem de marcação de luz do mentor
| macro | mnemónica | comentário
|
|---|
| ebia_pt | Edição Blocos de Inserção Accolades | insere um bloco de aparelho
|
| ebai_pt | Edição de Bloco Inverter Parênteses | insere aparelho para dividir um bloco |
| ebtb_pt | Edição Bloc Tag Build | cria um . bloc structurel completar, deixando em edição no rótulo |
| ebma_pt | Edição Bloc Mise En Accolades | apoia um bloco de linhas seleccionado por F3-F4 |
| ebmp_pt | Edição de Parênteses de Bloco | parênteses um bloco de linhas seleccionado por F3-F4 |
| ebm__pt | Edição de Bloqueio Silencioso | existe uma série de macros ebm cuja última letra é modifieur_de_bloc_pt |
| etft_pt | Edição Tab Fichier Textos | existe uma série de macro etf etf_mac_pt cuja última letra é o tipo do ficheiro-fonte |
2.Comandos macro para gerar hipertexto
- estas macros lançam, com várias opções, o programa utags que analisa os ficheiros na árvore de domÃnio.
- são mapeados para as teclas de função F11 Shift-F11 Alt-F11 Ctrl-F11 e Ctrl-Shift-F11.
2.1.Tabela de comandos macro para gerar hipertexto
| macro | mnemónica | comentário
|
|---|
| ub_pt | Base de UTags | lança utags para um scan de ficheiros modificados em toda a base de dados desde o último scan (racine.dom)
|
| ud_pt | Utags Domaine | lança utags para um scan de ficheiros modificados no domÃnio actual |
| uf_pt | Fichier de fichas | lança utags para a análise do ficheiro actual |
| F11_pt | ub_pt racine.dom | atalho ut_pt |
| M-F11_pt | ud_pt racine.dom geral | atalho ug_pt |
| C-F11_pt | uf_pt ficheiro | atalho uf_pt |
- o comando mais regularmente utilizado será certamente C-F11_pt. Quando se edita um documento através da criação de etiquetas e referências,
usará este comando depois de guardar as suas alterações para actualizar a base de dados de utags com novas etiquetas
e a base de dados urefs com as novas referências.
NOTA : Os comandos aqui descritos podem ser encontrados no menu Utags na barra de menu do gvim.
Este menu foi concebido para fornecer acesso rápido para ajudar na memorização de comandos.
NOTA : estes comandos e a linguagem de marcação de luz do mentor são as únicas coisas que precisa de saber para ter uma poderosa ferramenta de gestão de informação textual que se a integrar para o servir de forma consistente e durante muito tempo para manter e utilizar virtualmente toda a sua informação útil.
- o ficheiro extensio_lst_pt contém uma tabela de extensões de ficheiros conhecidos e as suas propriedades utilizadas pelo programa utags
- o ficheiro /home/minage/Documents/mt/ht/ref_abs.txt lista referências que não têm etiquetas correspondentes.
- o ficheiro utags_par_pt parâmetros que controlam o funcionamento do programa utags
No menu Utags existe um submenu "Exploração" que lhe permite guardar ou arquivar um domÃnio inteiro
e também para arquivar versões sucessivas de ficheiros.
O item do menu EnterDomainName é utilizado para introduzir o valor da variável de ambiente.
A etiqueta DisplayCurrentDomain exibe o valor desta variável.
Depois encontramos a redacção DomÃnio.Exportação que chama a macro fdex_pt que, por sua vez, chama o archive_domaine_sh_pt
que cria um ficheiro de arquivo com o comando "tar" e copia-o para o suporte de segurança definido pelo ARCHISUPP_pt
num directório com o nome da base de dados do mentor ARCHIDIR_pt.
A opção de redacção.IncrementArchiveDomain diz archive_domaine_sh_pt que o nome do arquivo deve incluir um número incremental
de modo a criar um arquivo sucessivo. exemplo "utags_000.ar", "utags_001.ar"
Segue-se um submenu Ficheiro com as seguintes etiquetas:
- "Arquivador" associado com a macro fiv_pt que cria uma cópia do ficheiro actual com um nome que tem um número incremental. (guião iv_sh_ptsistemas de backup de domÃnios e ficheiros).
- "ListerArquivo" associado com a macro fva_pt que enumera os diferentes arquivos do ficheiro actual.
- ^GoLogArquivo" associado com a macro gla_pt que abre um buffer de registo dos diferentes arquivos de ficheiros. O log pode ser editado
para preencher o motivo do arquivamento na linha de registo correspondente ao ficheiro arquivado.
NOTA : a gestão de dados estruturada será oferecida em breve.
Este novo módulo é a integração das funções de folha de cálculo e RDBMS (sistema de gestão de bases de dados relacionais).
É implementado através de blocos de texto do tipo CSV cujos rótulos são os nomes das tabelas RDBMS.
Uma linguagem de scripting também será integrada neste módulo para programar estes dados.
permitindo-lhe criar rapidamente aplicações de qualquer tipo.
Exemplo especÃfico de implementação : geração de uma partitura musical proteódica a partir do código FASTA de uma proteÃna : partition_de_la_protéodie_stimulatrice_de_phenylalanine_ammonia_lyase_1_pisum_sativum http://quantum.
alwaysdata.
net/phenylalanine_ammonia_lyase_1_pisum_sativum_sti_part_txh.
htm