natgillin/translations-raw huggingface dataset:
Per omissió, l' ordre serà executada 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.
By default, the command will be run in the working folder of the kate process, which is usually your home folder. This can be changed in the configuration page for the plugin.
Tingueu present que qualsevol ordre a un intèrpret d' ordres 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.
Note that any shell command that requires user input (for example passwd) or uses a ncurses interface or something similar (for example top) will fail to produce the expected output.
Per a configurar el connector Inserció d' ordre, obriu el diàleg de configuració des del menú Arranjament Configura & kate;... i escolliu Connectors Inserció d' ordre.
To configure the Insert Command plugin, open the & kate; configuration dialog from the Settings Configure & kate;... menu and choose Plugins Insert Command.
La pestanya de configuració Inserció d' ordre
The Insert Command Configuration Tab
Estan disponibles les següents opcions de configuració:
The following configuration options are available:
Número d' ordres a recordar
Number of commands to remember
Aquesta opció us presenta una caixa amb la qual establir un número per a les ordres que seran recordades. Serà vàlid qualsevol número de 0 a 99. Per omissió és 20.
This setting is presented as a spinbox which you can set to the number of commands to be remembered. Any number from 0 to 99 is legal. Default is 20.
Carpeta de treball per omissió
Default Working Folder
Aquestes opcions, presentades com a un conjunt de botons de selecció, us permeten decidir com s' escull la carpeta de treball d' una ordre. 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.
This setting, presented as a set of radio buttons, allows you to decide how the working folder of a command is chosen. The options are the working folder of the & kate; process (usually your home folder when & kate; is started from the K menu), the folder of the document (if any, otherwise the above option is used) or the working folder of the last command run in the plugin.
Agraïments i reconeixements
Thanks and Acknowledgments
Connector Inserció d' ordre per a & kate; copyright 2001 de & Anders. Lund; & Anders. Lund. mail;.
& kate; Plugin Insert Command copyright 2001 Anders Lund & Anders. Lund. mail;.
Documentació copyright 2001 de & Anders. Lund; & Anders. Lund. mail;
Documentation copyright 2001 & Anders. Lund; & Anders. Lund. mail;
capçalera
header
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@ kde. org, el coordinador de l' Equip de documentació de & kde;.
The & kate; plugin Open Header currently has no documentation. If you are interested in rectifying that situation, please contact Lauri Watts lauri@kde. org, & kde; 's Documentation Team coordinator.
filtre
filter
El connector Filtrat de text actualment te documentació. Si esteu interessat en corregir aquesta situació, si us plau contacteu amb en Lauri Watts lauri@ kde. org, el coordinador de l' Equip de documentació de & kde;.
The & kate; plugin Text Filer currently has no documentation. If you are interested in rectifying that situation, please contact Lauri Watts lauri@kde. org, & kde; 's Documentation Team coordinator.
Aquest connector comprova que els fitxers & XML; estiguin ben formats i que són vàlids.
This plugin checks & XML; files for well-formedness and validity.
xml
xml
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, & pex; 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.
This plugin checks the current file. A list of warnings and errors will appears at the bottom of & kate; 's main window. You can click on an error message to jump to the corresponding place in the file. If the file has a DOCTYPE the DTD given with this doctype will be used to check the file for validity. The DTD is expected at a position relative to the current file, & eg; if the doctype refers to DTD/ xhtml1-transitional. dtd and the file is / home/ peter/ test. xml the DTD is expected to be located at / home/ peter/ DTD/ xhtml1-transitional. dtd. However, remote DTDs specified via http are supported.
Si el fitxer no te tipus de document, es comprovarà que estigui format correctament.
If the file has no doctype it will be checked for well-formedness.
Per aprendre més sobre & XML; aneu a les pàgines oficials & XML; del W3C.
To learn more about & XML; check out the official W3C & XML; pages.
Internament aquest connector crida a l' ordre externa xmllint, que és part de libxml2. Si aquesta ordre no està correctament instal· lada al vostre sistema, el connector no funcionarà.
Internally this plugin calls the external command xmllint, which is part of libxml2. If this command is not correctly installed on your system, the plugin will not work.
É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.
A temporary file needs to be written to the same folder as the file that should be checked, so you need to have write access to that folder.
Per a carregar aquest connector obriu el diàleg de confguració de & kate; amb Arranjament Configura & kate;.... Aleshores trieu Validació XML per a Kate i aquest apareixerà en la secció Aplicació / Connectors i tanqueu el diàleg.
To load this plugin open & kate; s configuration dialog under Settings Configure & kate;.... Then select Kate XML Validation which will appear in the Application / Plugins section and close the dialog.
XML Valida l' XML
XML Validate XML
Aquest iniciarà la comprovació, tal i com s' ha descrit.
This will start the check, as described above.
Connector Validació XML de & kate; copyright 2002 de & Daniel. Naber; & Daniel. Naber. mail;.
& kate; Plugin XML Validation copyright 2002 & Daniel. Naber; & Daniel. Naber. mail;.
Documentació copyright 2002 de & Daniel. Naber;
Documentation copyright 2002 & Daniel. Naber;
Aquest connector suporta l' escriptura de fitxers & XML; a través del llistat de les etiquetes permeses i altres opcions.
This plugin supports writing & XML; files by listing allowed tags and more.
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 (pex; es llisten totes les entitats si el caràcter a l' esquerra del cursor és amp;). A més també és possible tancar l' etiqueta oberta més propera.
This plugin gives hints about what is allowed at a certain position in an & XML; file, according to the file's DTD. It will list possible elements, attributes, attribute values or entities, depending on the cursor position (eg; all entities are listed if the character on the left of the cursor is amp;). It's also possible to close the nearest open tag on the left.
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 Assigna la meta DTD.... Per a produir les vostres pròpies meta DTD, descarregueu dtdparse des de http: // dtdparse. sourceforge. net.
The DTD must exist in & XML; format, as produced by the Perl program dtdparse. We will call a DTD in this format meta DTD. Some meta DTDs are supplied. They are installed in $KDEDIR/ share/ apps/ katexmltools/, which is also the default folder when you choose Assign Meta DTD.... To produce your own meta DTDs, get dtdparse from http: / /dtdparse. sourceforge. net.
Com usar- lo
How to Use
Inicieu & kate; i obriu el diàleg de configuració sota Arranjament Configura Kate.... Aleshores trieu Compleció XML per a Kate, aquest apareixerà en la secció Aplicació / Connectors i tanqueu el diàleg. Després d' això, seleccioneu XML Assigna la Meta DTD. 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.
Start & kate; and open the configuration dialog under Settings Configure & kate;.... Then select Kate XML Completion which will appear in the Application / Plugins section and close the dialog. After that, select XML Assign Meta DTD.... If your document contains no DOCTYPE or the doctype is unknown, you'll have to select a meta DTD from the file system. Otherwise the meta DTD that matches the current document's DOCTYPE will be loaded automatically.
Ara podeu usar el connector mentre escriviu text:
You can now use the plugin while typing your text:
& lt; (clau menor que)
& lt; (less than key)
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 (pex; lt; htmlgt;).
This will trigger a list of possible elements unless the cursor is inside a tag already. Note that you currently cannot use this to insert the top level element (eg; lt; htmlgt;).
"(clau de cometes)
"(quote key)
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.
The quote key will trigger a list of possible attribute values (if there are some) if you are inside a tag.
(clau d' espai)
(space key)
Aquesta clau obrirà una llista de possibles atributs per a l' element actual si us trobeu dins d' una etiqueta.
This key will trigger a list of possible attributes for the current element if you are inside a tag.
& (clau de 'i')
& (ampersand key)
Aquest clau obrirà una llista d' entitats anomenades.
This key will trigger a list of named entities.
Característiques i limitacions
Features and Limitations
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.
You can test all functions and limitations by loading $KDEDIR/ share/ apps/ katexmltools/ testcases. xml into & kate; and following the instructions. Note that working with more than one view per document is not yet correctly supported by this plugin.
Ctrl; Retro; XML Insereix element...
Ctrl; Return XML...
Obrirà un diàleg que us permetrà inserir un element & XML;. Els caràcters & lt;, & gt; 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 compleció de tots els elements que es poden inserir en la posició actual del cursor si heu assignat una meta DTD mitjançant el menú Assigna la meta DTD....
This will open a dialog that lets you insert an & XML; element. The & lt;, & gt; characters and the closing tag will be inserted automatically. If you have selected text when this menu item is selected, the selected text will be surrounded by the opening and the closing tag. The dialog also offers completion of all elements that may be inserted at the current cursor position if you have assigned a meta DTD by using Assign Meta DTD....
Ctrl; lt; XML Tanca element
Ctrl; lt; XML Close Element
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ó.
This will search your text for a tag that is not yet closed and will close it by inserting the corresponding closing tag. The search starts at the cursor position and goes left. If it cannot find an open tag nothing will happen.
XML Assigna la meta DTD...
XML Assign Meta DTD...
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;.
This will tell the plugin which meta DTD to use for the current document. Note that this assignment will not be saved. You will have to repeat it when you start & kate; the next time.
El connector Compleció XML de & kate; copyright 2001, 2002 de & Daniel. Naber; & Daniel. Naber. mail;.
& kate; Plugin XML Completion copyright 2001,2002 & Daniel. Naber; & Daniel. Naber. mail;.
Documentació copyright 2001, 2002 de & Daniel. Naber;
Documentation copyright 2001,2002 & Daniel. Naber;
Expressions regulars
Regular Expressions
Aquest apèndix conté una breu però probablement suficient i completa introducció al món de les expressions regulars. Les documenta tal i com apareixen en el & kate;, donat que no són compatibles amb les expressions regulars de perl, ni de grep, per exemple.
This Appendix contains a brief but hopefully sufficient and covering introduction to the world of regular expressions. It documents regular expressions in the form available within & kate;, which is not compatible with the regular expressions of perl, nor with those of for example grep.
Les expressions regulars us proporcionen un mètode per a descriure el possible contingut d' una cadena de text de manera que pugui ser interpretada per una petita peça de programari, i d' aquesta manera es pugui esbrinar si un text es correspon amb el cercat i, en el cas d' aplicacions avançades, es posin els mitjans per a recuperar parts del text coincident.
Regular Expressions provides us with a way to describe some possible contents of a text string in a way understood by a small piece of software, so that it can investigate if a text matches, and also in the case of advanced applications with the means of saving pieces or the matching text.
Per exemple: Posem que voleu cercar un text que és el començament d' un paràgraf que inclou els noms Enric o Pere, seguits d' alguna forma del verb dir.
An example: Say you want to search a text for paragraphs that starts with either of the names Henrik or Pernille followed by some form of the verb say.
En una recerca normal, s' hauria de començar a cercar pel primer nom, Enric potser seguit de di, de la següent manera: Enric di, i mentre cerca coincidències, haureu de descartar aquelles que no estiguin al començament d' un paràgraf, així com aquelles en les que la paraula que comenci per di que no pertanyi al verb dir. I després tornar a repetir tot el procés amb el següent nom...
With a normal search, you would start out searching for the first name, Henrik maybe followed by sa like this: Henrik sa, and while looking for matches, you would have to discard those not being the beginning of a paragraph, as well as those in which the word starting with the letters sa was not either says, said or so. And then of course repeat all of that with the next name...
Amb les expressions regulars, aquesta tasca s' hauria de realitzar d' una sola recerca, i amb un alt grau de precisió.
With Regular Expressions, that task could be accomplished with a single search, and with a larger degree of preciseness.
Per a aconseguir- ho, les expressions regulars estableixen regles per expressar amb detall una generalització de la cadena a cercar. El nostre exemple el podríem expressar literalment com: Una línia que comença per Enric o per Pere (possiblement després de 4 espais en blanc o tabulacions) seguit d' un espai en blanc seguit de di i després u o gué, es podria expressar amb la següent expressió regular:
To achieve this, Regular Expressions defines rules for expressing in details a generalization of a string to match. Our example, which we might literally express like this: A line starting with either Henrik or Pernille (possibly following up to 4 blanks or tab characters) followed by a whitespace followed by sa and then either ys or id could be expressed with the following regular expression:
^ [\\ t] {0, 4} (Enric_BAR_Pere) di( u_BAR_gué)
^[ \\t]{0,4}(Henrik_BAR_Pernille) sa(ys_BAR_id)
L' exemple anterior mostra els quatre conceptes principals de les expressions regulars modernes, a veure:
The above example demonstrates all four major concepts of modern Regular Expressions, namely:
Patrons
Patterns
Declaracions
Assertions
Quantificadors
Quantifiers
Referències enrere
Back references
El barret (^) que es troba al començament de l' expressió és una declaració, que tan sols és certa si la resta de la cadena de recerca es troba al començament d' una línia.
The caret (^) starting the expression is an assertion, being true only if the following matching string is at the start of a line.
Les cadenes [\\ t] i (Enric_BAR_Pere) di( u_BAR_gué) són patrons. El primer és una classe de caràcters que coincideix amb un espai en blanc o amb una tabulació (horitzontal); l' altra patró conté un primer subpatró que coincideix amb Enric o amb Pere, després una part de coincidència exacta di i per últim un altra subpatró que coincideix amb u o amb gué
The stings [\\t] and (Henrik_BAR_Pernille) sa(ys_BAR_id) are patterns. The first one is a character class that matches either a blank or a (horizontal) tab character; the other pattern contains first a subpattern matching either Henrik or Pernille, then a piece matching the exact string sa and finally a subpattern matching either ys or id
La cadena {0, 4} és un quantificador que diu en qualsevol lloc des de 0 a 4 caràcters anteriors.
The string {0,4} is a quantifier saying anywhere from 0 up to 4 of the previous.
Com el programari d' expressions regulars suporta el concepte de referències enrere desa tota la part coincident de la cadena així com els subpatrons tancats entre parèntesis, proporcionant mitjans per accedir a aquestes referències, podem posar les nostres mans tant en la cadena coincident completa (quan es cerca al text d' un editor mitjançant una expressió regular, que normalment apareix marcada com a seleccionada) com en el nom trobat, o en la última part del verb.
Because regular expression software supporting the concept of back references saves the entire matching part of the string as well as sub-patterns enclosed in parentheses, given some means of access to those references, we could get our hands on either the whole match (when searching a text document in an editor with a regular expression, that is often marked as selected) or either the name found, or the last part of the verb.
Unint- ho tot, l' expressió coincidirà a on nosaltres vulguem, i tan sols allí.
All together, the expression will match where we wanted it to, and only there.
Les següents seccions descriuen amb detall com construir i usar patrons, classes de caràcters, declaracions, quantificadors i referències enrere, i la última secció presentarà una serie d' útils exemples.
The following sections will describe in details how to construct and use patterns, character classes, assertions, quantifiers and back references, and the final section will give a few useful examples.
Els patrons consten de cadenes literals i classes de caràcter. Els patrons poden contenir subpatrons, que són patrons tancats entre parèntesis.
Patterns consists of literal strings and character classes. Patterns may contain sub-patterns, which are patterns enclosed in parentheses.
Caràcters d' escapada
Escaping characters
En els patrons, així com en les classes de caràcter, alguns caràcters tenen un significat especial. Per aconseguir una coincidència literal amb algun d' aquests caràcters, és necessari marcar- los com a escapats per a permetre a l' intèrpret d' expressions regulars comprendre que aquests caràcters han de ser inclosos en el seu significat literal.
In patterns as well as in character classes, some characters have a special meaning. To literally match any of those characters, they must be marked or escaped to let the regular expression software know that it should interpret such characters in their literal meaning.
Això es fa precedint el caràcter d' una barra invertida (\\).
This is done by prepending the character with a backslash (\\).
El programari d' expressions regulars ignorarà l' escapat de qualsevol caràcter que no tingui cap significat especial en el context, així que escapar, per exemple, j (\\ j) no te per què causar problemes. Si teniu cap dubte sobre quan un caràcter pot tenir un significat especial, escapeu- lo amb seguretat.
The regular expression software will silently ignore escaping a character that does not have any special meaning in the context, so escaping for example a j (\\j) is safe. If you are in doubt whether a character could have a special meaning, you can therefore escape it safely.
L' escapat inclou el propi caràcter de la barra invertida. Per a poder presentar- la de forma literal, heu d' escriure\\\\.
Escaping of course includes the backslash character itself, to literally match a such, you would write\\\\.
Classes de caràcter i abreujaments
Character Classes and abbreviations
Una classe de caràcter és una expressió que coincideix amb un conjunt de caràcters definit. En les expressions regulars, les classes de caràcter s' estableixen col· locant els caràcters vàlids de la classe entre claudàtors [], o usant una de les classes abreujades que es descriuen a continuació.
A character class is an expression that matches one of a defined set of characters. In Regular Expressions, character classes are defined by putting the legal characters for the class in square brackets, [], or by using one of the abbreviated classes described below.
Les classes de caràcters simples tan sols contenen un o més caràcters literals, per exemple [abc] (que coincidirà amb les lletres a, b o c) o [0123456789] (que coincidirà amb qualsevol dígit).
Simple character classes just contains one or more literal characters, for example [abc] (matching either of the letters a, b or c) or [0123456789] (matching any digit).
Com les lletres i els números tenen un ordre lògic, ho podeu abreujar usant intervals: [a- c] és igual a [abc] i [0- 9] és igual a [0123456789]. Combinant aquestes construccions, per exemple [a- fynot1- 38] resulta completament vàlid (aquesta última hauria de coincidir amb qualsevol dels caràcters o dígits a, b, c, d, e, f, y, n, o, t, 1, 2, 3 o 8).
Because letters and digits have a logical order, you can abbreviate those by specifying ranges of them: [a-c] is equal to [abc] and [0-9] is equal to [0123456789]. Combining these constructs, for example [a-fynot1-38] is completely legal (the last one would match, of course, either of a, b, c, d, e, f, y, n, o, t, 1, 2, 3 or 8).
Com les lletres majúscules són caràcters diferents que els seus equivalents en minúscula, per a crear una classe de caràcter que sigui independent del format de les lletres, haureu d' escriure [aAbB].
As capital letters are different characters from their non-capital equivalents, to create a caseless character class matching a or b, in any case, you need to write it [aAbB].
De manera que és possible crear una classe negativa per a que es faci coincidir tot menys. Per a fer- ho inclogueu un barret (^) al començament de la classe:
It is of course possible to create a negative class matching as anything but To do so put a caret (^) at the beginning of the class:
[^abc] coincidirà amb qualsevol caràcter excepte amb a, b o c.
[^abc] will match any character but a, b or c.