Merge pull request #52 from 15tetori/master

Getting Started

Author: 15tetori

1-js/01-getting-started/2-manuals-specifications/article.md

@@ -1,42 +1,42 @@
 
-# Manuals and specifications
+# Manuali dhe specifikat
 
-This book is a *tutorial*. It aims to help you gradually learn the language. But once you're familiar with the basics, you'll need other sources.
+Ky libër eshte nje *udhëzues*. Ai synon t'ju ndihmojë të mësoni gradualisht gjuhën. Por sapo të njiheni me gjerat bazike, do t'ju nevojiten burime të tjera.
 
 ## Specification
 
-[The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information about JavaScript. It defines the language.
+[Specifikimi ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) përmban informacionin më të thellë, të detajuar dhe të zyrtarizuar rreth JavaScript. Ai percakton gjuhën.
 
-But being that formalized, it's difficult to understand at first. So if you need the most trustworthy source of information about the language details, the specification is the right place. But it's not for everyday use.
+Por duke qenë se është formalizuar, është e vështirë për tu kuptuar në fillim. Prandaj, nëse ju nevojitet burimi më i besueshëm i informacionit për detajet e gjuhës, specifikacioni është vendi i duhur. Por nuk është për përdorim të përditshëm.
 
-A new specification version is released every year. In-between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
+Çdo vit lëshohet një version i ri i specifikacionit. Mes këtyre versioneve, drafti i fundit i specifikacionit gjendet në adresën <https://tc39.es/ecma262/>.
 
-To read about new bleeding-edge features, including those that are "almost standard" (so-called "stage 3"), see proposals at <https://github.com/tc39/proposals>.
+Për të lexuar rreth veçorive të reja të fundit, duke përfshirë ato që janë "gati standarte" (të ashtuquajtura "stage 3"), shikoni propozimet tek <https://github.com/tc39/proposals>.
 
-Also, if you're in developing for the browser, then there are other specs covered in the [second part](info:browser-environment) of the tutorial.
+Gjithashtu, nëse po zhvilloni për shfletuesin, atëherë ka specifikime të tjera që trajtohen në [pjesen e dyte](info:browser-environment) të udhëzuesit.
 
-## Manuals
+## Manuali
 
-- **MDN (Mozilla) JavaScript Reference** is a manual with examples and other information. It's great to get in-depth information about individual language functions, methods etc.
+- **MDN (Mozilla) JavaScript Reference** është një manual me shembuj dhe informacione të tjera. Është shumë e mirë për të marrë informacion të hollësishëm për funksionet, metodat etj.
 
-    One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
+    Mund ta gjeni në adresën <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
 
-    Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. <https://google.com/search?q=MDN+parseInt> to search for `parseInt` function.
+    Megjithatë, shpesh është më e mirë të përdorni një kërkim në internet në vend të kësaj. Thjesht perdorni "MDN [termi]" në kërkesë, shembull. <https://google.com/search?q=MDN+parseInt> per te kerkuar funksionin `parseInt`.
 
 
-- **MSDN** – Microsoft manual with a lot of information, including JavaScript (often referred to as JScript). If one needs something specific to Internet Explorer, better go there: <http://msdn.microsoft.com/>.
+- **MSDN** – Manuali i Microsoft më shumë informacion, përfshirë JavaScript (shpesh e quajtur JScript). Nëse dikush ka nevojë për diçka specifike për Internet Explorer, është më mirë të shkojë aty: <http://msdn.microsoft.com/>.
 
-    Also, we can use an internet search with phrases such as "RegExp MSDN" or "RegExp MSDN jscript".
+    Gjithashtu, mund të përdorim një kërkim në internet me fraza të tilla si "RegExp MSDN" ose "RegExp MSDN jscript".
 
-## Compatibility tables
+## Tabelat e përputhshmërisë
 
-JavaScript is a developing language, new features get added regularly.
+Javascript është një gjuhë zhvilluese, veçoritë e reja shtohen rregullisht.
 
-To see their support among browser-based and other engines, see:
+Për të parë mbështetjen e tyre në shfletuesit dhe motorët e tjerë, shihni:
 
-- <http://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <http://caniuse.com/#feat=cryptography>.
-- <https://kangax.github.io/compat-table> - a table with language features and engines that support those or don't support.
+- <http://caniuse.com> - tabela e suportit sipas veçorive p.sh. për të parë cilët motorë mbështesin funksionet moderne të kriptografisë:  <http://caniuse.com/#feat=cryptography>.
+- <https://kangax.github.io/compat-table> - Një tabelë me veçoritë e gjuhës dhe motorët që i suportojnë ose nuk i suportojnë.
 
-All these resources are useful in real-life development, as they contain valuable information about language details, their support etc.
+Të gjithë këto burime janë të dobishme në zhvillimin e vërtetë, pasi përmbajnë informacion të vlefshëm rreth detajeve të gjuhës, mbështetjes së tyre, dhe aspekteve të tjera relevante.
 
-Please remember them (or this page) for the cases when you need in-depth information about a particular feature.
+Ju lutem mbani mend këto burime (ose këtë faqe) për rastet kur ju nevojitet informacion i hollësishëm rreth një veçorie të veçantë.

1-js/01-getting-started/3-code-editors/article.md

@@ -1,46 +1,46 @@
-# Code editors
+# Editoret e kodit
 
-A code editor is the place where programmers spend most of their time.
+Një editor kodi është vendi ku programuesit shpenzojnë më shumicën e kohës së tyre.
 
-There are two main types of code editors: IDEs and lightweight editors. Many people use one tool of each type.
+Ka dy lloje kryesore të editoreve te kodit: IDE-të dhe editoret e lehtë. Shumë njerëz përdorin një mjet nga secili lloj.
 
 ## IDE
 
-The term [IDE](https://en.wikipedia.org/wiki/Integrated_development_environment) (Integrated Development Environment) refers to a powerful editor with many features that usually operates on a "whole project." As the name suggests, it's not just an editor, but a full-scale "development environment."
+Termi [IDE](https://en.wikipedia.org/wiki/Integrated_development_environment) (Integrated Development Environment) i referohet një editori të fuqishëm me shumë karakteristika që zakonisht operon në një "projekt të tërë". Siç sugjeron edhe emri, nuk është thjesht një editor, por një "ambient zhvillimi" i plotë."
 
-An IDE loads the project (which can be many files), allows navigation between files, provides autocompletion based on the whole project (not just the open file), and integrates with a version management system (like [git](https://git-scm.com/)), a testing environment, and other "project-level" stuff.
+Një IDE ngarkon projektin (që mund të përmbaj shume dosje), lejon navigimin midis dosjeve, ofron automatizim të plotësimit të kodit bazuar në gjithë projektin (jo vetëm në dosjen e hapur), dhe integron me një sistem menaxhimi (like [git](https://git-scm.com/)), një ambient testimi dhe elemente të tjera në nivelin e projektit.
 
-If you haven't selected an IDE yet, consider the following options:
+Nëse ende nuk keni zgjedhur një IDE, konsideroni këto opsione:
 
-- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
-- [WebStorm](http://www.jetbrains.com/webstorm/) (cross-platform, paid).
+- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, falas).
+- [WebStorm](http://www.jetbrains.com/webstorm/) (cross-platform, me pagese).
 
-For Windows, there's also "Visual Studio", not to be confused with "Visual Studio Code". "Visual Studio" is a paid and mighty Windows-only editor, well-suited for the .NET platform. It's also good at JavaScript. There's also a free version [Visual Studio Community](https://www.visualstudio.com/vs/community/).
+Për Windows, gjithashtu ekziston "Visual Studio", pa u ngatërruar me "Visual Studio Code". "Visual Studio" është një editor me pagesë dhe shumë i fuqishëm, i përshtatshëm për platformën .NET. Është gjithashtu i mirë për JavaScript. Ekziston gjithashtu një version falas [Visual Studio Community](https://www.visualstudio.com/vs/community/).
 
-Many IDEs are paid, but have a trial period. Their cost is usually negligible compared to a qualified developer's salary, so just choose the best one for you.
+Shumë IDE janë me pagesë, por kanë një periudhë perdorimi falas. Kostoja e tyre është zakonisht e parëndësishme në krahasim me pagën e një zhvilluesi të kualifikuar, prandaj zgjidhni atë që ju përshtatet më së miri.
 
-## Lightweight editors
+## Editoret e lehte
 
-"Lightweight editors" are not as powerful as IDEs, but they're fast, elegant and simple.
+"Editoret e lehte" nuk janë aq të fuqishëm sa IDE-të, por ata janë të shpejtë, elegante dhe të thjeshtë.
 
-They are mainly used to open and edit a file instantly.
+Kryesisht përdoren për të hapur dhe edituar një dosje menjëherë.
 
-The main difference between a "lightweight editor" and an "IDE" is that an IDE works on a project-level, so it loads much more data on start, analyzes the project structure if needed and so on. A lightweight editor is much faster if we need only one file.
+Diferenca kryesore mes një "editori të lehtë" dhe një "IDE" është se një IDE vepron në nivelin e projektit, kështu që ngarkon shumë më shumë të dhëna në fillim, analizon strukturën e projektit sipas nevojës etj. Një editor i lehtë është shumë më i shpejtë nëse kemi nevojë vetëm për një dosje.
 
-In practice, lightweight editors may have a lot of plugins including directory-level syntax analyzers and autocompleters, so there's no strict border between a lightweight editor and an IDE.
+Në praktikë, editorët e lehtë mund të kenë shumë plugin duke përfshirë analizues sintakse në nivelin e direktorisë dhe plotësues automatikë, kështu që nuk ka kufi të prerë mes një editori të lehtë dhe një IDE.
 
-The following options deserve your attention:
+Opsionet në vijim meritojnë vëmendjen tuaj:
 
-- [Atom](https://atom.io/) (cross-platform, free).
-- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
-- [Sublime Text](http://www.sublimetext.com) (cross-platform, shareware).
-- [Notepad++](https://notepad-plus-plus.org/) (Windows, free).
-- [Vim](http://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them.
+- [Atom](https://atom.io/) (cross-platform, falas).
+- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, falas).
+- [Sublime Text](http://www.sublimetext.com) (cross-platform, me pagese).
+- [Notepad++](https://notepad-plus-plus.org/) (Windows, falas).
+- [Vim](http://www.vim.org/) dhe [Emacs](https://www.gnu.org/software/emacs/) janë gjithashtu të shkëlqyeshëm nëse dini si t'i përdorni.
 
-## Let's not argue
+## Le të mos diskutojmë.
 
-The editors in the lists above are those that either I or my friends whom I consider good developers have been using for a long time and are happy with.
+Në listat e mësipërme janë të përfshirë editorët që unë ose miqtë e mi që i konsideroj zhvillues të mirë kemi përdorur për një kohë të gjatë dhe jemi të kënaqur me to.
 
-There are other great editors in our big world. Please choose the one you like the most.
+Ka edhe editorë të tjerë të shkëlqyeshëm në botën tonë të madhe. Ju lutem zgjidhni atë që ju pëlqen më shumë.
 
-The choice of an editor, like any other tool, is individual and depends on your projects, habits, and personal preferences.
+Zgjedhja e një editori, si çdo mjet tjetër, është individuale dhe varet nga projektet tuaja, zakonet dhe preferencat personale.

1-js/01-getting-started/4-devtools/article.md

@@ -1,63 +1,63 @@
-# Developer console
+# Console e zhvilluesit
 
-Code is prone to errors. You will quite likely make errors... Oh, what am I talking about? You are *absolutely* going to make errors, at least if you're a human, not a [robot](https://en.wikipedia.org/wiki/Bender_(Futurama)).
+Kodi është i prirur të ketë gabime. Ka shumë gjasa që ju të bëni gabime... Oh, çfare po flas unë? Ju absolutisht do të bëni gabime, të paktën nëse jeni një njeri, jo një [robot](https://en.wikipedia.org/wiki/Bender_(Futurama)).
 
-But in the browser, users don't see errors by default. So, if something goes wrong in the script, we won't see what's broken and can't fix it.
+Por në shfletues, përdoruesit nuk shohin gabimet në mënyrë të paracaktuar. Prandaj, nëse diçka shkon keq në skript, nuk do të shohim se çfarë po shkon keq dhe nuk mund ta rregullojmë atë.
 
-To see errors and get a lot of other useful information about scripts, "developer tools" have been embedded in browsers.
+Për të parë gabimet dhe për të marrë shumë informacione të tjera të dobishme rreth skripteve, "mjetet e zhvilluesit" janë të integruara në shfletues.
 
-Most developers lean towards Chrome or Firefox for development because those browsers have the best developer tools. Other browsers also provide developer tools, sometimes with special features, but are usually playing "catch-up" to Chrome or Firefox. So most developers have a "favorite" browser and switch to others if a problem is browser-specific.
+Shumica e zhvilluesve preferojnë Chrome ose Firefox për zhvillim, sepse ato shfletues kanë mjetet e zhvilluesit më të mira. Shfletuesit e tjerë gjithashtu ofrojnë mjetet e zhvilluesit, ndonjëherë me karakteristika speciale, por zakonisht po përpiqen të ndjekin Chrome ose Firefox. Prandaj shumica e zhvilluesve kanë një shfletues "të preferuar" dhe bëjnë ndërrimin në të tjerët nëse një problem është i veçantë për shfletuesin.
 
-Developer tools are potent; they have many features. To start, we'll learn how to open them, look at errors, and run JavaScript commands.
+Mjetet e zhvilluesit janë të fuqishme; ato kanë shumë karakteristika. Fillimisht, do të mësojmë si t'i hapim ato, të shohim gabimet dhe të ekzekutojmë komanda JavaScript.
 
 ## Google Chrome
 
-Open the page [bug.html](bug.html).
+Hapim faqen [bug.html](bug.html).
 
-There's an error in the JavaScript code on it. It's hidden from a regular visitor's eyes, so let's open developer tools to see it.
+Ka një gabim në kodin JavaScript në të. Ai është i fshehur nga sytë e një vizitori të rregullt, kështu që le të hapim mjetet e zhvilluesit për ta parë atë.
 
-Press `key:F12` or, if you're on Mac, then `key:Cmd+Opt+J`.
+Shtypim `key:F12` ose, nese perdorni Mac, atëhere `key:Cmd+Opt+J`.
 
-The developer tools will open on the Console tab by default.
+Mjetet e zhvilluesit do të hapen në skedën "Console" si parazgjedhje.
 
-It looks somewhat like this:
+Do te duket dicka e tillë:
 
 ![chrome](chrome.png)
 
-The exact look of developer tools depends on your version of Chrome. It changes from time to time but should be similar.
+Pamja e saktë e mjetit te zhvilluesit varet nga versioni juaj i Chrome. Ajo ndryshon nga koha në kohë, por duhet të jetë e ngjashme.
 
-- Here we can see the red-colored error message. In this case, the script contains an unknown "lalala" command.
-- On the right, there is a clickable link to the source `bug.html:12` with the line number where the error has occurred.
+- Këtu mund të shohim mesazhin e gabimit me ngjyrë të kuqe. Në këtë rast, skripti përmban një komandë të panjohur "lalala".
+- Në të djathtë, ka një lidhje që mund të klikohet për burimin `bug.html:12` me numrin e linjës ku ka ndodhur gabimi.
 
-Below the error message, there is a blue `>` symbol. It marks a "command line" where we can type JavaScript commands. Press `key:Enter` to run them.
+Poshtë mesazhit të gabimit, ka një simbol blu >. Ai nenkupton një "linjë komande" ku mund të shkruajmë komandat JavaScript. Shtypni `key:Enter` për t'i ekzekutuar ato.
 
-Now we can see errors, and that's enough for a start. We'll come back to developer tools later and cover debugging more in-depth in the chapter <info:debugging-chrome>.
+Tani mund të shohim gabimet, dhe kjo mjafton per fillim. Do të kthehemi në mjetet e zhvilluesit më vonë dhe do të trajtojmë më thellë debuggimin në kapitullin <info:debugging-chrome>.
 
 ```smart header="Multi-line input"
-Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
+Zakonisht, kur vendosim një rresht kod në konsolë dhe pastaj shtypim `key:Enter`, ai ekzekutohet.
 
-To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code.
+Për të vendosur më shumë rreshta, shtypni `key:Shift+Enter`. Kështu mund të vendosni fragmente të gjata të kodit JavaScript.
 ```
 
-## Firefox, Edge, and others
+## Firefox, Edge, dhe te tjere.
 
-Most other browsers use `key:F12` to open developer tools.
+Shumica e shfletuesve të tjerë përdorin `key:F12` për të hapur mjetet e zhvilluesit.
 
-The look & feel of them is quite similar. Once you know how to use one of these tools (you can start with Chrome), you can easily switch to another.
+Pamjet e tyre janë shumë të ngjashme. Nëse dini si të përdorni njërin nga këto mjetet (mund të filloni me Chrome), mund të kaloni lehtësisht në një tjetër.
 
 ## Safari
 
-Safari (Mac browser, not supported by Windows/Linux) is a little bit special here. We need to enable the "Develop menu" first.
+Safari (shfletuesi i Mac, i cili nuk mbështetet në Windows/Linux) është paksa i veçantë këtu. Ne duhet të aktivizojmë "Menunë e Zhvilluesit" së pari.
 
-Open Preferences and go to the "Advanced" pane. There's a checkbox at the bottom:
+Hapni Preferencat dhe shkoni te paneli "Advanced". Në fund të tij ka një kutizë zgjedhjeje:
 
 ![safari](safari.png)
 
-Now `key:Cmd+Opt+C` can toggle the console. Also, note that the new top menu item named "Develop" has appeared. It has many commands and options.
+Tani `key:Cmd+Opt+C` mund të ndërrojë konsolën. Gjithashtu, vini re se ka shfaqur një element menu i ri në krye me emrin "Develop". Ai ka shumë komanda dhe opsione.
 
-## Summary
+## Përmbledhje
 
-- Developer tools allow us to see errors, run commands, examine variables, and much more.
-- They can be opened with `key:F12` for most browsers on Windows. Chrome for Mac needs `key:Cmd+Opt+J`, Safari: `key:Cmd+Opt+C` (need to enable first).
+- Mjetet e zhvilluesit na lejojnë të shohim gabimet, të ekzekutojmë komanda, të eksplorojmë variablat dhe shumë të tjera.
+- Ato mund te aksesohen me `key:F12` per shumicen e shfletuesve ne Windows. Chrome per Mac shtypim `key:Cmd+Opt+J`, Safari: `key:Cmd+Opt+C` (duhet ta aktivizioni si fillim).
 
-Now we have the environment ready. In the next section, we'll get down to JavaScript.
+Tani kemi gati mjedisin. Në seksionin e ardhshëm, do të merremi me JavaScript-in.