Merge pull request #12 from javascript-tutorial/master

english

Author: otmon76

.gitignore

@@ -21,7 +21,4 @@ sftp-config.json
 Thumbs.db
 
 
-*.bak
-token.txt
-/svgs
-
+/svgs

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

@@ -1,41 +1,37 @@
 
-# Manuály a specifikace
+# Manuals and specifications
 
-Tato kniha je *tutoriál*, jehož cílem je pomoci vám postupně se naučit jazyk. Až ovšem budete znát základy, budete potřebovat i jiné zdroje.
+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.
 
-## Specifikace
+## Specification
 
-[Specifikace ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) obsahuje nejhlubší, nejpodrobnější a nejformalizovanější informace o JavaScriptu. Ta definuje tento jazyk.
+[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.
 
-Avšak právě kvůli této vysoké formálnosti je obtížné jí na první pohled porozumět. Potřebujete-li tedy co nejdůvěryhodnější zdroj informací o detailech JavaScriptu, tato specifikace je správné místo. Ke každodennímu použití se však nehodí.
+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.
 
-Každý rok se vydává nová verze specifikace. Poslední návrh nového vydání specifikace najdete na <https://tc39.es/ecma262/>.
+A new specification version is released every year. In-between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
 
-Chcete-li si přečíst o zbrusu nových vlastnostech, včetně těch, které jsou „téměř standardem“ (tzv. „3. stadium“), viz propozice na <https://github.com/tc39/proposals>.
+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>.
 
-Pokud vyvíjíte pro prohlížeč, existují i další specifikace uvedené ve [druhé části](info:browser-environment) tutoriálu.
+Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of the tutorial.
 
-## Manuály
+## Manuals
 
-- **MDN (Mozilla) JavaScript Reference** je manuál s příklady a dalšími informacemi. Výborně poslouží pro získání podrobných informací o jednotlivých funkcích jazyka, metodách atd.
+- **MDN (Mozilla) JavaScript Reference** is the main manual with examples and other information. It's great to get in-depth information about individual language functions, methods etc.
 
-	Lze jej najít na <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
-	
-	Často je však nejlepší použít obyčejné internetové vyhledávání. Do dotazu jednoduše napište „MDN [pojem]“, např. pro vyhledávání funkce `parseInt` zadejte <https://google.com/search?q=MDN+parseInt>.
+    One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
 
-- **MSDN** – Manuál od Microsoftu s mnoha informacemi včetně těch o JavaScriptu (v IE se mu říká JScript). Potřebujete-li něco specifického ohledně Internet Exploreru, je lepší zavítat na: <http://msdn.microsoft.com/>.
+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.
 
-	Můžete také použít internetové vyhledávání s frázemi jako „RegExp MSDN“ nebo „RegExp MSDN jscript“.
+## Compatibility tables
 
-## Tabulky kompatibility
+JavaScript is a developing language, new features get added regularly.
 
-JavaScript je neustále vyvíjen a pravidelně se do něj přidávají nové vlastnosti.
+To see their support among browser-based and other engines, see:
 
-Chcete-li vědět, v jakých enginech jsou tyto vlastnosti už podporovány, podívejte se na:
+- <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> - pro každou vlastnost obsahuje tabulku enginů, které ji podporují, např. chcete-li vidět, které enginy podporují moderní kryptografické funkce, jděte na <http://caniuse.com/#feat=cryptography>. 
-- <https://kangax.github.io/compat-table> - tabulka vlastností jazyka a enginů, které je podporují nebo nepodporují.
+All these resources are useful in real-life development, as they contain valuable information about language details, their support etc.
 
-Všechny tyto zdroje se vám budou při vývoji hodit, jelikož obsahují cenné informace o detailech jazyka, jejich podpoře apod.
-
-Pamatujte si je (nebo tuto stránku) pro případ, že byste potřebovali podrobné informace o určité vlastnosti.
+Please remember them (or this page) for the cases when you need in-depth information about a particular feature.

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

@@ -1,45 +1,45 @@
-# Editory kódu
+# Code editors
 
-Editor kódu je místo, v němž programátoři tráví většinu času.
+A code editor is the place where programmers spend most of their time.
 
-Editory kódu se dělí na dva hlavní druhy: vývojová prostředí (IDE) a textové editory. Mnozí lidé používají jeden nástroj od každého druhu.
+There are two main types of code editors: IDEs and lightweight editors. Many people use one tool of each type.
 
 ## IDE
 
-Pojem [vývojové prostředí](https://cs.wikipedia.org/wiki/Vývojové_prostředí), zkráceně IDE (z anglického Integrated Development Environment) označuje  specializovaný editor s rozšířenou funkčností, který obvykle pracuje s celým projektovým adresářem. Jak název napovídá, není to pouhý editor, ale plnohodnotné „vývojové prostředí“.
+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."
 
-IDE načítá projekt (který se může skládat z mnoha souborů), umožňuje navigaci mezi soubory, radí vývojáři skrze automatické doplňování založené na celém projektu (nejenom na právě otevřeném souboru) a je propojen s verzovacím systémem (např. [git](https://git-scm.com/)), testovacím prostředím a dalšími pomůckami na „projektové úrovni“.
+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.
 
-Pokud jste si IDE ještě nevybrali, zvažte následující možnosti:
+If you haven't selected an IDE yet, consider the following options:
 
-- [Visual Studio Code](https://code.visualstudio.com/) (různé platformy, zdarma).
-- [WebStorm](http://www.jetbrains.com/webstorm/) (různé platformy, placené).
+- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
+- [WebStorm](http://www.jetbrains.com/webstorm/) (cross-platform, paid).
 
-Pro Windows existuje také „Visual Studio“ (nezaměňovat s „Visual Studio Code“), což je placený, ale silný editor pouze pro Windows, velmi vhodný pro platformu .NET, který funguje dobře i pro JavaScript. Má i neplacenou verzi [Visual Studio Community](https://www.visualstudio.com/vs/community/).
+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/).
 
-Mnoho IDE je placených, ale mají zkušební dobu. Jejich cena je obvykle zanedbatelná ve srovnání s platem kvalifikovaného vývojáře, takže si bez obav vyberte to, které se vám zdá nejlepší.
+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.
 
-## Textové editory
+## Lightweight editors
 
-„Lehké“ textové editory (z anglického „lightweight editor“) nejsou tak silné jako IDE, ale jsou rychlé, elegantní a jednoduché.
+"Lightweight editors" are not as powerful as IDEs, but they're fast, elegant and simple.
 
-Používají se zejména k okamžitému otevření a editaci souboru.
+They are mainly used to open and edit a file instantly.
 
-Hlavní rozdíl mezi „textovým editorem“ a „IDE“ je, že „IDE“ pracuje na projektové úrovni, takže si při spuštění načítá mnohem více dat, analyzuje strukturu projektu, je-li to zapotřebí, a podobně. Potřebujeme-li editovat pouze jeden soubor, textový editor to zvládne mnohem rychleji.
+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.
 
-V praxi mají textové editory obvykle velké množství zásuvných modulů a rozšíření včetně syntaktických analyzátorů a automatického doplňování na adresářové úrovni, takže mezi textovými editory a vývojovými prostředími neexistuje pevně daná hranice.
+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.
 
-Vaši pozornost si zasluhují následující možnosti:
+The following options deserve your attention:
 
-- [Atom](https://atom.io/) (různé platformy, zdarma).
-- [Sublime Text](http://www.sublimetext.com) (různé platformy, shareware).
-- [Notepad++](https://notepad-plus-plus.org/) (Windows, zdarma).
-- Také [Vim](http://www.vim.org/) a [Emacs](https://www.gnu.org/software/emacs/) jsou výborné, jestliže je umíte používat.
+- [Atom](https://atom.io/) (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.
 
-## Nehádejme se
+## Let's not argue
 
-Ve výše uvedených seznamech jsou zmíněny editory, které já nebo moji přátelé, které považuji za dobré vývojáře, dlouhou dobu používáme a jsme s nimi spokojeni.
+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.
 
-Svět je velký a existují v něm i jiné skvělé editory. Vyberte si prosím ten, který se vám nejvíce líbí.
+There are other great editors in our big world. Please choose the one you like the most.
 
-Výběr editoru, stejně jako výběr každého nástroje, je individuální záležitost a závisí na projektech, zvyklostech a osobním vkusu každého vývojáře.
+The choice of an editor, like any other tool, is individual and depends on your projects, habits, and personal preferences.

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

@@ -1,63 +1,63 @@
-# Vývojářská konzole
+# Developer console
 
-Kód je náchylný k chybám. Je pravděpodobné, že budete dělat chyby... Co to povídám? *Zaručeně* budete dělat chyby, jestliže jste člověk a ne [robot](https://cs.wikipedia.org/wiki/Bender_(Futurama)).
+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)).
 
-V prohlížeči však uživatelé chyby standardně nevidí. Jestliže je tedy ve skriptu něco špatně, nevidíme co a nemůžeme to opravit.
+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.
 
-Abychom viděli chyby a získali spoustu dalších užitečných informací o skriptech, byly do prohlížečů zahrnuty „vývojářské nástroje“.
+To see errors and get a lot of other useful information about scripts, "developer tools" have been embedded in browsers.
 
-Většina vývojářů tíhne k vývoji v Chrome nebo Firefoxu, protože mají vyhlášené vývojářské nástroje. Jiné prohlížeče rovněž poskytují vývojářské nástroje, někdy se speciálními vlastnostmi, ale obvykle jen „dohánějí“ Chrome nebo Firefox. Většina vývojářů tedy má svůj „oblíbený“ prohlížeč a k jinému se uchýlí jen tehdy, řeší-li problém specifický pro určitý prohlížeč.
+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.
 
-Vývojářské nástroje jsou silné a mají mnoho funkcí. Pro začátek se naučíme, jak je otevřít, podívat se na chyby a spustit v nich příkazy JavaScriptu.
+Developer tools are potent; they have many features. To start, we'll learn how to open them, look at errors, and run JavaScript commands.
 
 ## Google Chrome
 
-Otevřete si stránku [bug.html](bug.html).
+Open the page [bug.html](bug.html).
 
-V JavaScriptovém kódu na této stránce je chyba. Před očima běžného uživatele je skrytá, a tak otevřeme vývojářské nástroje, abychom ji viděli.
+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.
 
-Stiskněte `key:F12` nebo, máte-li Mac, stiskněte `key:Cmd+Opt+J`.
+Press `key:F12` or, if you're on Mac, then `key:Cmd+Opt+J`.
 
-Otevřou se vývojářské nástroje na záložce „Console“. 
+The developer tools will open on the Console tab by default.
 
-Budou vypadat zhruba takto:
+It looks somewhat like this:
 
 ![chrome](chrome.png)
 
-Vzhled vývojářských nástrojů závisí na vaší verzi Chrome. Čas od času se mění, ale měl by se podobat obrázku.
+The exact look of developer tools depends on your version of Chrome. It changes from time to time but should be similar.
 
-- Zde vidíte červenou chybovou zprávu. V tomto případě skript obsahuje neznámý příkaz „lalala“.
-- Napravo vidíte kliknutelný odkaz na zdrojový kód `bug.html:12` s číslem řádku, na němž se chyba vyskytla.
+- 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.
 
-Pod chybovou zprávou se nachází modrý symbol `>`, který označuje „příkazový řádek“, na němž můžeme psát příkazy JavaScriptu. Stisknutím `key:Enter` je spustíte.
+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.
 
-Nyní vidíme chyby a to pro začátek stačí. K vývojářským nástrojům se později vrátíme a ladění se budeme hlouběji věnovat v kapitole <info:debugging-chrome>.
+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>.
 
-```smart header="Víceřádkový vstup"
-Obvykle když napíšeme do konzole řádek kódu a stiskneme `key:Enter`, řádek se vykoná.
+```smart header="Multi-line input"
+Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
 
-Chcete-li vložit více řádků, stiskněte `key:Shift+Enter`. Tímto způsobem můžeme vkládat delší fragmenty JavaScriptového kódu.
+To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code.
 ```
 
-## Firefox, Edge a ostatní
+## Firefox, Edge, and others
 
-Většina ostatních prohlížečů rovněž využívá k otevření vývojářských nástrojů klávesu  `key:F12`.
+Most other browsers use `key:F12` to open developer tools.
 
-Jejich vzhled je vcelku podobný. Až budete vědět, jak používat nástroje v jednom prohlížeči (můžete začít s Chromem), budete moci snadno přejít na jiný.
+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.
 
 ## Safari
 
-Safari (prohlížeč pro Mac, není podporován ve Windows nebo Linuxu) je v tomto ohledu trochu zvláštní. Nejprve musíme povolit „menu Vývoj“.
+Safari (Mac browser, not supported by Windows/Linux) is a little bit special here. We need to enable the "Develop menu" first.
 
-Otevřete „Preferences“ a jděte na záložku „Advanced“. Dole uvidíte checkbox, který zaškrtněte:
+Open Preferences and go to the "Advanced" pane. There's a checkbox at the bottom:
 
 ![safari](safari.png)
 
-Nyní můžete zapínat konzoli pomocí `key:Cmd+Opt+C`. Všimněte si také, že v horním menu se objevila nová položka s názvem „Develop“ („Vývoj“), která obsahuje mnoho příkazů a nastavení.
+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.
 
-## Shrnutí
+## Summary
 
-- Vývojářské nástroje nám umožňují vidět chyby, prozkoumávat proměnné a mnoho dalšího.
-- Ve většině prohlížečů ve Windows se otevírají klávesou `key:F12`. Chrome pro Mac vyžaduje `key:Cmd+Opt+J`, Safari `key:Cmd+Opt+C` (zde je třeba je napřed povolit).
+- 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).
 
-Nyní máme prostředí připraveno a v příští kapitole již přejdeme k samotnému JavaScriptu.
+Now we have the environment ready. In the next section, we'll get down to JavaScript.

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

@@ -1,3 +1,3 @@
-# Úvod
+# An introduction
 
-O jazyku JavaScript a jeho vývojovém prostředí.
+About the JavaScript language and the environment to develop with it.

1-js/01-getting-started/index.md

@@ -4,7 +4,7 @@
 <body>
 
   <script>
-    alert( "Já jsem JavaScript!" );
+    alert( "I'm JavaScript!" );
   </script>
 
 </body>

1-js/02-first-steps/01-hello-world/1-hello-alert/index.html

@@ -1,12 +1,12 @@
-důležitost: 5
+importance: 5
 
 ---
 
-# Zobrazte zprávu
+# Show an alert
 
-Vytvořte stránku, která zobrazí zprávu „Já jsem JavaScript!“.
+Create a page that shows a message "I'm JavaScript!".
 
-Nezáleží na tom, zda to uděláte na pískovišti nebo na svém harddisku, jen se snažte, aby to fungovalo.
+Do it in a sandbox, or on your hard drive, doesn't matter, just ensure that it works.
 
 [demo src="solution"]
 

1-js/02-first-steps/01-hello-world/1-hello-alert/task.md

@@ -1 +1 @@
-alert("Já jsem JavaScript!");
+alert("I'm JavaScript!");

1-js/02-first-steps/01-hello-world/2-hello-alert-ext/alert.js

@@ -1,7 +1,8 @@
-HTML kód:
+The HTML code:
 
 [html src="index.html"]
 
-Soubor `alert.js` ve stejné složce:
+For the file `alert.js` in the same folder:
 
 [js src="alert.js"]
+

1-js/02-first-steps/01-hello-world/2-hello-alert-ext/solution.md

@@ -2,8 +2,8 @@ importance: 5
 
 ---
 
-# Zobrazte zprávu pomocí externího skriptu
+# Show an alert with an external script
 
-Vezměte si řešení předchozí úlohy <info:task/hello-alert> a upravte je tak, že obsah skriptu umístíte do externího souboru `alert.js`, který bude umístěn ve stejné složce.
+Take the solution of the previous task <info:task/hello-alert>. Modify it by extracting the script content into an external file `alert.js`, residing in the same folder.
 
-Otevřete stránku a ujistěte se, že zobrazování zprávy funguje.
+Open the page, ensure that the alert works.