merging all conflicts

Author: iliakan

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: iliakan

.gitignore

@@ -21,3 +21,4 @@ sftp-config.json
 Thumbs.db
 
 
+/svgs

1-js/01-getting-started/1-intro/article.md

@@ -24,26 +24,44 @@ A böngészőkbe épített JavaScript-motort *JavaScript virtuális gépnek* is
 
 A különböző böngészőkbe épített motoroknak mind saját kódneve van, például:
 
+<<<<<<< HEAD
 - [V8](https://hu.wikipedia.org/wiki/V8_JavaScript-motor) -- Chrome és Opera.
 - [SpiderMonkey](https://en.wikipedia.org/wiki/SpiderMonkey) -- Firefox.
 - ...és még egy sor másik, úgymint "Trident" és "Chakra" a különböző Internet Explorer verziókban, "ChakraCore" a Microsoft Edgeben, vagy a "Nitro" és "SquirrelFish" a Safariban.
 
 Jó, ha ismerjük a fenti fogalmakat, ugyanis vissza fognak köszönni a fejlesztőknek szánt cikkekben, például amikor arról van szó, hogy egy funkció támogatott-e a V8 által.
+=======
+- [V8](https://en.wikipedia.org/wiki/V8_(JavaScript_engine)) -- in Chrome, Opera and Edge.
+- [SpiderMonkey](https://en.wikipedia.org/wiki/SpiderMonkey) -- in Firefox.
+- ...There are other codenames like "Chakra" for IE, "JavaScriptCore", "Nitro" and "SquirrelFish" for Safari, etc.
+
+The terms above are good to remember because they are used in developer articles on the internet. We'll use them too. For instance, if "a feature X is supported by V8", then it probably works in Chrome, Opera and Edge.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ```smart header="Hogy működnek a JavaScript-motorok?"
 
 Habár a JavaScript-motorok összetettek, az alapvető működésük igen egyszerű.
 
+<<<<<<< HEAD
 1. A motor beolvassa és kielemzi a szkriptet (*parsing*, *elemzés*).
 2. Átalakítja a kódot gépi kódra (*compiling*, *fordítás*).
 3. A gépi kód lefut.
+=======
+1. The engine (embedded if it's a browser) reads ("parses") the script.
+2. Then it converts ("compiles") the script to machine code.
+3. And then the machine code runs, pretty fast.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 A motor különféle optimalizációkat hajt végre a lépések során, sőt, a lefordított kódot is monitorozza futás közben, hogy dinamikusan tovább optimalizálja a gépi kódot.
 ```
 
 ## Mire képes a böngészőben futó JavaScript?
 
+<<<<<<< HEAD
 A JavaScript egy "biztonságos" nyelv, nem ad hozzáférést olyan alacsonyszintű erőforrásokhoz, mint a processzor vagy a memória, mivel eredetileg kizárólag a böngészőkben való futásra szánták, s ott ezekre nincs szükség.
+=======
+Modern JavaScript is a "safe" programming language. It does not provide low-level access to memory or the CPU, because it was initially created for browsers which do not require it.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 Egy JavaScript program lehetőségeit nagyban befolyásolja a környezet, amelyben fut. [Node.js](https://hu.wikipedia.org/wiki/Node.js) esetén például tetszőlegesen írhatunk/olvashatunk fájlokat, kezdeményezhetünk hálózati hívásokat.
 
@@ -59,14 +77,19 @@ Néhány konkrét példa:
 
 ## Mire NEM képes a böngészőben futó JavaScript?
 
+<<<<<<< HEAD
 A böngészőben futó JavaScript, a felhasználó érdekében, több szempontból is korlátozva van. A cél az adatainkhoz való illetéktelen hozzáférés megakadályozása.
+=======
+JavaScript's abilities in the browser are limited to protect the user's safety. The aim is to prevent an evil webpage from accessing private information or harming the user's data.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 Például:
 
 - A weboldalakon futó JavaScript programok nem férnek hozzá az operációs rendszer szolgáltatásaihoz, nem tudnak tetszőlegesen fájlokat írni/olvasni.
 
     A modern böngészők korlátozottan és csakis a felhasználó közreműködésével képesek bizonyos fájlműveletekre, például fájlfeltöltésre egy `<input>` HTML elemen keresztül.
 
+<<<<<<< HEAD
     A webkamera és a mikrofon, a felhasználó kifejezett engedélyével, elérhetőek, de engedély nélkül, alattomosan, nem férhet hozzájuk egyetlen weboldal sem, így nem kell aggódnunk, hogy adataink ezeken keresztül eljutnának az [NSA](https://hu.wikipedia.org/wiki/National_Security_Agency)-hez.
 - A böngészőfülek és ablakok alapesetben nem tudnak kommunikálni egymással. Erre csak abban az esetben van lehetőség, ha egy weboldalon futó JavaScript nyit meg egy új fület vagy ablakot, de még ebben az esetben is csak azzal a feltétellel, hogy a megnyitott oldal ugyanarról a webcímről származik (azaz a protokoll, a kiszolgáló és a port is megegyezik).
 
@@ -78,34 +101,62 @@ Például:
 ![](limitations.svg)
 
 Ezek a korlátozások nem léteznek a böngészőn kívül, így például a szervereken. Ezeken túlmenően, a modern böngészőkbe különféle bővítményeket telepíthetünk, amelyek további engedélyeket igényelhetnek. 
+=======
+    There are ways to interact with the camera/microphone and other devices, but they require a user's explicit permission. So a JavaScript-enabled page may not sneakily enable a web-camera, observe the surroundings and send the information to the [NSA](https://en.wikipedia.org/wiki/National_Security_Agency).
+- Different tabs/windows generally do not know about each other. Sometimes they do, for example when one window uses JavaScript to open the other one. But even in this case, JavaScript from one page may not access the other page if they come from different sites (from a different domain, protocol or port).
+
+    This is called the "Same Origin Policy". To work around that, *both pages* must agree for data exchange and must contain special JavaScript code that handles it. We'll cover that in the tutorial.
+
+    This limitation is, again, for the user's safety. A page from `http://anysite.com` which a user has opened must not be able to access another browser tab with the URL `http://gmail.com`, for example, and steal information from there.
+- JavaScript can easily communicate over the net to the server where the current page came from. But its ability to receive data from other sites/domains is crippled. Though possible, it requires explicit agreement (expressed in HTTP headers) from the remote side. Once again, that's a safety limitation.
+
+![](limitations.svg)
+
+Such limitations do not exist if JavaScript is used outside of the browser, for example on a server. Modern browsers also allow plugins/extensions which may ask for extended permissions.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ## Mi teszi a JavaScriptet különlegessé?
 
 *Három* érv a JavaScript mellett:
 
 ```compare
+<<<<<<< HEAD
 + Teljeskörű HTML/CSS integráció.
 + Az egyszerű dolgok kivitelezése egyszerű.
 + Minden modern böngésző támogatja és alapértelmezetten engedélyezi a futtatását.
+=======
++ Full integration with HTML/CSS.
++ Simple things are done simply.
++ Supported by all major browsers and enabled by default.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 ```
 A JavaScript az egyetlen böngésző-technológia, amely mindhárom előnnyel rendelkezik.
 
 Ezért olyan különleges a JavaScript és ezért terjedhetett el és válhatott a felhasználói felületek kivitelezésének elsőszámú eszközévé.
 
+<<<<<<< HEAD
 Ezzel együtt a JavaScript kiválóan alkalmas szerverek programozására, mobilalkalmazások fejlesztésére és még sok minden másra is.
+=======
+That said, JavaScript can be used to create servers, mobile applications, etc.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ## JavaScriptre épülő nyelvek
 
 A JavaScript szintaxisa nem felel meg és nem is felelhet meg mindenki elvárásainak, ugyanis az egyes fejlesztőknek eltérőek az igényeik.
 
 Ez természetes, hiszen a projektek és a követelmények is eltérőek.
 
+<<<<<<< HEAD
 A JavaScript megjelenése óta egy sor nyelv bukkant fel, amelyeket JavaScriptté kell alakítani (*transpiling*), mielőtt le tudnánk futtatni a programot böngészőben.
+=======
+So, recently a plethora of new languages appeared, which are *transpiled* (converted) to JavaScript before they run in the browser.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 A modern fejlesztői eszközök rendkívül gyorsak és transzparensek, így lényegében a JavaScripttől teljesen eltérő nyelven is kódolhatunk, miközben az automatikusan JavaScriptté alakul a háttérben.
 
 Néhány példa:
 
+<<<<<<< HEAD
 - [CoffeeScript](http://coffeescript.org/): úgynevezett *szintaktikai cukorkákat* (*syntactic sugar*) alkalmazó nyelv. Tömörebb szintaxissal rendelkezik, így világosabb és rövidebb kódot írhatunk. A Ruby fejlesztők jellemzően kedvelik.
 - [TypeScript](http://www.typescriptlang.org/): elsősorban szigorú típusossággal egészíti ki a JavaScriptet, elősegítve a nagy bonyolultságú rendszerek fejlesztését és karbantartását. A Microsoft fejlesztése.
 - [Flow](http://flow.org/): szintén a szigorúbb típusosságot valósítja meg, de a TypeScripttől eltérő módon. A Facebook fejlesztése.
@@ -114,9 +165,25 @@ Néhány példa:
 - [Kotlin](https://kotlinlang.org/docs/reference/js-overview.html): egy modern, tömör, biztonságos programozási nyelv, amellyel böngésző és Node alá is fejleszthetünk .
 
 A fentieken túl számos más JavaScripten alapuló nyelv létezik. Még akkor is, ha egy JavaScriptté alakítandó nyelvvel dolgozunk, mindenképpen érdemes alaposan ismerni a JavaScriptet, hogy valóban értsük, hogyan működik a programunk.
+=======
+- [CoffeeScript](https://coffeescript.org/) is "syntactic sugar" for JavaScript. It introduces shorter syntax, allowing us to write clearer and more precise code. Usually, Ruby devs like it.
+- [TypeScript](https://www.typescriptlang.org/) is concentrated on adding "strict data typing" to simplify the development and support of complex systems. It is developed by Microsoft.
+- [Flow](https://flow.org/) also adds data typing, but in a different way. Developed by Facebook.
+- [Dart](https://www.dartlang.org/) is a standalone language that has its own engine that runs in non-browser environments (like mobile apps), but also can be transpiled to JavaScript. Developed by Google.
+- [Brython](https://brython.info/) is a Python transpiler to JavaScript that enables the writing of applications in pure Python without JavaScript.
+- [Kotlin](https://kotlinlang.org/docs/reference/js-overview.html) is a modern, concise and safe programming language that can target the browser or Node.
+
+There are more. Of course, even if we use one of these transpiled languages, we should also know JavaScript to really understand what we're doing.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ## Összefoglalás
 
+<<<<<<< HEAD
 - A JavaScriptet eredetileg kizárólag böngészőben való futtatásra szánták, mára azonban számtalan egyéb környezetben alkalmazzák.
 - A JavaScript egyedülálló helyzetben van a legszélesebb körben elterjedt böngészőoldali programozási nyelvként, teljeskörű HTML és CSS integrációval.
 - Számos JavaScriptre forduló nyelv létezik. Érdemes megismerkedni velük, miután magabiztos JavaScript tudásra tettünk szert.
+=======
+- JavaScript was initially created as a browser-only language, but it is now used in many other environments as well.
+- Today, JavaScript has a unique position as the most widely-adopted browser language, fully integrated with HTML/CSS.
+- There are many languages that get "transpiled" to JavaScript and provide certain features. It is recommended to take a look at them, at least briefly, after mastering JavaScript.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b

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

@@ -1,37 +1,62 @@
 
 # Kézikönyvek és specifikációk
 
+<<<<<<< HEAD
 A jelen könyv egy *útmutató*. A célja a JavaScript ismertetése. Az alapok ismeretén túl egyéb segédanyagokra is szükségünk lesz.
+=======
+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 resources.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ## Specifikáció
 
 Az [ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) specifikáció a létező legrészletesebb, hivatalos és formális leírása a JavaScript nyelvnek.
 
 Minthogy egy formális specifikációról van szó, elsőre igencsak nehéznek bizonyulhat az olvasása. Ha garantáltan megbízható választ keresünk valamely nyelvi kérdésünkre, a specifikációban érdemes kutakodnunk, de jó, ha tudjuk, hogy nem kimondottan a mindennapi használatra szánták.
 
+<<<<<<< HEAD
 Minden évben új ECMAScript verzió jelenik meg. A soronkövetkező verzió aktuális tervezetét a <https://tc39.es/ecma262/> oldalon találjuk.
+=======
+A new specification version is released every year. Between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 A legújabb nyelvi lehetőségekről és a szabványossá válás előtt álló, úgynevezett 3-as szintű előterjesztésekről a <https://github.com/tc39/proposals> oldalon tájékozódhatunk.
 
+<<<<<<< HEAD
 Böngészoldali programok írásához további specifikációkkal ismerkedhetünk meg a [második részben](info:browser-environment).
+=======
+Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of the tutorial.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ## Leírások
 
 - A **Mozilla Developer Network (MDN) JavaScript Referencia** egy mélyreható, széleskörű, példákkal illusztrált leírás a nyelv működéséről, a nyelvi elemekről, a beépített függvényekről és a böngészőben elérhető egyéb technológiákról.
 
+<<<<<<< HEAD
     A referencia a <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference> oldalon található.
 
 Az MDN közvetlen böngészése helyett az esetek többségében célszerűbb egy "MDN [kulcsszó]" alakú keresést indítani, például, ha a `parseInt` függvényről akarunk olvasni: <https://google.com/search?q=MDN+parseInt>.
+=======
+    You can find it at <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 the `parseInt` function.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ## Kompatibilitási táblázatok
 
 A JavaScript eszköztára folyamatosan bővül.
 
 Az alábbi linkeken összefoglaló táblázatokat találhatunk az egyes nyelvi funkciók különböző környezetekben való támogatottságáról:
 
+<<<<<<< HEAD
 - <http://caniuse.com> - konkrét funkciók szerinti bontás; például a modern titkosítási eljárások támogatottsága: <http://caniuse.com/#feat=cryptography>.
 - <https://kangax.github.io/compat-table> - részletes támogatottsági adatok specifikáció verzió szerint.
 
 A mindennapi munkánk során gyakran fogjuk böngészni ezeket az oldalakat. 
+=======
+- <https://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <https://caniuse.com/#feat=cryptography>.
+- <https://kangax.github.io/compat-table> - a table with language features and engines that support those or don't support.
+
+All these resources are useful in real-life development, as they contain valuable information about language details, their support, etc.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 Jegyezzük meg őket és ismerkedjünk meg velük alaposan, hogy könnyen el tudjunk igazodni, amikor válaszokat keresünk kérdéseinkre.

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

@@ -12,8 +12,13 @@ Egy IDE segítségével egész projektre vonatkozó műveleteket végezhetünk.
 
 Néhány figyelemreméltó IDE:
 
+<<<<<<< HEAD
 - [Visual Studio Code](https://code.visualstudio.com/) (patformfüggetlen, ingyenes).
 - [WebStorm](http://www.jetbrains.com/webstorm/) (platformfüggetlen, fizetős).
+=======
+- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
+- [WebStorm](https://www.jetbrains.com/webstorm/) (cross-platform, paid).
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 Nem keverendő össze a "Visual Studio Code" és a "Visual Studio". Utóbbi egy kizárólag Windowson elérhető, fizetős IDE, elsősorban .NET fejlesztésre. Ezzel együtt JavaScript programozásra is alkalmas, sőt, [Visual Studio Community](https://www.visualstudio.com/vs/community/) néven elérhető egy ingyenes változata is.
 
@@ -29,18 +34,35 @@ A legszembetűnőbb különbség, hogy az IDE-k a futás során projekt szinten
 
 A gyakorlatban számos bővítmény (*plugin*, *extension*) áll rendelkezésre a kódszerkesztők kiegészítésére, így az IDE-k és a szerkesztők közötti határvonal képlékeny.
 
+<<<<<<< HEAD
 Néhány figyelemreméltó kódszerkesztő:
 
 - [Atom](https://atom.io/) (platformfüggetlen, ingyenes).
 - [Visual Studio Code](https://code.visualstudio.com/) (platformfüggetlen, ingyenes).
 - [Sublime Text](http://www.sublimetext.com) (platformfüggetlen, shareware).
 - [Notepad++](https://notepad-plus-plus.org/) (Windows, ingyenes).
 - Bonyolulabb, de sokoldalú kódszerkesztők: [Vim](http://www.vim.org/) és [Emacs](https://www.gnu.org/software/emacs/)
+=======
+There are many options, for instance:
+
+- [Sublime Text](https://www.sublimetext.com/) (cross-platform, shareware).
+- [Notepad++](https://notepad-plus-plus.org/) (Windows, free).
+- [Vim](https://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ## Parttalan viták helyett
 
 A felsorolt IDE-k és szerkesztők széles körben elterjedt, hosszú évek óta használt eszközök.
 
 Számtalan egyéb, kiváló kódszerkesztő van. Válasszuk a nekünk legmegfelelőbbet!
 
+<<<<<<< HEAD
 A választott kódszerkesztő, sok más eszközhöz hasonlóan, egyéni szükségletek, szokások és személyes ízlés dolga.
+=======
+The choice of an editor, like any other tool, is individual and depends on your projects, habits, and personal preferences.
+
+The author's personal opinion:
+
+- I'd use [Visual Studio Code](https://code.visualstudio.com/) if I develop mostly frontend.
+- Otherwise, if it's mostly another language/platform and partially frontend, then consider other editors, such as XCode (Mac), Visual Studio (Windows) or Jetbrains family (Webstorm, PHPStorm, RubyMine etc, depending on the language).
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b