aide utags

aide utags aide_utags_txh_nl_som

versie beschikbaar in : en it ru zh es ja de pt fr

datum aangemaakt : 20220802- datum van bijwerking : 20220802- généré le: 20240612_171237

1.Help tags

Hallo, je hebt waarschijnlijk net een hypertext database van het "mentor" systeem gemaakt na de installatie van de utags module.
aan het einde van het script om de database aan te maken, wordt gvim gestart om dit helpbestand te bewerken.
gvim is de basis waarop utags een hypertext bewerkings- en beheersysteem levert.
Als u niet bekend bent met gvim, begin dan met het bekijken van aide_vim_nl.

aide_vim_nl is de referentie van een mentor hypertext tag die je naar het vim help bestand leidt.
Om het te openen, typ het commando ":ta aide_vim" en druk op enter of plaats de tekstcursor op de referentie aide_vim_nl typ shift-$ wat een nieuw tabblad zal openen naar het help bestand.
U moet nu leren hoe u het gereedschap moet gebruiken door:

van . commandes et macro commandes de navigation dans l'hypertexte
de présentation_de_la_forme_de_l_hypertexte_nl
de structuur van de langage_de_balisage_leger_mentor_nl dat is de structuur van deze tekst.
de . la méthodologie mentor d édition hypertexte
de . modes de recherche dans l'hypertexte
van . macro commandes d edition de l'hypertexte
van . macro commandes de generation de l'hypertexte
van de . pilotage de la generation de l'hypertexte
van . systemes de sauvegarde des domaines et des fichiers

Vervolgens zal een tweede belangrijke component in het mentorsysteem beschikbaar zijn : . module tableur base de donnee relationnelle et applications

2.. commandes et macro commandes de navigation dans l'hypertexte : en presentatie van de vorm van hypertext

De vim editor heeft een hypertext navigatie functie die kan worden opgedeeld in commando's :

in opdrachtregelmodus kunt u een label openen (tag) "summary" bijvoorbeeld door het commando: :uw samenvatting - een variant is : :sta samenvatting die het venster splitst voor de navigatie.

er is een terugkeer commando : :in. die je terug brengt naar de oorspronkelijke positie.

het commando ta zonder argument gaat u vooruit in de navigatieboom :kunt u door de navigatiestructuur bladeren door opeenvolging van deze twee commando's.

de navigatiestructuur kan worden bekeken met het commando: :tags - een navigatie tussen tekstbuffers die geen hypertextnavigatie is, is het commando: :e# die in de vorige buffer gaat (dus als je het herhaalt).
Dit is handig als u tussen twee bestanden wilt wisselen zonder de hypertext navigatieboom te veranderen.

om de navigatie te vergemakkelijken zijn deze commando's in kaart gebracht (bestellen :kaart) op de functietoetsen van F5 tot F8 : (het commando ":map ^ kunt u een reeks van controle-eigenschappen in een andere...
eenvoudigere mentor benadering gebruikt mappings beginnend met het " karakter.commando's en macro commando's voor hypertext navigatie) 2.1.Tabel van navigatie functietoetsen

