Skip to content

Commit 5da3e94

Browse files
committed
merging all conflicts
2 parents 12f2526 + 035c526 commit 5da3e94

File tree

243 files changed

+6339
-231
lines changed

Some content is hidden

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

243 files changed

+6339
-231
lines changed

Diff for: .github/FUNDING.yml

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
github: iliakan

Diff for: 1-js/01-getting-started/1-intro/article.md

+47
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,12 @@ I nomi citati sopra possono essere utili da ricordare, poiché si possono trovar
3434
3535
Il funzionamento di questi motori è complicato, ma i concetti alla base sono semplici.
3636
37+
<<<<<<< HEAD
38+
=======
39+
1. The engine (embedded if it's a browser) reads ("parses") the script.
40+
2. Then it converts ("compiles") the script to machine code.
41+
3. And then the machine code runs, pretty fast.
42+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
3743
3844
1. I motori (integrati nei browser) leggono ("analizzano") lo script.
3945
2. Successivamente convertono ("compilano") lo script nel linguaggio della macchina.
@@ -44,7 +50,11 @@ Il motore ottimizza il codice ad ogni passaggio del processo, anche durante l'es
4450

4551
## Cosa può fare JavaScript a livello browser?
4652

53+
<<<<<<< HEAD
4754
JavaScript, al giorno d'oggi, è un linguaggio di programmazione "sicuro". Non consente alcun accesso di basso livello alla memoria o alla CPU. Questo perché è stato creato con lo scopo di funzionare nei browser, che non richiedono questi tipi di privilegi.
55+
=======
56+
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.
57+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
4858
4959
Le capacità di JavaScript dipendono molto dall'ambiente in cui lo si esegue. Ad esempio, [Node.js](https://wikipedia.org/wiki/Node.js) supporta funzioni che consentono a JavaScript di scrivere/leggere file, eseguire richieste web, etc.
5060

@@ -60,14 +70,19 @@ Ad esempio, è possibile:
6070

6171
## Cosa NON può fare JavaScript a livello browser?
6272

73+
<<<<<<< HEAD
6374
Per la sicurezza dell'utente, le possibilità di JavaScript nel browser sono limitate. L'intento è di prevenire che una pagina "maligna" tenti di accedere alle informazioni personali o di danneggiare i dati degli utenti.
75+
=======
76+
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.
77+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
6478
6579
Esempi di queste restrizioni possono essere:
6680

6781
- JavaScript, in una pagina web, non può leggere o scrivere in qualsiasi file nell'hard disk, né copiare o eseguire programmi. Non ha accesso diretto alle funzioni del sistema operativo.
6882

6983
I moderni browser gli consentono di lavorare con i file, sempre con un accesso limitato e comunque solo se il comando proviene da utente, come il "dropping" di un file nella finestra del browser, o con la selezione tramite il tag `<input>`.
7084

85+
<<<<<<< HEAD
7186
Ci sono anche funzionalità che consentono di interagire con la camera/microfono e altri dispositivi, ma in ogni caso richiedono il permesso esplicito dell'utente. Quindi una pagina con JavaScript abilitato non può attivare la web-cam di nascosto, osservare i nostri comportamenti e inviare informazioni alla [CIA](https://it.wikipedia.org/wiki/Central_Intelligence_Agency).
7287
- Pagine o schede diverse generalmente non sono a conoscenza dell'esistenza delle altre. In certi casi, tuttavia, può capitare; ad esempio quando una finestra ne apre un'altra tramite JavaScript. Ma anche in questo caso, il codice JavaScript non può accedere all'altra pagina se non appartiene allo stesso sito (stesso dominio, protocollo o porta).
7388

@@ -79,6 +94,19 @@ Esempi di queste restrizioni possono essere:
7994
![](limitations.svg)
8095

8196
Queste limitazioni non si pongono se JavaScript viene eseguito fuori dal browser, ad esempio in un server. I browser moderni permettono l'installazione di plugin ed estensioni che consentono di estendere vari permessi.
97+
=======
98+
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).
99+
- 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).
100+
101+
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.
102+
103+
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.
104+
- 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.
105+
106+
![](limitations.svg)
107+
108+
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.
109+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
82110
83111
## Cosa rende JavaScript unico?
84112

@@ -93,20 +121,29 @@ JavaScript è l'unica tecnologia in ambiente browser che combina queste tre cara
93121

94122
Questo rende JavaScript unico. Ed è il motivo per cui è lo strumento più diffuso per creare interfacce web.
95123

124+
<<<<<<< HEAD
96125
Quando si ha in programma di imparare una nuova tecnologia, è fondamentale verificare le sue prospettive. Quindi diamo uno sguardo alle nuove tendenze che includono nuovi linguaggi e tecnologie.
126+
=======
127+
That said, JavaScript can be used to create servers, mobile applications, etc.
128+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
97129
98130
## Linguaggi "oltre" JavaScript
99131

