El manual dels connectors de Kate
Dret de reproducció © 2001, 2002
Es concedeix permís per a copiar, distribuir i/o modificar aquest document sota els termes de la Llicència Lliure Pública de GNU, Versió 1.1 o qualsevol versió publicada posteriorment per la Free Software Foundation; amb seccions no variants, sense text a la portada i sense text a la contraportada. S'inclou una còpia d'aquesta llicència en la secció titulada "GNU Free Documentation License".
Aquest és el manual per als connectors de Kate l'editor de text avançat de KDE.
Sumari
Els connectors de Kate són funcionalitats addicionals per a l'editor Kate. Poden afegir menús extra i dreceres, i estendre les característiques de Kate. Podeu instal·lar-ne tants com vulgueu, des de Kate. Obriu el diàleg de configuració de Kate amb ->. Seleccioneu -> per escollir els connectors que requeriu.
Per a més informació sobre com usar Kate i com habilitar els connectors, en el manual de Kate.
Els connectors instal·lats en aquest manual són:
Aquest connector dona consells sobre el que està permès en una posició determinada d'un fitxer XML, en funció de la DTD del fitxer. Mostrarà una llista de possibles elements, atributs, valors d'atribut o entitats, depenent de la posició del cursor (p.ex. es llisten totes les entitats si el caràcter a l'esquerra del cursor és “&”). A més també és possible tancar l'etiqueta oberta més propera.
La DTD haurà d'existir en format XML, tal i com la produeix el programa de Perl dtdparse. Direm a aquests tipus de DTD “meta DTD”. Es proveeixen algunes meta DTD. Estan instal·lades en $KDEDIR/share/apps/katexmltools/, que a més és la carpeta per omissió quan escolliu . Per a produir les vostres pròpies meta DTD, descarregueu dtdparse des de http://dtdparse.sourceforge.net.
Inicieu Kate i obriu el diàleg de configuració sota ->. Llavores trieu Completat XML per a Kate, aquest apareixerà en la secció Aplicació/Connectors i tanqueu el diàleg. Després d'això, seleccioneu ->. Si el vostre document no conté “DOCTYPE” o el tipus de document és desconegut, haureu de seleccionar una meta DTD des del sistema de fitxers. D'altra manera es carregarà automàticament la meta DTD que coincideixi amb el DOCTYPE.
Ara podeu usar el connector mentre escriviu text:
Obre una llista de possibles elements a menys que el cursor estigui dintre d'una etiqueta. Tingueu present que en aquest moment no serà possible usar-la per inserir un element de primer nivell (p.ex. “<html>”).
La clau de cometes obrirà una llista amb els possibles valors de l'atribut (si es que n'hi han) si us trobeu dins d'una etiqueta.
Aquesta clau obrirà una llista de possibles atributs per a l'element actual si us trobeu dins d'una etiqueta.
Aquest clau obrirà una llista d'entitats anomenades.
Podeu provar totes les funcions i limitacions carregant $KDEDIR/share/apps/katexmltools/testcases.xml en Kate i seguint les instruccions. Tingueu present que treballar amb més d'una vista per document encara no està correctament suportat per aquest connector.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Obrirà un diàleg que us permetrà inserir un element XML. Els caràcters <, > i l'etiqueta de tanca seran inserits automàticament. Si teniu algun text seleccionat en usar aquest menú, dit text serà envoltat per les etiquetes d'obrir i tancar. El diàleg també ofereix completat de tots els elements que es poden inserir en la posició actual del cursor si heu assignat una meta DTD mitjançant el menú .
Cercarà en el text una etiqueta que encara no estigui tancada i la tancarà inserint la marca de tanca corresponent. La recerca comença en la posició del cursor i continuarà cap a l'esquerra. Si no troba cap etiqueta oberta no es realitzarà cap operació.
Li diu al connector quina meta DTD usar en tots els documents actuals. Tingueu present que aquesta assignació no serà desada. Pel que haureu de repetir-la la propera vegada que inicieu Kate.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
El connector “Completat XML” de Kate copyright 2001,2002 de Naber, Daniel (daniel.naber AT t-online.de).
Documentació copyright 2001,2002 de Naber, Daniel
Traductor de la documentació: Antoni Bella (bella5 AT teleline.es)
Aquest programa està llicenciat sota els termes de la Llicència Pública General de GNU.
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
Aquest connector comprova el fitxer actual. En la part inferior de la finestra principal de Kate apareixerà una llista d'avisos i errors. Podeu fer clic sobre un missatge d'error per a saltar al lloc corresponent en el fitxer. Si el fitxer te un “DOCTYPE”, la DTD indicada amb aquest tipus de document serà usada per a comprovar la validesa del fitxer. S'espera que la DTD estigui al lloc corresponent en el fitxer actual, p.ex. si el tipus de document fa referència a “DTD/xhtml1-transitional.dtd” i el fitxer és /home/pere/prova.xml, s'esperarà que la DTD es trobi a /home/pere/DTD/xhtml1-transitional.dtd. De tota manera, també es poden especificar DTD remotes a través d'http.
Si el fitxer no te tipus de document, es comprovarà que estigui format correctament.
Per aprendre més sobre XML aneu a les pàgines oficials XML del W3C.
Internament aquest connector crida al comandament extern xmllint, que és part de libxml2. Si aquest comandament no està correctament instal·lat al vostre sistema, el connector no funcionarà.
És necessari escriure un fitxer temporal en la mateixa carpeta en la que es troba el fitxer a comprovar, així que haureu de tenir accés d'escriptura a aquesta carpeta.
Per a carregar aquest connector obriu el diàleg de confguració de Kate amb ->. Llavores trieu Validació XML per a Kate i aquest apareixerà en la secció Aplicació/Connectors i tanqueu el diàleg.
Connector “Validació XML” de Kate copyright 2002 de Naber, Daniel (daniel.naber AT t-online.de).
Documentació copyright 2002 de Naber, Daniel
Traductor de la documentació: Antoni Bella (bella5 AT teleline.es)
Aquest programa està llicenciat sota els termes de la Llicència Pública General de GNU.
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
El connector “Inserció del comandament” us permet inserir la sortida d'un comandament a un intèrpret de comandaments dintre d'un document obert en Kate.
Per habilitar el connector “Inserció de comandament” useu diàleg -> i marqueu Comandament d'inserció per a Kate en la secció Aplicació Connectors i tanqueu el diàleg.
Per a usar el connector, seleccioneu des del menú , se us presentarà un petit diàleg per introduir el comandament, escolliu una carpeta de treball i seleccioneu si incloure errors (STDERR output) en el text inserit. També podeu tenir la cadena del comandament impresa al damunt de la sortida.
El connector us recordarà un número de comandaments escollits en la pàgina de configuració. Aquest serà usat per autocompletar i es pot seleccionar des d'una llista en l'entrada del comandament.
Per omissió, el comandament serà executat en la carpeta a on estigui treballant kate, normalment és la vostra carpeta inicial. Aquesta es pot canviar en la pàgina de configuració del connector.
Tingueu present que qualsevol comandament a un intèrpret de comandaments requereix entrada de dades per part de l'usuari (per exemple passwd) o usar una interfície ncurses o similar (per exemple top) per a produir la sortida esperada.
Per a configurar el connector “Inserció de comandament”, obriu el diàleg de configuració des del menú -> i escolliu +Inserció de comandament.
Estan disponibles les següents opcions de configuració:
Aquesta opció us presenta una caixa amb la qual establir un número per als comandaments que seran recordats. Serà vàlid qualsevol número de 0 a 99. Per omissió és 20.
Aquestes opcions, presentades com a un conjunt de botons de selecció, us permeten decidir com s'escull la carpeta de treball d'un comandament. Les opcions són la carpeta en la que s'estigui executant Kate (normalment la vostra carpeta inicial quan Kate és executat des del menú K), la carpeta del document (si n'hi ha cap, d'altra manera s'usarà l'opció de més amunt) o la carpeta de treball de l'última vegada que vàreu executar el connector.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Connector “Inserció de comandament” per a Kate copyright 2001 de Lund, Anders (anders AT alweb.dk).
Documentació copyright 2001 de Lund, Anders (anders AT alweb.dk)
Traductor de la documentació: Antoni Bella (bella5 AT teleline.es)
Aquest programa està llicenciat sota els termes de la Llicència Pública General de GNU.
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
Aquest connector obrirà un diàleg que us demanarà pel nom d'una etiqueta HTML. Els atributs i valors es poden incloure en l'etiqueta oberta introduint nom-atribut="valor-atribut"
Connector “Eines HTML” de Kate copyright 2002 de Joseph Wenninger (kde AT jowenn.at).
Documentació copyright 2005 de Francis Giannaros
Antoni Bella Pérez(bella5 AT teleline.es)
Aquest programa està llicenciat sota els termes de la Llicència Pública General de GNU.
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
El connector “Obre la capçalera” actualment te documentació. Si esteu interessat en corregir aquesta situació, si us plau contacteu amb en Lauri Watts (lauri AT kde.org), el coordinador de l'Equip de documentació de KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
El connector “Filtrat de text” actualment te documentació. Si esteu interessat en corregir aquesta situació, si us plau contacteu amb en Lauri Watts (lauri AT kde.org), el coordinador de l'Equip de documentació de KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
El connector per a plantilles de fitxer us permetrà crear fitxers basats en d'altres fitxers. Podeu usar qualsevol fitxer com a plantilla, creant-se una còpia del fitxer amb una URL buida, o usar una plantilla de fitxer especial que pot contenir macros que completin la informació, tal com el nom i l'adreça de correu electrònic, la data actual, variables d'entorn i la posició en que s'haurà de situar el cursor en el nou fitxer.
A més, les plantilles que es trobin en la carpeta de plantilles es presentaran en l'ítem de menú ->.
El connector també proveeix un mètode per a crear una plantilla nova d'una manera fàcil a partir d'un document obert.
La carpeta de plantilles formen part del sistema de fitxers de KDE i almenys consisteix en KDEDIR/share/applications/kate/plugins/katefiletemplates/templates i KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Si la vostra variable d'entorn KDEDIRS conté directoris addicionals, es realitzarà la recerca de forma similar. Si es troben plantilles amb el mateix nom, es triarà la que es trobi en la carpeta local (KDEHOME).
Mostra un diàleg per obrir un fitxer que us permetrà usar qualsevol fitxer com a plantilla. Si el fitxer escollit te l'extensió katetemplate serà analitzat per obtenir la informació de la plantilla així com les macros.
Mostra una llista amb els últims fitxers usats com a plantilles, representats per la seva URL.
La resta dels submenús contenen enllaços a les plantilles. Feu clic en una de les opcions per a crear un fitxer com el descrit pel text de l'ítem del menú.
Això carregarà un diàleg amb una llista de totes les plantilles trobades en el directori de plantilles, amb opcions per afegir, editar i eliminar plantilles.
Quan es crea un fitxer des d'una plantilla aquest pot contenir macros, algunes macros apareixen com a variables editables en el text. Les variables es mostren com a paraules subratllades en el text.
La primera variable serà seleccionada, i tot seguit podeu editar-la. Si el document de text conté més instàncies de la mateixa variable, seran canviades a la vegada que l'editeu. Per abastar la següent variable editable feu clic de la tecla Tabulador. Quan s'hagi editat l'última variable, s'abandonarà la llista i la tecla Tabulador funcionarà de manera normal.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Per a crear una nova plantilla, useu l'opció -> que inicia el diàleg de gestió de plantilles. Tot seguit, feu clic a per iniciar l'assistent de fitxers de plantilla. Se us demanarà per un nom de fitxer opcional i se us demanarà per les preferències per a la plantilla, creant-se una plantilla de fitxer.
Alternativament, podeu crear una plantilla manualment afegint la informació sobre la mateixa a la part superior de qualsevol fitxer, afegiu text i macros, i deseu-lo amb l'extensió katetemplate.
El menú de plantilles s'actualitza automàticament si decidiu desar la plantilla en el directori de plantilles.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Per a editar una plantilla, useu l'opció ->. Seleccioneu la plantilla amb la que voleu treballar i feu clic a , el que farà que s'obri el fitxer de plantilla. Tanqueu el diàleg, editeu el fitxer de plantilla, deseu-lo i tanqueu-lo. Els canvis de la plantilla tindran efecte immediat, podent activar la plantilla per a provar els vostres canvis després de desar-la.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Si useu fitxers amb l'extensió katetemplate, seran analitzats per obtenir la informació de la plantilla, macros i una posició del cursor.
Mentre llegiu el fitxer, l'analitzador desa les línies que comencen amb katetemplate: i hi cerca informació per a la plantilla amb la forma NOMVARIABLE=VALOR. La primera línia que no comenci amb katetemplate: se prendrà per a l'inici del contingut de la plantilla. VALOR pot contenir qualsevol caràcter excepte el signe igual (=). Son noms vàlids de variable:
TemplateAquest és el nom de la plantilla, el qual es mostra en el menú ->.
GroupEl grup situa la plantilla en un submenú dins del menú ->.
NameAquest és el nom que serà establert per al document, i que es mostrarà en la llista de fitxers i en la barra de títol. Si el nom conté %N això serà substituït amb un número, que s'incrementarà si hi ha més documents amb el mateix nom.
HighlightEl connector intentarà establir Highlight per als documents nous el valor d'aquesta variable. El valor hauria de ser el nom tal i com es troba en ->.
DescripcióUna petita descripció informativa de la plantilla. Actualment s'usa per establir una cadena Què és això? per a l'ítem de menú, però en el futur es podrà usar per a més propòsits.
Una cadena identificant l'autor, per exemple en el formulari Nom <adreça de correu electrònic>. Actualment s'usa per establir una cadena Què és això? per a l'ítem de menú, però en el futur es podrà usar per a més propòsits.
Mentre s'analitza el contingut de la plantilla, s'expandeixen les macros en la forma %{NAME} o ${NAME}. Si useu el prefix $, la macro expandida serà tractada com una variable editable quan es crei el document des d'una plantilla, mentre que si useu % no, a menys que l'expansió falli.
S'expandiran les següents macros:
Expandeix a l'hora actual en el vostre format local.
Expandeix a la data actual en el seu format curt.
Expandeix a la data i hora actuals, d'acord al vostre format local.
L'any actual com un número de quatre dígits.
El nom complet del mes actual, d'acord al vostre format local.
Expandeix al dia actual del mes.
Expandeix al nom del vostre ordinador (hostname).
Expandeix a 'i'.
Expandeix al vostre nom complet, tal i com està definit per al destinatari propietari en la vostra llibreta d'adreces de KDE.
Expandeix al vostre primer nom, tal i com està definit per al destinatari propietari en la vostra llibreta d'adreces de KDE.
Expandeix al vostre cognom, tal i com està definit per al destinatari propietari en la vostra llibreta d'adreces de KDE.
Expandeix a la vostra adreça de correu electrònic, tal i com està definit per al destinatari propietari en la vostra llibreta d'adreces de KDE.
Qualsevol macro que no estigui inclosa en l'anterior llista anterior serà tractada com una variable editable sense importar el prefix. Si la mateixa variable apareix en varies ocasions en la plantilla, serà editada d'una sola vegada després d'haver creat un document a partir d'una plantilla.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
El connector “Plantilles de fitxer” de Kate te copyright 2004 de Lund, Anders (anders AT alweb.dk).
Documentació copyright 2004 de Lund, Anders
Antoni Bella (bella5 AT teleline.es)
Aquest programa està llicenciat sota els termes de la Llicència Pública General de GNU.
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
Els copyright per a cada applet està llistat en el capítol corresponent.
Aquesta documentació està llicenciada sota els termes de la Llicència de Documentació Lliure de GNU.
Aquest programa està llicenciat sota els termes de la Llicència Pública General de GNU.
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