natgillin/translations-raw huggingface dataset:
A continuació se us mostrarà com crear barres d' eines per a un & DTEP;. Les barres d' eines són elements gràfics que són assignats a accions. Les accions, en & quantaplus;, són la base per a gairebé totes les extensions que té & quantaplus; i que obtindreu en el futur. El mateix mecanisme que defineix una acció en & quantaplus; també habilita l' autocompleció i els diàlegs de les etiquetes. Amb les accions, el límit del que voleu fer és virtualment il· limitat. A veure un exemple, usarem HTML; tidy en les nostres pàgines web.
The following will show you how to create toolbars for a & DTEP;. Toolbars are graphical elements that are assigned to actions. Actions, in & quantaplus;, are the basis for nearly all the extensions that & quantaplus; has and will acquire in the future. The same mechanism that defines an action in & quantaplus; also enables auto-completion and tag dialogs. With actions, the limit of what you can do is virtually limitless. For means of an example, we will use HTML; tidy on our web pages.
Del no res al complet
From Scratch to Complete
Per a començar, ens caldrà crear una barra d' eines d' usuari. Seleccioneu Barres d' eines Afegir barra d' eines d' usuari.
To begin, you will need to create a user toolbar. Select Toolbars Add User Toolbar.
Si hi ha masses etiquetes per al llenguatge de marcat, es recomana dividir les etiquetes en grups lògics. Haureu de crear una nova barra d' eines d' usuari per a cada grup. En aquest cas, no n' hi ha moltes, així que crearem una barra d' eines i l' anomenarem amb el nom del marcat.
If there are many tags for the markup language, it is recommended that you split up the tags into logical groups. You will need to create a new user toolbar for each group. In this case, there are not many, so we will be making one toolbar and naming it with the name of the markup.
Una vegada heu creat les barres d' eines, heureu d' afegir i configurar les accions. Per a fer- ho, escolliu Arranjament Configura accions.
Once all your toolbars are created, you must add and configure the actions. To do this, select Settings Configure Actions.
Les parts d' aquesta finestra són força fàcils. Feu clic al botó Acció nova al final de la finestra per a entrar en el mode d' edició.
The parts of this window are pretty straight forward. Press the New action button at the bottom of the window to enter the editing mode.
Ompliu tots els camps necessaris i afegiu l' etiqueta a la( es) barra( es) d' eines adequada.
Fill in all of the necessary fields and add the tag to the appropriate toolbar(s).
Completar la resta i, si l' etiqueta conté atributs i penseu usar- los sempre, marqueu la caixa Executa diàleg "Edita etiqueta" si es pot per a que es mostri cada vegada que s' usi l' acció.
Complete the rest and, if the tag has attributes and you always plan to use them, check the Run "Edit tag" dialog if available box so that you will be prompted every time the action is used.
Ara hauríeu de tenir quelcom semblant al següent.
You should now have something much like the following.
Premeu el botó Aplica i veureu afegida l' acció a la( es) barra( es) d' eines que heu seleccionat.
Press the Apply button and you will see the action added to the toolbar(s) you have selected.
Vaja! És una icona horrible. Com recordaré que aquesta icona representa aquesta acció? La substituïm abans de trobar problemes.
Egad! That's an awful icon. How will yourself and others remember that icon goes with that action? Let's replace it before trouble arises.
Per a crear una icona que descrigui amb major precisió aquesta acció, usarem & kiconedit;. Seleccioneu- lo des del & kmenu;, Gràfics Més aplicacions (o allà a on l' ha col· locat la vostra distribució).
To create an icon that more accurately describes that action, we will be using & kiconedit;. Select it from the & kmenu;, Graphics More Programs (or where ever your distribution placed it).
& kiconedit; fa que la mida per omissió sigui 32x32 píxels, però el que ens cal és 22x22. Per a canviar- la, seleccioneu Edita Dimensiona.
& kiconedit; defaults to the size 32x32 pixels, but we need 22x22. To change this, select Edit Resize.
Tingueu present que creareu una icona que no tan sols us ajudarà a vos mateix a recordar el que fa una acció, si no també a d' altres usuaris del & DTEP;.
Keep in mind that you are creating an icon that will assist in helping not only yourself to remember which action does what, but also other users of the & DTEP;.
Ja que l' etiqueta per a la que estic creant la icona s' anomena inici, he decidit crear un símbol d' inici. Usant el color verd (el verd sovint s' interpreta com a vés, comença o procedeix) haurà, o almenys, hauria de transmetre a l' usuari el missatge de que al fer clic sobre aquesta acció posarà l' etiqueta & lt; inicigt; en el document actual.
Since the tag I am creating the icon for is called start, I have decided to create a Start sign. Using the color green (green often interpreted as go, start, or proceed) will, or, at least, should, convey a message to the user that clicking this action will place the & lt; startgt; tag in the current document.
Ara que he finalitzat de crear la icona, la deso.
Now that I am finished with the creation of the icon, I will save it.
Una vegada creada( es) la( es) icona( es), haureu d' associar la icona amb l' acció. Per a fer- ho, torneu a obrir Arranjament Configura accions (en & quantaplus;) i seleccioneu l' acció per a la que heu creat la icona. Al costat del camp Text veureu un botó, feu- hi clic.
Once you are done with creating the icon(s), you must associate the icon with the action. To do this, open Settings Configure Actions again (in & quantaplus;) and select the action you made the icon for. Beside the Text field, you will see a button, click it.
Seleccioneu Altres icones i després feu clic sobre el botó Navega.
Select Other Icons and then click the Browse button.
Aneu a la carpeta en la que heu desat la icona, seleccioneu- la i feu clic a Bé.
Goto the folder in which you saved the icon, select the icon, and click OK.
Premeu el botó Aplica i seguiu fent el mateix amb les altres etiquetes, si n' hi ha, o bé feu clic sobre Bé per a finalitzar.
Press the Apply button and either continue to do the same with the other tags, if any, or click OK to finish.
Posem que us agradaria afegir algunes funcions comunes de & quantaplus; a la vostra barra d' eines o potser penseu que la barra d' eines podria estar més ben organitzada, amb separadors per agrupar les accions. Obriu el diàleg Configura barres d' eines usant Arranjament Configura barres d' eines. Assegureu- vos de que està seleccionada la vostra barra d' eines.
Let us say you would like to add some common & quantaplus; functions to your toolbar or maybe you think the toolbar would be better off organized in a different manner with some separators to group the actions. Open the Configure Toolbars dialog by going Settings Configure Toolbars. Make sure your toolbar is selected.
Escolliré el separador (a dalt de la columna esquerra) per a la meva barra d' eines. Una vegada heu seleccionat l' element que voleu afegir a la barra d' eines, premeu el botó de cursor dret. Tot seguit s' afegirà a la vostra barra d' eines.
I will be choosing the separator (top of the left column) for my toolbar. Once you have selected the item you wish to add to your toolbar, press the right arrow button. This will add it to your toolbar.
Suposo que us agradaria tenir una manera d' accedir ràpidament a Veure amb Konqueror. El selecciono i l' afegeixo a la barra d' eines,
I think I would like a quick way to access the Konqueror Preview. I will select it and add it to the toolbar.
Mireu com el separador ajuda a agrupar. Algú que tingui un primer contacte amb la meva barra d' eines podria haver pensat que el botó de & konqueror; era igual o el contrari al botó de començament.
Note how the separator helps in grouping. Someone new to my toolbar might have thought that the & konqueror; button was like or the opposite of the start button.
Apliqueu els vostres canvis i, quan ho tingueu fet, premeu Bé per a finalitzar.
Apply your changes and, when you are done, press OK to finish.
Ah, mireu quant de fantàstica és la barra d' eines nova! Ara es molt més útil.
Ah, look at the fantastic new toolbar! Much more handy now.
Recordeu provar la vostra barra d' eines, fent clic sobre tots els botons per a verificar que la sortida és correcta.
Remember to test your toolbar, by clicking all the buttons, so that you know the output is correct.
Ara, per a desar la barra d' eines, escollirem Barres d' eines Desa barres de eines Desa com a barra d' eines local.
Now to save the toolbar, we will select Toolbars Save Toolbars Save as Local Toolbar.
Desar- la a la carpeta adequada. Ja que no hi ha NeXML, la desaré en la carpeta principal, però hauríeu de desar les vostres barres d' eines en la carpeta adequada. Assegureu- vos d' ajustar el vostre & descriptionrc; per a que carregi la( es) vostra( es) barra( es) d' eines quan es crei un fitxer nou d' aquest tipus.
Save it to the correct folder. Since NeXML does not exist, I will just have it to the top-level folder, but your toolbar(s) should be saved to the correct folder. Make sure to adjust your & descriptionrc; to have it load your toolbar(s) when a new file of that type is created.
Crear la vostra pròpia documentació
Creating Your Own Documentation
Probablement els afegits més notables en & quantaplus; per a l' usuari general siguin l' afegit de documentació per al llenguatge de marcat o d' script que preferiu. Amb aquesta finalitat, aquest capítol explicarà com he creat l' arbre de documentació & PHP; per al meu ús personal.
Probably the most notable additions to & quantaplus; for the general user will be the addition of documentation for the markup or scripting language that you like best. To that end, this chapter will explain how I create the & PHP; documentation tree for my personal use.
Abans de començar a crear la vostra pròpia documentació, potser voleu comprovar el repositori de & quantaplus; per a veure si algú ja ho ha fet.
Before starting on creating your own documentation, you may wish to check out the & quantaplus; repository to see if someone else has already done this set.
Hi ha dues parts en aquest procés. Primer, obtenir la documentació existent per al llenguatge de marcat/ script/ etc; que preferiu. Segon, heu de crear el fitxer docrc. El primer es cosa vostra, el segon és el que es tracta aquí.
There are two parts to this process. First, you must obtain the existing documentation for the markup/ scripting/ etc; language that you prefer. Second, you have to create the docrc file. The first is up to you, the second is what we will cover here.
La forma general del fitxer docrc és la següent:
The general form of the docrc file is as follows:
# Fitxer de configuració del KDE [Tree] Doc dir= ruta, relativa a aquest fitxer, dels fitxers html de la documentació & pex; php42 / # elements de nivell superior Top Element= La vostra descripció d' aquesta documentació & pex; & PHP; 4. 2 documentation Section 1=Section1. html Section 2=# Sec2. 1, # Sec2. 2, # Sec2. 3 Sec2. 1=Sec2. 1. html Sec2. 2=Sec2. 2. html Sec2. 3=Sec2. 3. html... [Context] ContextList=func1, func2, tag1, tag2, tag3 func1=func1. html func2=func2. html tag1=tag1. html tag2=tag2. html tag3=tag3. html
#KDE Config File [Tree] Doc dir= path, relative to this file, of the documentation html files & eg; php42/ #top level elements Top Element= Your description for these documentation & eg; & PHP; 4.2 documentation Section 1=Section1. html Section 2=#Sec2.1, #Sec2.2, #Sec2.3 Sec2.1=Sec2.1. html Sec2.2=Sec2.2. html Sec2.3=Sec2.3. html... [Context] ContextList=func1, func2, tag1, tag2, tag3 func1=func1. html func2=func2. html tag1=tag1. html tag2=tag2. html tag3=tag3. html
El docrc està dividit en dues seccions: L' arbre i el context.
The docrc is broken down into two sections: Tree and Context.
La secció 'Tree' (arbre) defineix l' aspecte de la presentació de la documentació en la pestanya de documentació. Per exemple, veureu que en la documentació & PHP; teniu quelcom semblant a això:
The Tree section defines the presentation aspect of the documentation in the documentation tab. For example, you will see that in the & PHP; documentation you have something akin to this:
En relació a l' anterior, el meu docrc de & PHP; té aquest aspecte:
Relating this to the above, my & PHP; docrc looks like this:
# Fitxer de configuració del KDE [Tree] Doc dir=php42 / # elements de nivell superior Top Element=PHP 4. 2 documentation PHP 4. 2 documentation=Table of Contents, # Getting Started, # Language Reference Table of Contents=index. html Getting Started=Introduction,... Introduction=introduction. html... Language Reference=Basic syntax,... Basic syntax=language. basic- syntax. html...
#KDE Config File [Tree] Doc dir=php42/ #top level elements Top Element=PHP 4.2 documentation PHP 4.2 documentation=Table of Contents, #Getting Started, #Language Reference Table of Contents=index. html Getting Started=Introduction,... Introduction=introduction. html... Language Reference=Basic syntax,... Basic syntax=language. basic-syntax. html...
Tingueu present el # que està davant de Getting Started (començar) i de Language Reference (referència del llenguatge). Indica que són subcontenidors de l' arbre i tenen contingut propi. No crec que hi hagi establert un límit de profunditat (més del que sigui raonable) & mdash; empreu el vostre bon judici.
Notice the # in front of Getting Started and Language Reference. This indicates that these are sub containers in the tree and have content of their own. I do not believe that there is a set limit to the depth here (other than that driven by sanity) & mdash; use your judgment.
Per a la Taula de contingut, haureu notat que es fa referència directa a un fitxer (i per tant, es mostra al final de la vista en arbre & mdash; les carpetes primer!).
For the Table of Contents, you will notice that it is referenced directly to a file (and consequently shows up at the bottom of the tree view & mdash; folders first!).
Els espais no afecten negativament a res, però tingueu cura amb els caràcters & i & lt;. Els heu de substituir amb & amp; i & lt; respectivament en tots els fitxers de recursos de & quantaplus; basats en & XML;.
Spaces do not adversely affect anything, but watch out for & and & lt; characters. These should likely be replaced by & amp; and & lt; respectively in all of the & XML; based & quantaplus; resource files.
Context és la secció del fitxer docrc que s' usa per a facilitar l' ajuda de context. Per exemple, si esteu escrivint un script & PHP; i us agradaria veure la documentació per a la funció mysql_ fetch_ array. Simplement ressalteu la funció i després premeu Ctrl; H per accedir a l' ajuda de context. Immediatament es mostrarà la documentació de mysql_ fetch_ array. Aquí tan sols hi ha dos tipus d' entrades: ContextList i les línies d' associació de fitxers.
The Context section is the section of the docrc file that is used to facilitate context sensitive help. For example, you are writing a & PHP; script and you would like to see the documentation for the mysql_fetch_array function. You simply highlight the function and then press Ctrl; H for context help. The documentation on mysql_fetch_array will immediately display. There are only two entry types here: the ContextList and the file association lines.
ContextList
ContextList
Realment simple. És una llista separada per comes amb els elements del context que voleu que estiguin disponibles (per a & PHP;, són les funcions pròpies de & PHP;).
Really simple, this is just a comma separated list of the context items you wish to have available (for & PHP;, these are the functions for & PHP;).
Línies d' associació de fitxers
File association lines
Són de la forma element_ de_ context=pàgina_ de_ doc_ html ». & pex;, acos=function. asoc. html
These are of the form context item=html doc page. & eg; acos=function. acos. html
Una versió reduïda de la secció Context del meu docrc és:
A pared down version of my docrc Context section is as follows:
# Paraules clau per a l' ajuda de context [Context] ContextList=abs, acos, acosh, addcslashes, addslashes,... abs=function. abs. html acos=function. acos. html acosh=function. acosh. html addcslashes=function. addcslashes. html addslashes=function. addslashes. html...
#Keywords for context help [Context] ContextList=abs, acos, acosh, addcslashes, addslashes,... abs=function. abs. html acos=function. acos. html acosh=function. acosh. html addcslashes=function. addcslashes. html addslashes=function. addslashes. html...
Ara podeu desar el vostre fitxer docrc. Deseu- lo en $HOME /. kde/ share/ apps/ quanta/ doc o $KDEDIR / share/ apps/ quanta/ doc per a ús local o global respectivament. Després, creeu una carpeta (la que heu especificat en el vostre fitxer docrc) en la mateixa carpeta que el vostre fitxer docrc i copieu- hi les vostres pàgines & HTML;.
Now you can just save your docrc file, save it in $HOME /. kde/ share/ apps/ quanta/ doc or $KDEDIR / share/ apps/ quanta/ doc for local or global use respectively. Then create a folder (the one specified in your docrc file) in the same folder as your docrc file and copy your & HTML; pages in there.
Caldrà reiniciar el & quantaplus; per a veure la vostra documentació.
You will need to restart & quantaplus; to see your documentation.
Una vegada esteu segur de que és prou bo per a compartir- lo, envieu el fitxer docrc junt amb una descripció de qualsevol informació pertinent sobre quins documents heu usat al repositori de & quantaplus; per a que el pugui usar la comunitat de & quantaplus;. No us fareu ric, però us sentireu gran sabent que heu contribuït al desenvolupament de la millor plataforma de desenvolupament web.
Once you are sure that they are good and worth sharing, send the docrc file along with a description of any pertinent information on what documentation you used to the quantaplus; repository for use by the & quantaplus; community. You will not get rich, but you will feel great knowing that you contributed to the best web development platform around.
Compartir recursos
Sharing Resources
Amb & quantaplus; no us sentireu sòl. És possible compartir amb els demés els diversos recursos (paquets DTEP, barres d' eines amb accions, scripts, plantilles). Hi ha dues formes de fer- ho:
With & quantaplus; you are not alone. It is possible to share the various resources (DTEP packages, toolbars with actions, scripts, templates) with others. There are two ways to do it:
Enviar per correu- e
Sending in Email
Els recursos es poden enviar per correu electrònic als vostres amics, companys o a qui es vulgui. Podeu accedir a l' entrada del menú Envia per correu- e des de varis llocs, com DTD Envia el paquet de la DTD (DTEP) per correu- e, Barres d' eines Envia la barra d' eines per correu electrònic, en el menú de context dels fitxers i carpetes en els arbres Plantilles i Scripts.
The resources can be sent in email to your friends, partners or to whomever you want. You will see the Send in Email menu entries in various places, like DTD Send DTD Package (DTEP) in Email, Toolbars Send Toolbar in Email, in the context menu of the files and folders in the Templates and Scripts tree.
Publicar en el servidor principal
Uploading to the main server
Els recursos es poden publicar en el repositori principal, des d' on els poden descarregar tots els demés usuaris de & quantaplus;. Els enviaments es revisen i tan sols es publiquen si el nostre equip els considera correctes i d' utilitat. Per a fer un enviament vàlid, es suggereix signar els recursos, per al que us caldrà una clau GPG/ PGP. Aquesta informació s' usa per a que tant el nostre equip com aquells que la descarreguin puguin verificar l' origen.
The resources can be uploaded to our main repository, from where all other & quantaplus; users can download them. The submissions are reviewed and made available only if our team considers correct and useful will be published. In order to make a valid submission it is suggested to sign the resources, thus you need a GPG/ PGP key. This information is used to verify the origin of the resources both by our team and by the downloaders.
Per a saber com obtenir els recursos des del servidor principal, podeu veure.
About getting the resources from the main server see.
Quan aneu a publicar, se us demanarà una frase de pas per a la vostra clau GPG secreta (la frase de pas no serà desada) o, en el cas de que tingueu més claus secretes, podreu escollir la que voleu usar. En la caixa de diàleg Compartir les novetats, ompliu els camps d' entrada (l 'URL de la vista prèvia pot romandre buit) i inicieu la publicació fent clic sobre Bé.
When uploading you will be asked to enter the passphrase for your secret GPG key (the passphrase will not be stored), or in the case of having more secret keys, you will be able to pick up the one you want to use. In the Share Hot New Stuff dialog fill the input fields (the Preview URL may remain empty) and start the upload by clicking OK.
Es pot iniciar la publicació des de DTD Publica paquet de DTD (DTEP), Barres d' eines Publica barra d' eines, en el menú de context dels fitxers i de les carpetes en els arbres Plantilles i Scripts.
The upload can be initiated from DTD Upload DTD Package (DTEP), Toolbars Upload Toolbar, in the context menu of the files and folders in the Templates and Scripts tree.
Obtenir recursos
Getting Resources
És possible actualitzar & quantaplus; sense obtenir una versió nova, i tan sols obtenint recursos nous com paquets DTEP, barres d' eines amb accions, plantilles, scripts i documentació. Una possibilitat és que heu obtingut els recursos per correu electrònic o que les heu descarregat des d' un servidor web, en aquests casos normalment les haureu d' instal· lar manualment. Si teniu sort, també podreu obtenir un script d' instal· lació del lloc de procedència dels recursos. Però & quantaplus; té un servidor dedicat a hostatjar recursos que, o bé no s' han inclòs en la distribució principal per la seva mida o el seu escàs ús, o s' han fet arribar més tard, i dits recursos s' instal· len automàticament. Per a descarregar- los s' usen les diverses entrades del menú Descarrega. Les podeu trobar a DTD Descarrega paquets de DTD (DTEP), Barres d' eines Descarrega barra d' eines, en el menú de context d' una àrea buida o d' un element de nivell superior en els arbres Plantilles, Scripts i Documentació.
It is possible to upgrade your & quantaplus; without getting a new version, by getting new resources like DTEP packages, toolbars with actions, templates, scripts and documentation. One possibility is that you got the resources in email or have downloaded from a web server, in which cases you usually need to manually install them. In lucky case you also got an install script when you have downloaded the resources. But & quantaplus; has a dedicated server holding resources that were either not included in the main distribution because of their sizes or infrequent usage, or they were contributed later by users, and these resources are automatically installed. Do download such resources use the various Download menu entries. You can find them at DTD Download DTD Package (DTEP), Toolbars Download Toolbar, in the context menu of an empty area or toplevel item in the Templates, Scripts and Documentation trees.
Una vegada descarregats els recursos, però abans d' haver- los instal· lat, & quantaplus; comprova si el recurs és vàlid, comprovant la integritat i la signatura. En el cas d' haver- hi problemes, us avisarà i deixarà en les vostres mans la decisió de continuar o no. Si us plau, llegiu amb atenció els diàlegs d' avís. En el cas de que la integració sigui correcta i de que el recurs estigui signat correctament, també es mostrarà un diàleg informatiu, per a que pugueu veure qui va crear el recurs.
After a resource was downloaded, but before it is installed, & quantaplus; verifies if the resource is valid, by checking the integrity and the signature. In case of problems it warns you and you can decide if you want to continue or not. Please read the warning dialogs carefully. In the case when the integrity is correct and the resource is correctly signed, you will still get an information dialog, so you can see who created the resource.