aide utags
aide_utags_txh_de_som
Hilfe-Tags
1.Hilfe-Tags
Hallo, Sie haben wahrscheinlich gerade eine Hypertextdatenbank des "mentor"-Systems nach der Installation des utags-Moduls erstellt..
am Ende des Skripts zur Erstellung der Datenbank wird gvim gestartet, um diese Hilfedatei zu bearbeiten.
gvim ist die Grundlage, auf der utags aufbaut, um ein Hypertext-Editier- und Verwaltungssystem bereitzustellen..
Wenn Ihnen gvim nicht vertraut ist, schauen Sie zunächst nach aide vim de.
aide vim de ist der Verweis auf ein Mentor-Hypertext-Label, das Sie zur Hilfedatei von vim führt.
Um darauf zuzugreifen, geben Sie entweder den Befehl " ein:ta aide_vim" und drücken Sie enter oder setzen Sie den Textcursor auf den Verweis aide vim de geben Sie shift-$ ein, wodurch ein neuer Tab mit der Hilfedatei geöffnet wird.
Nun müssen Sie den Umgang mit dem Werkzeug lernen durch:
Später wird ein zweiter wichtiger Teil im Mentorensystem verfügbar sein. : module tableur base de donnee relationnelle et applications de
2.Commandes et macro commandes de navigation dans l'hypertexte de: und Darstellung der Hypertextform
der vim-Editor verfügt über eine Hypertext-Navigationsfunktion, die in Befehle unterteilt ist :
im Befehlszeilenmodus kann man auf ein Label zugreifen (Tag) "sommaire" zum Beispiel durch den Befehl:
:ta sommaire - eine Variante ist :
:sta sommaire, die das Fenster vor der Navigation splittet.
gibt es einen Rückgabebefehl :
:po, der Sie in die Ausgangsposition zurückbringt.
der Befehl ta ohne Argumente lässt Sie im Navigationsbaum vorrücken :ta kannst du so den Navigationsbaum durch Sequenzen dieser beiden Befehle durchsuchen.
kann der Navigationsbaum mit dem Befehl:
:tags - Eine Navigation zwischen Textpuffern, die keine Hypertext-Navigation ist, ist der Befehl:
:e# die in den vorherigen Puffer geht (switch also, wenn wir sie wiederholen).
Das ist nützlich, wenn man zwischen zwei Dateien wechseln will, ohne den Hypertext-Navigationsbaum zu verändern..
um die Navigation zu erleichtern, wurden diese Befehle gemappt (Bestellung :Karte) auf den Funktionstasten von F5 bis F8 : (die Bestellung ":map" ermöglicht es, eine Folge von Befehlsmerkmalen auf eine andere Folge von Befehlsmerkmalen abzubilden....
einfacher der Mentor-Ansatz verwendet Mappings, die mit dem Zeichen " beginnen.Befehle und Makrobefehle Befehle zur Navigation in Hypertext)
2.1.Tabelle der funktionstasten für die navigation
TF | bestellzeile | Aktion
|
---|
F5 | tags | den Stapel der durchlaufenen Etiketten anzeigen (Tags'stapel)
|
F6 | po | ein Etikett im Stapel nach oben gehen |
F7 | ta | ein Etikett im Stapel vorschieben |
F8 | e# | switch zwischen zwei Textpuffern |
und mode_commande_vi_de der Cursor muss sich z. B. auf dem Hypertextverweis befinden: sommaire_de
(Hypertext-Referenz für den langage de balisage leger mentor detabelle der funktionstasten für die navigation).
die Taste für die Navigation ist "ctrl-.]" auf einer qwerty-Tastatur und ctrl-altgr-] auf einem Azerty
was komplizierter ist und deshalb auf altgr-$ emuliert wurde
(das $ befindet sich in azerty an derselben Stelle wie das ] in qwerty und altgr-$ ist eigentlich das Zeichen "¤")
dieser Befehl geht zu dem Etikett, auf das verwiesen wird, und zwar im selben Fenster.
das ist also das Äquivalent zur Bestellung ":deine Etikette" aber ohne die Etikette auf der Tastatur eingeben zu müssen.
altgr-$ startet das Makro ggt_de (im Befehlsmodus geben Sie " ein)
Die Taste "µ" sucht nach dem Etikett, indem das Fenster horizontal geteilt wird.
sie ist also das Äquivalent zum Befehl ":sta etiquette".
µ startet das Makro ght_de (im Befehlsmodus geben Sie " ein
das Makro gvt_de macht einen vertikalen Spit des Fensters sie wird auf die Taste "§" abgebildet, die von vi nicht verwendet wird.
- die Befehle für die Navigation zwischen den Fenstern sind :
- Strg-Pfeil-nach-oben oder Strg-Pfeil-nach-unten für eine Bewegung in die eine oder andere Richtung
in der zeitlichen Reihenfolge des Fenstersplittings.
die Shift-$-Taste, die dem Zeichen "£" entspricht Hypertextnavigation, aber durch Öffnen eines neuen Tabs.
£ startet das Makro gnt_de (im Befehlsmodus geben Sie " ein) - die Befehle für die Navigation zwischen den Tabs sind :
- Öffnen eines Tabs ":tabnew" auf das Makro gemappt "
- nächste Registerkarte, Befehl "ctrl-tab"
- vorheriger Tab, Befehl "ctrl-shift-tab"
das Bewegen zwischen Tabs erfolgt mit folgenden Befehlen: - Strg-Tabulator Strg-Umschalt-Tabulator (die vi-Befehle sind jeweils gt und gT)
- tn_de um einen leeren Tab zu erstellen
die 3 Tasten altgr-$, £ (shif-$) , µ und § wurden gewählt, da sie nicht vom mode_commande_vi_de und sie sind zufällig Nachbarn.
* und § werden durch ihre Position relativ zur rechten Shift gewählt, um die Richtung des Fenstersplits anzuzeigen..
Der Buchstabe "g" steht für eine Verschiebung. (gehen.) in der nomenclature_des_macros_de.
(das Franglais in den Nomenklaturen wird klar angenommen - angelsächsischer Pragmatismus verpflichtet)
2.2.Tabelle der tasten für die navigationssteuerung
Taste | Makros | | Aktion
|
---|
altgr-$ | ggt_de | | Hypertextnavigation im aktuellen vi-Puffer
|
µ | ght_de | horizontales Tag machen | Hypertextnavigation durch horizontales Splitten des Fensters |
£ | gnt_de | | Hypertext-Navigation durch Öffnen eines neuen Tabs |
§ | gvt_de | | Hypertextnavigation durch vertikales Splitten des Fensters |
| | andere Makros, die mit bestimmten Dateien verknüpft sind (siehe unten) |
|
---|
| gsf_de | go Inhaltsverzeichnis Datei | Hypertext-Navigation im Inhaltsverzeichnis der Datei |
| gsr_de | go Inhaltsverzeichnis Referenzdatei | Hypertext-Navigation im Inhaltsverzeichnis der Datei an der Stelle der aktuellen Etikettenreferenz |
| gsg_de | go allgemeines Inhaltsverzeichnis | hypertext-navigation im allgemeinen inhaltsverzeichnis (Liste der Verweise auf die Dateien in der Datenbank) |
| gut_de | go tags | hypertext-navigation zur utags-datei (Index der Hypertext-Labels der Dateien in der Datenbank) |
| gag_de | zum Arbre General | Hypertext-Navigation zur Datei, die den Baum der Datenbankdateien enthält) |
| gas_de | go Quellbaum | hypertext navigation to the file containing the file tree of the last execution of utags) |
| grc_de | go Querverweis | Hypertext-Navigation zur Querverweisdatei:sucht nach der Referenz des aktuellen Etiketts |
3.Textblock
texte_structuré_de
Der Textblock ist die Struktur, unter der ein Text gespeichert wird..
Er besteht aus vier Arten von Elementen, die von Begrenzungspaaren begrenzt werden < >, ( ), { } und [ ]
ein Hypertext- oder Tag-Tag, das zwischen die Begrenzungszeichen " gesetzt wird<" et ">", sagte étiquette mentor de
.
der nur alphanumerische Zeichen mit dem Underscore-Zeichen "_" als Trennzeichen enthalten darf - ein eventueller Résumé de bloc de
oder Commentaire mentor de
in Klammern gesetzt "( )",
den eigentlichen Text in geschweifte Klammern gesetzt "{}" bei dem es sich um den eigentlichen Textblock handelt.
die Hypertext-Verweise der Form zu den Textmarken, die den in den Textblöcken enthaltenen Text ausschmücken 3.1.Blockstruktur
Wir haben also eine allgemeine Form:
<etiquette_de_bloc_de>(Titel) [reference_de]
{
...
... [reference_de] ...
...
<etiquette_de_sous_bloc_de>(Unterblocketikett)
{
...
... [reference_de] ...
...
... <etiquette_dans_texte_de> ...
...
... [reference_de] ...
...
usw....
}
}
die daher verschachtelt werden kann: Ein Textblock kann andere Textblöcke enthalten.
Ein bestimmter Block ist der Block der gesamten Datei, dessen Beschriftungszeile Folgendes enthält:
die Beschriftung des Dateinamens - den Titel der Datei - einen Verweis auf das Inhaltsverzeichnis der Datei.
Die Form des Labels der Datei ist also 3.2.Etikette in text
.
z. B. für eine Datei namens Dateiname.
ext auf eine :
<nomfichier_extension_de>(Dateititel)[nomfichier_extension_de_som]
das Makro zum Erzeugen dieser Zeile ist fnt_de für eine Textdatei.
Es gibt weitere Makros.
- die Dateien in der Datenbank werden in Dateien namens Domain mit der Erweiterung .dom
- der Wurzelbereich also Wurzel.dom ist der Bereich mit der niedrigsten Ebene racine_dom_de wie der Name schon sagt.
- Die Domäne enthält eine Liste der Dateipfade und eventuell der Unterdomänen..
- eine Subdomäne wird durch das Zeichen @ gekennzeichnet, das dem Domänenpfad vorangestellt ist
so weiß utags, dass es diese Datei als Domäne analysieren muss.
- dies bildet einen hierarchischen Baum, dessen Zweige die Domänen und dessen Blätter die Dateien sind.
innerhalb der Dateien setzt sich dieser Baum durch die Verschachtelung von Textblöcken fort grace
zum Etikett der Blöcke.
- um Ihre Dateien zur mentor-Datenbank hinzuzufügen, empfiehlt es sich, eine oder mehrere Domänen zu erstellen
in der root_domain und bearbeiten Sie seine Dateien mit Ihren.
Dies kann automatisch durch einen Shell-Befehl geschehen, Beispiel auf unix:
!!find . -Name *.* -print
oder unter den Fenstern:
!!dir /b /l /s *.*
- utags erzeugt eine Inhaltsverzeichnisdatei, wenn es eine Datei analysiert die Erweiterung des Inhaltsverzeichnisses ist ".som" der Name des Inhaltsverzeichnisses der aktuellen Datei ist aide_utags_txh.som
- für die aktuelle Datei lautet das Label aide_utags_txh_de_som und befindet sich wie gesehen in der ersten Zeile der Datei
- das Makro, um direkt zum Inhaltsverzeichnis zu gelangen, lautet gsf_de
- wenn Sie sich im Inhaltsverzeichnis befinden, wählen Sie eine Bezeichnung, um mit altgr-$ in die Datei zurückzukehren (aber das wird sich in den Navigationsbaum einschreiben)
- oder geben Sie dieses Makro ein, um zum Inhaltsverzeichnis zu gelangen, und drücken Sie dann F6, um zu dieser Datei zurückzukehren, oder F8, wenn Sie leicht umschalten können wollen.
en die Datei und ihr Inhaltsverzeichnis.
- utags erzeugt auch ein allgemeines Inhaltsverzeichnis für alle Dateien in der Datenbank, um darauf zuzugreifen, verwenden Sie das Makro gsg_de
- das allgemeine Inhaltsverzeichnis besteht aus Textblöcken, die mit den Bereichen beschriftet sind
und deren Blöcke aus der Liste der Dateien oder Subdomains der Domain bestehen.
Das heißt, diese Blöcke sind die Zusammenfassungen der Bereiche.
- der erste Verweis im Block einer Domäne ist ein Link auf die Domänendatei selbst.
- wenn Sie durch diese Dateireferenz der Domäne navigieren z. B. utags_dom_de
gehen Sie, um die Liste der Dateipfade zu sehen. Ignorieren Sie die Zeilen "CSV", die Folgendes tun
aus dem nächsten Mentor-Modul, das strukturierte Daten verarbeitet (die Datentabellen)
das Modul utags, das sogenannte "unstrukturierte" Daten, d. h. Text, verarbeitet
aber zu dem der langage de balisage leger mentor de gibt eine Struktur.
- können Sie beliebig im Hypertext navigieren und mit F6 zum Ausgangspunkt zurückkehren.
und mit der Taste F7 wieder in den Navigationsbaum wechseln
- bei all diesen Bewegungen müssen Sie vielleicht eine bestimmte Position in einer Datei speichern, um direkt dorthin zurückzukehren.
Sie können dazu einen Befehl der Marke vi verwenden : mp zum Beispiel, um mit dem Buchstaben "p" die Position der aktuellen Zeile zu markieren
und nach dem Verschieben in der Datei mit dem Befehl 'p' wiederfinden
- utags beim Scannen des Domainbaums eine Reihe von Dateien erzeugt :
- die wichtigste Datei ist die Etikettendatei namens "utags", an die man
Zugriff durch Eingabe des Befehls ".:deine Tags" oder das Makro gut_de (von nun an
man wird nicht mehr im Text für ein Makro Mentor das " angeben.
- die Datei utags auf die Struktur einer tags Datei, wie sie der unix-Befehl ctags für C-Sprachquellen erzeugt.
- kann man mit dem Makro nach der Position eines Labels in der Datei utags suchen frt_de.
- die Datei "Baum.txt", auf die man mit dem Befehl gag_de (nein das ist kein Witz).
In dieser Datei wird der gesamte Domänenbaum mit seinen Blättern, den Dateien, visualisiert,
d. h. man sieht für eine Datei sowohl den Mentor-Pfad als auch den Pfad des Dateisystems.
So bietet utags eine andere Art des Zugriffs und eine andere Organisation Ihrer Dateien..
Eine doppelte Hierarchie also.
- die Datei "source.txt" Zugriff über gas_de die das Ergebnis eines bestimmten utags-Befehls ist
die statt der Domäne nur eine bestimmte Domäne oder eine Datei behandeln würde racine_dom_de.
- die Datei "urefs" ist auch sehr wichtig, hier geht es um Querverweise, d. h.
die Liste der Dateien, in denen ein Verweis in einem Text zitiert wird.
Wenn Sie sich auf einem Etikett befinden, wird das Makro frr_de ermöglicht es also, herauszufinden, wo dieses Etikett
verwendet wird, was praktisch ist, wenn man sie entfernen möchte, um die Konsistenz des Hypetextes zu wahren.
Logischerweise müssen auch seine Verweise gelöscht werden.
So greifen Sie auf die urefs-Datei zu, ohne eine Suche durchzuführen : ":ta refs"
- das Wissen, das man über eine Information besitzt, auch davon abhängt
die Art und Weise, wie diese in den Hypertext eingefügt wurde.
- aus diesem Grund ist besondere Aufmerksamkeit geboten
Umfang für die Ausgabe des Labels, mit dem die Information abgerufen werden kann.
- mit Information meint man den Textblock einer Blockbeschriftung
oder die Nachbarschaft eines Labels in einem Text.
- Man wählt logischerweise die Schlüsselwörter, die diese Information charakterisieren.
um das Etikett zu bilden.
- eine ebenfalls zur Bildung dieses Etiketts verwendete Methode ist die Verwendung von
eine Nomenklatur voninfixe_de die aus drei Buchstaben bestehende Codes sind
- diese Nomenklatur vorgeschlagen wird, Sie sie aber erweitern oder ersetzen können
je nach Ihren Bedürfnissen.
Wichtig ist, dass Sie eine Nomenklatur verwenden, da dies eine Kategorisierung der Informationen ermöglicht
der dann leichter zu finden ist, weil die Anzahl der Infixe begrenzt ist..
- es gibt mehrere Ebenen, um eine Information im Hypertext zu erreichen
je nachdem, wie gut man über diese Information Bescheid weiß.
- Wenn Sie das Etikett vollständig kennen, ist die einfachste Methode, Folgendes einzugeben
die Bestellung : ":deine Etikette"
- dann kann man entweder das allgemeine Inhaltsverzeichnis gsg_de wenn man nach einer Datei sucht
entweder die Datei utags_de gut_de wenn nach einem Textblock gesucht wird.
- dann gehen Sie einfach in die Datei und führen eine vi-Suche durch den Befehl
"/kette/" gefolgt von enter
- die Zeichenkette kann eine expression_régulière_de die eine flexible Suche nach syntaktischen Elementen ermöglicht.
z. B. in der Datei utags die Suche: /Bestellung.*buffer/ setzt Sie auf das Etikett commande_de_gestion_de_buffer_vi_de
- fdr_de
- Funktion Domäne suchen - führt eine Volltextsuche in allen Dateien einer Domäne durch.
sie das Programm nomfic verwendet, das die Dateiliste einer Domäne unter rekursiver Berücksichtigung der Unterdomänen erstellt.
ANMERKUNG FÃœR ENTWICKLER : dieses Dokument mit Links zu den Quellen von Vim-Makrodateien oder Perl-Skripten sind ein Beispiel
wie Sie Ihre Quellen und Dokumentationen zu technischen Spezifikationen durch in den Kommentaren gesetzte Labels verlinken können,
die es einfach machen, mit Buchstaben zu programmieren.
Auch das Inhaltsverzeichnis der Datei (gsf_deSuchmodi in Hypertext) gibt Ihnen einen Überblick über Ihre Quellen und Links zum Zugriff.
zum Code, der Sie interessiert. Beispiel mit dem Perl-Programm zur Generierung von html-Seiten : mt_to_htm_pl_de_som
( Programm weitgehend verbesserungswürdig - Entwicklung in zukünftigen Versionen, wie das Einfügen von "inside html" in das Quelldokument
um die Stylesheets zu nutzen.Suchmodi in Hypertext)
Diese Funktionen bieten eine praktische Lösung für das ewige Problem der Diskrepanz zwischen Code und Dokumentation..
Mit der Mentor-Methode ist die Dokumentation ein Code wie jeder andere.
Makrobefehle zur leichteren Bearbeitung der Hypertextform werden bereitgestellt. :
1.Tableau des macro commandes d'edition de: für die leichte Auszeichnungssprache mentor
Makro | Eselsbrücke | Kommentar
|
---|
ebia_de | Edition Bloc Einfügung Auszeichnungen | fügt einen Block mit geschweiften Klammern ein
|
ebai_de | Blockausgabe Umkehrung Von Klammern | fügt geschweifte Klammern ein, um einen Block aufzuteilen |
ebtb_de | Ausgabe Bloc Tag Build | erstellt einen bloc structurel de komplett in der Ausgabe auf dem Etikett verlassen |
ebma_de | Edition Bloc Mise En Accolades | setzt einen mit F3-F4 ausgewählten Zeilenblock in geschweifte Klammern |
ebmp_de | Bearbeiten Block Einklammern | setzt einen mit F3-F4 ausgewählten Zeilenblock in Klammern |
ebm__de | Block editieren Block einrichten Silencer | es gibt eine Reihe von ebm-Makros, deren letzter Buchstabe lautet modifieur de bloc de |
etft_de | Edition Tab Fichier Texte | es gibt eine Reihe von Makro etf etf_mac_de dessen letzter Buchstabe der Typ der Quelldatei ist |
2.Makrobefehle zur hypertexterzeugung
- diese Makros starten mit mehreren Optionen das Programm utags, das Dateien im Domainbaum analysiert.
- sie sind auf die Funktionstasten F11 Shift-F11 Alt-F11 Ctrl-F11 und Ctrl-Shift-F11 abgebildet.
2.1.Tabelle der makrobefehle zur erzeugung von hypertext
Makro | Eselsbrücke | Kommentar
|
---|
ub_de | UTags Basis | startet utags für einen Scan der Dateien, die seit dem letzten Scan geändert wurden, in der gesamten Datenbank (racine.dom)
|
ud_de | Utags Domaine | startet utags für eine Analyse der geänderten Dateien der aktuellen Domäne |
uf_de | Utags Fichier | startet utags zur Analyse der aktuellen Datei |
F11_de | ub_de racine.dom | Abkürzung ut_de |
M-F11_de | ud_de racine.dom allgemein | Abkürzung ug_de |
C-F11_de | uf_de Datei | Abkürzung uf_de |
- der am häufigsten verwendete Befehl wird sicherlich C-F11_de. Wenn Sie ein Dokument bearbeiten und dabei Beschriftungen und Verweise erstellen,
verwenden Sie diesen Befehl, nachdem Sie Ihre Änderungen gespeichert haben, um die utags-Datenbank mit neuen Labels zu aktualisieren
und die urefs-Datenbank mit den neuen Referenzen.
HINWEIS : Die hier beschriebenen Befehle finden sich im Menü Utags der Menüleiste von gvim wieder.
Dieses Menü soll einen schnellen Zugang zu einer Hilfe bieten, um sich an Befehle zu erinnern..
HINWEIS : Diese Befehle und die leichte Auszeichnungssprache mentor sind die einzigen Dinge, die Sie kennen müssen, um ein leistungsstarkes Werkzeug zur Verwaltung von Textinformationen zu erhalten, das, wenn Sie es integrieren, konstant und lange dienen wird, um praktisch alle Ihre nützlichen Informationen zu erhalten und zu nutzen..
- die Datei extensio_lst_de enthält eine Tabelle mit bekannten Dateierweiterungen und deren Proprietäten, die vom Programm utags verwendet werden.
- die Datei /home/minage/Documents/mt/ht/ref_abs.txt listet Verweise auf, die keine passenden Labels haben.
- die Datei utags_par_de Parameter, die den Betrieb des utags-Programms steuern
Im Utags-Menü findet man ein Untermenü "Betrieb", mit dem man eine ganze Domain sichern oder archivieren kann.
und auch aufeinanderfolgende Versionen von Dateien archivieren.
Die Menübeschriftung DomainNameEingabe ermöglicht die Eingabe des Werts der Umgebungsvariablen.
Die Beschriftung LaufendeDomäneAnzeigen zeigt den Wert dieser Variablen an.
Dann findet man die Bezeichnung Domäne.Exportieren, der das Makro aufruft fdex_de der wiederum das Skript aufruft archive_domaine_sh_de
die mit dem Befehl "tar" eine Archivdatei erstellt und diese auf das Sicherungsmedium kopiert, das durch die Variable ARCHISUPP_de
in einem Verzeichnis mit dem Namen der Mentor-Datenbank ARCHIDIR_de.
Der Wortlaut Option.IncrementArchivDomain weist auf archive_domaine_sh_de dass der Name des Archivs eine inkrementelle Nummer enthalten muss
so dass ein aufeinanderfolgendes Archiv entsteht. Beispiel "utags_000.ar", "utags_001.ar"
Danach folgt ein Untermenü Datei mit folgenden Beschriftungen:
- "Archiv", das dem Makro zugeordnet ist fiv_de die eine Kopie der aktuellen Datei mit einem Namen erstellt, der eine inkrementelle Nummer enthält. (Skript iv_sh_deSicherungssysteme für Domänen und Dateien).
- "ListerArchiv", das dem Makro zugeordnet ist fva_de die die verschiedenen Archive der aktuellen Datei auflistet.
- "GoLogArchiv", das dem Makro zugeordnet ist gla_de der einen Puffer für das Log der verschiedenen Dateiarchive öffnet. Man kann das Log bearbeiten
um den Grund für die Eincheckung in der Logzeile der eingecheckten Datei anzugeben..
HINWEIS : eine Verwaltung strukturierter Daten wird in Kürze angeboten werden.
Dieses neue Modul ist die Integration von Tabellenkalkulation und RDBMS-Funktionen. (relationales Datenbankverwaltungssystem).
Es wird durch Textblöcke vom Typ CSV implementiert, deren Labels die Namen der Tabellen des RDBMS sind.
Eine Skriptsprache wird ebenfalls in dieses Modul integriert, um diese Daten zu programmieren..
die es Ihnen ermöglichen, Anwendungen aller Art schnell zu realisieren.
Besonderes Ausführungsbeispiel : Generierung von Proteodie-Musikpartituren aus dem FASTA-Code eines Proteins : partition_de_la_protéodie_stimulatrice_de_phenylalanine_ammonia_lyase_1_pisum_sativum http://quantisch.
alwaysdata.
net/phenylalanine_ammonia_lyase_1_pisum_sativum_sti_part_txh.
htm