Merge pull request #7299 from Gioggio/master
Docs: Start Italian translations
This commit is contained in:
Kevin Sawicki
GitHub
commit
f5694daeb7
3 changed files with 513 additions and 0 deletions
100
docs-translations/it-IT/README.md
Normal file
100
docs-translations/it-IT/README.md
Normal file
|
|
@ -0,0 +1,100 @@
|
|||
Sii certo di usare la documentazione che corrisponde alla tua versione di
|
||||
Electron. Il numero della versione dovrebbe fare parte dell'URL della pagina.
|
||||
Se così non fosse, stai probabilmente utilizzando una documentazione facente
|
||||
parte di una branch di sviluppo che potrebbe contenere modifiche all'API che non
|
||||
sono compatibili con la tua versione di Electron. In questo caso, puoi passare a
|
||||
una differente versione della documentazione dalla lista di
|
||||
[versioni disponibili](http://electron.atom.io/docs/) su atom.io, o nel caso tu
|
||||
stia usando l'interfaccia di GitHub, apri il menu a tendina "Switch
|
||||
branches/tags" e seleziona il tag che corrisponde alla tua versione.
|
||||
|
||||
## FAQ
|
||||
|
||||
Ci sono domande che vengono chieste abbastanza spesso, quindi controlla questa
|
||||
sezione prima di creare una issue:
|
||||
|
||||
* [Electron FAQ](faq.md)
|
||||
|
||||
## Guide
|
||||
|
||||
* [Piattaforme Supportate](tutorial/piattaforme-supportate.md)
|
||||
* [Sicurezza](tutorial/sicurezza.md)
|
||||
* [Versionamento Electron](tutorial/versionamento-electron.md)
|
||||
* [Distribuzione dell'Applicazione](tutorial/distribuzione-applicazione.md)
|
||||
* [Guida Mac App Store](tutorial/guida-mac-app-store.md)
|
||||
* [Guida Windows Store](tutorial/guida-windows-store.md)
|
||||
* [Packaging Applicazione](tutorial/packaging-applicazione.md)
|
||||
* [Usare Moduli Node Nativi](tutorial/usare-moduli-node-nativi.md)
|
||||
* [Debugging Processo Principale](tutorial/debugging-processo-principale.md)
|
||||
* [Usare Selenium e WebDriver](tutorial/usare-selenium-e-webdriver.md)
|
||||
* [Estensioni DevTools](tutorial/estensioni-devtools.md)
|
||||
* [Usare Plugin Pepper Flash](tutorial/usare-plugin-pepper-flash.md)
|
||||
* [Usare Plugin Widevine CDM](tutorial/usare-plugin-widevine-cdm.md)
|
||||
* [Testare su Sistemi Headless CI (Travis, Jenkins)](tutorial/testare-su-sistemi-headless-ci.md)
|
||||
* [Rendering Offscreen](tutorial/rendering-offscreen.md)
|
||||
|
||||
## Tutorial
|
||||
|
||||
* [Guida Rapida](tutorial/guida-rapida.md)
|
||||
* [Integrazione Ambiente Desktop](tutorial/integrazione-ambiente-desktop.md)
|
||||
* [Rilevazione Eventi Online/Offline](tutorial/eventi-online-offline.md)
|
||||
|
||||
## Documentazione API
|
||||
|
||||
* [Sinossi](api/sinossi.md)
|
||||
* [Oggetto Process](api/process.md)
|
||||
* [Parametri Linea di Comando Chrome Supportati](api/parametri-linea-comando-chrome.md)
|
||||
* [Variabili di Ambiente](api/variabili-ambiente.md)
|
||||
|
||||
### Elementi personalizzati DOM:
|
||||
|
||||
* [Oggetto `File`](api/oggetto-file.md)
|
||||
* [Tag `<webview>`](api/web-view-tag.md)
|
||||
* [Funzione `window.open`](api/window-open.md)
|
||||
|
||||
### Moduli per il Processo Main:
|
||||
|
||||
* [app](api/app.md)
|
||||
* [autoUpdater](api/auto-updater.md)
|
||||
* [BrowserWindow](api/browser-window.md)
|
||||
* [contentTracing](api/content-tracing.md)
|
||||
* [dialog](api/dialog.md)
|
||||
* [globalShortcut](api/global-shortcut.md)
|
||||
* [ipcMain](api/ipc-main.md)
|
||||
* [Menu](api/menu.md)
|
||||
* [MenuItem](api/menu-item.md)
|
||||
* [powerMonitor](api/power-monitor.md)
|
||||
* [powerSaveBlocker](api/power-save-blocker.md)
|
||||
* [protocol](api/protocol.md)
|
||||
* [session](api/session.md)
|
||||
* [systemPreferences](api/system-preferences.md)
|
||||
* [Tray](api/tray.md)
|
||||
* [webContents](api/web-contents.md)
|
||||
|
||||
### Moduli per il Processo di Rendering (Pagina Web):
|
||||
|
||||
* [desktopCapturer](api/desktop-capturer.md)
|
||||
* [ipcRenderer](api/ipc-renderer.md)
|
||||
* [remote](api/remote.md)
|
||||
* [webFrame](api/web-frame.md)
|
||||
|
||||
### Moduli per Entrambi i Processi:
|
||||
|
||||
* [clipboard](api/clipboard.md)
|
||||
* [crashReporter](api/crash-reporter.md)
|
||||
* [nativeImage](api/native-image.md)
|
||||
* [screen](api/screen.md)
|
||||
* [shell](api/shell.md)
|
||||
|
||||
## Sviluppo
|
||||
|
||||
* [Stile Codice](development/stile-codice.md)
|
||||
* [Struttura Cartella Codice Sorgente](development/struttura-cartella-codice-sorgente.md)
|
||||
* [Differenze Tecniche da NW.js (precedentemente node-webkit)](development/atom-shell-vs-node-webkit.md)
|
||||
* [Panoramica Sistema di Build](development/panoramica-sistema-build.md)
|
||||
* [Istruzioni Build (macOS)](development/istruzioni-build-macos.md)
|
||||
* [Istruzioni Build (Windows)](development/istruzioni-build-windows.md)
|
||||
* [Istruzioni Build (Linux)](development/istruzioni-build-linux.md)
|
||||
* [Istruzioni Debug (macOS)](development/istruzioni-debug-macos.md)
|
||||
* [Istruzioni Debug (Windows)](development/istruzioni-debug-windows.md)
|
||||
* [Impostare Symbol Server nel debugger](development/impostare-symbol-server.md)
|
||||
167
docs-translations/it-IT/faq.md
Normal file
167
docs-translations/it-IT/faq.md
Normal file
|
|
@ -0,0 +1,167 @@
|
|||
# Electron FAQ
|
||||
|
||||
## Quando verrà utilizzata l'ultima versione di Chrome per Electron?
|
||||
|
||||
La versione di Chrome usata da Electron viene aggiornata solitamente entro una o
|
||||
due settimane dal rilascio di una versione stabile di Chrome. Questa stima non è
|
||||
garantita e dipende dall'ammontare di lavoro necessario all'aggiornamento.
|
||||
|
||||
E' utilizzato solo il canale stabile di Chrome. Se un fix importante si trovasse
|
||||
sui canali beta o dev, lo applicheremo a una versione precedente.
|
||||
|
||||
Per maggiori informazioni, leggi l'[introduzione alla sicurezza](tutorial/sicurezza.md).
|
||||
|
||||
## Quando verrà utilizzata l'ultima versione di Node.js per Electron?
|
||||
|
||||
Quando una nuova versione di Node.js viene rilasciata, aspettiamo per circa un
|
||||
mese prima di aggiornare quella di Electron. Possiamo così evitare di essere
|
||||
influenzati dai bug introdotti nelle nuove versioni di Node.js, cosa che accade
|
||||
spesso.
|
||||
|
||||
Le nuove funzionalità di Node.js sono solitamente introdotte dagli aggiornamenti
|
||||
di V8. Siccome Electron usa la versione di V8 integrata nel browser Chrome, le
|
||||
nuove funzionalità di JavaScript implementate nella nuova versione di Node.js
|
||||
sono già presenti in Electron.
|
||||
|
||||
## Come condividere dati tra pagine web?
|
||||
|
||||
Il modo più semplice per condividere dati tra pagine web (il processo di
|
||||
rendering) è usare le API di HTML5 già disponibili nei browser. Alcune buone
|
||||
opzioni sono [Storage API][storage], [`localStorage`][local-storage],
|
||||
[`sessionStorage`][session-storage] e [IndexDB][indexed-db].
|
||||
|
||||
Oppure puoi usare il sistema IPC, che è specifico di Electron, per memorizzare
|
||||
gli oggetti nel processo principale come variabile globale e accedervi poi
|
||||
dai renderer tramite la proprietà `remote` del modulo `electron`:
|
||||
|
||||
```javascript
|
||||
// Nel processo principale.
|
||||
global.sharedObject = {
|
||||
someProperty: 'valore di default'
|
||||
}
|
||||
```
|
||||
|
||||
```javascript
|
||||
// Nella pagina 1.
|
||||
require('electron').remote.getGlobal('sharedObject').someProperty = 'nuovo valore'
|
||||
```
|
||||
|
||||
```javascript
|
||||
// Nella pagina 2.
|
||||
console.log(require('electron').remote.getGlobal('sharedObject').someProperty)
|
||||
```
|
||||
|
||||
## La finestra/icona della mia app è sparita dopo qualche minuto.
|
||||
|
||||
Ciò accade quando una variabile usata per la memorizzazione della finestra/
|
||||
icona viene garbage-collected.
|
||||
|
||||
Se dovessi incontrare questo problema, i seguenti articoli potrebbero esserti
|
||||
d'aiuto:
|
||||
|
||||
* [Gestione Memoria][memory-management]
|
||||
* [Visibilità Variabili][variable-scope]
|
||||
|
||||
Se hai bisogno di un fix veloce, puoi rendere le variabili globali cambiando il
|
||||
tuo codice da così:
|
||||
|
||||
```javascript
|
||||
const {app, Tray} = require('electron')
|
||||
app.on('ready', () => {
|
||||
const tray = new Tray('/percorso/icona.png')
|
||||
tray.setTitle('ciao mondo')
|
||||
})
|
||||
```
|
||||
|
||||
a così:
|
||||
|
||||
```javascript
|
||||
const {app, Tray} = require('electron')
|
||||
let tray = null
|
||||
app.on('ready', () => {
|
||||
tray = new Tray('/percorso/icona.png')
|
||||
tray.setTitle('ciao mondo')
|
||||
})
|
||||
```
|
||||
|
||||
## Non posso usare jQuery/RequireJS/Meteor/AngularJS in Electron.
|
||||
|
||||
Data l'integrazione di Node.js di Electron, vi sono alcuni simboli extra
|
||||
inseriti nel DOM quali `module`, `exports`, `require`. Ciò causa problemi ad
|
||||
alcune librerie in quanto vogliono inserire simboli con gli stessi nomi.
|
||||
|
||||
Per risolvere il problema, puoi disattivare l'integrazione di Node in Electron:
|
||||
|
||||
```javascript
|
||||
// Nel processo principale.
|
||||
const {BrowserWindow} = require('electron')
|
||||
let win = new BrowserWindow({
|
||||
webPreferences: {
|
||||
nodeIntegration: false
|
||||
}
|
||||
})
|
||||
win.show()
|
||||
```
|
||||
|
||||
Se invece volessi mantenere la capacità di usare Node.js e le API di Electron,
|
||||
devi rinominare i simboli nella pagina prima di includere altre librerie:
|
||||
|
||||
```html
|
||||
<head>
|
||||
<script>
|
||||
window.nodeRequire = require;
|
||||
delete window.require;
|
||||
delete window.exports;
|
||||
delete window.module;
|
||||
</script>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
</head>
|
||||
```
|
||||
|
||||
## `require('electron').xxx` is undefined.
|
||||
|
||||
Mentre usi il modulo integrato di Electron potresti incorrere in un errore
|
||||
come questo:
|
||||
|
||||
```
|
||||
> require('electron').webFrame.setZoomFactor(1.0)
|
||||
Uncaught TypeError: Cannot read property 'setZoomLevel' of undefined
|
||||
```
|
||||
|
||||
Ciò è causato dal fatto che hai il [modulo npm `electron`][electron-module]
|
||||
installato localmente o globalmente, e ciò sovrascrive il modulo integrato di
|
||||
Electron.
|
||||
|
||||
Per verificare che tu stia usando il modulo integrato corretto, puoi stampare a
|
||||
schermo il percorso del modulo `electron`:
|
||||
|
||||
```javascript
|
||||
console.log(require.resolve('electron'))
|
||||
```
|
||||
|
||||
e dopodiché controlla che sia in questa forma
|
||||
|
||||
```
|
||||
"/percorso/Electron.app/Contents/Resources/atom.asar/renderer/api/lib/exports/electron.js"
|
||||
```
|
||||
|
||||
Se dovesse essere simile a `node_modules/electron/index.js`, allora devi
|
||||
rimuovere il modulo npm `electron` oppure rinominarlo.
|
||||
|
||||
```bash
|
||||
npm uninstall electron
|
||||
npm uninstall -g electron
|
||||
```
|
||||
|
||||
Tuttavia, se usi il modulo integrato e continui a ricevere questo errore è molto
|
||||
probabile che tu stia usando il modulo in un processo sbagliato. Per esempio
|
||||
`electron.app` può essere usato solo nel processo principale, mentre
|
||||
`electron.webFrame` è disponibile solo nel processo di rendering.
|
||||
|
||||
[memory-management]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Memory_Management
|
||||
[variable-scope]: https://msdn.microsoft.com/library/bzt2dkta(v=vs.94).aspx
|
||||
[electron-module]: https://www.npmjs.com/package/electron
|
||||
[storage]: https://developer.mozilla.org/en-US/docs/Web/API/Storage
|
||||
[local-storage]: https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage
|
||||
[session-storage]: https://developer.mozilla.org/en-US/docs/Web/API/Window/sessionStorage
|
||||
[indexed-db]: https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API
|
||||
246
docs-translations/it-IT/styleguide.md
Normal file
246
docs-translations/it-IT/styleguide.md
Normal file
|
|
@ -0,0 +1,246 @@
|
|||
# Guida allo Stile della Documentazione
|
||||
|
||||
Queste sono le linee guida per la stesura della documentazione di Electron.
|
||||
|
||||
## Titoli
|
||||
|
||||
* Ogni pagina deve avere un singolo titolo di livello `#` all'inizio.
|
||||
* I capitoli di una stessa pagina devono avere titoli di livello `##`.
|
||||
* I sotto-capitoli devono avere un numero crescente di `#` a seconda del loro
|
||||
livello di annidamento.
|
||||
* Tutte le parole nel titolo della pagina devono iniziare con la lettera
|
||||
maiuscola, a eccezione delle congiunzioni come "di" ed "e".
|
||||
* Solo la prima lettera della prima parola di un capitolo deve essere maiuscola.
|
||||
|
||||
Prendendo `Guida Rapida` come esempio:
|
||||
|
||||
```markdown
|
||||
# Guida Rapida
|
||||
|
||||
...
|
||||
|
||||
## Processo principale
|
||||
|
||||
...
|
||||
|
||||
## Processo di rendering
|
||||
|
||||
...
|
||||
|
||||
## Esegui la tua app
|
||||
|
||||
...
|
||||
|
||||
### Crea una distribuzione
|
||||
|
||||
...
|
||||
|
||||
### Electron scaricato manualmente
|
||||
|
||||
...
|
||||
```
|
||||
|
||||
Esistono eccezioni a queste regole per quanto riguarda la documentazione delle
|
||||
API.
|
||||
|
||||
## Regole markdown
|
||||
|
||||
* Usa `bash` invece di `cmd` nei blocchi di codice (per via della diversa
|
||||
evidenziazione della sintassi).
|
||||
* Le linee devono essere lunghe al massimo 80 caratteri.
|
||||
* Non annidare le liste per più di due livelli (per via del rendering compiuto
|
||||
da markdown).
|
||||
* Tutti i blocchi di codice `js` o `javascript` sono analizzati con
|
||||
[standard-markdown](http://npm.im/standard-markdown).
|
||||
|
||||
## Documentazione API
|
||||
|
||||
Le regole seguenti vengono applicate solo alla documentazione delle API.
|
||||
|
||||
### Titolo della pagina
|
||||
|
||||
Ogni pagina deve avere come titolo il nome dell'oggetto a cui si riferisce
|
||||
seguito da `require('electron')`, come ad esempio `BrowserWindow`, `autoUpdater`
|
||||
e `session`.
|
||||
|
||||
Sotto il titolo della pagina deve esserci una descrizione della lunghezza di una
|
||||
linea che comincia con `>`.
|
||||
|
||||
Prendendo `session` come esempio:
|
||||
|
||||
```markdown
|
||||
# session
|
||||
|
||||
> Gestisce le sessioni browser, cookies, cache, impostazioni proxy, etc.
|
||||
```
|
||||
|
||||
### Metodi ed eventi dei moduli
|
||||
|
||||
Per i moduli che non sono classi, i loro metodi ed eventi devono essere elencati
|
||||
sotto i capitoli `## Metodi` ed `## Eventi`.
|
||||
|
||||
Prendendo `autoUpdate` come esempio:
|
||||
|
||||
```markdown
|
||||
# autoUpdater
|
||||
|
||||
## Eventi
|
||||
|
||||
### Evento: 'error'
|
||||
|
||||
## Metodi
|
||||
|
||||
### `autoUpdater.setFeedURL(url[, requestHeaders])`
|
||||
```
|
||||
|
||||
### Classi
|
||||
|
||||
* Le classi API e le classi che sono parte di moduli devono essere elencate
|
||||
sotto un capitolo `## Classe: NomeDellaClasse`.
|
||||
* Una pagina può avere più classi.
|
||||
* I costruttoi devono essere elencati con un titolo di livello `###`.
|
||||
* I [Metodi Statici](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes/static) (Inglese) devono essere elencati sotto un capitolo
|
||||
`### Metodi Statici`.
|
||||
* I [Metodi di Istanza](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes#Prototype_methods) (Inglese) devono essere elencati sotto un
|
||||
capitolo `### Metodi di Istanza`.
|
||||
* Gli Eventi di Istanza devono essere elencati sotto un capitolo
|
||||
`## Eventi di Istanza`.
|
||||
* Le Proprietà di Istanza devono essere elencate sotto un capitolo `## Proprietà di Istanza`.
|
||||
|
||||
Prendendo le classi `Session` e `Cookies` come esempi:
|
||||
|
||||
```markdown
|
||||
# session
|
||||
|
||||
## Metodi
|
||||
|
||||
### session.fromPartition(partition)
|
||||
|
||||
## Proprietà
|
||||
|
||||
### session.defaultSession
|
||||
|
||||
## Classe: Session
|
||||
|
||||
### Eventi di Istanza
|
||||
|
||||
#### Evento: 'will-download'
|
||||
|
||||
### Metodi di Istanza
|
||||
|
||||
#### `ses.getCacheSize(callback)`
|
||||
|
||||
### Proprietà di Istanza
|
||||
|
||||
#### `ses.cookies`
|
||||
|
||||
## Classe: Cookies
|
||||
|
||||
### Metodi di Istanza
|
||||
|
||||
#### `cookies.get(filter, callback)`
|
||||
```
|
||||
|
||||
### Metodi
|
||||
|
||||
Il capitolo dei metodi deve seguire il seguente formato:
|
||||
|
||||
```markdown
|
||||
### `objectName.methodName(required[, optional]))`
|
||||
|
||||
* `required` String
|
||||
* `optional` Integer (optional)
|
||||
|
||||
...
|
||||
```
|
||||
|
||||
Il titolo può essere di livello `###` o `####` a seconda che sia un metodo di
|
||||
un modulo o di una classe.
|
||||
|
||||
Per i moduli, il `nomeOggetto` è il nome del modulo. Per le classi, deve essere
|
||||
il nome dell'istanza della classe e non deve essere lo stesso del modulo.
|
||||
|
||||
Per esempio, i metodi della classe `Session` sotto il modulo `session` devono
|
||||
usare `ses` come `nomeOggetto`.
|
||||
|
||||
I parametri opzionali sono caratterizzati sia dalle parentesi quadre `[]` che
|
||||
circondano il parametro, sia dalla virgola obbligatoria in caso il parametro
|
||||
ne segua un altro.
|
||||
|
||||
```
|
||||
required[, optional]
|
||||
```
|
||||
|
||||
Sotto ogni metodo si trovano informazioni dettagliate su ogni parametro. Il tipo
|
||||
di parametro è caratterizzato da uno dei tipi di dati comuni:
|
||||
|
||||
* [`String`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)
|
||||
* [`Number`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)
|
||||
* [`Object`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)
|
||||
* [`Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)
|
||||
* [`Boolean`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)
|
||||
* O da un tipo di dati personalizzato come [`WebContent`](api/web-content.md) di
|
||||
Electron
|
||||
|
||||
Se un parametro o un metodo sono limitati a certe piattaforme, esse sono
|
||||
segnalate, dopo il tipo di dato, attraverso l'uso di una lista di elementi in
|
||||
corsivo e delimitati da uno spazio. I valori possono essere `macOS`,
|
||||
`Windows` e `Linux`.
|
||||
|
||||
```markdown
|
||||
* `animate` Boolean (optional) _macOS_ _Windows_
|
||||
```
|
||||
|
||||
I parametri di tipo `Array` devono specificare nella descrizione sottostante
|
||||
che elementi può contenere l'array.
|
||||
|
||||
La descrizione per i parametri di tipo `Funzione` dovrebbero rendere chiaro come
|
||||
sia possibile chiamarli, ed elencare i tipi di parametri che vi saranno passati.
|
||||
|
||||
### Eventi
|
||||
|
||||
Il capitolo degli eventi deve seguire il seguente formato:
|
||||
|
||||
```markdown
|
||||
### Evento: 'wake-up'
|
||||
|
||||
Ritorna:
|
||||
|
||||
* `time` String
|
||||
|
||||
...
|
||||
```
|
||||
|
||||
Il titolo può essere di livello `###` o `####` a seconda che sia di un evento di
|
||||
un modulo o di una classe.
|
||||
|
||||
I parametri di un evento seguono le stesse regole di quelli dei metodi.
|
||||
|
||||
### Proprietà
|
||||
|
||||
Il capitolo delle proprietà deve seguire il seguente formato:
|
||||
|
||||
```markdown
|
||||
### session.defaultSession
|
||||
|
||||
...
|
||||
```
|
||||
|
||||
Il titolo può essere di livello `###` o `####` a seconda che sia una proprietà
|
||||
di un metodo o di una classe.
|
||||
|
||||
## Traduzioni della Documentazione
|
||||
|
||||
Le traduzioni della documentazione di Electron si trovano nella cartella
|
||||
`docs-translations`.
|
||||
|
||||
Per aggiungere un altro set (o set parziale):
|
||||
|
||||
* Crea una sottocartella che abbia come nome il codice della lingua.
|
||||
* Traduci i file.
|
||||
* Aggiorna il file README.md dentro la cartella della lingua in modo che
|
||||
reindirizzi ai file che hai tradotto.
|
||||
* Aggiungi un collegamento alla cartella della traduzione nel [README](https://github.com/electron/electron#documentation-translations) principale di Electron.
|
||||
|
||||
Nota che tutti i file nella cartella `docs-translations` devono includere solo
|
||||
i file tradotti. I file originali in inglese non devono essere copiati lì.
|
||||
Loading…
Add table
Add a link
Reference in a new issue