100132
La sintassi di JavaScript non soddisfa le necessità di tutti. Alcune persone necessitano di caratteristiche differenti.
101133

102134
Questo è prevedibile, poiché i progetti e i requisiti sono diversi da persona a persona.
103135

136+
<<<<<<< HEAD
104137
Recentemente, per questo motivo, sono nati molti nuovi linguaggi che vengono *convertiti* in JavaScript prima di essere eseguiti nel browser.
138+
=======
139+
So, recently a plethora of new languages appeared, which are *transpiled* (converted) to JavaScript before they run in the browser.
140+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
105141
106142
Gli strumenti moderni rendono la conversione molto veloce e pulita, consentendo agli sviluppatori di programmare in un altro linguaggio e di auto-convertirlo *under the hood*.
107143

108144
Esempi di alcuni linguaggi:
109145

146+
<<<<<<< HEAD
110147
- [CoffeeScript](http://coffeescript.org/) è un linguaggio che introduce una sintassi semplificata che consente di scrivere codice più leggibile. Amato dagli sviluppatori provenienti da Ruby.
111148
- [TypeScript](http://www.typescriptlang.org/) si occupa di aggiungere la "tipizzazione", per semplificare lo sviluppo e supportare sistemi più complessi. E' stato sviluppato da Microsoft.
112149
- [Flow](http://flow.org/) anche'esso aggiunge la tipizzazione dei dati, ma in un modo differente. Sviluppato da Facebook.
@@ -115,6 +152,16 @@ Esempi di alcuni linguaggi:
115152
- [Kotlin](https://kotlinlang.org/docs/reference/js-overview.html) è un moderno, conciso e sicuro linguaggio di programmazione mirato ai browsers o a Node.
116153

117154
Ce ne sono molti altri. Ovviamente, per comprendere cosa stiamo facendo, se utilizziamo uno di questi linguaggi dovremmo altresì conoscere JavaScript.
155+
=======
156+
- [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.
157+
- [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.
158+
- [Flow](https://flow.org/) also adds data typing, but in a different way. Developed by Facebook.
159+
- [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.
160+
- [Brython](https://brython.info/) is a Python transpiler to JavaScript that enables the writing of applications in pure Python without JavaScript.
161+
- [Kotlin](https://kotlinlang.org/docs/reference/js-overview.html) is a modern, concise and safe programming language that can target the browser or Node.
162+
163+
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.
164+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
118165
119166
## Riepilogo
120167

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

+21
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,23 @@
11

22
# Manuali e Specifiche
33

4+
<<<<<<< HEAD
45
Questo libro è un *tutorial*. L'obiettivo è quello di aiutarti ad apprender il linguaggio gradualmente. Una volta che avrai familiarizzato con le basi avrai bisogno di ulteriori risorse.
6+
=======
7+
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.
8+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
59
610
## Specifiche
711

812
[La specifica ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contiene informazioni più dettagliate, approfondite e formalizzate riguardanti JavaScript. E' la definizione stessa del linguaggio.
913

1014
Iniziare a studiare dalla specifica può risultare difficile. Se avete bisogno di una fonte affidabile e formale riguardante i dettagli del linguaggio, la specifica è il posto in cui cercare. Ma non è una risorsa comoda da consultare per i problemi di tutti i giorni.
1115

16+
<<<<<<< HEAD
1217
Ogni anno viene rilasciata una nuova specifica. Di queste pubblicazioni, è possibile trovare l'ultima bozza a <https://tc39.es/ecma262/>.
18+
=======
19+
A new specification version is released every year. Between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
20+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
1321
1422
Per leggere delle più recenti caratteristiche, incluse quelle considerate "quasi standard" (definite "stage 3"), potete consultare <https://github.com/tc39/proposals>.
1523

@@ -19,16 +27,29 @@ Inoltre, se state sviluppando in ambiente browser, ci sono ulteriori specifiche
1927

2028
- **MDN (Mozilla) JavaScript Reference** è il manuale principale, corredato di spiegazioni teoriche, esempi ed altre informazioni utili. E' ottimo per avere informazioni dettagliate riguardo le funzioni e altre caratteristiche del linguaggio.
2129

30+
<<<<<<< HEAD
2231
Può essere consultato a <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
2332

2433
Tuttavia, spesso è meglio fare una ricerca su internet. E' sufficiente cercare "MDN", seguito dal termine da ricercare, e.g. <https://google.com/search?q=MDN+parseInt> per ricercare la funzione `parseInt`, oppure frasi come "RegExp MSDN" o "RegExp MSDN jscript".
34+
=======
35+
You can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
36+
37+
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.
38+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
2539
2640

2741
Può essere consultato al link <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
2842

2943
- **MSDN** – Manuale Microsoft con molte informazioni, tra cui su JavaScript (a cui viene fatto riferimento con il termine JScript). Se si ha bisogno di ottenere qualche informazione specifica per Internet Explorer, meglio consultare la guida: <http://msdn.microsoft.com/>.
3044

45+
<<<<<<< HEAD
46+
47+
=======
48+
- <https://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <https://caniuse.com/#feat=cryptography>.
49+
- <https://kangax.github.io/compat-table> - a table with language features and engines that support those or don't support.
3150

51+
All these resources are useful in real-life development, as they contain valuable information about language details, their support, etc.
52+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
3253
3354
## Tabelle di compatibilità
3455

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

+22
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,13 @@ Un IDE carica il progetto (possono essere molti file), consente la navigazione t
1212

1313
Se non hai ancora considerato di scegliere un IDE, dai un'occhiata a queste alternative:
1414

15+
<<<<<<< HEAD
1516
- [Visual Studio Code](https://code.visualstudio.com/) (*cross-platform*, gratutito).
1617
- [WebStorm](http://www.jetbrains.com/webstorm/) (*cross-platform*, a pagamento).
18+
=======
19+
- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
20+
- [WebStorm](https://www.jetbrains.com/webstorm/) (cross-platform, paid).
21+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
1722
1823
Per Windows, c'è anche l'editor "Visual Studio", da non confondere con "Visual Studio Code". "Visual Studio" è un potente editor (a pagamento) disponibile solo per Windows, ottimo per le piattaforme .NET. E' disponibile anche una versione gratuita: ([Visual Studio Community](https://www.visualstudio.com/vs/community/).
1924

@@ -29,18 +34,35 @@ La principale differenza tra gli editor semplici e un IDE è che quest'ultimo la
2934

3035
In pratica, tuttavia, gli editor semplici possono avere molti plugin, tra cui la sintassi a livello directory e l'autocompletamento, quindi non ci sono delle differenze ben definite tra un editor semplice e un IDE.
3136

37+
<<<<<<< HEAD
3238
Meritano attenzione le seguenti opzioni:
3339

3440
- [Atom](https://atom.io/) (*cross-platform*, gratuito).
3541
- [Visual Studio Code](https://code.visualstudio.com/) (*cross-platform*, gratuito).
3642
- [Sublime Text](http://www.sublimetext.com) (*cross-platform*, con prova gratuita).
3743
- [Notepad++](https://notepad-plus-plus.org/) (Windows, gratuito).
3844
- [Vim](http://www.vim.org/) e [Emacs](https://www.gnu.org/software/emacs/) sono particolarmente carini se si sanno utilizzare.
45+
=======
46+
There are many options, for instance:
47+
48+
- [Sublime Text](https://www.sublimetext.com/) (cross-platform, shareware).
49+
- [Notepad++](https://notepad-plus-plus.org/) (Windows, free).
50+
- [Vim](https://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them.
51+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
3952
4053
## Non intestarditevi
4154

4255
Gli editor elencanti sopra sono quelli che io e i miei amici, che considero buoni sviluppatori, abbiamo utilizzato senza problemi per molto tempo.
4356

4457
Ci sono altri grandi editor nel nostro grande mondo. Scegli quello che più ti si addice.
4558

59+
<<<<<<< HEAD
4660
La scelta di un editor, come pure di altri strumenti, è individuale e dipende dai progetti, dalle abitudini e preferenze personali.
61+
=======
62+
The choice of an editor, like any other tool, is individual and depends on your projects, habits, and personal preferences.
63+
64+
The author's personal opinion:
65+
66+
- I'd use [Visual Studio Code](https://code.visualstudio.com/) if I develop mostly frontend.
67+
- 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).
68+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9

Diff for: 1-js/02-first-steps/04-variables/3-uppercast-constant/task.md

+8-3
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,18 @@ const birthday = '18.04.1982';
1212
const age = someCode(birthday);
1313
```
1414

15+
<<<<<<< HEAD
1516
Abbiamo una costante `birthday` che indica una data e `age` che viene calcolata da `birthday` tramite un algoritmo (non viene fornito per brevità, e perchè non è importante per descrivere l'argomento).
17+
=======
18+
Here we have a constant `birthday` for the date, and also the `age` constant.
19+
20+
The `age` is calculated from `birthday` using `someCode()`, which means a function call that we didn't explain yet (we will soon!), but the details don't matter here, the point is that `age` is calculated somehow based on the `birthday`.
21+
>>>>>>> 035c5267ba80fa7b55878f7213cbde449b4092d9
1622
1723
Sarebbe giusto utilizzare lettere maiuscole per `birthday`? E per `age`? O anche per entrambe?
1824

1925
```js
20-
const BIRTHDAY = '18.04.1982'; // make uppercase?
26+
const BIRTHDAY = '18.04.1982'; // make birthday uppercase?
2127

22-
const AGE = someCode(BIRTHDAY); // make uppercase?
28+
const AGE = someCode(BIRTHDAY); // make age uppercase?
2329
```
24-

0 commit comments

Comments
 (0)