natgillin/translations-raw huggingface dataset:
Aquesta secció és una introducció al format & XML; de definició de ressaltat. Descriu els components principals, el seu significat i utilització. La següent secció entra en detalls amb les regles de detecció.
This section is an overview of the Highlight Definition & XML; format. It will describe the main components and their meaning and usage, and go into detail with the detection rules.
La definició formal, és a dir, el DTD, es desa en el fitxer language. dtd, el qual hauria d' estar instal· lat en la carpeta $KDEDIR / share/ apps/ katepart/ syntax del vostre sistema.
The formal definition, aka the DTD is stored in the file language. dtd which should be installed on your system in the folder $KDEDIR / share/ apps/ kate/ syntax.
Principals seccions dels fitxers de definicions de ressaltat de & kate;
Main components of & kate; Highlight Definitions
section especifica la categoria.
The String attribute defines the set of characters.
kateversion especifica la última versió suportada per & kate;.
The String attribute defines the set of characters.
casesensitive defineix quan les paraules clau són o no sensibles a majúscules i minúscules.
The String attribute defines the set of characters.
author conté el nom de l' autor i la seva adreça de correu electrònic.
The String attribute defines the set of characters.
hidden defineix quan hauria d' aparèixer el nom en els menús de & kate;.
The String attribute defines the set of characters.
De manera que dita línia pot tenir un aspecte similar a:
A rule looks like this:
Les seccions al detall
The Rules in Detail
fallthroughContext especifica el context següent si no hi ha regles que coincideixin.
The String attribute defines the set of characters.
selColor defineix el color de la selecció.
The String attribute defines the set of characters.
Estils per omissió disponibles
Default Styles
dsChar, usat per a un caràcter.
The char attribute defines the character to match.
dsString, usat per a cadenes.
The String attribute defines the set of characters.
dsOthers, usat per a d ''altres 'coses.
The char attribute defines the character to match.
Cada regla pot coincidir en cap o amb varis caràcters del començament de la cadena amb la que es comparen. Si la regla coincideix, als caràcters coincidents se' ls assigna l' estil o attribute definit per la regla, tan mateix una regla pot demanar que es canviï el context actual.
Each rule can match zero or more characters at the beginning of the string they are asked to test. If the rule matches, the matching characters are assigned the style or attribute defined by the rule, and a rule may ask that the current context is switched.
& lt; NomRegla attribute=quot; (identificador) quot; context=quot; (identificador) quot; [atributs específics de la regla] / gt;
& lt; RuleName attribute=quot; (identifier)quot; context=quot; (identifier_BAR_order)quot; [rule specific attributes] / gt;
L 'attribute identifica l' estil que usaran els caràcters coincidents per nom, i el context identifica el context a usar des d' aquí.
The attribute identifies the style to use for matched characters by name or index, and the context identifies the context to use from here.
Un identifier, que és el nom dels altres contexts.
An identifier, currently only its zero-based index in the contexts group.
Algunes regles poden tenir regles fill que s' executen únicament si la regla pare resulta aplicable. A tota la cadena coincident se us donarà l' atribut definit per la regla pare. Una regla amb regles fills te aquest aspecte:
Some rules can have child rules which are then evaluated if and only if the parent rule matched. The entire matched string will be given the attribute defined by the parent rule. A rule with child rules looks like this:
Els atributs específics de la regla varien, i es descriuen en les següents seccions.
Rule specific attributes varies and are described in the following list.
Atributs comuns
& lt; HlCOct (common attributes) / gt;
attribute: Un mapa d' atributs d' un definit itemData.
The attribute and context attributes are common to all rules.
& lt; DetectChar char=quot; (caràcter) quot; (atributs comuns) (dinàmic) / gt;
& lt; DetectChar char=quot; (character)quot; (common attributes) / gt;
& lt; Detect2Chars char=quot; (caràcter) quot; char1=quot; (caràcter) quot; (atributs comuns) (dinàmic) / gt;
& lt; Detect2Chars char=quot; (character)quot; char1=quot; (character)quot; (common attributes) / gt;
& lt; StringDetect String=quot; (cadena) quot; [insensitive=quot; true_BAR_falsequot;] (atributs comuns) (dinàmic) / gt;
& lt; StringDetect String=quot; (string)quot; [insensitive=quot; TRUE_BAR_FALSE; quot;] (common attributes) / gt;
L' atribut String defineix la cadena a comparar. L' atribut insensitive per omissió és a false i es passa a la funció de comparació de cadena. Si el valor és true la comparació no serà sensible a majúscules i minúscules.
The String attribute defines the string to match. The insensitive attribute defaults to FALSE and is fed to the string comparison function. If the value is TRUE insensitive comparing is used.
& lt; RegExpr String=quot; (cadena) quot; [insensitive=quot; true_BAR_falsequot;] [minimal=quot; true_BAR_falsequot;] (atributs comuns) (dinàmic) / gt;
& lt; RegExpr String=quot; (string)quot; [insensitive=quot; TRUE_BAR_FALSE; quot;] [minimal=quot; TRUE_BAR_FALSEquot;] (common attributes) / gt;
insensitive per omissió és a false i és passada al motor d' expressions regulars.
insensitive defaults to FALSE and is fed to the regular expression engine.
minimal per omissió és a false i és passada al motor d' expressions regulars.
minimal defaults to FALSE and is fed to the regular expression engine.
keyword
Keyword
& lt; Int (atributs comuns) (dinàmic) / gt;
& lt; Int (common attributes) / gt;
Aquesta regla no te atributs específics. Les regles fill normalment s' usen per a detectar combinacions de L i U després del número, indicant el tipus d' enter en el codi del programa. En realitat s' admeten totes les regles com a regles fill, tot i que, el DTD tan sols permet la regla fill StringDetect.
This rule has no specific attributes. Child rules are typically used to detect combinations of L and U after the number, indicating the integer type in program code.
Aquesta regla no te atributs específics. Es permet AnyChar com a regla fill i normalment s' usa per a detectar combinacions, mireu la regla Int com a referència.
This rule has no specific attributes. Child rules are typically used to detect combinations of L and U after the number, indicating the integer type in program code.
& lt; HlCHex (atributs comuns) / gt;
& lt; HlCOct (common attributes) / gt;
Localitza representacions literals de caràcters que s' usen habitualment en el codi de programació, per exemple\ (nova línia) o\\ t (TAB).
It matches letteral representations of invisible characters commonly used in program code, for example\ (newline) or \\t (TAB).
Els següents caràcters coincideixen amb la regla si segueixen a una barra invertida (\\): abefnrtvquot; '?\\. A més seran vàlids els números hexadecimals escapats com per exemple\\ xff, i els números octals escapats, per exemple\\ 033.
The following characters will match if they follow a backslash (\\): abefnrtvquot; '?. Additionally, escaped hexadecimal numbers like for example \\xff and escaped octal numbers, for example \\033 will match.
HlCChar
HlCStringChar
Detecta un caràcter C.
Detect an escaped character.
& lt; HlCChar (atributs comuns) / gt;
& lt; HlCOct (common attributes) / gt;
char defineix el caràcter que inicia l' interval, char1 el caràcter que finalitza l' interval.
char defines the character starting the range, char2 the character ending the range.
És molt útil per a detectar per exemple petites cadenes entre cometes i similars, però tingueu en compte que el motor de ressaltat tan sols pot treballar amb una cada vegada, així que no es detectaran cadenes que estiguin dividides en dues línies o més.
Useful to detect for example small quoted strings and the like, but note that since the hl engine works on one line at a time, this will not find strings spanning over a line break.
L' atribut context defineix el context a incloure.
The char attribute defines the character to match.
DetectSpaces
Detect2Chars
& lt; DetectSpaces (atributs comuns) / gt;
& lt; Int (common attributes) / gt;
& lt; DetectIdentifier (atributs comuns) / gt;
& lt; Int (common attributes) / gt;
La finestra principal de & kate; és una finestra d' aplicació estàndard de & kde;, amb l' afegit de subfinestres ancorables o vistes d' eina. Teniu una barra de menú amb tots els menús comuns i algun més, i una barra d' eines que proveeix accés a les ordres usades amb més freqüència.
The & kate; Main Window is a standard & kde; application window, with the addition of dockable subwindows, or tool windows. It has a Menubar with all the common menus, and some more, and a toolbar providing access to commonly used commands.
La part més important de la finestra és l' àrea d' edició, que per omissió mostra un únic component d' edició de text, en el qual podreu treballar amb els vostres documents.
The most important part of the window is the Editing Area, by default displaying a single text editor component, in which you can work with your documents.
La llista de documents
The File Selector
El selector de fitxers
The File List
I possiblement d' altres vistes d' eina, per exemple les que són proveïdes pels connectors.
And possibly other tool windows, for example provided by plugins.
En dividir un editor en dos marcs, aquest es divideix en dos marcs de la mateixa grandària i ambdós mostraran el document que s' està editant en aquell moment. El nou marc estarà a la part inferior (en el cas d' una divisió horitzontal) o a la part dreta (si la divisió és vertical). El nou marc obtindrà el focus, el qual es representa visualment per un petit indicador verd en el marc mateix.
When splitting an editor into two frames, it is divided into two equally sized frames, both displaying the current document of that editor. The new frame will be at the bottom (in the case of a horizontal split) or at the right (for a vertical split). The new frame gets the focus, which is visualised by a small green led in the focused frame.
La llista de fitxers mostra una llista de tots els documents oberts actualment en el & kate;. Els fitxers modificats tindran una petita icona d' un disquet a la seva esquerra per a indicar el seu estat.
The file list displays a list of all documents currently open in & kate;. Modified files will have a small floppy disk icon on their left to indicate that state.
La localització per omissió en la finestra del & kate; és a la part inferior, a sota de l' àrea d' edició.
The default location in the & kate; window is at the bottom, below the editing area.
El selector de fitxers és un visor de carpetes, que us permet obrir fitxers des d' una carpeta mostrada en el marc actual.
The File Selector is a folder viewer, allowing you to open files from a displayed folder in the current frame.
De d' alt a baix, el selector de fitxers consisteix dels següents elements:
From top down, the file selector consist of the following elements:
L' emulador de terminal encastat és una còpia a conveniència de l' aplicació de terminal; konsole; del & kde;. Aquesta està disponible des de l' ítem del menú Arranjament Mostra finestra de terminal o prement la tecla F7 i n' obtindreu el focus quan es mostri. De forma addicional, si teniu habilitada l' opció Sincronitza l' emulador de terminal amb el document actiu, aquesta farà que es canviï cap al directori del document actual en el cas d' existir o quan aquest canviï.
The built in Terminal Emulator is a copy of the & kde; & konsole; terminal application, for your convenience. It is available from the Settings Show Terminal Emulator menu item or by pressing the F7 key, and will get the focus whenever displayed. Additionally, if the Sync & konsole; with active document option is enabled, it will change into the directory of the current document if possible when it is displayed, or when the current document changes.
Podeu configurar la & konsole; emprant el seu menú en el & BDR;, per a més informació, consulteu el manual de & konsole;.
You can configure the & konsole; using it 's & RMB; menu, for more information, see the & konsole; manual.
La llista de fitxers
File list
Treballar amb connectors
Working with Plugins
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 cause repeat all of that with the next name...
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 generalisation 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:
L' escapat inclou el propi caràcter de la barra invertida. Per a poder presentar- la de forma literal, heu d' escriure\\\\.
Escaping of cause includes the backslash character it self, to literally match a such, you would write\\\\.
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 cause, either of a, b, c, d, e, f, y, n, o, t, 1, 2, 3 or 8).
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 cause possible to create a negative class matching as anything but To do so put a caret (^) at the beginning of the class:
Per exemple, si desitgeu trobar dues ocurrències de la mateixa paraula separades per una coma i possiblement algun espai en blanc, podeu escriure (\\ w+),\\ s *\\ 1. El subpatró\\ w+ localitzarà un conjunt de caràcters d' una paraula, i tota la expressió coincidirà si aquest conjunt va seguit d' una coma, 0 o més espais en blanc i després un conjunt de caràcters d' una paraula igual al primer (la cadena\\ 1 fa referència al primer subpatró delimitat per parèntesis).
For example, it you want to find two occurrences of the same word separated by a comma and possibly some whitespace, you could write (\\w+), \\s*\\1. The sub pattern \\w+ would find a chunk of word characters, and the entire expression would match if those were followed by a comma, 0 or more whitespace and then an equal chunk of word characters. (The string \\1 references the first sub pattern enclosed in parentheses)
Quan s' usen quantificadors sense màxim, les expressions regulars intenten coincidir amb la major part possible de la cadena cercada, coneguen- se aquest comportament com a avariciós.
When using quantifiers with no maximum, regular expressions defaults to match as much of the searched string as possible, commonly known as greedy behaviour.
El programari modern d' expressions regulars proporciona els mitjans per a desactivar l' avarícia, tot i que en els entorns gràfics dependrà de la interfície al tenir accés a aquesta característica. Per exemple, un diàleg de recerca que permeti expressions regulars, podria tenir una casella de comprovació anomenada Coincidència mínima. a més, hi podria haver una indicació quant a que el comportament per omissió és d' avarícia.
Modern regular expression software provides the means of turning off greediness, though in a graphical environment it is up to the interface to provide you with access to this feature. For example a search dialogue providing a regular expression search could have a check box labelled Minimal matching as well as it ought to indicate if greediness is the default behaviour.
Algunes declaracions actuals no tenen un patró amb el que coincidir, però la part coincident de la cadena no serà part del resultat de la coincidència de l' expressió completa.
Some assertions actually does have a pattern to match, but the part of the string matching that will not be a part of the result of the match of the full expression.
Això vol dir que coincidirà, per exemple, dins de les paraules: L' expressió\\ Bin\\ B coincidirà en window però no en integer o en I' m in love.
That means that it will match for example within words: The expression \\Bin\\B will match at in window but not in integer or I 'm in love.
La documentació per a & kbugbuster; encara no ha estat finalitzada quan s' ha instal· lat el & kde; en aquest ordinador.
The documentation for & kappname; was not finished when & kde; was installed on this computer.
Diff
KDE
& kompare;
Kompare
La versió 1. 0 ja oferia un munt de funcionalitats, però després el projecte va ser revisat a la universitat del Paul; altres desenvolupadors van poder unir- se i van començar a fer valuoses aportacions al UML Modeller, com ara el canvi de un format de fitxer binari a un fitxer & XML;, implementació per més tipus de diagrames & UML;, generació del codi i importació del codi simplement per anomenar- ne unes quantes.
Version 1.0 already offered a lot of functionality, but after the project had been reviewed at Paul 's University, other developers could join and they started making valuable contributions to UML Modeller, like switching from a binary file format to an & XML; file, support for more types of & UML; Diagrams, Code Generation and Code Import just to name a few.
& umbrello; pot generar codi font per diversos llenguatges de programació basat en el vostre model & UML; per ajudar- vos a començar amb la implementació del vostre projecte. El codi generar consisteix en la declaració de les classes, amb els seus mètodes i atributs, de manera que pugueu emplenar els espais en blanc proporcionant la funcionalitat de les operacions de les classes.
& umbrello; can generate source code for various programming languages based on your & UML; Model to help you get started with the implementation of your project. The code generated consists of the class declarations, with their methods and attributes so you can fill in the blanks by providing the functionality of your classes 'operations.
La opció Inclou els fitxers de capçalera des de la carpeta permet inserir una capçalera a l' inici de cada fitxer generat. Les fitxers de capçalera poden contenir informació del copyright o informació de la llicència i contenir variables que son avaluades en temps de generació. Podeu fer un cop d' ull a la plantilla de fitxers de capçalera empaquetada amb & umbrello; per veure com usar aquestes variables per reemplaçar el vostre nom o la data actual en temps de generació.
The Include heading files from folder option allows you to insert a heading at the beginning of each generated file. Heading files can contain copyright or licensing information and contain variables that are evaluated at generation time. You can take a look at the template heading files shipped with & umbrello; to see how to use this variables for replacing your name or the current date at generation time.
Per importar classes en el model, seleccioneu l' entrada Importa classes... del menú Codi. En el diàleg de fitxer seleccioneu els fitxers que contenen la declaració de classes C++ i premeu Obre. S' importaran les classes i podreu trobar- les com a part del model en la vista d' arbre. Noteu que & umbrello; no crearà cap tipus de diagrama per a mostrar les classes, només s' importaran en el model de manera que podeu usar- les mes tard en qualsevol diagrama que vulgueu.
To import classes into your Model, select the entry Import Classes... from the Code menu. In the file dialogue select the files containing the C++ class declarations and press OK. The classes will be imported and you will find them as part of your Model in the Tree View. Note that & umbrello; will not create any kind of Diagram for showing your classes, they will only be imported into your Model so that you can use them later in any diagram you want.
& umbrello; permet imprimir diagrames individuals. Premeu el botó Imprimeix de la barra d' eines de l' aplicació o seleccioneu la opció Imprimeix del menú Fitxer i obtindreu un menú d' impressió estàndard del & kde; des d' on podreu imprimir els vostres diagrames.
& umbrello; allows you to print individual diagrams. Press the Print button on the application toolbar or selecting the Print option from the File menu will give you a standard & kde; Print dialogue from where you can print your diagrams.
Per organitzar millor el model, especialment per a projectes grans, podeu crear carpetes lògiques el la vista d' arbre. Simplement seleccioneu l' opció Nou Carpeta del menú contextual de les carpetes predeterminades de la vista d' arbre per crear- le. Les carpetes poden estar imbricades, i podeu moure objectes arrossegant- los i deixant- los anar des d' una carpeta a una alta.
To better organise your model, especially for larger projects, you can create logical folders in the Tree View. Just select the option New Folder from the context menu of the default folders in the Tree View to create them. Folders can be nested, and you can move objects around by dragging them from one folder and dropping them into another.
Organització del model amb carpetes
Organising your Model with Folders
Organització del model amb carpetes lògiques en & umbrello;
Organising a Model with Logical Folders in & umbrello;
El llenguatge unificat de modelat (UML;) és un llenguatge per fer diagrames o notació per especificar, visualitzar i modelar documents de sistemes de programari orientat a objectes. & UML; no és un mètode de desenvolupament, això significa que no us diu el que heu de fer primer i el que heu de fer a continuació o com heu de dissenyar el sistema, però us ajuda a visualitzar el vostre disseny i comunicar- vos amb els altres. & UML; és controlat pel grup Object Management (OMG) i és l' estàndard de l' industria per descriure gràficament el programari.
The Unified Modelling Language (UML;) is a diagramming language or notation to specify, visualise and document models of Object Oriented software systems. & UML; is not a development method, that means it does not tell you what to do first and what to do next or how to design your system, but it helps you to visualise your design and communicate with others. & UML; is controlled by the Object Management Group (OMG) and is the industry standard for graphically describing software.
Diagrames de relació d' entitats mostren les dades i les relacions i les restriccions entre les dades.
Class Diagrams show classes and the relationships between them
Generalització especifica que un cas d' ús hereta les característiques del cas d' ús superior, i pot substituir- ne una part o afegir- ne de noves de manera similar a l' herència entre classes.
Generalisation specifies that a Use Case inherits the characteristics of the Super -Use Case, and can override some of them or add new ones in a similar way as the inheritance between classes.