Handbok Kate insticksprogram
Copyright © 2001, 2002
Härmed ges tillåtelse att kopiera, distribuera och/eller ändra detta dokument under villkoren i GNU Free Documentation License, Version 1.1 eller någon senare version publicerad av Free Software Foundation; utan invarianta avsnitt, utan framsidestexter och utan baksidestexter. En kopia av licensen inkluderas i avsnittet som heter "GNU Free Documentation License".
Det här är handboken för insticksprogram för Kate, KDE:s avancerade texteditor.
Innehållsförteckning
Kate insticksprogram är ytterligare funktioner för editorn Kate. De kan lägga till extra menyer och snabbtangenter, och utöka Kates funktioner. Du kan installera så många eller så få du vill, inne i Kate. Öppna Kates inställningsdialogruta med ->. Använd -> för att välja önskade insticksprogram.
Mer information om att använda Kate och att aktivera de insticksprogram som du vill ha, finns i Kates handbok.
Insticksprogrammen som ingår i den här handboken är:
Det här insticksprogrammet ger tips om vad som är tillåtet på vissa ställen i en XML-fil, i enlighet med filens DTD. Det listar möjliga element, egenskaper, egenskapsvärden eller objekt, beroende på markörens plats (t.ex. så listas alla objekt om tecknet till vänster om markören är “&”). Det är också möjligt att avsluta den närmaste taggen till vänster som ännu ej avslutats.
En DTD på XML-format, som skapas av Perl-programmet dtdparse måste finnas. Den här sortens DTD:er kallas för “meta-DTD:er”. Vissa meta-DTD:er medföljer. De är installerade i $KDEDIR/share/apps/katexmltools/, som också är den förvalda katalogen när du väljer . För att skapa dina egna meta-DTD:er, hämta dtdparse från http://dtdparse.sourceforge.net.
Starta Kate och öppna inställningsdialogrutan med ->. Markera därefter Kate XML-komplettering, som visas i avsnittet Program Insticksprogram. Välj därefter ->. Om dokumentet inte innehåller någon “DOCTYPE” eller en okänd doctype, måste du välja en meta-DTD i filsystemet. Annars så laddas automatiskt den meta-DTD som hör ihop med det nuvarande dokumentets doctype.
Nu kan du använda insticksprogrammet medan du skriver in text:
Det här visar en lista med möjliga element om inte markören redan är inne i en tagg. Observera att du för närvarande inte kan använda det här för att infoga toppnivåelementet (t.ex. “<html>”).
Ett citationstecken visar en lista med möjliga attributvärden (om det finns några) när du är inne i en tagg.
Den här tangenten visar en lista med möjliga egenskaper för det nuvarande elementet om du är inne i en tagg.
Den här tangenten visar en lista med namngivna objekt.
Du kan prova alla funktioner och begränsningar genom att ladda $KDEDIR/share/apps/katexmltools/testcases.xml i Kate och följa instruktionerna. Observera att arbeta med mer än en vy per dokument ännu inte stöds på ett riktigt sätt av insticksprogrammet.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Det här visar en dialogruta som låter dig infoga ett XML-element. Tecknen <, > och den avslutande taggen infogas automatiskt. Om du har markerat text när menyalternativet väljes, så omges den markerade texten av den inledande och avslutande taggen. Dialogrutan tillhandahåller också komplettering av alla element som kan infogas vid markörens nuvarande position, om du har tilldelat en meta-DTD genom att använda .
Det här söker i texten efter en tagg som ännu inte avslutats och avslutar den genom att sätta in motsvarande avslutningstagg. Sökningen börjar på markörens plats och går åt vänster. Om ingen tagg som inte har avslutats hittas, händer ingenting.
Det här talar om för insticksprogrammet vilken meta-DTD som ska användas för det nuvarande dokumentet. Observera att den här tilldelningen inte sparas. Du måste upprepa den när du startar Kate nästa gång.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate insticksprogram “XML-komplettering” copyright 2001,2002 Daniel Naber (daniel.naber AT t-online.de).
Dokumentation copyright 2001,2002 Daniel Naber
Översättning Stefan Asserhäll (stefan.asserhall AT comhem.se)
Det här programmet licensieras under villkoren i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Det här insticksprogrammet kontrollerar nuvarande fil. En lista med varningar och fel visas längst ner i Kates huvudfönster. Du kan klicka på ett felmeddelande för att hoppa till motsvarande plats i filen. Om filen har en “DOCTYPE”, så används den DTD som anges av DOCTYPE för att kontrollera filens giltighet. Denna DTD förväntas finnas på en plats relativt den nuvarande filen, t.ex. om DOCTYPE refererar till “DTD/xhtml1-transitional.dtd” och filen heter /home/peter/test.xml, så förväntas denna DTD finnas under /home/peter/DTD/xhtml1-transitional.dtd. Dock så stöds också DTD:er som anges med HTTP.
Om filen inte har någon doctype, så kontrolleras att den är välformad.
För att ta reda på mer om XML, titta på de officiella W3C XML-sidorna.
Internt anropar insticksprogrammet det externa kommandot xmllint, som är en del av libxml2. Om det här programmet inte är riktigt installerat på systemet, fungerar inte insticksprogrammet.
En tillfällig fil måste skrivas i samma katalog där filen som ska kontrolleras finns, så du måste ha skrivrättigheter i denna katalog.
För att ladda insticksprogrammet, öppna först Kates inställningsdialogruta under -> . Markera därefter Kate XML-validering, som visas under Program Insticksprogram och stäng dialogrutan.
Kates insticksprogram “XML-validering” copyright 2002 Daniel Naber (daniel.naber AT t-online.de).
Dokumentation copyright 2002 Daniel Naber
Översättning Stefan Asserhäll (stefan.asserhall AT comhem.se)
Det här programmet licensieras under villkoren i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Insticksprogrammet “Infoga kommandon” låter dig lägga till utmatning från ett skalkommando i ett dokument som är öppet i . Kate
Aktivera först insticksprogrammet “Infoga kommando” genom att använda dialogrutan -> och markera Kate Infoga kommando i Program under fliken Insticksprogram och stäng dialogrutan.
För att använda insticksprogrammet, välj i menyn , som visar en liten dialogruta för att skriva in kommandot, välja en arbetskatalog och välja om du vill ha med fel (standardutmatning av fel) i texten som infogas. Du kan också välja att skriva ut kommandosträngen ovanför utmatningen.
Insticksprogrammet kommer ihåg det antal kommandon som väljs på inställningssidan. Dessa används för automatisk komplettering, och kan väljas från en lista i kommandoinmatningsfältet.
Normalt körs kommandot i arbetskatalogen där Kate startades, som oftast är din hemkatalog. Detta kan ändras på insticksprogrammets inställningssida.
Observera att alla skalkommandon som kräver inmatning från användaren (t.ex. passwd) eller använder ett terminalgränssnitt baserat på ncurses eller något liknande (t.ex. top) misslyckas med att skapa förväntad utmatning.
För att anpassa insticksprogrammet “Infoga kommando”, öppna Kates inställningsdialogruta i menyn -> och välj +Infoga kommando.
Följande inställningsalternativ är tillgängliga:
Den här inställningen, som visas som en nummerinmatningsruta, låter dig bestämma hur många kommandon som kan kommas ihåg. Alla värden från 0 till 99 är giltiga. Standardvärdet är 20.
Den här inställningen, som visas som en uppsättning med knappar, låter dig bestämma hur arbetskatalogen för kommandot väljs. Alternativen är arbetskatalogen där Kate startades (oftast din hemkatalog när Kate startas från K-menyn), katalogen för dokumentet (om det finns någon, annars används alternativet ovanför) eller arbetskatalogen för det senaste kommandot som kördes i insticksprogrammet.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate insticksprogram “Infoga kommandon” copyright 2001 Anders Lund (anders AT alweb.dk).
Dokumentation copyright 2001 Anders Lund (anders AT alweb.dk)
Översättning Stefan Asserhäll (stefan.asserhall AT comhem.se)
Det här programmet licensieras under villkoren i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Det här insticksprogrammet visar en dialogruta som frågar efter ett HTML-taggnamn. Egenskaper och värden som ska läggas till i den inledande taggen ska skrivas in som egenskapsnamn="egenskapsvärde"
Kate-insticksprogrammet “HTML-verktyg” copyright 2002 Joseph Wenninger (kde AT jowenn.at).
Dokumentation copyright 2005 Francis Giannaros
Översättning Stefan Asserhäll (stefan.asserhall AT comhem.se)
Det här programmet licensieras under villkoren i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Insticksprogrammet “Öppna deklarationsfiler” för Kate har inte någon dokumentation för närvarande. Om du är intresserad av att avhjälpa situationen, kontakta då gärna Lauri Watts (lauri AT kde.org), samordnare av KDE:s dokumentationsgrupp.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Insticksprogrammet “Textfilter” för Kate har inte någon dokumentation för närvarande. Om du är intresserad av att avhjälpa situationen, kontakta då gärna Lauri Watts (lauri AT kde.org), samordnare av KDE:s dokumentationsgrupp.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Insticksprogrammet Filmallar låter dig skapa filer baserade på andra filer. Du kan använda vilken fil som helst som en mall, vilket skapar en kopia av filen med en tom webbadress, eller använda en särskild mallfil som kan innehålla makron för att fylla i information som ditt namn och e-postadress, dagens datum och så vidare, samt placera markören på en lämplig plats i den nya filen.
Dessutom visas mallar som finns i mallkatalogerna i menyalternativet ->.
Insticksprogrammet tillhandahåller också en metod att enkelt skapa en ny mall från ett öppet dokument.
Mallkatalogerna är en del av KDE:s filsystem, och består åtminstone av KDEDIR/share/applications/kate/plugins/katefiletemplates/templates och KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Om miljövariabeln KDEDIRS innehåller ytterligare kataloger, söks de dessutom igenom efter liknande underkataloger. Om mallar med samma namn hittas, väljes mallen i den lokala katalogen (KDEHOME).
Visar en dialogruta för att öppna en fil, som låter dig välja vilken fil som helst som mall. Om den valda filen har filändelsen katetemplate tolkas den för att hitta mallinformation och makron.
Visar en lista med filer som nyligen använts som mallar, representerade av sina webbadresser.
Återstoden av undermenyer innehåller länkar till mallar. Klicka på ett menyalternativ för att skapa en fil som beskrivs av menyalternativets text.
Det här visar en dialogruta med en lista över mallar som hittas i mallkatalogerna, tillsammans med alternativ för att lägga till, redigera eller ta bort mallar.
När en fil skapas från en mall som innehåller mallmakron, visas vissa makron som redigerbara variabler i texten. Sådana variabler visas som understrukna ord i texten.
Den första variabeln väljes, så du behöver bara skriva för att redigera den. Om dokumenttexten innehåller flera förekomster av samma variabel, ändras de medan du redigerar. För att gå till nästa redigerbara variabel, tryck på tabulatortangenten. När den sista variabeln redigeras, försvinner listan och tabulatortangenten fungerar som vanligt.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Använd -> som startar mallhanteringsdialogrutan, för att skapa en ny mall. Klicka på i den för att starta Filmallsguiden. Du blir tillfrågad om en valfri fil att omvandla till en mall samt om mallinformationsinställningar, och en mallfil skapas åt dig.
Som ett alternativ kan du skapa mallen för hand genom att lägga till mallinformation längst upp i vilken fil som helst, lägga till text och makron, och spara den med filändelsen katetemplate.
Mallmenyn uppdateras automatiskt om du väljer att lagra din mall i mallkatalogen.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Använd -> för att redigera en mall. Markera mallen du vill arbeta med, och klicka på , så öppnas mallfilen. Stäng dialogrutan, redigera mallfilen som önskas, spara och stäng den. Ändringar i mallen får omedelbart effekt, och du kan aktivera mallen för att prova dina ändringar efter du har sparat den.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Om du använder filer med filändelsen katetemplate, tolkas de för att hitta mallinformation, makron och en markörposition.
Medan filen läses in, behåller tolken rader som börjar med ordet katetemplate: och söker i dem efter mallinformation på formen VARIABELNAMN=VÄRDE. Den första raden som inte börjar med katetemplate: antas vara början på mallens innehåll. VÄRDE kan innehålla vilket tecken som helst utom likhetstecken (=). Riktiga variabelnamn är:
TemplateDet här är mallens namn, som visas i menyn ->.
GroupGruppen placerar mallen i en undermeny till menyn ->.
NameDet här är namnet som dokumentet får, och som visas i fillistan och namnlisten. Om namnet innehåller %n ersätts det med ett nummer, som ökas om flera dokument har samma namn.
HighlightInsticksprogrammet försöker ställa in färgläggningen för det nya dokumentet till den här variabelns värde. Värdet ska vara namnet, som syns under ->.
DescriptionEn kort informativ beskrivning av mallen. Den används för närvarande för att visa en “Vad är det här”-sträng för menyalternativet, men kan användas för fler syften i framtiden.
En sträng som identifierar upphovsmannen, till exempel på formen Namn <e-postadress>. Den används för närvarande för att visa en “Vad är det här”-sträng för menyalternativet, men kan användas för fler syften i framtiden.
Medan mallens innehåll tolkas, expanderas makron på formen %{NAMN} eller ${NAMN}. Om du använder prefixet $, behandlas det expanderade makrot som en redigerbar variabel när ett dokument skapas från mallen, medan om du använder % gör det inte det, om inte expansion misslyckades.
Följande makron expanderas:
Expanderas till aktuell tid med format enligt landsinställningarna.
Expanderas till dagens datum med kort format.
Expanderas till aktuell tid och datum, formaterat som en sträng enligt landsinställningarna.
Innevarande år som ett tal med fyra siffror.
Fullständigt namn på innevarande månad, enligt dina landsinställningar.
Expanderas till dagen i innevarande månad.
Expanderas till datorns värddatornamn.
Expanderas till 'i'.
Expanderas till ditt fullständiga namn, som det definieras av ägarens adress i den vanliga adressboken i KDE.
Expanderas till ditt förnamn, som det definieras av ägarens adress i den vanliga adressboken i KDE.
Expanderas till ditt efternamn, som det definieras av ägarens adress i den vanliga adressboken i KDE.
Expanderas till din e-postadress, som den definieras av ägarens adress i den vanliga adressboken i KDE.
Ett makron som inte finns i listan ovan behandlas som en redigerbar variabel oberoende av prefix. Om samma variabel förekommer flera gånger i mallen, kan de redigeras omedelbart efter dokumentet skapats från mallen.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate-insticksprogrammet “Filmallar” copyright 2004 Anders Lund (anders AT alweb.dk).
Dokumentation copyright 2004 Anders Lund
Översättning Stefan Asserhäll (stefan.asserhall AT comhem.se)
Det här programmet licensieras under villkoren i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Copyright för varje miniprogram listas i motsvarande kapitel.
Den här dokumentationen licensieras under villkoren i GNU Free Documentation License.
Det här programmet licensieras under villkoren i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team