Skip to content

Commit 50964a0

Browse files
authored
Merge pull request #12 from javascript-tutorial/master
english
2 parents 0e0fb5a + d822cd8 commit 50964a0

File tree

622 files changed

+15971
-16954
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

622 files changed

+15971
-16954
lines changed

.gitignore

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,4 @@ sftp-config.json
2121
Thumbs.db
2222

2323

24-
*.bak
25-
token.txt
26-
/svgs
27-
24+
/svgs

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

Lines changed: 69 additions & 69 deletions
Large diffs are not rendered by default.
Lines changed: 19 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,37 @@
11

2-
# Manuály a specifikace
2+
# Manuals and specifications
33

4-
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.
4+
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.
55

6-
## Specifikace
6+
## Specification
77

8-
[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.
8+
[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.
99

10-
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í.
10+
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.
1111

12-
Každý rok se vydává nová verze specifikace. Poslední návrh nového vydání specifikace najdete na <https://tc39.es/ecma262/>.
12+
A new specification version is released every year. In-between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
1313

14-
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>.
14+
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>.
1515

16-
Pokud vyvíjíte pro prohlížeč, existují i další specifikace uvedené ve [druhé části](info:browser-environment) tutoriálu.
16+
Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of the tutorial.
1717

18-
## Manuály
18+
## Manuals
1919

20-
- **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.
20+
- **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.
2121

22-
Lze jej najít na <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
23-
24-
Č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>.
22+
One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
2523

26-
- **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/>.
24+
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.
2725

28-
Můžete také použít internetové vyhledávání s frázemi jako „RegExp MSDN“ nebo „RegExp MSDN jscript“.
26+
## Compatibility tables
2927

30-
## Tabulky kompatibility
28+
JavaScript is a developing language, new features get added regularly.
3129

32-
JavaScript je neustále vyvíjen a pravidelně se do něj přidávají nové vlastnosti.
30+
To see their support among browser-based and other engines, see:
3331

34-
Chcete-li vědět, v jakých enginech jsou tyto vlastnosti už podporovány, podívejte se na:
32+
- <http://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <http://caniuse.com/#feat=cryptography>.
33+
- <https://kangax.github.io/compat-table> - a table with language features and engines that support those or don't support.
3534

36-
- <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>.
37-
- <https://kangax.github.io/compat-table> - tabulka vlastností jazyka a enginů, které je podporují nebo nepodporují.
35+
All these resources are useful in real-life development, as they contain valuable information about language details, their support etc.
3836

39-
Všechny tyto zdroje se vám budou při vývoji hodit, jelikož obsahují cenné informace o detailech jazyka, jejich podpoře apod.
40-
41-
Pamatujte si je (nebo tuto stránku) pro případ, že byste potřebovali podrobné informace o určité vlastnosti.
37+
Please remember them (or this page) for the cases when you need in-depth information about a particular feature.
Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,45 @@
1-
# Editory kódu
1+
# Code editors
22

3-
Editor kódu je místo, v němž programátoři tráví většinu času.
3+
A code editor is the place where programmers spend most of their time.
44

5-
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.
5+
There are two main types of code editors: IDEs and lightweight editors. Many people use one tool of each type.
66

77
## IDE
88

9-
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í“.
9+
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."
1010

11-
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“.
11+
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.
1212

13-
Pokud jste si IDE ještě nevybrali, zvažte následující možnosti:
13+
If you haven't selected an IDE yet, consider the following options:
1414

15-
- [Visual Studio Code](https://code.visualstudio.com/) (různé platformy, zdarma).
16-
- [WebStorm](http://www.jetbrains.com/webstorm/) (různé platformy, placené).
15+
- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
16+
- [WebStorm](http://www.jetbrains.com/webstorm/) (cross-platform, paid).
1717

18-
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/).
18+
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/).
1919

20-
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ší.
20+
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.
2121

22-
## Textové editory
22+
## Lightweight editors
2323

24-
„Lehké“ textové editory (z anglického „lightweight editor“) nejsou tak silné jako IDE, ale jsou rychlé, elegantní a jednoduché.
24+
"Lightweight editors" are not as powerful as IDEs, but they're fast, elegant and simple.
2525

26-
Používají se zejména k okamžitému otevření a editaci souboru.
26+
They are mainly used to open and edit a file instantly.
2727

28-
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.
28+
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.
2929

30-
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.
30+
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.
3131

32-
Vaši pozornost si zasluhují následující možnosti:
32+
The following options deserve your attention:
3333

34-
- [Atom](https://atom.io/) (různé platformy, zdarma).
35-
- [Sublime Text](http://www.sublimetext.com) (různé platformy, shareware).
36-
- [Notepad++](https://notepad-plus-plus.org/) (Windows, zdarma).
37-
- Také [Vim](http://www.vim.org/) a [Emacs](https://www.gnu.org/software/emacs/) jsou výborné, jestliže je umíte používat.
34+
- [Atom](https://atom.io/) (cross-platform, free).
35+
- [Sublime Text](http://www.sublimetext.com) (cross-platform, shareware).
36+
- [Notepad++](https://notepad-plus-plus.org/) (Windows, free).
37+
- [Vim](http://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them.
3838

39-
## Nehádejme se
39+
## Let's not argue
4040

41-
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.
41+
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.
4242

43-
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í.
43+
There are other great editors in our big world. Please choose the one you like the most.
4444

45-
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.
45+
The choice of an editor, like any other tool, is individual and depends on your projects, habits, and personal preferences.
Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,63 +1,63 @@
1-
# Vývojářská konzole
1+
# Developer console
22

3-
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)).
3+
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)).
44

5-
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.
5+
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.
66

7-
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“.
7+
To see errors and get a lot of other useful information about scripts, "developer tools" have been embedded in browsers.
88

9-
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č.
9+
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.
1010

11-
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.
11+
Developer tools are potent; they have many features. To start, we'll learn how to open them, look at errors, and run JavaScript commands.
1212

1313
## Google Chrome
1414

15-
Otevřete si stránku [bug.html](bug.html).
15+
Open the page [bug.html](bug.html).
1616

17-
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.
17+
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.
1818

19-
Stiskněte `key:F12` nebo, máte-li Mac, stiskněte `key:Cmd+Opt+J`.
19+
Press `key:F12` or, if you're on Mac, then `key:Cmd+Opt+J`.
2020

21-
Otevřou se vývojářské nástroje na záložce „Console“.
21+
The developer tools will open on the Console tab by default.
2222

23-
Budou vypadat zhruba takto:
23+
It looks somewhat like this:
2424

2525
![chrome](chrome.png)
2626

27-
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.
27+
The exact look of developer tools depends on your version of Chrome. It changes from time to time but should be similar.
2828

29-
- Zde vidíte červenou chybovou zprávu. V tomto případě skript obsahuje neznámý příkaz „lalala.
30-
- Napravo vidíte kliknutelný odkaz na zdrojový kód `bug.html:12` s číslem řádku, na němž se chyba vyskytla.
29+
- Here we can see the red-colored error message. In this case, the script contains an unknown "lalala" command.
30+
- On the right, there is a clickable link to the source `bug.html:12` with the line number where the error has occurred.
3131

32-
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.
32+
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.
3333

34-
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>.
34+
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>.
3535

36-
```smart header="Víceřádkový vstup"
37-
Obvykle když napíšeme do konzole řádek kódu a stiskneme `key:Enter`, řádek se vykoná.
36+
```smart header="Multi-line input"
37+
Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
3838
39-
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.
39+
To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code.
4040
```
4141

42-
## Firefox, Edge a ostatní
42+
## Firefox, Edge, and others
4343

44-
Většina ostatních prohlížečů rovněž využívá k otevření vývojářských nástrojů klávesu `key:F12`.
44+
Most other browsers use `key:F12` to open developer tools.
4545

46-
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ý.
46+
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.
4747

4848
## Safari
4949

50-
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“.
50+
Safari (Mac browser, not supported by Windows/Linux) is a little bit special here. We need to enable the "Develop menu" first.
5151

52-
Otevřete „Preferences“ a jděte na záložku „Advanced“. Dole uvidíte checkbox, který zaškrtněte:
52+
Open Preferences and go to the "Advanced" pane. There's a checkbox at the bottom:
5353

5454
![safari](safari.png)
5555

56-
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í.
56+
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.
5757

58-
## Shrnutí
58+
## Summary
5959

60-
- Vývojářské nástroje nám umožňují vidět chyby, prozkoumávat proměnné a mnoho dalšího.
61-
- 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).
60+
- Developer tools allow us to see errors, run commands, examine variables, and much more.
61+
- 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).
6262

63-
Nyní máme prostředí připraveno a v příští kapitole již přejdeme k samotnému JavaScriptu.
63+
Now we have the environment ready. In the next section, we'll get down to JavaScript.

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
1-
# Úvod
1+
# An introduction
22

3-
O jazyku JavaScript a jeho vývojovém prostředí.
3+
About the JavaScript language and the environment to develop with it.

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<body>
55

66
<script>
7-
alert( "Já jsem JavaScript!" );
7+
alert( "I'm JavaScript!" );
88
</script>
99

1010
</body>
Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
důležitost: 5
1+
importance: 5
22

33
---
44

5-
# Zobrazte zprávu
5+
# Show an alert
66

7-
Vytvořte stránku, která zobrazí zprávu „Já jsem JavaScript!.
7+
Create a page that shows a message "I'm JavaScript!".
88

9-
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.
9+
Do it in a sandbox, or on your hard drive, doesn't matter, just ensure that it works.
1010

1111
[demo src="solution"]
1212

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
alert("Já jsem JavaScript!");
1+
alert("I'm JavaScript!");
Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
1-
HTML kód:
1+
The HTML code:
22

33
[html src="index.html"]
44

5-
Soubor `alert.js` ve stejné složce:
5+
For the file `alert.js` in the same folder:
66

77
[js src="alert.js"]
8+

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@ importance: 5
22

33
---
44

5-
# Zobrazte zprávu pomocí externího skriptu
5+
# Show an alert with an external script
66

7-
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.
7+
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.
88

9-
Otevřete stránku a ujistěte se, že zobrazování zprávy funguje.
9+
Open the page, ensure that the alert works.

0 commit comments

Comments
 (0)