Skip to content

Commit 49b0bbf

Browse files
committed
translated headers of 01-getting started
1 parent 62afefc commit 49b0bbf

File tree

6 files changed

+29
-31
lines changed

6 files changed

+29
-31
lines changed

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

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
1-
# An Introduction to JavaScript
1+
# JavaScript-ə giriş
22

33
Let's see what's so special about JavaScript, what we can achieve with it, and which other technologies play well with it.
44

55
## What is JavaScript?
66

7-
*JavaScript* was initially created to *"make web pages alive"*.
7+
_JavaScript_ was initially created to _"make web pages alive"_.
88

9-
The programs in this language are called *scripts*. They can be written right in a web page's HTML and run automatically as the page loads.
9+
The programs in this language are called _scripts_. They can be written right in a web page's HTML and run automatically as the page loads.
1010

1111
Scripts are provided and executed as plain text. They don't need special preparation or compilation to run.
1212

13-
In this aspect, JavaScript is very different from another language called [Java](https://en.wikipedia.org/wiki/Java_(programming_language)).
13+
In this aspect, JavaScript is very different from another language called [Java](<https://en.wikipedia.org/wiki/Java_(programming_language)>).
1414

1515
```smart header="Why <u>Java</u>Script?"
1616
When JavaScript was created, it initially had another name: "LiveScript". But Java was very popular at that time, so it was decided that positioning a new language as a "younger brother" of Java would help.
@@ -24,7 +24,7 @@ The browser has an embedded engine sometimes called a "JavaScript virtual machin
2424

2525
Different engines have different "codenames". For example:
2626

27-
- [V8](https://en.wikipedia.org/wiki/V8_(JavaScript_engine)) -- in Chrome and Opera.
27+
- [V8](<https://en.wikipedia.org/wiki/V8_(JavaScript_engine)>) -- in Chrome and Opera.
2828
- [SpiderMonkey](https://en.wikipedia.org/wiki/SpiderMonkey) -- in Firefox.
2929
- ...There are other codenames like "Trident" and "Chakra" for different versions of IE, "ChakraCore" for Microsoft Edge, "Nitro" and "SquirrelFish" for Safari, etc.
3030

@@ -53,7 +53,7 @@ For instance, in-browser JavaScript is able to:
5353

5454
- Add new HTML to the page, change the existing content, modify styles.
5555
- React to user actions, run on mouse clicks, pointer movements, key presses.
56-
- Send requests over the network to remote servers, download and upload files (so-called [AJAX](https://en.wikipedia.org/wiki/Ajax_(programming)) and [COMET](https://en.wikipedia.org/wiki/Comet_(programming)) technologies).
56+
- Send requests over the network to remote servers, download and upload files (so-called [AJAX](<https://en.wikipedia.org/wiki/Ajax_(programming)>) and [COMET](<https://en.wikipedia.org/wiki/Comet_(programming)>) technologies).
5757
- Get and set cookies, ask questions to the visitor, show messages.
5858
- Remember the data on the client-side ("local storage").
5959

@@ -65,14 +65,16 @@ Examples of such restrictions include:
6565

6666
- JavaScript on a webpage may not read/write arbitrary files on the hard disk, copy them or execute programs. It has no direct access to OS system functions.
6767

68-
Modern browsers allow it to work with files, but the access is limited and only provided if the user does certain actions, like "dropping" a file into a browser window or selecting it via an `<input>` tag.
68+
Modern browsers allow it to work with files, but the access is limited and only provided if the user does certain actions, like "dropping" a file into a browser window or selecting it via an `<input>` tag.
69+
70+
There are ways to interact with 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).
6971

70-
There are ways to interact with 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).
7172
- 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 if they come from different sites (from a different domain, protocol or port).
7273

73-
This is called the "Same Origin Policy". To work around that, *both pages* must agree for data exchange and contain a special JavaScript code that handles it. We'll cover that in the tutorial.
74+
This is called the "Same Origin Policy". To work around that, _both pages_ must agree for data exchange and contain a special JavaScript code that handles it. We'll cover that in the tutorial.
75+
76+
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` and steal information from there.
7477

75-
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` and steal information from there.
7678
- 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.
7779

7880
![](limitations.svg)
@@ -81,13 +83,14 @@ Such limits do not exist if JavaScript is used outside of the browser, for examp
8183

8284
## What makes JavaScript unique?
8385

84-
There are at least *three* great things about JavaScript:
86+
There are at least _three_ great things about JavaScript:
8587

8688
```compare
8789
+ Full integration with HTML/CSS.
8890
+ Simple things are done simply.
8991
+ Support by all major browsers and enabled by default.
9092
```
93+
9194
JavaScript is the only browser technology that combines these three things.
9295

9396
That's what makes JavaScript unique. That's why it's the most widespread tool for creating browser interfaces.
@@ -100,7 +103,7 @@ The syntax of JavaScript does not suit everyone's needs. Different people want d
100103

101104
That's to be expected, because projects and requirements are different for everyone.
102105

103-
So recently a plethora of new languages appeared, which are *transpiled* (converted) to JavaScript before they run in the browser.
106+
So recently a plethora of new languages appeared, which are _transpiled_ (converted) to JavaScript before they run in the browser.
104107

105108
Modern tools make the transpilation very fast and transparent, actually allowing developers to code in another language and auto-converting it "under the hood".
106109

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

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
1+
# Nizamnamə və spesifikasiyalar
12

2-
# Manuals and specifications
3-
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.
3+
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.
54

65
## Specification
76

@@ -19,14 +18,13 @@ Also, if you're in developing for the browser, then there are other specs covere
1918

2019
- **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.
2120

22-
One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
23-
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.
21+
One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
2522

23+
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.
2624

27-
- **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/>.
25+
* **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/>.
2826

29-
Also, we can use an internet search with phrases such as "RegExp MSDN" or "RegExp MSDN jscript".
27+
Also, we can use an internet search with phrases such as "RegExp MSDN" or "RegExp MSDN jscript".
3028

3129
## Compatibility tables
3230

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Code editors
1+
# Kod redaktorları
22

33
A code editor is the place where programmers spend most of their time.
44

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

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Developer console
1+
# Developer konsolu
22

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)).
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

55
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

@@ -33,7 +33,6 @@ Below the error message, there is a blue `>` symbol. It marks a "command line" w
3333

3434
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-
3736
## Firefox, Edge, and others
3837

3938
Most other browsers use `key:F12` to open developer tools.

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-
# An introduction
1+
# Giriş
22

3-
About the JavaScript language and the environment to develop with it.
3+
JavaScript dili və development mühiti haqqında.

1-js/index.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,4 @@
1-
# The JavaScript language
2-
3-
Here we learn JavaScript, starting from scratch and go on to advanced concepts like OOP.
4-
5-
We concentrate on the language itself here, with the minimum of environment-specific notes.
1+
# JavaScript dili
62

3+
Burada biz JavaScript-in əsaslarından başlayıb, dərinliklərinə qədər öyrənəcəyik.
4+
Bu fəsil, mühitə xas xüsusiyyətlərdən daha çox JavaScript-in özünə fokuslanacaq.

0 commit comments

Comments
 (0)