TF order_regel actie
F5 tags de stapel doorbladerde etiketten weergeven (tags'stack)
F6 po ga één etiket omhoog in de stapel

F7 ta een etiket in de stapel vooruitbrengen

F8 e# schakelen tussen twee tekstbuffers

TF	order_regel	actie
F5	tags	de stapel doorbladerde etiketten weergeven (tags'stack)
F6	po	ga één etiket omhoog in de stapel
F7	ta	een etiket in de stapel vooruitbrengen
F8	e#	schakelen tussen twee tekstbuffers

en mode_commande_vi_nl de cursor moet op de hypertextverwijzing staan, bijvoorbeeld: sommaire_nl (hypertext referentie voor de langage_de_balisage_leger_mentor_nltabel van navigatie functietoetsen).

de sleutel voor navigatie is "ctrl-.]" op een qwerty toetsenbord en ctrl-altgr-] op een azerty die gecompliceerder is en die wij hebben geëmuleerd op altgr-$ (de $ die in azerty op dezelfde plaats als de ] in qwerty en altgr-$ is eigenlijk het "¤^ teken) deze opdracht gaat naar het label waarnaar verwezen wordt in hetzelfde venster.
dus het is het equivalent van het commando ":je label" maar zonder dat je het label op het toetsenbord hoeft te typen.
altgr-$ start de macro ggt_nl (in commando mode type ")

de "µ" toets zoekt naar het label door een horizontale splitsing van het venster te maken het is dus het equivalent van het commando ":sta etiquette". µ start de macro ght_nl (in commando mode type " de macro gvt_nl maakt een verticale spit van het venster het wordt toegewezen aan de "§" toets die niet door vi wordt gebruikt.

de commando's om tussen vensters te navigeren zijn :
ctrl-pijltje omhoog of ctrl-pijltje omlaag voor eenrichtingsverkeer in de tijdsvolgorde van het splitsen van ramen.

de shift-$ toets die overeenkomt met het "£" teken hypertext navigatie maar het openen van een nieuw tabblad.
£ voert de macro uit gnt_nl (in commando mode type ")

de commando's om tussen de tabbladen te navigeren zijn :
een tabblad openen ":tabnew" toegewezen aan de macro "
volgende tab, commando "ctrl-tab"
vorige tab, commando "ctrl-shift-tab"

Verplaatsen tussen tabbladen wordt gedaan door de volgende commando's:

ctrl-tab ctrl-shift-tab (de vi commando's zijn respectievelijk gt en gT)
tn_nl om een leeg tabblad te maken

de 3 sleutels altgr-$, £ (shif-$) , µ en § zijn gekozen omdat zij niet door de mode_commande_vi_nl en ze zijn toevallig buren.
* en § worden gekozen door hun relatieve positie op de rechter verschuiving om de richting van de venstersplitsing aan te geven.

Merk op dat de letters die gebruikt worden voor de macro's ook gelijk zijn, de letter "g" betekent een verplaatsing (ga) in de nomenclature_des_macros_nl.
(de franglais in de nomenclaturen is duidelijk verondersteld - Angelsaksisch pragmatisme dwingt) 2.2.Navigatietoetsen tabel

toets macro's actie
altgr-$ ggt_nl hypertext navigatie in de huidige vi buffer
µ ght_nl doe horizontale tag hypertextnavigatie door een horizontale splitsing van het venster

£ gnt_nl hypertextnavigatie door een nieuw tabblad te openen

§ gvt_nl hypertext navigatie door een verticale splitsing van het venster

andere macro's gekoppeld aan specifieke bestanden (zie hieronder)
gsf_nl ga samenvattingsbestand hypertextnavigatie in het bestandsoverzicht

gsr_nl ga samenvattend referentiebestand hypertextnavigatie in het bestandsoverzicht naar de locatie van de huidige labelverwijzing

gsg_nl ga algemene samenvatting hypertextnavigatie in de algemene samenvatting (lijst van bestandsverwijzingen in de database)

gut_nl ga tags hypertextnavigatie naar het utags-bestand (index van hypertextlabels voor bestanden in de database)

gag_nl ga arbre generaal hypertextnavigatie naar het bestand met de boom van bestanden in de database)

gas_nl ga bron boom hypertextnavigatie naar het bestand met de bestandsstructuur van de laatste uitvoering van utags)

grc_nl ga kruisverwijzing hypertextnavigatie naar het kruisverwijzingsbestand:zoekt naar de huidige label referentie

toets	macro's		actie
altgr-$	ggt_nl		hypertext navigatie in de huidige vi buffer
µ	ght_nl	doe horizontale tag	hypertextnavigatie door een horizontale splitsing van het venster
£	gnt_nl		hypertextnavigatie door een nieuw tabblad te openen
§	gvt_nl		hypertext navigatie door een verticale splitsing van het venster
		andere macro's gekoppeld aan specifieke bestanden (zie hieronder)
	gsf_nl	ga samenvattingsbestand	hypertextnavigatie in het bestandsoverzicht
	gsr_nl	ga samenvattend referentiebestand	hypertextnavigatie in het bestandsoverzicht naar de locatie van de huidige labelverwijzing
	gsg_nl	ga algemene samenvatting	hypertextnavigatie in de algemene samenvatting (lijst van bestandsverwijzingen in de database)
	gut_nl	ga tags	hypertextnavigatie naar het utags-bestand (index van hypertextlabels voor bestanden in de database)
	gag_nl	ga arbre generaal	hypertextnavigatie naar het bestand met de boom van bestanden in de database)
	gas_nl	ga bron boom	hypertextnavigatie naar het bestand met de bestandsstructuur van de laatste uitvoering van utags)
	grc_nl	ga kruisverwijzing	hypertextnavigatie naar het kruisverwijzingsbestand:zoekt naar de huidige label referentie

présentation_de_la_forme_de_l_hypertexte_nl

3.Tekstblok texte_structuré_nl

Het tekstblok is de structuur waaronder een tekst wordt opgeslagen.
Het bestaat uit vier soorten elementen, afgebakend door paren van scheidingstekens < >, ( ), { } en [ ]

een hypertext label of tag tussen de scheidingstekens "<" et ">", zei . étiquette mentor .
die alleen alfanumerieke tekens kan bevatten met het onderstrepingsteken "_" als scheidingsteken - een mogelijke . résumé de bloc of . commentaire mentor tussen haakjes gezet "( )",

de eigenlijke tekst tussen accolades "{}" wat het eigenlijke tekstblok is.

hypertextverwijzingen van de vorm tekstlabels die worden gebruikt om de tekst in de tekstblokken te markeren 3.1.Blok structureel

We hebben dus een algemene vorm:

<etiquette_de_bloc_nl>(titel) [reference_nl]
{
...
... [reference_nl] ...
...
<etiquette_de_sous_bloc_nl>(label subblok)
{
...
... [reference_nl] ...
...
... <etiquette_dans_texte_nl> ...
...
... [reference_nl] ...
...
etc...
}
}

die dus genest kunnen worden: Een tekstblok kan andere tekstblokken bevatten.
Een bepaald blok is het blok van het gehele bestand waarvan de labelregel bevat:

het bestandsnaamlabel - de bestandstitel - een verwijzing naar het bestandsoverzicht.
De vorm van het bestandslabel is dus 3.2.Label in tekst .

bijvoorbeeld voor een bestand met de naam bestandsnaam.
op een :
<nomfichier_extension_nl>(bestandstitel)[nomfichier_extension_nl_som]
de macro om deze regel te genereren is fnt_nl voor een tekstbestand.
Er zijn andere macro's.

naar de bestanden in de database wordt verwezen in bestanden met de naam domein, met extensie .dom
het hoofddomein dus root.dom is het domein op het laagste niveau racine_dom_nl zoals de naam al doet vermoeden.
het domein bevat de lijst van bestandspaden en eventueel subdomeinen.
een subdomein wordt gekenmerkt door het teken @ dat aan het domeinpad voorafgaat zodat utags weet dit bestand te parsen als een domein.
dit vormt een hiërarchische boom waarvan de takken de domeinen zijn en de bladeren de bestanden.
binnen de bestanden gaat deze boom verder door het nesten van tekstblokken grace naar het blok label.
om uw bestanden toe te voegen aan de mentor database, is het aanbevolen om één of meer domeinen aan te maken in het root_domain en bewerk de bestanden door uw.
Dit kan automatisch worden gedaan door een shell commando, bijvoorbeeld op unix:
!!vind . -naam *.* -print
ou sous windows:
!!dir /b /l /s *.*

utags genereert een samenvatting bestand wanneer het een bestand parseert de samenvatting extensie is ".som" de samenvattende naam van het huidige bestand is aide_utags_txh.som
voor het huidige bestand is het label aide_utags_txh_nl_som en wordt gevonden zoals te zien is op de eerste regel van de
de macro voor directe toegang tot de inhoudsopgave is gsf_nl
eenmaal in het overzicht kies een label om terug te keren naar het bestand door altgr-$ (maar dit zal worden opgenomen in de navigatiestructuur)
of typ deze macro om de samenvatting te openen en druk dan op F6 om terug te keren naar dit bestand of F8 als u gemakkelijk wilt overschakelen in het bestand en de samenvatting ervan.
utags genereert ook een algemene samenvatting voor alle bestanden in de database, om deze te openen gebruik je de macro gsg_nl
de algemene samenvatting is samengesteld uit tekstblokken waarvan de labels de domeinen zijn en waarvan de blokken zijn samengesteld uit de lijst van bestanden of subdomeinen van de.
Dat wil zeggen, deze blokken zijn samenvattingen van de.
de eerste verwijzing in een domeinblok is een link naar het domeinbestand zelf.
als je navigeert door dit domein bestand referentie bijv. utags_dom_nl zult u de lijst van bestandspaden zien. Negeer de ^CSV" lijnen die deel van de volgende mentormodule die over gestructureerde gegevens gaat (gegevenstabellen) de utags module behandelt zogenaamde "ongestructureerde" gegevens, d.w.z. tekst maar waaraan de langage_de_balisage_leger_mentor_nl biedt een structuur.
kunt u naar believen in de hypertext navigeren en terugkeren naar uw vertrekpunt door op F6 te drukken en keer terug naar de navigatiestructuur door op F7 te drukken
met al deze verplaatsingen kan het nodig zijn een specifieke positie in een bestand op te slaan om er direct naar terug te keren.
U kunt een gemerkte vi : mp bijvoorbeeld om met de letter "p^ de positie van de huidige regel te markeren en het op te halen na het te hebben verplaatst in het bestand met het 'p' commando
utags wanneer het de domeinboom scant, genereert een aantal :
het belangrijkste bestand is het tags bestand genaamd "utags" waar we toegang door het typen van het commando ":je tags" of de macro gut_nl (van nu af aan zullen we niet langer in de tekst voor een macro mentor de ".
het utags bestand heeft de structuur van een tags bestand zoals gegenereerd door het unix ctags commando voor C taalbronnen.
kan je zoeken naar de locatie van een tag in het utags bestand met de macro frt_nl.
het "tree bestand.txt" die kan worden geopend met het commando gag_nl (Nee, dit is geen grap.).
Dit bestand toont de volledige domeinboom met zijn bladeren, de bestanden, d.w.z. voor een bestand zien we zowel het mentorpad als het bestandssysteempad.
Dus utags biedt een andere manier om je bestanden te openen en te organiseren.
Een dubbele hiërarchie.
het "source bestand.txt" benaderd door gas_nl wat het resultaat is van een bepaald utags commando dat zich alleen zou bezighouden met een bepaald domein of bestand in plaats van de racine_dom_nl.
het "urefs" bestand is ook erg belangrijk, het is de kruisverwijzing, d.w.z.
de lijst van bestanden waar een verwijzing in een tekst wordt geciteerd.
Als u op een etiket staat, zal de macro frr_nl kunt u vinden waar dit label wordt gebruikt, wat handig is als u het wilt verwijderen om de hypetext consistent te houden.
Logischerwijs moeten de verwijzingen ernaar ook worden geschrapt.
Om het urefs bestand te openen zonder een zoekopdracht uit te voeren : ":ta refs"

de kennis die men heeft over een bepaald gegeven hangt ook af van de manier waarop het in de hypertext werd ingevoegd.
Daarom moet bijzondere aandacht worden besteed aan de de mogelijkheid om het etiket te bewerken om de informatie op te halen.
met informatie bedoelen we het tekstblok van een bloketiket of de buurt van een label in een tekst.
zullen wij logischerwijs de sleutelwoorden kiezen die deze informatie karakteriseren om het label te vormen.
een methode die ook wordt gebruikt om dit label te vormen is het gebruik van een nomenclatuur vaninfixe_nl dat zijn drie-letter codes
deze nomenclatuur is voorgesteld, maar u kunt hem uitbreiden of vervangen volgens uw behoeften.
Het is belangrijk een nomenclatuur te gebruiken, omdat de informatie dan kan worden gecategoriseerd die gemakkelijker te vinden zal zijn omdat het aantal infixen beperkt is.

er zijn verschillende niveaus om informatie te bereiken in hypertext naar gelang de kennis die men heeft van deze informatie.
als u het etiket volledig kent, is de gemakkelijkste manier om te typen de volgorde : ":uw label"
dan kunt u ofwel de algemene samenvatting gsg_nl als u op zoek bent naar een bestand of het bestand utags_nl gut_nl als u op zoek bent naar een blok tekst.
ga dan gewoon naar het bestand en doe een vi zoekopdracht met het commando "/chain/" gevolgd door enter
de tekenreeks kan een expression_régulière_nl dat een flexibele zoekactie op syntactische elementen mogelijk maakt.
bijvoorbeeld in het utags bestand de zoekopdracht: /bestellen.*buffer/ zal je op het label plaatsen commande_de_gestion_de_buffer_vi_nl
fdr_nl
domein zoekfunctie - voert een full tekst zoekactie uit in alle bestanden in een domein het gebruikt het nomfic programma dat de lijst van bestanden van een domein aanmaakt door recursief rekening te houden met de sub-domeinen.

OPMERKING VOOR ONTWIKKELAARS : dit document met links naar de bronnen van vim macro bestanden of perl scripts is een voorbeeld hoe u uw bronnen en technische specificatiedocumenten kunt koppelen met labels in de opmerkingen, het programmeren met letters gemakkelijk maken.
Ook de samenvatting van het bestand (gsf_nlzoekmethoden in hypertext) zal u een overzicht geven van uw bron en links naar naar de code waarin u geïnteresseerd bent. Voorbeeld met het perl programma voor het genereren van html pagina's : mt_to_htm_pl_nl_som ( Er is nog veel ruimte voor verbetering in toekomstige versies, zoals het opnemen van "inside html" in het brondocument om te profiteren van de.zoekmethoden in hypertext) Deze functies bieden een praktische oplossing voor het eeuwige probleem van de discrepantie tussen de code en de documentatie.
Met de mentor methodologie, is documentatie code zoals elke andere.

Macrocommando's voor eenvoudige bewerking van het hypertextformulier zijn beschikbaar :

1.. tableau des macro commandes d'edition : voor de mentor light markup taal

macro mnemonisch opmerking
ebia_nl Editie Bloc Toevoeging Accolades voegt een blok accolades in
ebai_nl Blok Omkerende Parenthese bewerken voegt accolades in om een blok te splitsen

ebtb_nl Editie Bloc Tag Bouw creëert een . bloc structurel vul aan door de editie op het etiket achter te laten

ebma_nl Editie Bloc Mise En Accolades accolades een regelblok geselecteerd met F3-F4

ebmp_nl Blokparenthese bewerken haakjes een lijnblok geselecteerd met F3-F4

ebm__nl Stille blokkering bewerken er is een serie ebm macro's waarvan de laatste letter modifieur_de_bloc_nl

etft_nl Editie Tabblad Fichier Teksten er is een reeks van macro-ETF etf_mac_nl waarvan de laatste letter het type is van het bronbestand

macro	mnemonisch	opmerking
ebia_nl	Editie Bloc Toevoeging Accolades	voegt een blok accolades in
ebai_nl	Blok Omkerende Parenthese bewerken	voegt accolades in om een blok te splitsen
ebtb_nl	Editie Bloc Tag Bouw	creëert een . bloc structurel vul aan door de editie op het etiket achter te laten
ebma_nl	Editie Bloc Mise En Accolades	accolades een regelblok geselecteerd met F3-F4
ebmp_nl	Blokparenthese bewerken	haakjes een lijnblok geselecteerd met F3-F4
ebm__nl	Stille blokkering bewerken	er is een serie ebm macro's waarvan de laatste letter modifieur_de_bloc_nl
etft_nl	Editie Tabblad Fichier Teksten	er is een reeks van macro-ETF etf_mac_nl waarvan de laatste letter het type is van het bronbestand

2.Macrocommando's voor het genereren van hypertext

deze macro's starten, met verschillende opties, het utags programma dat bestanden in de domeinboom analyseert.

worden ze toegewezen aan de functietoetsen F11 Shift-F11 Alt-F11 Ctrl-F11 en Ctrl-Shift-F11.

2.1.Tabel van macro-opdrachten voor het genereren van hypertext

macro mnemonisch opmerking
ub_nl UTags Basis lanceert utags voor een database-wijde scan van bestanden gewijzigd sinds de laatste scan (racine.dom)
ud_nl Utags Domaine start utags voor een scan van gewijzigde bestanden in het huidige domein

uf_nl Utags Fichier start utags voor de analyse van het huidige bestand

F11_nl ub_nl racine.dom snelkoppeling ut_nl

M-F11_nl ud_nl racine.algemene dom snelkoppeling ug_nl

C-F11_nl uf_nl bestand snelkoppeling uf_nl

het meest gebruikte commando zal zeker zijn C-F11_nl. Wanneer u een document bewerkt door labels en referenties te maken, gebruik je dit commando na het opslaan van je wijzigingen om de utags database bij te werken met nieuwe tags en de urefs database met de nieuwe referenties.

macro	mnemonisch	opmerking
ub_nl	UTags Basis	lanceert utags voor een database-wijde scan van bestanden gewijzigd sinds de laatste scan (racine.dom)
ud_nl	Utags Domaine	start utags voor een scan van gewijzigde bestanden in het huidige domein
uf_nl	Utags Fichier	start utags voor de analyse van het huidige bestand
F11_nl	ub_nl racine.dom	snelkoppeling ut_nl
M-F11_nl	ud_nl racine.algemene dom	snelkoppeling ug_nl
C-F11_nl	uf_nl bestand	snelkoppeling uf_nl

OPMERKING : De hier beschreven commando's zijn te vinden in het menu Utags in de gvim-menubalk.
Dit menu is ontworpen om snel toegang te bieden tot hulp bij het onthouden van commando's.
OPMERKING : deze commando's en de mentor light markup taal zijn de enige dingen die je moet weten om een krachtig tekstueel informatiebeheer gereedschap te hebben dat als je het integreert om je consistent en voor een lange tijd te dienen om vrijwel al je nuttige informatie te bewaren en te gebruiken.

het bestand extensio_lst_nl bevat een tabel van bekende bestandsextensies en hun eigenschappen gebruikt door het utags programma
het bestand /home/minage/Documents/mt/ht/ref_abs.txt geeft referenties weer die geen overeenkomstige tags hebben.
het bestand utags_par_nl parameters die de werking van het utags-programma regelen

In het Utags menu is er een submenu "Exploitatie" waarmee je een heel domein kunt opslaan of archiveren en ook om opeenvolgende versies van bestanden te archiveren.

Het menu-item EnterDomainName wordt gebruikt om de waarde van de omgevingsvariabele.

Het label DisplayCurrentDomain toont de waarde van deze variabele.

Dan vinden we de formulering Domein.Export die de macro aanroept fdex_nl die op zijn beurt de archive_domaine_sh_nl dat een archiefbestand aanmaakt met het "tar" commando en het kopieert naar de backup media gedefinieerd door het ARCHISUPP_nl in een directory met de naam van de mentor database ARCHIDIR_nl.

De formulering Optie.IncrementArchiveDomain vertelt archive_domaine_sh_nl dat de naam van het archief een incrementeel nummer moet bevatten om een opeenvolgend archief te maken. voorbeeld "utags_000.ar", "utags_001.ar"

Dit wordt gevolgd door een Bestand submenu met de volgende labels:

"Archiver" geassocieerd met de macro fiv_nl dat een kopie maakt van het huidige bestand met een naam die een incrementeel nummer heeft. (script iv_sh_nlback-upsystemen voor domeinen en bestanden).
"ListerArchive" verbonden met de macro fva_nl die de verschillende archieven van het huidige bestand opsomt.
^GoLogArchive" geassocieerd met de macro gla_nl die een logbuffer opent van de verschillende bestandsarchieven. Het logboek kan worden bewerkt om de reden van archivering in te vullen op de logregel die overeenkomt met het gearchiveerde bestand.

OPMERKING : gestructureerd gegevensbeheer zal binnenkort worden aangeboden.
Deze nieuwe module is de integratie van spreadsheet en RDBMS functies (systeem voor het beheer van relationele gegevensbanken).
Het wordt geïmplementeerd door middel van tekstblokken van het CSV-type waarvan de labels de namen van de RDBMS-tabellen zijn.
In deze module zal ook een scripttaal worden geïntegreerd om deze gegevens te programmeren.
waarmee u snel toepassingen van welke aard dan ook kunt maken.
Specifiek voorbeeld van de uitvoering : genereren van een proteodymusical score uit de FASTA-code van een eiwit : partition_de_la_protéodie_stimulatrice_de_phenylalanine_ammonia_lyase_1_pisum_sativum http://kwantum.
alwaysdata.
net/phenylalanine_ammonia_lyase_1_pisum_sativum_sti_part_txh.
htm