natgillin/translations-raw huggingface dataset:
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.
Järgnevas selgitame, kuidas luua & DTEP; jaoks tööriistaribasid. Tööriistaribad on graafilised elemendid, mis on omistatud toimingutele. Toimingud kujutavad & quantaplus; is alust peaaegu kõigile laiendustele, mida & quantaplus; praegu või tulevikus kasutab. Sama mehhanism, mis defineerib & quantaplus; is toiminguid, võimaldab automaatset lõpetamist ning sildidialooge. Toimingute puhul sisuliselt puuduvad piirangud. Näitena kasutame siinkohal meie veebilehtedel HTML; tidy 't.
From Scratch to Complete
Nullist peale
To begin, you will need to create a user toolbar. Select Toolbars Add User Toolbar.
Alustuseks tuleb luua kasutaja tööriistariba. Vali menüükäsk Tööriistaribad Lisa kasutaja tööriistariba.
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.
Kui märkekeeles on palju silte, on soovitatav jagada need loogilistesse gruppidesse. Igale grupile tuleb luua uus kasutaja tööriistariba. Antud juhul pole neid eriti palju, seepärast piirdume ühe tööriistaribaga ja anname sellele vastava märkekeele nime.
Once all your toolbars are created, you must add and configure the actions. To do this, select Settings Configure Actions.
Kui kõik vajalikud tööriistaribad on loodud, tuleb neile lisada toimingud ja viimased seadistada. Selleks vali menüükäsk Seadistused Toimingute seadistamine.
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.
Selles aknas peaks kõik iseenda eest kõnelema. Klõpsa akna allosas asuvale nupule > Uus toiming, mis avab redigeerimisrežiimi.
Fill in all of the necessary fields and add the tag to the appropriate toolbar(s).
Täida kõik vajalikud väljad ja lisa silt vastavale tööriistaribale.
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.
Nüüd tee sama muude toimingute ja siltidega ning kui sildil on atribuute ja sa kavatsed neid kasutada, märgi ära ka kast Käivitatakse dialoog "Sildi muutmine" (kui võimalik), et sinu käest iga kord vastava toimingu kasutamisel küsitaks.
You should now have something much like the following.
Nüüd peaks sul olema midagi sellist.
Press the Apply button and you will see the action added to the toolbar(s) you have selected.
Klõpsa nuppu Rakenda ja näed, kuidas toiming lisatakse valitud tööriistaribale.
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.
Nähh! See ikoon on veidi imelik. Isegi mina ise ei pruugi mäletada, et see käib selle toimingu kohta, mis siis veel teistest rääkida! Vahetame selle enne välja, kui häda käes.
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).
Antud toimingut paremini kirjeldava ikooni loomiseks kasutame rakendust & kiconedit;. Ava see käsuga & kmenu; st Graafika Muud rakendused (või kuidas iganes sinu distributsioon seda ei nimetaks).
& kiconedit; defaults to the size 32x32 pixels, but we need 22x22. To change this, select Edit Resize.
& kiconedit; kasutab vaikesuurusena 32x32 pikslit, kuid meie soovime suurust 22x22. Muutmiseks kasuta menüükäsku Redigeerimine Muuda suurust.
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;.
Pea meeles, et sa lood ikooni, mis ei aita mitte ainult sul endal meeles pidada, milline toiming mida teeb, vaid tuleb samamoodi kasuks ka teistele & DTEP; kasutajatele.
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.
Et silt, millele ma ikooni looma asusin, kannab nimetust start, siis otsustasin luua alustamismärgi. Roheline värv (mida sageli tarvitatakse tähenduses mine, alusta või jätka) annab või vähemalt peaks andma kasutajale märku, et sellele toimingule klõpsates asetatakse dokumenti silt & lt; startgt;.
Now that I am finished with the creation of the icon, I will save it.
Nii, ikoon on valmis tehtud ja käes aeg see salvestada.
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.
Kui oled ikooni( d) valmis teinud, tuleb need toiminguga siduda. Selleks ava uuesti Seadistused Toimingute seadistamine (quantaplus; is mõistagi) ja vali toiming, mille jaoks ikooni lõid. Välja Tekst kõrval asub nupp. Vajuta sellele.
Select Other Icons and then click the Browse button.
Vali Muud ikoonid ja seejärel klõpsa nupule Lehitse.
Goto the folder in which you saved the icon, select the icon, and click OK.
Mine nüüd kataloogi, kuhu ikooni salvestasid, vali ikoon ja klõpsa nupule OK.
Press the Apply button and either continue to do the same with the other tags, if any, or click OK to finish.
Klõpsa nupule Rakenda ning jätka ikoonide seostamist muude siltidega või klõpsa OK, kui oled omadega valmis.
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.
Oletame, et soovid lisada oma tööriistaribale mõned & quantaplus; i levinumad funktsioonid või arvad, et tööriistariba tuleks paremini organiseerida, näiteks see eraldajatega toimingute gruppidesse jagada. Ava selleks dialoog Tööriistaribade seadistamise dialoog (Seadistused Tööriistaribade seadistamine). Kontrolli, et soovitud tööriistariba oleks valitud.
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.
Mina valisin oma tööriistaribale eraldaja (vasaku veeru ülaosast). Kui oled valinud elemendi, mida soovid tööriistaribale lisada, klõpsa paremale osutava noolega nupule, mis lisabki elemendi sinu tööriistaribale.
I think I would like a quick way to access the Konqueror Preview. I will select it and add it to the toolbar.
Ma arvan ka, et mulle meeldiks kiiresti kasutada võimalust Eelvaatlus Konqueroris, seega valin ka selle ja lisan tööriistaribale.
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.
Vaata, kuidas eraldaja tuleb rühmitamisel kasuks. Muidu oleks võinud mõni, kes minu tööriistariba esimest korda näeb, arvata, et nupp & konqueror; on sama, mis alustamisnupp või lausa selle vastand.
Apply your changes and, when you are done, press OK to finish.
Rakenda muudatused ja klõpsa lõpetamiseks nupule OK.
Ah, look at the fantastic new toolbar! Much more handy now.
Ah, kui lahe uus tööriistariba! Igati käepärane ja mõnus.
Remember to test your toolbar, by clicking all the buttons, so that you know the output is correct.
Testi kindlasti oma tööriistariba, proovides klõpsata kõigile nuppudele, et näha, kas kõik teevad ikka seda, mida nad peavad tegema.
Now to save the toolbar, we will select Toolbars Save Toolbars Save as Local Toolbar.
Seejärel salvesta tööriistariba: Tööriistaribad Salvesta tööriistaribad Salvestamine kohaliku tööriistaribana.
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.
Salvesta see kindlasti õigesse kataloogi. Kuna NeXML- i ei ole veel olemas, on see mul mul tipptaseme kataloogis, aga sinu tööriistaribad tuleb salvestada korrektsesse kataloogi. Kohenda kindlasti ka faili & descriptionrc;, et tööriistariba( d) laetaks alati, kui lood uue selle tüübiga faili.
Creating Your Own Documentation
Oma dokumentide loomine
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.
Võib- olla üks tavakasutajale kõige silmatorkavamaid lisandusi & quantaplus; is on võimalus lisada dokumentatsiooni endale meelepärase märgistus - või skriptikeele kohta. See peatükk selgitab, kuidas luua & PHP; dokumentatsioonipuu isiklikuks kasutamiseks.
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.
Enne seda, kui asud looma omaenda dokumentatsiooni, võiksid kontrollida quantaplus; i hoidlast, ega keegi juba midagi sellist teinud pole.
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.
Loomisprotsess koosneb kahest osast. Esiteks tuleb hankida antud märgistus/ skripti/ etc; keele olemasolev dokumentatsioon. Teiseks tuleb luua docrc fail. Esimene jääb su enda ülesandeks, teist asume järgnevalt kirjeldama.
The general form of the docrc file is as follows:
Fail docrc näeb üldiselt välja selline:
#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
# KDE Config File [Tree] Doc dir= dokumentatsiooni html- failide asukoht antud faili suhtes & eg; php42 / # top level elements Top Element= nende dokumentide kirjeldus & 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
The docrc is broken down into two sections: Tree and Context.
Fail docrc jaguneb kaheks osaks: puu ja kontekst.
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:
Puusektsioon määrab dokumentatsiooni esitamise dokumentatsiooni kaardil. Näiteks & PHP; - dokumentide korral võid näha midagi sellist:
Relating this to the above, my & PHP; docrc looks like this:
Arvestades ülaltoodut, näeb minu & PHP; docrc välja selline:
#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...
# 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...
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.
Pane tähele märki # kirjete Getting Started ja Language Reference ees. See näitab, et need on omaette ühikud puus, millel on omaenda sisu. Ma ei usu, et puu sügavusele oleks kusagil limiit seatud (kui jätta arvestamata kaine mõistuse määratu) & mdash; nii et kasuta siin oma paremat äranägemist.
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!).
Sisukord (Table of Contents) on otseviitega failile (ning seetõttu on see näha puuvaates viimasena & mdash; kataloogid esimesena!).
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.
Tühikud segavat mõju ei avalda, kuid silma peaks peal pidama märkidel & ja & lt;. On tõenäoline, et kõigis & XML; - põhistes & quantaplus; i ressursifailides asendatakse need vastavalt märkidega & amp; ja & lt;.
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.
Faili docrc kontekstisektsiooni kasutatakse kontekstitundliku abi pakkumiseks. Oletame näiteks, et kirjutad & PHP; skripti ja tahad näha funktsiooni mysql_ fetch_ array dokumentatsiooni. Selleks tuleb lihtsalt funktsioon esile tõsta ja vajutada kontekstiabi saamiseks klahvikombinatsiooni Ctrl; H. Kohe ilmubki nähtavale mysql_ fetch_ array dokumentatsioon. Siin on ainult kaks kirjetüüpi: ContextList ja failiassotsiatsiooni read.
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;).
See on päris lihtne: komadega eraldatud nimekiri kontekstielementidest, mis sinu arvates peaks olema kättesaadavad (PHP; puhul on need mõistagi & PHP; - funktsioonid).
File association lines
Failiassotsiatsiooni read
These are of the form context item=html doc page. & eg; acos=function. acos. html
Need on kujul kontekstielement=html- dokumendi lehekülg, & eg; acos=function. acos. html
A pared down version of my docrc Context section is as follows:
Minu docrc omajagu kärbitud kontekstisektsioon on selline:
#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...
# Kontekstiabi võtmesõnad [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...
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.
Nüüd võid faili docrc salvestada vastavalt sellele, kas soovid seda kasutada globaalselt või kohalikult, kataloogi $KDEDIR / share/ apps/ quanta/ doc või $HOME /. kde/ share/ apps/ quanta/ doc. Seejärel loo failiga docrc samas kataloogis alamkataloog (seesama, mille määrasid failis docrc) ning kopeeri sinna oma & HTML; - dokumendid.
You will need to restart & quantaplus; to see your documentation.
Kui nüüd taaskäivitad & quantaplus; i, võidki dokumente näha.
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.
Kui oled kindel, et dokumendid on asjalikud, ning soovid neid ka teistega jagada, saada fail docrc koos kogu sinu arvates vajaliku infoga quantaplus; i hoidlasse, kus neid saab kasutada ka ülejäänud & quantaplus; i kogukond. See ei tee sind küll rikkaks, kuid laseb tunda heameelt, et oled andnud oma panuse parimasse olemasolevasse veebiarendusplatvormi.
Sharing Resources
Ressursside jagamine
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:
& quantaplus; i kasutajana ei pruugi sa üksi olla. sul on võimalik jagada teistega mitmesuguseid ressursse (DTEP paketid, toimingutega tööriistaribad, skriptid, mallid). Seda saab teha kahel moel:
Sending in Email
E- kirja saatmine
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.
Ressursse saab saata e- kirjaga sõpradele, partneritele või kellele tahes. Menüükäsku Saada e- postiga võib näha mitmel pool, näiteks DTD Saada DTD pakett (DTEP) e- postiga, Tööriistaribad Saada tööriistariba e- postiga, failide ja kataloogide kontekstimenüüs mallid e ja skriptid e puuvaates.
Uploading to the main server
Üleslaadimine peaserverile
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.
Ressursse saab laadida meie peahoidlasse, kust neid saavad endale tõmmata teised & quantaplus; i kasutajad. Saadetised vaadatakse üle ja muudetakse kättesaadavaks ainult juhul, kui meie arendajate meeskond hindab need korrektseks ja kasulikuks. Üleslaadimise korrektsuse tagamiseks oleks mõttes need digitaalselt allkirjastada, milleks läheb vaja GPG/ PGP võtit. Seda infot saavad ressursside ehtsuse kontrollimiseks kasutada nii meie arendajad kui ka hiljem allalaadijad.
About getting the resources from the main server see.
Ressursside tõmbamisest peaserverilt räägib.
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.
Üleslaadimisel palutakse sul sisestada oma salajase GPG võtme paroolifraas (paroolifraasi ei salvestata) või kui sul peaks olema rohkem salajasi võtmeid, siis valida see, mida soovid kasutada. Täida dialoogis Uue kuuma kraami jagamine kõik väljad (Eelvaaatluse URL võib jääda tühjaks) ning alusta üleslaadimist klõpsuga nupule OK.
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.
Üleslaadimise saab algatada menüüst DTD Lae DTD pakett (DTEP) üles, Tööriistaribad Lae tööriistariba üles, failide ja kataloogide kontekstimenüüst mallid e ja skriptid e puuvaates.
Getting Resources
Ressursside hankimine
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.
& quantaplus; i on võimalik uuendada ka ilma uut versiooni hankimata lihtsalt uusi ressursse tõmmates: DTEP paketid, toimingutega tööriistaribad, mallid, skriptid, dokumentatsioon. Üks võimalus on saada neid e- postiga või tõmmata mõnelt veebiserverilt, millisel juhul need tuleb tavaliselt ise käsitsi paigaldada. Heal juhul saad kaasa ka paigaldamisskripti, mis võtab seda vaeva vähemaks. Kuid & quantaplus; il on ka asjalik server, mis sisaldab selliseid ressursse, mida ei ole kaasatud rakenduse põhipaketti kas suuruse või vähese kasutamisvajaduse tõttu või mida on kasutajad ise hiljem meile annetanud. Neid saab paigaldada juba automaatselt. Selliseid ressursse saab tõmmata mitmel pool menüüs esineva käsuga Lae alla. Täpsemalt leiab sellised käsud menüüst DTD Lae DTD pakett (DTEP) alla, Tööriistaribad Lae tööriistariba alla, failide ja kataloogide kontekstimenüüst mallid e ja skriptid e puuvaates.
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.
Kui ressurss on tõmmatud, kontrollib & quantaplus; enne selle paigaldamist ressursi korrektsust ja signatuuri. Probleemide korral näidatakse sulle hoiatust ning sa saad otsustada, kas jätkata paigaldamist või mitte. Palun suhtu hoiatustesse tõsiselt ja loe need hoolikalt läbi. Kui ressursiga on kõik korras, ilmub lihtsalt infodialoog, kus saad näha, kes on ressursi loonud.
Be sure that you install resources, especially toolbars and scripts, only from trusted sources!
Kontrolli kindlasti, et paigaldad ressursse, eriti tööriistaribasid ja skripte, ainult usaldusväärsetest allikatest!
Converting a DTD to a & DTEP;
DTD teisendamine & DTEP; - ks
It is possible to work on XML languages currently not supported by & quantaplus; by creating a DTEP package. But the creation can be time consuming, as you may need to write hundreds of tag files in tagXML format. Of course, there is a nicer way to go, by converting the DTD automatically into a DTEP package.
Oma töös saab kasutada ka XML- keeli, mida & quantaplus; veel ei toeta, kui luua DTEP pakett. Selle loomine võib võtta siiski palju aega, sest kirja tuleb panna sadu sildifaile tagXML - vormingus. Seda saab küll ka märksa vähema vaevaga teha - nimelt DTD- d automaatselt DTEP paketiks teisendades.