diff options
Diffstat (limited to 'files/it/mdn')
26 files changed, 2258 insertions, 0 deletions
diff --git a/files/it/mdn/about/index.html b/files/it/mdn/about/index.html new file mode 100644 index 0000000000..b6b978345d --- /dev/null +++ b/files/it/mdn/about/index.html @@ -0,0 +1,116 @@ +--- +title: Informazioni su MDN +slug: MDN/About +tags: + - Collaborazione + - Copyright + - Documentazione + - Guide + - Licenzze + - Meta MDN +translation_of: MDN/About +--- +<div>{{MDNSidebar}}</div> + +<p>Mozilla Developer Network o MDN (la Rete di Sviluppatori Mozilla) è una piattaforma di apprendimento in continua evoluzione per le tecnologie e il software che rendono il Web possibile, tra cui:</p> + +<ul> + <li>Standard del Web come <a href="/it/docs/CSS" title="/it/docs/CSS">CSS</a>, <a href="/it/docs/HTML" title="/it/docs/HTML">HTML</a>, e <a href="/it/docs/JavaScript" title="/it/docs/JavaScript">JavaScript</a></li> + <li><a href="/it/docs/Apps" title="/it/docs/Apps">Sviluppo di app open eb</a></li> + <li><a href="/it/docs/Add-ons" title="/it/docs/Add-ons">Sviluppo di componenti aggiuntive per Firefox</a></li> +</ul> + +<h2 id="La_nostra_missione">La nostra missione</h2> + +<p>La missione di MDN è semplice: fornire agli sviluppatori tutte le informazioni di cui hanno bisogno per creare facilmente progetti <a href="/it/docs/Web">web open</a>. Se si tratta di una tecnologia open disponibile sul Web, vogliamo documentarla.</p> + +<p>Inoltre, forniamo documentazione sui <a href="/it/docs/Mozilla">prodotti Mozilla</a> come <a href="/it/docs/Mozilla">sviluppare e contribuire ai progetti Mozilla</a>.</p> + +<p>Se non sei sicuro che un argomento in particolare debba essere trattato su MDN, leggi l'articolo: <a href="/it/docs/Project:MDN/Contributing/Does_this_belong">Questo appartiene a MDN?</a></p> + +<h2 id="Come_contribuire">Come contribuire</h2> + +<p>Non devi essere in grado di programmare - o esser uno scrittore - per poter contribuire a MDN! Esistono molti modi per aiutare, dalla revisione degli articoli per assicurarsi che siano sensati, allo scrivere testi, all'aggiungere esempi di codice. Esistono così tanti modi di contribuire che abbiamo creato una pagina <a href="https://developer.mozilla.org/en-US/docs/MDN/Getting_started">Come Iniziare</a> per aiutarti a scegliere i task piu' adatti in base ai tuoi interessi o al tempo che gli puoi dedicare!</p> + +<p>Puoi contribuire anche <a href="https://developer.mozilla.org/en-US/docs/MDN/About/Promote">promuovendo MDN</a> sul tuo blog o sito web.</p> + +<h2 id="La_comunità_di_MDN">La comunità di MDN</h2> + +<p>La nostra è una comunità globale! Abbiamo fantastici collaboratori in tutto il mondo che parlano varie lingue. Se vuoi maggiori informazioni, o se hai bisogno di qualsiasi tipo di aiuto riguardo MDN, puoi cercare nel nostro <span class="short_text" id="result_box" lang="it"><span>forum di discussione</span></span> o il nostro <a href="irc://irc.mozilla.org#mdn">canale IRC</a>! Puoi seguirci su Twitter <a href="http://twitter.com/MozDevNet">@MozDevNet</a> per essere sempre aggiornato su quello che stiamo facendo. Se vedi qualcosa di sbagliato, ci vuoi dare il tuo feedback o inviare un ringraziamento ai nostri editori e collaboratori mandaci i tuoi tweet!</p> + +<h2 id="Utilizzare_i_Web_Docs_MDN">Utilizzare i Web Docs MDN</h2> + +<p>I contenuti di MDN sono disponibili gratuitamente sotto licenze opern source.</p> + +<h3 id="Copyright_e_licenze">Copyright e licenze</h3> + +<p>I contenuti MDN sono completamente disponibili sotto differenti licenze opern source. Questa sezione descrive il tipo di contenuti e le licenze in uno per ognuno di essi.</p> + +<h4 id="Documentazione_e_articoli">Documentazione e articoli</h4> + +<p><strong>I documenti wiki di MDN</strong> sono stati realizzati con il contributo di vari autori, sia interni che esterni alla Mozilla Foundation. A meno che non sia indicato diversamente, i contenuti sono disponibili secondo i termini della <a class="external text" href="http://creativecommons.org/licenses/by-sa/2.5/" rel="nofollow" title="http://creativecommons.org/licenses/by-sa/2.5/">licenza Creative Commons Attribution-ShareAlike</a> (CC-BY-SA), v2.5 o qualsiasi versione successiva. Per favore attribuisci gli articoli a "Mozilla Contributors" e includi un collegamento (online) o un URL (per le stampe) alla pagina wiki specifica da cui hai preso i contenuti. Per esempio, per indicare l'attribuzione di questo articolo, puoi scrivere</p> + +<blockquote><a href="https://developer.mozilla.org/it/docs/MDN/About">About MDN</a> by <a href="https://developer.mozilla.org/it/docs/MDN/About$history">Mozilla Contributors</a> is licensed under <a href="http://creativecommons.org/licenses/by-sa/2.5/">CC-BY-SA 2.5</a>.</blockquote> + +<p>Nota che nell'esempio, "Mozilla Contributors" è un collegamento allo storico della pagina citata. Per ulteriori informazioni leggi <a href="http://wiki.creativecommons.org/Marking/Users">Regole per una corretta attribuzione</a>.</p> + +<div class="note"> +<p><strong>Nota:</strong> per maggiori informazioni su come riutilizzare e attribuire contenuti MDN sul sito WebPlatform.org, leggi <a href="/it/docs/MDN_content_on_WebPlatform.org" title="/it/docs/MDN_content_on_WebPlatform.org">contenuti MDN su WebPlatform.org</a>.</p> +</div> + +<h4 id="Esempi_di_codice_e_frammenti">Esempi di codice e frammenti</h4> + +<p>Gli esempi di codice aggiunti dal 20 agosto 2010 (incluso) sono di <a class="external" href="http://creativecommons.org/publicdomain/zero/1.0/" title="http://wiki.creativecommons.org/Public_domain">pubblico dominio</a>. Non è necessaria alcuna nota di licenza, ma se te ne serve una puoi usare: "Any copyright is dedicated to the Public Domain. http://creativecommons.org/publicdomain/zero/1.0/".</p> + +<p>Gli esempi di codice aggiunti a questo wiki prima del 20 agosto 2010 sono disponibili sotto la <a class="external" href="http://www.opensource.org/licenses/mit-license.php" title="http://www.opensource.org/licenses/mit-license.php">licenza MIT</a>; dovresti inserire le seguenti informazioni di attribuzione nel template MIT: "© <data della ultima revisione della pagina wiki> <nome della persona che l'ha inserita nel wiki>".</p> + +<h4 id="Contributi">Contributi</h4> + +<p>Se desideri contribuire a questo wiki devi rendere la tua documentazione disponibile sotto licenza Attribution-ShareAlike (o occasionalmente una licenza altrenativa già specificata nella pagina che stai modificando), e il tuo codice di esempio deve essere disponibile sotto licenza <a href="http://creativecommons.org/publicdomain/zero/1.0/" title="http://creativecommons.org/publicdomain/zero/1.0/">Creative Commons CC-0</a> (una dedica al Pubblico Dominio). Aggiungere materiale a questo wiki significa che acconsenti a che i tuoi contributi siano resi disponibili secondo queste licenze.</p> + +<p>Alcuni vecchi contenuti sono resi disponibili sotto licenze diverse da quelle qui indicate; questi sono indicati in fondo alla pagina attraverso un <a class="internal" href="/Project:en/Examples/Alternate_License_Block" title="Project:En/Examples/Alternate License Block">Blocco di licenza alternativa</a>.</p> + +<div class="warning"> +<p>Nessuna nuova pagina può essere creata usando licenze alternative.</p> +</div> + +<p><strong>Il copyright per i materiali aggiunti rimane all'autore, a meno che l'autore non lo assegni a qualcun altro.</strong></p> + +<p>In caso di dubbi sull'argomento, contattare gli <a href="mailto:mdn-admins@mozilla.org">amministratori MDN</a>.</p> + +<h4 id="Loghi_marchi_marchi_di_servizio_e_logotipo">Loghi, marchi, marchi di servizio e logotipo</h4> + +<hr> +<p>I diritti dei marchi, loghi e marchi dei servizi della Mozilla Foundation, così come l'aspetto di questo sito, non sono sotto licenza Creative Commons e, se si tratta di lavori di autore (come loghi e design grafico) non sono inclusi nelle opere che sottostanno a questa licenza. Se intendi usare il testo di questi documenti e intendi esercitare qualcuno di questi diritti, o se hai altre domande riguardo il rispetto dei nostri termini di licenza per questa collezione, puoi contattare la Mozilla foundation all'indirizzo: <a class="external text" href="mailto:licensing@mozilla.org" rel="nofollow" title="mailto:licensing@mozilla.org">licensing@mozilla.org</a>.</p> + +<h3 id="Collegamenti_a_MDN">Collegamenti a MDN</h3> + +<p>Questo articolo fornisce una guida e best practices quando si crea <a href="https://developer.mozilla.org/en-US/docs/MDN/About/Linking_to_MDN">un link a MDN</a>.</p> + +<h2 id="Scaricare_contenuti">Scaricare contenuti</h2> + +<p>Puoi scaricare un <a href="https://mdn-downloads.s3-us-west-2.amazonaws.com/developer.mozilla.org.tar.gz">mirror completo in formato tarball di MDN</a> (2.1 GB aggiornato a Febbraio 2017).</p> + +<h3 id="Pagine_singole">Pagine singole</h3> + +<p>Puoi ottenere i contenuti di una singola pagina di MDN aggiungendo dei <a href="/it/docs/Project:MDN/Kuma/API#Document_parameters">parametri di documento</a> all'URL per specificare quale formato vuoi richiedere.</p> + +<h3 id="Strumenti_di_terze_parti">Strumenti di terze parti</h3> + +<p>Puoi visualizzare i contenuti di MDN anche tramite strumenti di terze parti come <a href="http://kapeli.com/dash">Dash</a> (per Mac OS) e <a href="http://zealdocs.org/">Zeal</a> (per Linux e Windows).</p> + +<p><a href="https://kapeli.com/">Kapeli</a> pubblica <a href="https://kapeli.com/mdn_offline">documenti MDN offline</a> su HTML, CSS, JavaScript, SVG e XSLT.</p> + +<h2 id="Segnalare_problemi_con_i_Web_Docs_MDN">Segnalare problemi con i Web Docs MDN</h2> + +<p>Visita <a href="https://developer.mozilla.org/en-US/docs/MDN/Contribute/Howto/Report_a_problem">Come segnalare un problema con MDN</a>.</p> + +<h2 id="La_storia_di_MDN">La storia di MDN</h2> + +<p>Il progetto Mozilla Developer Network (precedentemente <em>Mozilla Developer Center (MDC) o</em> <em>Devmo</em>) è nato all'inizio del 2005 quando la <a class="external" href="https://www.mozilla.org/it/foundation/">Mozilla Foundation</a> ha ottenuto la licenza da AOL per utilizzare i contenuti originali di <a href="/it/docs/Archive/Meta_docs/DevEdge" title="Project:en/DevEdge">DevEdge</a>. Il contenuto di DevEdge è stato estratto per cercare materiale ancora utile, poi migrato su questo wiki dai volontari affinché fosse più facile da aggiornare e mantenere.</p> + +<p>Puoi trovare altre informazioni nella <a href="https://developer.mozilla.org/en-US/docs/MDN_at_ten">pagina del 10mo anniversario</a> oltre ad un racconto da parte di alcune delle persone che ne hanno fatto parte.</p> + +<h2 id="Informazioni_su_Mozilla">Informazioni su Mozilla</h2> + +<p>Se vuoi saperne di più su chi siamo, su come entrare a far parte di Mozilla o semplicemente sapere dove trovarci, sei arrivato nel posto giusto. Per scoprire cosa ci spinge e ci rende differenti, visita la pagina sulla nostra <a href="http://www.mozilla.org/it/mission/">missione</a>.</p> diff --git a/files/it/mdn/community/index.html b/files/it/mdn/community/index.html new file mode 100644 index 0000000000..14a121baca --- /dev/null +++ b/files/it/mdn/community/index.html @@ -0,0 +1,49 @@ +--- +title: Join the MDN community +slug: MDN/Community +translation_of: MDN/Community +--- +<div>{{MDNSidebar}}</div> + +<p>{{IncludeSubnav("/it-IT/docs/MDN")}}</p> + +<div class="summary"> +<p>MDN (l'abbreviazione sta per Mozilla Developer Network) è più di un wiki: è una comunità di sviluppatore che lavorano insieme per rendere MDN una risorsa eccezionale per gli sviluppatori che usano le tecnologie web di tipo open.</p> +</div> + +<p>Ci fa piacere se contribuisci a MDN, ma ci piacerebbe ancora di più se tu partecipassi alla community di MDN. Ecco come puoi connetterti, in tre facili passi:</p> + +<ol> + <li><a href="/en-US/docs/MDN/Contribute/Howto/Create_an_MDN_account">Crea un account MDN</a>.</li> + <li><a href="/en-US/docs/MDN/Community/Conversations">Unisciti a una conversazione</a>.</li> + <li><a href="/en-US/docs/MDN/Community/Whats_happening">Segui ciò che avviene</a>.</li> +</ol> + +<h2 id="Come_lavora_la_community">Come lavora la community</h2> + +<p>Quelli che seguono sono articoli aggiuntivi per descrivere la community di MDN.</p> + +<div class="row topicpage-table"> +<div class="section"> +<dl> + <dt class="landingPageList"><a href="/en-US/docs/MDN/Community/Roles">Regole della Community</a></dt> + <dd class="landingPageList">Ci sono alcuni ruoli nella community di MDN che hanno specifiche responsabilità.</dd> + <dt class="landingPageList"><a href="/en-US/docs/MDN/Community/Doc_sprints">Sprint di documentazione</a></dt> + <dd class="landingPageList">Questa è una guida per organizzare uno sprint documentale. Contiene consigli e trucchi forniti da chi ne ha organizzati, per fare in modo che anche tu ne possa organizzarne uno.</dd> + <dt class="landingPageList"><a href="/en-US/docs/MDN/Community/Whats_happening">Segui cosa succede</a></dt> + <dd class="landingPageList">MDN ti viene proposto dalla <a class="external" href="https://wiki.mozilla.org/MDN">community del Mozilla Developer Network</a>. Questi sono alcuni modi che utilizziamo per condividere le informazioni circa ciò che facciamo.</dd> +</dl> + +<dl> +</dl> +</div> + +<div class="section"> +<dl> + <dt class="landingPageList"><a href="/en-US/docs/MDN/Community/Conversations">Conversazioni nella community di MDN</a></dt> + <dd class="landingPageList">Il "lavoro" di MDN avviene sul sito MDN, ma la "community" appare anche in discussioni (di tipo asincrono) e chat e meeting (di tipo sincrono).</dd> + <dt class="landingPageList"><a href="/en-US/docs/MDN/Community/Working_in_community">Lavorare nella community</a></dt> + <dd class="landingPageList">Una parte interessante nel contribuire alla documentazione di MDN a qualsiasi livello è capire come lavorare come parte della community di MDN. Questo articolo offre consigli per aiutarti a gestire la maggior parte delle interazioni sia con altri autori che con team di sviluppo.</dd> +</dl> +</div> +</div> diff --git a/files/it/mdn/contribute/creating_and_editing_pages/index.html b/files/it/mdn/contribute/creating_and_editing_pages/index.html new file mode 100644 index 0000000000..2ffa7888a4 --- /dev/null +++ b/files/it/mdn/contribute/creating_and_editing_pages/index.html @@ -0,0 +1,110 @@ +--- +title: 'creare., edizione paginaCreazione e modifica delle pagine' +slug: MDN/Contribute/Creating_and_editing_pages +translation_of: MDN/Contribute/Howto/Create_and_edit_pages +--- +<div>{{MDNSidebar}}</div><p><span style="line-height: 1.5;">Modificare e creare una pagina sono le due attività più comuni per la maggior parte dei <strong>COLLABORATORI MDN. </strong>Questo articolo spiega come eseguire queste due operazioni.</span></p> + +<h2 id="Modificare_una_pagina_esistente">Modificare una pagina esistente</h2> + +<p>E' facile modificare-</p> + +<ul> + <li>Clicca il pulsante <strong>modifica</strong> nell'angolo in alto a destra della pagina.</li> + <li>La pagina si ricarica con le opzioni di formattazione in modo che tu possa aggiungere o cancellare informazioni direttamente nella pagina.</li> + <li>Puoi aggiungere paragrafi, cancellare testo, aggiungere titoli ed eseguire molte funzioni basilari della scrittura e della modifica.</li> +</ul> + +<h3 id="Anteprima_delle_modifiche">Anteprima delle modifiche</h3> + +<p>Per osservare le tue modifiche-</p> + +<ul> + <li>Clicca il pulsante "Mostra cambiamenti" (all'interno delle funzioni di modifica) sopra il titolo della pagina.</li> + <li>Questo apre una pagina di anteprima che include le tue revisioni in una nuova finestra o etichetta.</li> + <li>Tutte le volte che premi questi bottone la pagina viene ricaricata con i tuoi ultimi cambiamenti.</li> +</ul> + +<p>Attenzione! L'anteprima di una pagina <em>non salva</em> i tuoi cambiamenti, quindi ricorda di non chiudere la finestra in cui stai modificando.</p> + +<h3 id="Commenti_di_correzione">Commenti di correzione</h3> + +<p>Dopo aver visualizzato i cambiamenti, vorrai <em>salvare la tua revisione.</em> Prima di <strong>salvare,</strong> verfica i commenti di correzione nella finestra sotto la sezione del titolo e lascia un commento per informare gli altri collaboratori sul perchè hai effettuato qualche cambiamento. Per esempio, potresti aver aggiunto una nuova sezione, cambiato qualche parole per rendere la terminologia più appropriata, riscritto un paragrafo per renderlo più chiaro, oppure rimosso informazioni ridondanti.</p> + +<h3 id="Tags">Tags</h3> + +<p>Puoi <em>aggiungere o rimuovere etichette </em>che descrivono il contenuto della pagina e funzioni sotto la sezione di modifica della pagina. Visita <a href="/en-US/docs/MDN/Contribute/Tagging">Come taggare in modo appropriato una pagina</a> per avere informazioni su quali etichette applicare.</p> + +<h3 id="Revisione_necessaria">Revisione necessaria?</h3> + +<p>Se un esperto o un collaboratore esperto dovrebbe controllare le tue modifiche, puoi richiedere una revisione tecnica (per codice, API o tecnologie), una revisione editoriale (per forma, grammatica e contenuto), oppure una revisione della rappresentazione (per il codice KumaScript) facendo una spunta nel box prima di salvare.</p> + +<h3 id="Allegare_file">Allegare file</h3> + +<p>Se volessi <em>allegare </em><em>un file</em> ad una pagina esistente per aggiungere un'illustrazione oppure ulteriori chiarimenti, puoi farlo a fondo pagina.</p> + +<h3 id="Salvare_scartare_o_continuare_a_modificare">Salvare, scartare o continuare a modificare</h3> + +<p>Quando hai terminato di modificare e sei soddisfatto dell'anteprima, puoi <strong>salvare</strong> il tuo lavoro e i tuoi commenti cliccando<strong> "Salva cambiamenti"</strong> (in verde) a destra del titolo della pagina. Se cambi idea, puoi scartare le tue modifiche cliccando su <strong>"Scarta cambiamenti"</strong> (in rosso) a destra del titolo della pagina.</p> + +<p>Premendo <strong>invio </strong>nel campo commenti di revisione equivale a cliccare "Salva e continua a modificare".</p> + +<h2 id="Creare_una_nuova_pagina">Creare una nuova pagina</h2> + +<p>Se non sai dove inserire un nuovo articolo, <strong>non preoccuparti!</strong> Mettilo ovunque, noi lo troveremo e lo sposteremo nel posto giusto o lo aggiungeremo ad un contenuto esistente se è più sensato. Inoltre non preoccuparti di renderlo perfetto. Abbiamo aiutanti gnomi che saranno felici di migliorare il tuo contenuto.</p> + +<p>Ci sono alcuni modi di creare una nuova pagina:</p> + +<ul> + <li><a href="#Link_from_an_existing_page">Collegamento da una pagina esistente</a></li> + <li><a href="#New_page_without_link">Nuova pagina senza un link</a></li> + <li><a href="#Subpage_of_an_existing_page">Sottopagina di una pagina esistente</a></li> + <li><a href="#Clone_of_an_existing_page">Clone di una pagina esistente</a></li> +</ul> + +<h3 id="Collegamento_da_una_pagina_esistente">Collegamento da una pagina esistente</h3> + +<ol> + <li>Inserisci il nome della nuova pagina ovunque abbia senso nel testo di una pagina esistente.</li> + <li>Evidenzia il nome e <strong>clicca l'icona Link</strong><strong> (<img alt="" src="https://developer.mozilla.org/files/3810/link-icon.png" style="height: 28px; width: 29px;">) </strong>nella barra degli strumenti di modifica. La finestra di dialogo <strong>"Update Link"</strong> si apre, con il testo evidenziato nel campo<strong> "Link To"</strong>.</li> + <li>"/en-US/docs/" viene inserito di default all'inizio del campo URL. <em>Inserisci il nome</em> della pagina dopo "/en-US/docs/". (Il nome della pagina non deve essere lo stesso del link.)</li> + <li>Clicca OK per creare e inserire il link.</li> +</ol> + +<p>Se la pagina non esiste ancora il link viene visualizzato in rosso. Se la pagina <em>esiste già, </em>il link viene visualizzato in blu. Se vuoi creare una nuova pagina, ma il titolo della pagina che vuoi utilizzare esiste già controlla prima se non sia meglio aiutare a modificare e migliorare la pagina esistente. Altrimenti pensa a un titolo diverso per la tua nuova pagina e creane uno. Fai riferimento alla <a href="https://developer.mozilla.org/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">guida per nominare le pagine </a>per linee guida.</p> + +<p>Per aggiungere un contenuto alla tua nuova pagina clicca nel link in rosso che hai appena creato (dopo aver salvato e chiuso l'editor). La nuova pagina si apre nella modalità di modifica così che potrai cominciare a scrivere. Fai riferimento alla sezione <a href="#Editing_an_existing_page">Modificare una pagina esistente</a> di questo articolo sull'utilizzo della modalità di modifica.</p> + +<h3 id="Nuova_pagina_senza_link">Nuova pagina senza link</h3> + +<p><em>Per creare una nuova pagina senza link da altre pagine</em>, inserisci un nome unico per la pagina nel campo URL del tuo browser. Per esempio, se inserisci:</p> + +<pre class="language-html">https://developer.mozilla.org/en-US/docs/FooBar</pre> + +<p>MDN crea una nuova pagina con il titolo "FooBar" e apre l'editor così che tu possa aggiungere il contenuto nella nuova pagina. Vedi la sezione <a href="#Editing_an_existing_page">Modificare una pagina esistente</a> di questo articolo per sapere come usare la modalità editor.</p> + +<h3 id="Sottopagina_di_una_pagina_esistente">Sottopagina di una pagina esistente</h3> + +<p>Per creare una pagina che sia sotto una pagina esistente nella gerarchia della pagina:</p> + +<ol> + <li>In una pagina "padre", clicca sulla voce di menu <strong>Advanced</strong> (l'icona ingranaggio nella toolbar) e clicca <strong>New sub-page</strong>. Un editor sarà aperto per la creazione di un nuovo documento.</li> + <li>Digita il titolo del documento nel campo <strong>Title</strong>.</li> + <li>Cambia il campo <strong>Slug</strong> se necessario (per esempio, se il titolo è molto lungo e tu vuoi una URL più breve). Questo campo è automaticamente riempito dall'editor, sostituendo con i caratteri undescores gli spazi nel titolo. In questo caso, puoi cambiare solo l'ultima parte della URL del documento.</li> + <li>Nel campo <strong>TOC</strong>, seleziona il livello di heading che vuoi che venga automaticamente visualizzato nella tabella dei contenuti per la pagina, oppure "No table of contents" se la pagina non ne contiene uno.</li> + <li>Scrivi il contenuto della pagina nel pannello dell'editor e salva le modifiche. Vedi la sezione <a href="#Editing_an_existing_page">Modificare una pagina esistente</a> di questo articolo per sapere come usare la modalità editor.</li> +</ol> + +<h3 id="Clonare_una_pagina_esistente">Clonare una pagina esistente</h3> + +<p>Se esiste una pagina di cui vuoi usare il formato per una nuova, puoi "clonare" la pagina e quindi le modificare il contenuto.</p> + +<ol> + <li>Sulla pagina originale, clicca sulla voce di menu <strong>Advanced</strong> (l'icona ingranaggio della toolbar) e clicca <strong>Clone this page</strong>. Un editor si editor si aprirà per creare un nuovo documento.</li> + <li>Cambia il <strong>Title</strong> della pagina come appropriato per il nuovo contenuto. Il campo <strong>Slug</strong> sarà modificato automaticamente quando cambierai il campo <strong>Title</strong>.</li> + <li>Se necessario, cambia la parte del path del campo <strong>Slug</strong>, per inserire il nuovo documento una diversa parte della gerarchia del documento (nella maggior parte dei casi non è necessario, poiché la pagina clonata ha un contenuto simile all'originale, e perciò dovrebbe essere posizionata nello stesso posto).</li> + <li>Nel campo <strong>TOC</strong>, seleziona il livello di heading che vuoi che sia automaticamente visualizzato nella tabella dei contenuti della pagina o "No table of contents" se la pagina non ne necessita uno.</li> + <li>Scrivi il contenuto di una pagina nel pannello di editor e salva le modifiche. Vedi la sezione <a href="#Editing_an_existing_page">Modificare una pagina esistemte</a> di questo articolo per conoscere come usare la modalità editor.</li> +</ol> + +<p> </p> diff --git a/files/it/mdn/contribute/feedback/index.html b/files/it/mdn/contribute/feedback/index.html new file mode 100644 index 0000000000..a8e48e0e47 --- /dev/null +++ b/files/it/mdn/contribute/feedback/index.html @@ -0,0 +1,49 @@ +--- +title: Invia feedback su MDN +slug: MDN/Contribute/Feedback +tags: + - Documentazione + - Guida + - Italiano + - MDN +translation_of: MDN/Contribute/Feedback +--- +<div>{{MDNSidebar}}</div> + +<p>Benvenuto su MDN! Se hai dei suggerimenti<span class="seoSummary">, o hai dei problemi nell'utilizzare MDN, questo è il luogo giusto. Il fatto stesso che tu sia interessato nell'offrire feedback ti rende ancora più importante nella community di Mozilla, e ti ringraziamo in anticipo per il tuo interesse.</span></p> + +<p><span class="seoSummary">Hai diverse opzione per offrire la tua "saggezza"; questo articolo ti aiuterà in tal proposito.</span></p> + +<h2 id="Aggiorna_la_documentazione">Aggiorna la documentazione</h2> + +<p>Innanzitutto, se hai notato un problema con la documentazione, sentiti pure libero di correggerla tu stesso. Semplicemente <a href="https://developer.mozilla.org/it/MDN/Contribute/Howto/Create_an_MDN_account">accedi</a> utilizzando <a href="https://github.com/">Github</a>, premi un qualsiasi pulsante blu <strong>modifica </strong>per aprire l'<a href="https://developer.mozilla.org/it/MDN/Contribute/Editor">editor</a> ed entrare nel mondo dei contributori alla documentazione di MDN. Tutta la documentazione qui presente è una wiki, curata da un team di volontari e da dello staff pagato, perciò non essere timido: la tua grammatica non deve essere perfetta. Ci penseremo noi a pulirla nel caso tu dovessi fare un errore!</p> + +<p>Per maggiori informazioni riguardanti la collaborazione alla documentazione di MDN, guarda:</p> + +<ul> + <li><a href="https://developer.mozilla.org/it/docs/Project:Getting_started">Primi passi su MDN</a></li> + <li><a href="https://developer.mozilla.org/it/MDN/Contribute">Contribuire a MDN</a></li> + <li><a href="https://developer.mozilla.org/it/MDN/Contribute/Editor">Guida all'editor di MDN</a></li> +</ul> + +<h2 id="Unisciti_alla_conversazione">Unisciti alla conversazione</h2> + +<p>Parla con noi! Ci sono diversi modi per metterti in contatto con altre persone che lavorano su MDN.</p> + +<h3 id="Chat">Chat</h3> + +<p> + </p><h3 id="Discussioni_Asincroni"><span class="short_text" id="result_box" lang="it"><span>Discussioni (Asincroni) </span></span></h3> + + +<p><span id="result_box" lang="it"><span>Le discussioni a lungo termine si verificano sul nostro <a href="https://discourse.mozilla-community.org/c/mdn">forum di discussione MDN</a>.</span> <span>Puoi inviare al forum via e-mail a <a href="mailto://mdn@mozilla-community.org">mdn@mozilla-community.org</a>.</span> <span>Se si aggiunge al forum, puoi scegliere di avere notifiche sulle discussioni inviate anche via e-mail.</span></span></p> + +<h2 id="Segnala_un_problema">Segnala un problema</h2> + +<h3 id="Problemi_di_documentazione">Problemi di documentazione</h3> + +<p>Se noti un problema nella documentazione e non lo puoi aggiustare tu stesso per qualsiasi ragione, puoi <a href="https://github.com/mdn/sprints/issues/new?template=issue-template.md&projects=mdn/sprints/2&labels=user-report">segnalare il problema</a>! Puoi utilizzare questo form per qualsiasi problema riguardante la documentazione, sia esso una semplice correzione o una richiesta per del contenuto completamente nuovo. Come menzionato in precedenza, ti invitiamo a contribuire ai cambiamenti tu stesso, ma questa opzione è comunque a tua completa disponibilità.</p> + +<h3 id="Problemi_del_sito">Problemi del sito</h3> + +<p>Se incontri dei problemi con il sito, o se hai delle idee per il futuro di MDN, puoi <a href="https://bugzilla.mozilla.org/form.mdn">scrivere un ticket al team di sviluppo di MDN</a>.</p> diff --git a/files/it/mdn/contribute/getting_started/index.html b/files/it/mdn/contribute/getting_started/index.html new file mode 100644 index 0000000000..d76748a0dc --- /dev/null +++ b/files/it/mdn/contribute/getting_started/index.html @@ -0,0 +1,95 @@ +--- +title: Primi passi su MDN +slug: MDN/Contribute/Getting_started +translation_of: MDN/Contribute/Getting_started +--- +<div>{{MDNSidebar}}</div><div class="boxed translate-display"> + <p id="What_is_MDN.3F"><span class="seoSummary">Siamo una comunità aperta di sviluppatori che stanno creando risorse per un Web migliore, indipendentemente da marchi, browser o piattaforme. Tutti possono contribuire. Ogni nuovo collaboratore ci rende più forti. Insieme possiamo continuare a guidare il processo di innovazione sul Web per il bene comune. E cominciamo da qui, da te.</span></p> + <p><span>Tutte le varie parti di MDN (documentazione, demo, il sito stesso) sono create da una comunità aperta di sviluppatori. Unisciti a noi!</span></p> + <h2 id="3_semplici_passi_per_contribuire_a_MDN"><span>3 semplici passi per contribuire a MDN</span></h2> + <p>MDN è un wiki, dove <strong>tutti</strong> possono aggiungere e modificare contenuti. Non è necessario essere programmatori o sapere tutto sulla tecnologia. Esistono molti compiti che necessitano di volontari, dai più semplici (revisione e correzione degli articoli) ai più complessi (scrivere la documentazione delle API).</p> + <p>Contribuire è facile e sicuro. Anche se fai errori è semplice sistemarli. Anche se non sai esattamente quale deve essere l'aspetto delle cose o la tua grammatica non è perfetta, non ti preoccupare! Abbiamo un gruppo di persone che ha il compito di assicurarsi che il contenuto di MDN sia il migliore possibile. Ci sarà sempre qualcuno pronto ad assicurarsi che il tuo lavoro sia ordinato e ben scritto. Condividi quello che sai.</p> + <h3 id="Passo_1_creare_un_account_su_MDN">Passo 1: creare un account su MDN</h3> + <p>Per iniziare a collaborare con MDN, devi avere un account su MDN. Per i dettagli leggi<a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Howto/Create_an_MDN_account"> come creare un account</a>.</p> + <h3 id="Passo_2_scegli_un_compito_da_portare_a_termine">Passo 2: scegli un compito da portare a termine</h3> + <p>Ora che sei registrato e hai effettuato l'accesso, leggi le descrizioni dei vari tipi di compiti nella {{anch("Tipi_di_compiti_possibili", "lista qui sotto")}} e decidi quale ti attira di più. Puoi scegliere qualsiasi compito preferisci per iniziare a collaborare.</p> + <h3 id="Passo_3_esegui_il_compito">Passo 3: esegui il compito</h3> + <p>Una volta che hai deciso che tipo di compito vuoi eseguire, trova una pagina specifica, un esempio di codice ecc. su cui lavorare. E buon lavoro!</p> + <p>Non preoccuparti di farlo alla perfezione; altri collaboratori di MDN sono qui per aiutare a correggere gli errori che potresti commettere. Se in corso d'opera hai qualche dubbio o bisogno di chiarimenti, vedi la pagina <a href="https://developer.mozilla.org/it/docs/MDN/Community">Comunità</a> per informazioni sulle mailing list e i canali di chat dove puoi trovare le risposte ai tuoi quesiti.</p> + <div class="note"> + <p><strong>Nota:</strong> se vuoi fare qualche esperimento prima di affrontare un vero compito su MDN, puoi modificare la pagina<a href="https://developer.mozilla.org/it/docs/Sandbox"> Sandbox</a>. Per favore limita i tuoi esperimenti a questa pagina e non effettuare modifiche non necessarie alle altre pagine solo per vedere cosa succede; creeresti confusione che altri dovrebbero poi sistemare.</p> + </div> + <p>Quando hai portato a termine il compito che hai scelto, sentiti libero di scegliere un altro compito o scopri quali <a href="#Altre_cose_che_puoi_fare_su_MDN">altre cose puoi fare su MDN</a>.</p> + <h2 id="Tipi_di_compiti_possibili">Tipi di compiti possibili</h2> + <p>Esistono vari modi per collaborare a MDN a seconda delle tue capacità e interessi. Anche se alcuni compiti possono essere veramente impegnativi, sono disponibili anche molte attività più semplici. Molte di queste richiedono solo cinque minuti (o meno). Insieme ai compiti e a una breve descrizione, viene indicato anche il tempo approssimativamente necessario al loro completamento.</p> + <h3 id="Opzione_1_mi_piace_scrivere">Opzione 1: mi piace scrivere</h3> + <p>Puoi aiutarci a revisionare o modificare la documentazione corrente e applicarle le etichette corrette.</p> + <ul> + <li><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Howto/Set_the_summary_for_a_page">Scrivi l'introduzione di una pagina</a> (5-15 minuti)</li> + <li><a href="https://developer.mozilla.org/it/docs/Project:MDN/Contributing/How_to/Do_an_editorial_review">Effettua revisioni editoriali</a> (5–30 minuti)</li> + <li><a href="https://developer.mozilla.org/it/docs/MDN/User_guide/Writing#Editing_an_existing_page">Aggiorna un articolo esistente con nuove informazioni</a> (5 minuti-1 ora)</li> + <li><a href="/it/docs/Project:MDN/Contributing/How_to/Write_a_new_entry_in_the_Glossary">Scrivi un nuovo termine per il glossario</a> (15 minuti-1 ora)</li> + <li><a href="https://developer.mozilla.org/it/docs/MDN/User_guide/Writing#Adding_a_new_page">Scrivi un articolo su una nuova tecnologia o API</a> (30 minuti-2 ore)</li> + <li><a href="/it/docs/Project:MDN/Contributing/How_to/Write_an_article_to_help_learning_the_web">Scrivi un articolo per aiutare a imparare il Web</a> (1 ora-3 ore)</li> + </ul> + <div class="note"> + <strong>Nota:</strong> se stai revisionando un articolo o ne stai scrivendo di nuovi ti chiediamo di leggere la <a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Content/Style_guide">Guida di stile</a>. Questo ci aiuta ad assicurarci che lo stile degli articoli sia omogeneo.</div> + <h3 id="Opzione_2_mi_piace_programmare">Opzione 2: mi piace programmare</h3> + <p>Abbiamo bisogno di più esempi di codice! Puoi anche aiutare nello sviluppo della piattaforma del sito, <a href="https://developer.mozilla.org/it/docs/Project:MDN/Kuma">Kuma</a>!</p> + <ul> + <li><a href="https://developer.mozilla.org/it/docs/Project:MDN/Contributing/How_to/Convert_code_samples_to_be_live_">Converti gli esempi di codice perché siano "vivi"</a> (30 minuti)</li> + <li><a href="https://kuma.readthedocs.org/en/latest/installation-vagrant.html">Crea un ambiente di sviluppo per Kuma</a> (1 ora)</li> + <li><a href="https://github.com/mozilla/kuma#readme">Condividi le tue modifiche dei sorgenti di Kuma</a> (1 ora)</li> + <li><a href="https://developer.mozilla.org/it/demos/submit">Invia una nuova demo </a>(1 ora)</li> + </ul> + <h3 id="Opzione_3_mi_piace_sia_scrivere_che_programmare">Opzione 3: mi piace sia scrivere che programmare</h3> + <p>Abbiamo dei compiti che richiedono capacità sia tecniche che linguistiche, come ad esempio la scrittura di nuovi articoli, la revisione tecnica o l'adattamento dei documenti.</p> + <ul> + <li><a href="https://developer.mozilla.org/it/docs/Project:MDN/Contributing/How_to/Tag_JavaScript_pages">Etichetta le pagine su JavaScript </a>(5 minuti)</li> + <li><a href="https://developer.mozilla.org/it/docs/MDN/Promote">Promuovi MDN sul tuo sito</a> (5 minuti)</li> + <li><a href="https://developer.mozilla.org/it/docs/Project:MDN/Contributing/How_to/Do_a_technical_review">Effettua revisioni tecniche</a> (30 minuti)</li> + <li><a href="https://developer.mozilla.org/it/docs/Project:MDN/Contributing/How_to/Update_API_page_layout">Aggiorna il layout delle pagine delle API</a> (30 minuti)</li> + <li><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Creating_and_editing_pages#Creating_a_new_page">Scrivi un nuovo articolo su un argomento con cui hai familiarità</a> (1 ora o più)</li> + <li><a href="/it/docs/MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web">Crea un esercizio interattivo per aiutare ad imparare il Web</a> (1 ora o più)</li> + </ul> + <h3 id="Opzione_4_voglio_MDN_tradotto_nella_mia_lingua">Opzione 4: voglio MDN tradotto nella mia lingua</h3> + <p>Tutto il lavoro di localizzazione e traduzione di MDN viene svolto dalla nostra fantastica comunità di volontari.</p> + <ul> + <li><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Localize/Translating_pages">Traduci le pagine</a> (2 ore)</li> + <li>Connettiti con gli altri traduttori presenti negli elenchi dei <a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Localize/Localization_projects">Progetti di localizzazione</a> (30 minuti)</li> + </ul> + <h3 id="Opzione_5_ho_trovato_informazioni_sbagliate_ma_non_so_come_correggerle">Opzione 5: ho trovato informazioni sbagliate ma non so come correggerle</h3> + <p>Puoi segnalare problemi <a class="external external-icon" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">aprendo un bug riguardo la documentazione</a>. (5 minutes)</p> + <p>Usa questi valori per i campi richiesti:</p> + <table class="standard-table"> + <tbody> + <tr> + <td><strong>Campo su Bugzilla</strong></td> + <td><strong>Valore</strong></td> + </tr> + <tr> + <td><code>product</code></td> + <td><a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Developer+Documentation">Developer Documentation</a></td> + </tr> + <tr> + <td><code>component</code></td> + <td>[scegli un'area appropriata all'argomento o "General" se non sei sicuro su quale sia quella corretta]</td> + </tr> + <tr> + <td><code>URL</code></td> + <td>La pagina in cui hai trovato il problema</td> + </tr> + <tr> + <td><code>Description</code></td> + <td>Il maggior numero possibile di informazioni per permetterci di replicare il problema e trovare informazioni utili alla sua risoluzione. Puoi includere nomi di persone ("chiedete a tizio o caio") o anche collegamenti web.</td> + </tr> + </tbody> + </table> + <h2 id="Altre_cose_che_puoi_fare_su_MDN">Altre cose che puoi fare su MDN</h2> + <ul> + <li><a href="https://developer.mozilla.org/it/docs/Project:Community">Unisciti alla comunità MDN</a>.</li> + <li><a href="https://developer.mozilla.org/it/profile">Compila il tuo profilo</a> per permettere agli altri di saperne di più su di te.</li> + <li>Scopri maggiori dettagli su come <a href="https://developer.mozilla.org/it/docs/MDN/Contribute">contribuire a MDN</a>.</li> + </ul> +</div> +<p> </p> diff --git a/files/it/mdn/contribute/howto/convert_code_samples_to_be_live/index.html b/files/it/mdn/contribute/howto/convert_code_samples_to_be_live/index.html new file mode 100644 index 0000000000..7c1fe93a6e --- /dev/null +++ b/files/it/mdn/contribute/howto/convert_code_samples_to_be_live/index.html @@ -0,0 +1,33 @@ +--- +title: Come convertire esempi di codice per renderli "vivi" +slug: MDN/Contribute/Howto/Convert_code_samples_to_be_live +tags: + - Come fare + - Principiante +translation_of: MDN/Contribute/Howto/Convert_code_samples_to_be_live +--- +<div>{{MDNSidebar}}</div><p class="summary">MDN ha un sistema di "<a href="/en-US/docs/MDN/Contribute/Editor/Live_samples">esempi vivi</a>", in cui il codice d'esempio mostrato nella pagina è utilizzato per mostrare immediatamente il risultato che si ottiene con quel codice. Comunque, molti articoli esistenti hanno esempi di codice che non sfruttano questo sistema e devono essere convertiti.</p> + +<p><span class="seoSummary">Gli esempi vivi, che permettono di vedere qual è il risultato di un esempio, rendono la documentazione più dinamica e istruttiva. Questa guida spiega come modificare gli esempi e aggiungere la funzionalità "live".</span></p> + +<dl> + <dt><strong>Dove c'è bisogno di farlo?</strong></dt> + <dd>Negli articoli con etichetta <a href="/en-US/docs/tag/NeedsLiveSample">NeedsLiveSample</a></dd> + <dt><strong>Cosa ho bisogno di sapere?</strong></dt> + <dd> + <ul> + <li>Conoscere i linguaggi HTML, CSS e/o JavaScript, a seconda del codice d'esempio.</li> + <li>Capacità nell'usare le macro <a href="/en-US/docs/MDN/Contribute/Tools/KumaScript">KumaScript</a> negli articoli di MDN.</li> + </ul> + </dd> + <dd><strong>Quali sono i passi per completare il compito?</strong></dd> + <dd> + <ol> + <li>Scegli un articolo dalla lista di quelli che sono etichettati con <a href="/en-US/docs/tag/NeedsLiveSample">NeedsLiveSample</a>, in cui il codice d'esempio usa una funzionalità che ti è familiare.</li> + <li>Converti il codice per renderlo "vivo".</li> + <li>Cancella qualsiasi codice o immagine che era usata in precedenza per mostrare il risultato dell'esempio.</li> + </ol> + </dd> +</dl> + +<p>Per maggiori informazioni su come creare e modificare "esempi vivi", fai riferimento a <a href="/en-US/docs/MDN/Contribute/Editor/Live_samples">Utilizzare il sistema di esempi dal vivo.</a></p> diff --git a/files/it/mdn/contribute/howto/create_an_mdn_account/index.html b/files/it/mdn/contribute/howto/create_an_mdn_account/index.html new file mode 100644 index 0000000000..c6759dc479 --- /dev/null +++ b/files/it/mdn/contribute/howto/create_an_mdn_account/index.html @@ -0,0 +1,49 @@ +--- +title: Come creare un account su MDN +slug: MDN/Contribute/Howto/Create_an_MDN_account +tags: + - Documentazione + - Guide + - MDN + - Principianti + - Sviluppatori +translation_of: MDN/Contribute/Howto/Create_an_MDN_account +--- +<div>{{MDNSidebar}}</div> + +<p><span class="seoSummary">Per apportare qualsiasi modifica ai contenuti di MDN hai bisogno di un profilo MDN. Tranquillo, non hai bisogno di un profilo MDN se vuoi solo leggere e cercare in MDN! Questa semplice guida ti aiuta a creare un profilo MDN.</span></p> + +<div class="pull-aside"> +<div class="moreinfo"> +<p><strong>Perché MDN ha bisogno del mio indirizzo email?</strong><br> + <br> + Il tuo indirizzo email serve per recuperare l'account, oppure se gli amministratori di MDN hanno la necessità di contattarti in merito al tuo account o alla tua attività sul sito.<br> + <br> + Inoltre hai la possibilità di registrarti per ricevere le notifiche (come quando <a href="/en-US/docs/MDN/Contribute/Howto/Watch_a_page">una certa pagina è cambiata</a>) e messaggi (ad esempio, se decidici di unirti al nostro gruppo di beta testing, potresti ricevere email in merito alle nuove funzionalità che hanno bisogno di essere controllate).<br> + <br> + Il tuo indirizzo email non verrà mai visualizzato su MDN e sarà usato solo in accordo alla nostra <a href="https://www.mozilla.org/privacy/websites/">informativa sulla privacy</a>.</p> + +<div class="note">Se fai login tramite Github ed usi un indirizzo email "noreply" su Github, <em>non</em> riceverai i messaggi da MDN (comprese le notifiche quando ti registri alle pagine.)</div> +</div> +</div> + +<ol> + <li>In cima ad ogni pagina su MDN trovi un pulsante con etichetta <strong>Accedi</strong>. Muovi il mouse sul pulsante (o fai tap sullo stesso se usi un dispositivo mobile) per visualizzare una lista dei servizi di autenticazione che usiamo per accedere a MDN.</li> + <li> + <p>Seleziona il servizio che vuoi usare per accedere. Attualmente è disponibile solo GitHub. Nota che se usi GitHub, un link al tuo profilo GitHub verrà incluso nella tua pagina pubblica del profilo MDN.</p> + </li> + <li> + <p>Segui le richieste di GitHub per collegare il tuo account a MDN.</p> + </li> + <li>Quando il servizio di autenticazione ti riporta su MDN, ti verrà chiesto da MDN di inserire un nome utente ed un indirizzo email. <em>Il tuo nome utente sarà visualizzato pubblicamente per identificare il lavoro che hai svolto. Non usare il tuo indirizzo email come nome utente</em><strong>.</strong></li> + <li>Fai click su <strong>Crea nuovo profilo</strong>.</li> + <li>Se l'indirizzo email che hai indicato al punto 4 non è lo stesso che usi con il servizio di autenticazione, controlla la tua email e fai click sul link nell'email di conferma che ti abbiamo inviato.</li> +</ol> + +<p>Fatto! Ora hai un account MDN e puoi immediatamente modificare le pagine!</p> + +<p>Puoi fare click sul tuo nome in cima ad ogni pagina MDN per vedere il tuo profilo pubblico. Da lì puoi fare click su <strong>Modifica</strong> per fare modifiche od aggiunte al tuo profilo.</p> + +<div class="note"> +<p>I nuovi nomi utenti non possono contenere spazi o il carattere "@". Ricordati che il tuo nome utente sarà visualizzato pubblicamente per identificare il lavoro che hai svolto!</p> +</div> diff --git a/files/it/mdn/contribute/howto/delete_my_profile/index.html b/files/it/mdn/contribute/howto/delete_my_profile/index.html new file mode 100644 index 0000000000..182bc6a241 --- /dev/null +++ b/files/it/mdn/contribute/howto/delete_my_profile/index.html @@ -0,0 +1,24 @@ +--- +title: Come rimuovere il mio profilo +slug: MDN/Contribute/Howto/Delete_my_profile +translation_of: MDN/Contribute/Howto/Delete_my_profile +--- +<div>{{MDNSidebar}}</div> + +<p>Nel caso decidessi di non voler più far parte di MDN, puoi richiedere la cancellazione del tuo profilo. Ciò nonostante, non possiamo cancellare alcuna tua revisione (modifiche alle pagine), e la nostra licenza del contenuto prevede che le tue modifiche abbiano una fonte. Se hai fatto delle modifiche, dovrai decidere di volerle attribuire al tuo nome utente, o ri-attribuirle ad "Anonimo".</p> + +<ol> + <li>Dopo aver eseguito l'accesso su MDN, clicca sul tuo profilo nella barra di navigazione in alto visibile in qualsiasi pagina. Si aprirà la tua pagina di profilo, mostrando tutte le informazioni su ciò a cui hai contribuito. Annota se le revisioni sono elencate in <strong>Attività Documenti Recenti</strong>.</li> + <li>Clicca su <strong>Modifica</strong>. Si apirà il modulo <strong>Modifica il tuo profilo</strong>.</li> + <li>Scorri fino alla fine del modulo e fai clic sul link "<strong>Elimina il tuo account</strong>". Si aprirà il modulo "<strong>Elimina il tuo profilo</strong>".</li> + <li>Seleziona una delle seguenti opzioni: + <ul> + <li><strong>Non ho fatto alcuna modifica, cancella il mio account</strong>. Scegli questa opzione se non c'era alcun elemento in <strong>Attività Documenti Recenti</strong>.</li> + <li><strong>Mantieni il mio nome utente come fonte per le mie modifiche, cancella il mio indirizzo email e sospendi il mio account, in modo che non possa più eseguire l'accesso.</strong> Se scegli questa opzione, il tuo profilo verrà associato con le tue modifiche, ma non sarai più in grado di accedere a MDN. La tua pagina del profilo continuerà ad esistere, ma le informazioni personali verranno rimosse.</li> + <li><strong>Cambia la fonte delle mie modifiche in "Anonimo", e cancella il mio account</strong>. Se scegli questa opzione, tutte le modifiche da te eseguite verranno attribuite ad "Anonimo". Il tuo account e pagina del profilo verranno rimosse. Non ci sarà più alcuna associazione tra te e le tue modifiche.</li> + </ul> + </li> + <li>Fai clic su <strong>Segnala un Bug per Chiudere il tuo Account</strong>. Questa azione creerà un nuovo caso nel sistema di tracciamento dei problemi <a href="https://bugzilla.mozilla.org/enter_bug.cgi">Bugzilla</a> per la tua richiesta di cancellazione dell'account, con i campi Riepilogo e Descrizione precompilati in base al tuo nome utente e all'opzione che hai scelto. Questo passaggio è necessario perché un essere umano esaminerà la tua richiesta ed eseguirà le azioni necessarie.</li> + <li>Devi accedere a Bugzilla per inviare la richiesta. Se non hai un account Bugzilla, dovrai crearne uno.</li> + <li>Fare clic su Invia bug per inviare la richiesta. Quando la tua richiesta è stata gestita, riceverai una notifica da Bugzilla all'indirizzo email che hai utilizzato per accedere a Bugzilla.</li> +</ol> diff --git a/files/it/mdn/contribute/howto/do_a_technical_review/index.html b/files/it/mdn/contribute/howto/do_a_technical_review/index.html new file mode 100644 index 0000000000..31f0885a09 --- /dev/null +++ b/files/it/mdn/contribute/howto/do_a_technical_review/index.html @@ -0,0 +1,50 @@ +--- +title: Come effettuare una revisione tecnica +slug: MDN/Contribute/Howto/Do_a_technical_review +translation_of: MDN/Contribute/Howto/Do_a_technical_review +--- +<div>{{MDNSidebar}}</div><p class="summary"><strong>La revisione tecnica consiste nel controllo dell'accuratezza tecnica e della completezza di un articolo e, se necessario, nella sua correzione</strong>. Se chi scrive un articolo desidera che qualcun altro verifichi il contenuto tecnico di un articolo, può segnalarlo attivando l'opzione "Revisione tecnica" durante la modifica di una pagina. A volte chi scrive contatta un ingegnere specifico affinché effettui la revisione tecnica, ma chiunque abbia esperienza tecnica può farlo.</p> +<p><span class="seoSummary">Questo articolo spiega come effettuare una revisione tecnica, permettendo così di mantenere corretto il contenuto di MDN.</span></p> +<table class="fullwidth-table"> + <tbody> + <tr> + <td><strong>In cosa consiste?</strong></td> + <td>Revisionare e correggere gli articoli per assicurarsi che siano tecnicamente corretti e completi</td> + </tr> + <tr> + <td><strong>Dove è necessaria?</strong></td> + <td>In articoli specifici che sono contrassegnati per essere sottoposti a una <a href="/it/docs/needs-review/technical">revisione tecnica</a>.</td> + </tr> + <tr> + <td><strong>Cosa hai bisogno di sapere per completare l'operazione?</strong></td> + <td> + <ul> + <li>Conoscenza da esperto sull'argomento dell'articolo che stai revisionando.</li> + <li>Capacità di modificare un articolo wiki su MDN.</li> + </ul> + </td> + </tr> + <tr> + <td><strong>Quali sono i passi necessari?</strong></td> + <td> + <ol> + <li>Scegli un articolo da revisionare + <ol> + <li>Visita l'elenco delle pagine che necessitano di <a href="/it/docs/needs-review/technical">revisioni tecniche</a>. Questo contiene tutte le pagine per le quali è stata richiesta una revisione tecnica.</li> + <li>Scegli una pagina che tratta di un argomento con cui hai familiarità.</li> + <li>Fai clic sul link dell'articolo per caricare la pagina.</li> + </ol> + </li> + <li>Al termine del caricamento della pagina, fai clic sul pulsante <strong>MODIFICA</strong> in alto a sinistra; verrà aperto l'<a href="/it/docs/MDN/Contribute/Editor">editor di MDN</a>. Non esitare a cambiare pagina se la prima che hai scelto non ti è congeniale.</li> + <li>Man mano che leggi l'articolo, sistema qualsiasi informazione errata e aggiungi le parti importanti mancanti.</li> + <li>Inserisci un <strong>Commento per la revisione</strong> nell'apposito campo in fondo alla pagina, ad esempio <em>'Revisione tecnica completata'</em>. Se hai corretto qualche informazione, includi le modifiche effettuate nel commento, ad esempio <em>'Revisione tecnica: corrette le descrizioni dei parametri'.</em></li> + <li>Fai clic sul pulsante <strong>SALVA MODIFICHE</strong>.</li> + <li>Alla chiusura dell'editor, quando l'articolo a cui sono state apportate le correzioni verrà visualizzato sullo schermo, spunta la voce <strong>Tecnica </strong>a lato (nel riquadro <strong>Sono state richieste le seguenti revisioni</strong>) e fai clic su <strong>CARICA REVISIONE</strong>.</li> + <li>Congratulazioni! Hai concluso la revisione!</li> + </ol> + </td> + </tr> + </tbody> +</table> +<p><br> + </p> diff --git a/files/it/mdn/contribute/howto/do_an_editorial_review/index.html b/files/it/mdn/contribute/howto/do_an_editorial_review/index.html new file mode 100644 index 0000000000..7bfc4bf759 --- /dev/null +++ b/files/it/mdn/contribute/howto/do_an_editorial_review/index.html @@ -0,0 +1,46 @@ +--- +title: Come effettuare una revisione editoriale +slug: MDN/Contribute/Howto/Do_an_editorial_review +translation_of: MDN/Contribute/Howto/Do_an_editorial_review +--- +<div>{{MDNSidebar}}</div><p class="summary"><strong>Una revisione editoriale consiste nel sistemare</strong> errori di digitazione, grammatica, utilizzo, ortografia in un articolo. Non tutti i collaboratori sono traduttori esperti, ma data la loro conoscenza hanno scritto articoli estremamente utili, che necessitano di revisioni e correzioni; questo è lo scopo della revisione editoriale.</p> +<p><span class="seoSummary">Questo articolo descrive come eseguire una revisione editoriale, così da accertarsi che il contenuto di MDN sia accurato.</span></p> +<table class="fullwidth-table"> + <tbody> + <tr> + <td><strong>In che cosa consiste?</strong></td> + <td>In una revisione e correzione di articoli per i quali è richiesta una revisione editoriale.</td> + </tr> + <tr> + <td><strong>Quando è necessaria?</strong></td> + <td>In articoli specifici che sono contrassegnati per essere sottoposti a una revisione editoriale.</td> + </tr> + <tr> + <td><strong>Cosa hai bisogno di sapere per completare l'operazione?</strong></td> + <td>Ti serve avere una buona conoscenza della grammatica e del lessico della lingua in questione.</td> + </tr> + <tr> + <td><strong>Quali sono i passi necessari?</strong></td> + <td> + <ol> + <li>Scegli un articolo da revisionare: + <ol> + <li>Visita l'elenco delle pagine che necessitano di revisione editoriale. Questo contiene tutte le pagine per le quali è stata richiesta una revisione editoriale.</li> + <li>Scegli una pagina che possiede un titolo nella lingua in questione e il cui indirizzo non inizia con Template:<code>.</code></li> + <li>Fai clic sul collegamento per caricare la pagina.</li> + </ol> + </li> + <li>Al termine del caricamento della pagina, fai clic sul pulsante <strong>MODIFICA</strong> in alto a sinistra; verrà aperto l'<a class="new" href="https://developer.mozilla.org/it/docs/MDN/Contribute/Editor">editor di MDN</a>. Non esitare a cambiare pagina se la prima che hai scelto non ti è congeniale.</li> + <li>Correggi tutti gli errori di digitazione, grammatica, utilizzo che trovi.</li> + <li>Inserisci un <strong>Commento per la revisione</strong> nell'apposito campo in fondo alla pagina, ad esempio <em>'Revisione editoriale completata:</em><em> sistemati errori digitazione, grammatica e ortografia'.</em></li> + <li>Fai clic sul pulsante <strong>SALVA MODIFICHE</strong>.</li> + <li>Alla chiusura dell'editor, quando l'articolo a cui sono state apportate le correzioni verrà visualizzato sullo schermo, spunta la voce <strong>Editoriale </strong>a lato (nel riquadro <strong>Sono state richieste le seguenti revisioni</strong>) e fai clic su <strong>CARICA REVISIONE</strong>.</li> + <li> + <p>Congratulazioni! Hai concluso la revisione!</p> + </li> + </ol> + </td> + </tr> + </tbody> +</table> +<p> </p> diff --git a/files/it/mdn/contribute/howto/impostare_il_riassunto_di_una_pagina/index.html b/files/it/mdn/contribute/howto/impostare_il_riassunto_di_una_pagina/index.html new file mode 100644 index 0000000000..ba8df38979 --- /dev/null +++ b/files/it/mdn/contribute/howto/impostare_il_riassunto_di_una_pagina/index.html @@ -0,0 +1,57 @@ +--- +title: Come impostare il riassunto di una pagina +slug: MDN/Contribute/Howto/impostare_il_riassunto_di_una_pagina +tags: + - Community + - Documentazione + - Guida + - MDN + - Riassunto Pagina +translation_of: MDN/Contribute/Howto/Set_the_summary_for_a_page +--- +<div>{{MDNSidebar}}</div><p><span class="seoSummary">Il riassunto di una pagina di MDN è definito in modo da essere utilizzabile in vari ambiti, tra cui i risultati dei motori di ricerca, in altre pagine di MDN, come ad esempio nelle landing pages relative a diversi argomenti, e nei tooltips. Deve essere quindi un testo che conservi il proprio significato sia nel contesto della propria pagina, sia quando si trova in contesti differenti, privato dei contenuti della pagina di origine</span>.</p> +<p>Un riassunto può essere identificato esplicitamente all'interno della pagina. In caso contrario, si utilizza in genere la prima frase, il che non sempre si rivela la scelta più adatta per raggiungere lo scopo prefissato.</p> +<table class="full-width-table"> + <tbody> + <tr> + <td><strong>Qual è il tuo compito?</strong></td> + <td>Evidenziare la parte di testo all' interno della pagina che, a tuo parere, dovrebbe essere utilizzata come riassunto della pagina nei vari contesti; questo compito richiede talvolta la scrittura di un testo appropriato, là dove ve ne sia necessità.</td> + </tr> + <tr> + <td><strong>Dove c'è bisogno del tuo intervento?</strong></td> + <td>In quelle pagine che non hanno riassunto o ne presentano uno di scarsa qualità.</td> + </tr> + <tr> + <td><strong>Di cosa hai bisogno per portare a termine la tua missione?</strong></td> + <td>Conoscenza dell' editor testi di MDN; buone capacità di scrittura in lingua inglese; sufficiente familiarità con l'argomento della pagina in questione, al fine di poterne scrivere un valido riassunto.</td> + </tr> + <tr> + <td><strong>Le tappe del tuo lavoro:</strong></td> + <td> + <ol> + <li>Scegli una pagina di cui fare il riassunto: + <ol> + <li>Nella pagina <a href="/en-US/docs/MDN/Doc_status">MDN documentation status</a>, sotto <strong>Sections</strong>, seleziona l'argomento che meglio conosci (ad esempio HTML):<br> + <img alt="" height="130" src="https://mdn.mozillademos.org/files/8681/sections.png" width="504"></li> + <li>Nella pagina dello stato di documentazione dell'argomento scelto, clicca sulla casella <strong>Pages</strong> della tabella <strong>Summary</strong>. Si aprirà un indice di tutte le pagine di quell'argomento; nella colonna di sinistra troverai i links delle pagine, in quella di destra i tags e i riassunti:<br> + <img alt="" height="82" src="https://mdn.mozillademos.org/files/8675/pages.png" width="361"></li> + <li>Scegli una pagina senza riassunto o con un riassunto mediocre:<br> + <img alt="" height="38" src="https://mdn.mozillademos.org/files/8677/summary.png" width="296"></li> + <li>Clicca il link per aprire quella pagina.</li> + </ol> + </li> + <li>Clicca su <strong>Edit</strong> per aprire la pagina nell'editor testi di MDN.</li> + <li>Cerca una o due frasi adatte per un riassunto, o, all'occorrenza, creane di nuove o modificane di esistenti allo scopo di creare un buon riassunto.</li> + <li>Seleziona il testo da utilizzare come riassunto</li> + <li>Nello <em>Styles</em> widget della barra degli strumenti di editor, seleziona <strong>SEO Summary</strong>. (Si crea così un elemento {{HTMLElement("span")}} nella page source con <code>class="seoSummary"</code> attorno al testo prescelto.) + <p><img alt="" height="231" src="https://mdn.mozillademos.org/files/8679/styles.png" width="403"></p> + </li> + <li>Salva le modifiche con un commento di revisione del tipo "riassunto pagina".</li> + </ol> + </td> + </tr> + </tbody> +</table> +<p> </p> +<p> </p> +<p> </p> diff --git a/files/it/mdn/contribute/howto/index.html b/files/it/mdn/contribute/howto/index.html new file mode 100644 index 0000000000..129865db8b --- /dev/null +++ b/files/it/mdn/contribute/howto/index.html @@ -0,0 +1,16 @@ +--- +title: Guide come fare per +slug: MDN/Contribute/Howto +tags: + - Documentation + - Landing + - MDN + - NeedsTranslation + - TopicStub +translation_of: MDN/Contribute/Howto +--- +<div>{{MDNSidebar}}</div><div>{{IncludeSubnav("/it/docs/MDN")}}</div> + +<p>Questi articoli forniscono una guida passo passo per raggiugnere specifici obiettivi quando si contribuisce a MDN.</p> + + <p>{{LandingPageListSubpages}}</p> diff --git a/files/it/mdn/contribute/howto/tag/index.html b/files/it/mdn/contribute/howto/tag/index.html new file mode 100644 index 0000000000..e518fc0c96 --- /dev/null +++ b/files/it/mdn/contribute/howto/tag/index.html @@ -0,0 +1,380 @@ +--- +title: Usare correttamente i tag +slug: MDN/Contribute/Howto/Tag +tags: + - Beginner + - Contribute + - Glossary + - Guide + - Howto + - Intro + - MDN Meta + - Tutorial +translation_of: MDN/Contribute/Howto/Tag +--- +<div>{{MDNSidebar}}</div> + +<p class="summary">I <strong>tag associati agli articoli</strong> sono uno strumento fondamentale per permettere ai visitatori di accedere a contenuti rilevanti. Normalmente, ogni pagina dovrebbe essere associata a più tag, che contribuiscono a mantenere i contenuti organizzati. <span class="seoSummary">Questa pagina spiega come ottimizzare l'uso dei tag per facilitare i lettori nella ricerca e agevolare i gestori nell'organizzazione e mantenimento dei contenuti.</span></p> + +<p>Per informazioni su come modificare i tag dall'interfaccia utente, consulta la <a href="/en-US/docs/MDN/Contribute/Editor/Basics#The_tags_box">sezione sui tag</a> della guida all'editor di testo di MDN.</p> + +<p>È importante utilizzare i tag secondo queste regole, altrimenti gli automatismi non saranno in grado di generare liste di contenuti, landing page e link incrociati tra i vari articoli.</p> + +<div class="blockIndicator warning"> +<p><strong>Nota per i traduttori e i localizzatori:</strong> <em>non</em> tradurre nessuno dei tag elencati in questa pagina. Sono necessari per scopi specifici, come ad esempio operazioni di gestione del sito ed elaborazione automatica di dati. Tali processi non funzionano con tag tradotti.</p> +</div> + +<h2 id="Uso_dei_tag_in_MDN">Uso dei tag in MDN</h2> + +<p>In MDN i tag vengono utilizzati in diversi modi:</p> + +<dl> + <dt>{{anch("Categoria documento")}}</dt> + <dd>Di che tipo di documento si tratta? È un materiale di consultazione? Un tutorial? Una landing page? Si tratta di una categoria di tag fondamentali, che i lettori possono utilizzare per filtrare le ricerche.</dd> + <dt>{{anch("Argomento")}}</dt> +<dd>Qual è l'argomento dell'articolo? Parla di API? Oppure di DOM? O di grafica? Questi tag, al pari dei precedenti, hanno un ruolo fondamentale nel filtrare i risultati di ricerca.</dd> + <dt>{{anch("Identificazione API")}}</dt> +<dd>Ogni pagina di consultazione di un'API deve essere associata a un tag che identifichi lo specifico componente trattato (ovvero l'interfaccia di cui fa parte e, dove applicabile, la proprietà o metodo).</dd> + <dt>{{anch("Stato tecnologia")}}</dt> + <dd>Qual è lo stato dell'arte della tecnologia trattata? Non è riconosciuta come standard? È obsoleta o deprecata? Oppure sperimentale?</dd> + <dt>{{anch("Livello di competenza")}}</dt> + <dd>Applicabile a tutorial e guide: quanto è avanzata la materia di cui tratta l'articolo?</dd> + <dt>{{anch("Metadati del documento")}}</dt> + <dd>Chi scrive e gestisce i contenuti usa questi tag per tenere traccia del tipo di interventi da effettuare sulle pagine.</dd> +</dl> + +<h2 id="Guida_ai_tipi_di_tag">Guida ai tipi di tag</h2> + +<p>Segue una breve guida ai tipi di tag utilizzati su MDN e i loro significati.</p> + +<h3 id="Categoria_documento">Categoria documento</h3> + +<p>I tag di categoria, associati a un articolo, facilitano la generazione automatica di landing page, indici e via dicendo. Inoltre, nel nuovo sistema di ricerca, questi termini possono essere usati anche dagli utenti per trovare materiali di consultazione e guide pertinenti.</p> + +<p>Ecco i tag che identificano le categorie:</p> + +<dl> + <dt><code>{{Tag("Intro")}}</code></dt> + <dd>"Introduzione". L'articolo tratta di contenuti introduttivi su un argomento. Come regola generale, ciascuna area tecnologica dovrebbe disporre di un unico tag "Intro".</dd> + <dt><code>{{Tag("Reference")}}</code></dt> + <dd>"Consultazione". L'articolo contiene materiali di consultazione su un'API, un elemento, un attributo, una proprietà o simili.</dd> + <dt><code>{{Tag("Landing")}}</code></dt> + <dd>Indica che la pagina in questione è una landing page, la pagina iniziale di un dato argomento.</dd> + <dt><code>{{Tag("Guide")}}</code></dt> + <dd>"Guida". L'articolo consiste in una pagina contenente una guida o una procedura guidata.</dd> + <dt><code>{{Tag("Example")}}</code></dt> + <dd>"Esempio". L'articolo contiene un codice di esempio, oppure campioni di codice (ovvero non semplici esempi di sintassi da una riga, bensì frammenti di codice che possono essere riutilizzati).</dd> +</dl> + +<h3 id="Argomento">Argomento</h3> + +<p>I tag che identificano l'argomento di un articolo consentono di ottenere risultati di ricerca più pertinenti. Inoltre, facilitano la navigazione e l'individuazione di landing page.</p> + +<p>Pur trattandosi di una categoria che può espandersi mano a mano che vengono identificati nuovi argomenti, cerchiamo di limitare i tag ai nomi di API o tecnologie. Alcuni esempi pratici:</p> + +<ul> + <li><code>{{Tag("HTML")}}</code></li> + <li><code>{{Tag("CSS")}}</code></li> + <li><code>{{Tag("JavaScript")}}</code> (notare la "S" maiuscola)</li> + <li><code>{{Tag("Document")}}</code>, "documento"</li> + <li><code>{{Tag("DOM")}}</code></li> + <li><code>{{Tag("API")}}</code> che identifica l'articolo introduttivo, l'interfaccia, i metodi e le proprietà di ciascuna API.</li> + <li><code>{{Tag("Method")}}</code>, "metodo", per ciascun metodo di un'API.</li> + <li><code>{{Tag("Property")}}</code>, "proprietà", per ciascuna proprietà di un'API.</li> + <li><code>{{Tag("Graphics")}}</code>, "grafica"</li> + <li><code>{{Tag("SVG")}}</code></li> + <li><code>{{Tag("WebGL")}}</code></li> + <li><code>{{Tag("Tools")}}</code>, "strumenti"</li> + <li><code>{{Tag("Web")}}</code></li> + <li><code>{{Tag("Element")}}</code>, "elemento"</li> + <li><code>{{Tag("Extensions")}}</code>,"estensioni" e <code>{{Tag("WebExtensions")}}</code> per la documentazione su WebExtension.</li> +</ul> + +<p>In linea generale, i tag di argomento sono nomi di un'interfaccia associati a diverse pagine rilevanti (per esempio, <a href="it/docs/Web/API/Node">Node</a> è associato a diverse pagine perché possiede molteplici proprietà e metodi), o nomi che indicano un complesso di tecnologie. Ad esempio, una pagina che parla di WebGL potrebbe essere associata ai tag <code>Graphics</code> e <code>WebGL</code>, mentre una pagina che tratta dell'elemento {{HTMLElement("canvas")}} ai tag <code>HTML</code>, <code>Element</code>, <code>Canvas</code> e <code>Graphics</code>.</p> + +<h4 id="Contenuti_Mozilla">Contenuti Mozilla</h4> + +<p>I seguenti tag sono associati esclusivamente a contenuti specifici di Mozilla:</p> + +<ul> + <li><code>{{Tag("Mozilla")}}</code></li> + <li><code>{{Tag("Firefox")}}</code></li> + <li><code>{{Tag("Gecko")}}</code></li> + <li><code>{{Tag("XUL")}}</code></li> + <li><code>{{Tag("XPCOM")}}</code></li> +</ul> + +<h3 id="Identificazione_API">Identificazione API</h3> + +<p>All'interno del materiale di consultazione delle API, ciascun articolo dovrebbe essere associato a un tag che identifichi la specifica parte dell'API trattata:</p> + +<dl> + <dt><code>{{tag("Interface")}}</code></dt> + <dd>"Interfaccia". Il tag da associare all'articolo principale dell'interfaccia. Esempio: {{DOMxRef("RTCPeerConnection")}}.</dd> + <dt><code>{{tag("Constructor")}}</code></dt> + <dd>"Costruttore". Ciascuna interfaccia può contenere fino a una pagina con tag "Constructor", ovvero il costruttore dell'interfaccia. Il titolo della pagina deve corrispondere al nome dell'interfaccia. Esempio: {{DOMxRef("RTCPeerConnection.RTCPeerConnection()", "RTCPeerConnection()")}}.</dd> + <dt><code>{{tag("Property")}}</code></dt> + <dd>"Proprietà". Questo tag va associato a ciascun articolo che descrive una proprietà specifica all'interno dell'interfaccia. Esempio: {{DOMxRef("RTCPeerConnection.connectionState")}}</dd> + <dt><code>{{tag("Method")}}</code></dt> + <dd>"Metodo". Questo tag va associato a ciascun articolo che descrive un metodo dell'interfaccia. Esempio: {{DOMxRef("RTCPeerConnection.createOffer()")}}</dd> +</dl> + +<p>In aggiunta, le pagine di consultazione devono includere tra i tag i nomi di interfaccia, proprietà e metodo. Alcuni esempi:</p> + +<dl> + <dt>L'interfaccia {{DOMxRef("RTCPeerConnection")}}</dt> + <dd>include il tag <code>{{Tag("RTCPeerConnection")}}</code> in aggiunta ad altri tag rilevanti come <code>{{Tag("Interface")}}</code>, <code>{{Tag("WebRTC")}}</code>, <code>{{Tag("WebRTC API")}}</code>, <code>{{Tag("API")}}</code>, <code>{{Tag("Reference")}}</code> ecc.</dd> + <dt>Il metodo {{DOMxRef("RTCPeerConnection.createOffer()")}}</dt> + <dd>include i tag <code>{{Tag("RTCPeerConnection")}}</code> e <code>{{Tag("createOffer")}}</code> (attenzione: <em>non</em> inserire parentesi all'interno dei nomi dei tag!) in aggiunta ad altri tag rilevanti come <code>{{Tag("Method")}}</code>, <code>{{Tag("WebRTC")}}</code>, <code>{{Tag("WebRTC API")}}</code>, <code>{{Tag("API")}}</code>, <code>{{Tag("Reference")}}</code>, ecc. Qui è anche possibile aggiungere anche altri tag rilevanti come <code>{{Tag("Offer")}}</code> e <code>{{Tag("SDP")}}</code>.</dd> + <dt>La proprietà {{DOMxRef("RTCPeerConnection.iceConnectionState")}}</dt> + <dd>include i tag <code>{{Tag("RTCPeerConnection")}}</code> e <code>{{Tag("iceConnectionState")}}</code> in aggiunta ad altri tag rilevanti come <code>{{Tag("Property")}}</code>, <code>{{Tag("WebRTC")}}</code>, <code>{{Tag("WebRTC API")}}</code>, <code>{{Tag("API")}}</code> e <code>{{Tag("Reference")}}</code>. È possibile aggiungere anche il tag <code>{{Tag("ICE")}}</code>.</dd> +</dl> + +<h3 id="Stato_tecnologia">Stato tecnologia</h3> + +<p>I seguenti tag identificano lo stato dell'arte delle specifiche tecnologiche. Aiutano il lettore a farsi un'idea di quanto praticabile sia una particolare tecnologia. Il tag non spiega in dettaglio il tipo e i progressi della tecnologia nel processo di specificazione (per questo scopo c'è la tabella delle specifiche), ma aiuta il lettore a giudicare a colpo d'occhio quanto convenga utilizzare la tecnologia descritta nell'articolo.</p> + +<p>Di seguito, i possibili valori per questa categoria di tag:</p> + +<dl> + <dt><code>{{Tag("Read-only")}}</code></dt> + <dd>"Sola lettura". Il tag da applicare alle pagine di consultazione, che descrivono una proprietà o un attributo di sola lettura.</dd> + <dt><code>{{Tag("Non-standard")}}</code></dt> + <dd>"Non standardizzata". Indica che la tecnologia o l'API descritta sulla pagina non rientra in alcuno standard, indipendentemente dalla sua stabilità nei browser che la implementano (se è instabile, va aggiunto anche il tag {{Tag("Experimental")}}). In assenza di questo tag, il lettore presumerà che quella descritta sia una tecnologia standard. La pagina deve inoltre contenere una tabella di compatibilità con l'elenco dei browser che supportano l'API o la tecnologia trattata.</dd> + <dt><code>{{Tag("Deprecated")}}</code></dt> + <dd>"Deprecata". Quando la tecnologia o API trattata nella pagina è segnalata come "deprecata", è probabile che cada in disuso, anche se per il momento è ancora disponibile nelle versioni più recenti dei browser.</dd> + <dt><code>{{Tag("Obsolete")}}</code></dt> + <dd>"Obsoleta". La tecnologia o API trattata è ormai ritenuta obsoleta, dunque è stata rimossa (o è in corso di rimozione) da tutti gli attuali browser, o quasi.</dd> + <dt><code>{{Tag("Experimental")}}</code></dt> + <dd>"Sperimentale". La pagina tratta di una tecnologia non ancora standardizzata, dunque sperimentale, oppure di un'API che potrebbe o meno diventare parte di uno standard. È inoltre soggetta alle modifiche nel motore del browser che la implementa (di solito si tratta di un singolo browser). Se tale tecnologia non fa parte di alcuna specifica (neanche in forma di bozza), deve essere associata anche al tag {{tag("Non-standard")}}.</dd> + <dt><code>{{Tag("Needs Privileges")}}</code></dt> + <dd>"Richiede privilegi". L'API trattata richiede privilegi di accesso al dispositivo su cui si esegue il codice.</dd> + <dt><code>{{Tag("Certified Only")}}</code></dt> + <dd>"Solo certificato". L'API trattata funziona solo con codice certificato.</dd> +</dl> + +<p>I tag precedenti non sostituiscono la <a href="/it/docs/MDN/Contribute/Structures/Tabelle_compatibilità">tabella di compatibilità</a>, che deve essere sempre presente nell'articolo.</p> + +<h3 id="Livello_di_competenza">Livello di competenza</h3> + +<p>I tag che indicano il livello di competenza vanno applicati unicamente a guide e tutorial (ovvero, alle pagine con tag <code>Guide</code>). Aiutano l'utente a scegliere un tutorial in base alla propria conoscenza di una data tecnologia. Questa categoria ha tre valori:</p> + +<dl> + <dt><code>{{Tag("Beginner")}}</code></dt> + <dd>"Principiante". Articoli concepiti per presentare una tecnologia a chi non l'ha mai utilizzata o la conosce solo superficialmente.</dd> + <dt><code>{{Tag("Intermediate")}}</code></dt> + <dd>"Intermedio". Articoli destinati a utenti che hanno già iniziato a utilizzare la tecnologia trattata, ma non ne sono ancora esperti.</dd> + <dt><code>{{Tag("Advanced")}}</code></dt> + <dd>"Avanzato". Articoli che approfondiscono le possibilità della tecnologia trattata e mettono alla prova le competenze dell'utente.</dd> +</dl> + +<h3 id="Metadati_del_documento">Metadati del documento</h3> + +<p>La comunità dei creatori di contenuti usa i tag per contrassegnare gli articoli che richiedono interventi di tipo specifico. Di seguito, una lista dei più utilizzati:</p> + +<dl> + <dt><code>{{Tag("Draft")}}</code></dt> + <dd>"Bozza". L'articolo non è ancora completo. In teoria, significa che è in fase di aggiornamento, ma potrebbe trattarsi anche di un articolo abbandonato. Prima di eseguire qualsiasi modifica, è buona norma contattare i collaboratori che hanno lavorato all'ultima bozza dell'articolo, al fine di evitare possibili conflitti di contenuto.</dd> + <dt><code>{{Tag("NeedsCompatTable")}}</code></dt> + <dd>"Richiede tabella compatibilità". Occorre aggiungere all'articolo una tabella che specifichi la compatibilità della funzione trattata con i vari browser. Vedi anche la <a href="/it/docs/MDN/Contribute/Structures/Tabelle_compatibilità">guida</a> per collaborare alla compilazione di una tabella di compatibilità dei browser.</dd> + <dt><code>{{Tag("NeedsContent")}}</code></dt> + <dd>"Richiede contenuti". L'articolo è solo un abbozzo, oppure contiene informazioni incomplete. Questo tag indica che è richiesto un revisore per controllare la correttezza dei contenuti, aggiungere ulteriori informazioni e/o completare la stesura dell'articolo.</dd> + <dt><code>{{Tag("NeedsExample")}}</code></dt> + <dd>"Richiede esempio". L'articolo necessita di uno o più esempi che chiariscano i concetti illustrati. Tali esempi devono utilizzare il <a href="/en-US/docs/Project:MDN/Contributing/How_to_help/Code_samples">sistema di codice esempio live</a>.</dd> + <dt><code>{{Tag("NeedsLiveSamples")}}</code></dt> + <dd>"Richiede esempi live". L'articolo contiene uno o più esempi che devono essere aggiornati al <a href="/en-US/docs/Project:MDN/Contributing/How_to_help/Code_samples">sistema di codice esempio live</a>.</dd> + <dt><code>{{Tag("NeedsMarkupWork")}}</code></dt> + <dd>"Richiede formattazione". Il codice di markup che costituisce la formattazione dell'articolo deve essere ottimizzato (solitamente perché l'articolo è formattato solo o quasi da tag generici tipo {{HTMLElement("p")}}).</dd> + <dt><code>{{Tag("NeedsSpecTable")}}</code></dt> + <dd>"Richiede tabella specifiche". Occorre aggiungere all'articolo una tabella che documenti le specifiche della funzione trattata.</dd> + <dt><code>{{Tag("NeedsUpdate")}}</code></dt> + <dd>"Richiede aggiornamento". Occorre aggiornare i contenuti dell'articolo con informazioni più recenti.</dd> + <dt><code>{{Tag("l10n:exclude")}}</code></dt> + <dd>"Escluso da localizzazione". Non vale la pena localizzare questo contenuto, dunque verrà escluso dalle pagine di stato della localizzazione.</dd> + <dt><code>{{Tag("l10n:priority")}}</code></dt> + <dd>"Priorità localizzazione". Questo contenuto è importante, i traduttori di MDN dovrebbero dargli la priorità rispetto ad altri articoli. Questo tag viene visualizzato in una tabella delle priorità a parte nelle pagine di stato della localizzazione.</dd> +</dl> + +<h2 id="Combinare_i_vari_tag">Combinare i vari tag</h2> + +<p>Abbiamo visto che a ogni pagina vanno assegnati più tag di diverse categorie, per esempio:</p> + +<dl> + <dt>Un tutorial per principianti su WebGL</dt> + <dd>comprende i tag {{Tag("WebGL")}}, {{Tag("Graphics")}}, {{Tag("Guide")}}, {{Tag("Beginner")}}</dd> + <dt>La pagina di consultazione dell'elemento {{HTMLElement("canvas")}}</dt> + <dd>comprende i {{Tag("Canvas")}}, {{Tag("HTML")}}, {{Tag("Element")}}, {{Tag("Graphics")}}, {{Tag("Reference")}}</dd> + <dt>Una landing page sugli strumenti di sviluppo di Firefox</dt> + <dd>comprende i tag {{Tag("Tools")}}, {{Tag("Firefox")}}, {{Tag("Landing")}}</dd> +</dl> + +<h2 id="Tag_e_filtri_di_ricerca">Tag e filtri di ricerca</h2> + +<p>L'efficacia dei filtri di ricerca dipende dall'inserimento dei tag corretti nelle pagine di MDN. Di seguito, una tabella dei filtri di ricerca con i tag corrispondenti. (Questi filtri di ricerca si applicano unicamente al sito <a href="https://wiki.developer.mozilla.org">wiki</a> (la versione modificabile di MDN); la versione MDN <a href="https://developer.mozilla.org">in sola lettura</a> utilizza un sistema di ricerca diverso, senza filtri.)</p> + +<div class="blockIndicator note"> +<p><strong>Nota:</strong> Quando sotto la colonna "Nome tag" sono presenti più tag, significa che, perché l'articolo compaia nei risultati di ricerca, deve essere associato a uno o più dei tag elencati.</p> +</div> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Gruppo filtro</th> + <th scope="col">Nome filtro ricerca</th> + <th scope="col">Nome tag</th> + </tr> + </thead> + <tbody> + <tr> + <th rowspan="22" scope="row" style="vertical-align: baseline;">Argomento</th> + <td>APIs and DOM</td> + <td>{{Tag("API")}} || {{Tag("DOM")}} {{Deprecated_Inline}}</td> + </tr> + <tr> + <td>Add-ons & Extensions {{Deprecated_Inline}}</td> + <td>{{Tag("Add-ons")}} || {{Tag("Extensions")}} || {{Tag("Plugins")}} || {{Tag("Themes")}} || {{Tag("WebExtensions")}}</td> + </tr> + <tr> + <td>CSS</td> + <td>{{Tag("CSS")}}</td> + </tr> + <tr> + <td>Canvas</td> + <td>{{Tag("Canvas")}}</td> + </tr> + <tr> + <td>Firefox</td> + <td>{{Tag("Firefox")}}</td> + </tr> + <tr> + <td>Firefox OS</td> + <td>{{Tag("Firefox OS")}}</td> + </tr> + <tr> + <td>Games</td> + <td>{{Tag("Games")}}</td> + </tr> + <tr> + <td>HTML</td> + <td>{{Tag("HTML")}}</td> + </tr> + <tr> + <td>HTTP</td> + <td>{{Tag("HTTP")}}</td> + </tr> + <tr> + <td>JavaScript</td> + <td>{{Tag("JavaScript")}}</td> + </tr> + <tr> + <td>Marketplace {{Non-standard_Inline}}</td> + <td>{{Tag("Marketplace")}}</td> + </tr> + <tr> + <td>MathML</td> + <td>{{Tag("MathML")}}</td> + </tr> + <tr> + <td>Mobile</td> + <td>{{Tag("Mobile")}}</td> + </tr> + <tr> + <td>Open Web Apps {{Non-standard_Inline}}</td> + <td>{{Tag("Apps")}}</td> + </tr> + <tr> + <td>SVG</td> + <td>{{Tag("SVG")}}</td> + </tr> + <tr> + <td>Web Development</td> + <td>{{Tag("Web Development")}}</td> + </tr> + <tr> + <td>Web Standards</td> + <td>{{Tag("Web")}}</td> + </tr> + <tr> + <td>WebExtensions</td> + <td>{{Tag("WebExtensions")}}</td> + </tr> + <tr> + <td>WebGL</td> + <td>{{Tag("WebGL")}}</td> + </tr> + <tr> + <td>Writing Documentation</td> + <td>{{Tag("MDN Meta")}}</td> + </tr> + <tr> + <td>XPCOM {{Non-standard_Inline}}</td> + <td>{{Tag("XPCOM")}}</td> + </tr> + <tr> + <td>XUL {{Non-standard_Inline}}</td> + <td>{{Tag("XUL")}}</td> + </tr> + <tr> + <th rowspan="3" scope="row" style="vertical-align: baseline; white-space: nowrap;">{{anch("Livello di competenza")}}</th> + <td>I'm an Expert</td> + <td>{{Tag("Advanced")}}</td> + </tr> + <tr> + <td>Intermediate</td> + <td>{{Tag("Intermediate")}}</td> + </tr> + <tr> + <td>I'm Learning</td> + <td>{{Tag("Beginner")}}</td> + </tr> + <tr> + <th rowspan="7" scope="row" style="vertical-align: baseline; white-space: nowrap;">Tipo di documento</th> + <td>Docs</td> + <td><em>Restringe il campo di ricerca alla documentazione, escludendo i contenuti di Hacks e contenuti di altro tipo in MDN.</em></td> + </tr> + <tr> + <td>Demos</td> + <td><em>Questo tipo di documento non è più in uso nella documentazione web di MDN.</em></td> + </tr> + <tr> + <td>Tools</td> + <td>{{Tag("Tools")}}</td> + </tr> + <tr> + <td>Code Samples</td> + <td>{{Tag("Example")}}</td> + </tr> + <tr> + <td>How-To & Tutorial</td> + <td>{{Tag("Guide")}}</td> + </tr> + <tr> + <td>Developer Profiles</td> + <td><em>Include nei risultati di ricerca i profili degli sviluppatori registrati su MDN.</em></td> + </tr> + <tr> + <td>External Resources</td> + <td><em>Il team di sviluppo non ha ancora stabilito come utilizzare questo filtro...</em></td> + </tr> + </tbody> +</table> + +<h2 id="Problemi_di_tag_che_puoi_aiutare_a_risolvere">Problemi di tag che puoi aiutare a risolvere</h2> + +<p>I collaboratori possono contribuire a risolvere diversi tipi di problemi riguardanti i tag:</p> + +<dl> + <dt>Niente tag</dt> + <dd>Di norma, ogni articolo dovrebbe essere associato <em>almeno</em> a un tag per la {{anch("Categoria documento", "categoria")}} e a un tag per l'{{anch("Argomento", "argomento")}} del documento. È possibile aggiungere altri tag appropriati, ma assicurarsi che ogni pagina abbia i tag strettamente necessari costituisce già di per sé un enorme contributo.</dd> + <dt>Tag non conformi agli standard MDN</dt> + <dd>Quando si trova un documento che non segue gli standard di questa pagina, è opportuno correggerlo.<br> +Attenzione: su alcune pagine in lingua inglese è possibile talvolta imbattersi in tag localizzati in altre lingue (es. <code>Référence</code>). Questo problema è dovuto a un <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=776048">bug in Kuma</a> per cui i tag ricomparivano anche dopo essere stati eliminati. Il bug <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=776048#c37">è stato successivamente risolto</a>: ora è possibile ripulire le pagine da tutti i tag erratamente localizzati.</dd> + <dt>Tag non corretti</dt> + <dd>Se un articolo sul codice HTML è associato al tag "JavaScript", si tratta probabilmente di un errore. Lo stesso vale per un articolo che tratta di meccanismi interni di prodotti Mozilla, ma è associato al tag "Web". I tag non corretti vanno rimossi e quelli appropriati vanno aggiunti, se mancanti. Inoltre, vanno corretti anche i tag che contengono errori di battitura, come ad esempio "Javascript" (il tag funziona comunque, poichè il sistema non coglie la differenza tra maiuscole e minuscole, ma anche la forma va curata).</dd> + <dt>Tag mancanti</dt> + <dd>Un articolo potrebbe già essere associato ad alcuni tag, ma non a tutti quelli necessari. In questo caso, occorre aggiungere i tag mancanti. Per esempio, se una pagina di consultazione in JavaScript presenta soltanto il tag "JavaScript" (peraltro corretto), i collaboratori sono incoraggiati ad aggiungere i tag "Reference" o di un'altra {{anch("Categoria documento", "categoria")}}.</dd> +<dt>Tag spam</dt> +<dd>Si tratta del problema più fastidioso di tutti: alcuni malevoli frequentatori del Web hanno attaccato anche MDN, infestando le pagine con tag tipo "Free warez!" o "Ehi passavo da questo sito e volevo sapere se potete aiutarmi a risolvere il problema con Flash che crasha sempre". Questi tag vanno eliminati al più presto! Non solo danno fastidio e creano problemi nella gestione delle pagine se non vengono rimossi tempestivamente, ma hanno anche un effetto deleterio sul {{Glossary("SEO")}}.</dd> +</dl> + +<p>Quando si nota uno (o più) di questi tag, <a href="/it/docs/Project:Getting_started">accedere a MDN</a> e premere MODIFICA nell'angolo in alto a destra della finestra. Una volta che l'editor si sarà caricato, scorrere fino al riquadro dei tag, che si trova in fondo alla pagina. Per ulteriori dettagli sull'interfaccia di inserimento dei tag, consulta la <a href="/en-US/docs/MDN/Contribute/Editor/Basics/Tags">sezione sui tag</a> nella <a href="/it/docs/MDN/Contribute/Editor">guida all'editor di MDN</a>.</p> diff --git a/files/it/mdn/contribute/index.html b/files/it/mdn/contribute/index.html new file mode 100644 index 0000000000..2a0a00581a --- /dev/null +++ b/files/it/mdn/contribute/index.html @@ -0,0 +1,71 @@ +--- +title: Contribuire a MDN +slug: MDN/Contribute +tags: + - Documentation + - Guide + - Landing + - MDN +translation_of: MDN/Contribute +--- +<div>{{MDNSidebar}}</div> + +<p> <span class="seoSummary">Benvenuto! Visitando questa pagina hai fatto il primo passo per diventare un collaboratore di MDN. Queste guide coprono tutti gli aspetti inerenti la collaborazione con MDN, ad esempio le guide di stile, le guide per l'uso dell'editor, dei vari strumenti e altro ancora.</span></p> + +<div class="row topicpage-table"> +<div class="section"> +<h2 id="Guide_per_i_collaboratori">Guide per i collaboratori</h2> + +<dl> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Getting_started">Primi passi</a></dt> + <dd>Una guida veloce per prepararti ai tuoi primi contributi.</dd> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Style_guide">Guida di stile e di contenuto</a></dt> + <dd>La guida di stile e di contenuto di MDN fornisce i dettagli riguardo lo stile di scrittura, il layout delle pagine e lo stile dei contenuti, per fare sì che ciò che scrivi sia in linea con il resto del contenuto di MDN.</dd> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Editor">Guida all'editor</a></dt> + <dd>Una guida completa all'uso dell'editor di MDN.</dd> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Reviewing_articles">Revisione degli articoli</a></dt> + <dd>Una guida alla revisione editoriale e tecnica del contenuto degli articoli, per assicurarci che tutto il contenuto di MDN sia il più possibile utile e leggibile.</dd> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Conventions">Terminologia e convenzioni</a></dt> + <dd>La nostra guida alla terminologia e alle convenzioni fornisce informazioni che puoi utilizzare per assicurarti che tu stia usando la corretta terminologia per descrivere i vari concetti.</dd> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Community">Lavorare con la comunità di MDN</a></dt> + <dd>Una guida che spiega come lavorare con la nostra comunità, trovare aiuto e connetterti con le persone giuste per risolvere qualsiasi dubbio tu abbia nella tua collaborazione con MDN.</dd> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/FAQ">Risposte a domande frequenti</a></dt> + <dd>Suggerimenti e risposte alle domande più frequenti riguardo alla collaborazione con MDN.</dd> +</dl> + +<dl> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Kuma/Contributing">Contribuire a Kuma</a></dt> + <dd>Una guida alla collaborazione con il progetto Kuma, ovvero la piattaforma del sito web di MDN.</dd> +</dl> +</div> + +<div class="section"> +<h2 id="Come_fare_per...">Come fare per...</h2> + +<p>I nostri<a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Howto"> manuali di istruzioni</a> ti guideranno passo passo nello svolgere specifici compiti quando collabori con MDN.</p> + +<dl> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Howto/Document_a_CSS_property">Come documentare una proprietà CSS</a></dt> + <dd>Una guida alla scrittura di documentazione per le proprietà CSS. Tutti i documenti sulle proprietà dei CSS devono adeguarsi allo stile e al layout descritti in questo articolo.</dd> + <dt>Come documentare un elemento HTML</dt> + <dd>Questa guida alla scrittura di documentazione sugli elementi HTML permette di preparare documenti che siano in linea con la documentazione già presente su MDN.</dd> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Howto/Tag">Come etichettare correttamente le pagine</a></dt> + <dd>Questa guida all'etichettatura delle pagine fornisce informazioni riguardo ai nostri standard per l'etichettatura. Inoltre contiene un elenco di etichette che hanno un significato standard su MDN. Seguire questa guida garantirà che i tuoi contenuti siano categorizzati appropriatamente, più facili da cercare e che il nostro sistema di filtri di ricerca funzioni correttamente con i tuoi articoli.</dd> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Howto/Interpret_specifications">Come interpretare le specifiche</a></dt> + <dd>Questa guida ti aiuterà ad interpretare correttamente le specifiche degli standard Web; la capacità di leggere queste specifiche può essere una vera e propria forma d'arte. Una corretta interpretazione ti aiuterà a creare una documentazione migliore.</dd> +</dl> + +<h2 id="Localizzazione">Localizzazione</h2> + +<dl> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Localize/Tour">Tour guidato alla localizzazione</a></dt> + <dd>Questo tour guidato spiega come localizzare i contenuti su MDN.</dd> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Localize/Guide">Guida alla localizzazione</a></dt> + <dd>Questa guida fornisce maggiori dettagli riguardo al processo di localizzazione dei contenuti su MDN.</dd> + <dt><a href="https://developer.mozilla.org/it/docs/MDN/Contribute/Localize/Localization_projects">Progetti di localizzazione</a></dt> + <dd>Quasta pagina ti permette di trovare i progetti di localizzazione per la tua lingua o, se non ne esistono, ti spiega come crearne uno!</dd> +</dl> +</div> +</div> + +<p> </p> diff --git a/files/it/mdn/contribute/localize/guidaitaliano/index.html b/files/it/mdn/contribute/localize/guidaitaliano/index.html new file mode 100644 index 0000000000..203b17067d --- /dev/null +++ b/files/it/mdn/contribute/localize/guidaitaliano/index.html @@ -0,0 +1,82 @@ +--- +title: Processo di localizzazione di MDN per la versione Italiana +slug: MDN/Contribute/Localize/GuidaItaliano +tags: + - Localization + - MDN + - l10n +--- +<div>{{MDNSidebar}}</div><div id="magicdomid3"> + <span class="author-g-ci9fz122zcotjn90xvng">La localizzazione di MDN viene gestita principalmente da Mozilla Italia, un gruppo di volontari che si occupa della localizzazione e diffusione dei progetti e dei valori di Mozilla per gli utenti italiani.</span></div> +<div id="magicdomid4"> + </div> +<div id="magicdomid5"> + <span class="author-g-ci9fz122zcotjn90xvng">Abbiamo messo a punto un sistema che ci permette di gestire più agevolmente il processo di localizzazione e QA (Quality Assurance, ovvero Controllo Qualità) degli articoli presenti su MDN. Se da un lato non è obbligatorio usare questo sistema per partecipare alla localizzazione degli articoli di MDN, dall'altro questo ci aiuta ad evitare la duplicazione del lavoro e ad avere un approccio più sistematico nell'opera che stiamo portando avanti.</span></div> +<div id="magicdomid6"> + </div> +<h2 id="Ruoli_attuali"><span class="author-g-ci9fz122zcotjn90xvng">Ruoli attuali</span></h2> +<div id="magicdomid8"> + <span class="author-g-ci9fz122zcotjn90xvng">Il processo di traduzione viene eseguito da due figure: il traduttore ed il revisore.</span></div> +<div id="magicdomid9"> + </div> +<div id="magicdomid10"> + <span class="author-g-ci9fz122zcotjn90xvng">Il traduttore si occupa di tradurre gli articoli, mentre il revisore si occupa della parte di QA, ovvero di verificare che la traduzione sia scritta in maniera chiara, leggibile e linguisticamente corretta.</span></div> +<div id="magicdomid11"> + </div> +<h2 id="Prerequisiti"><span class="author-g-ci9fz122zcotjn90xvng">Prerequisiti</span></h2> +<div id="magicdomid13"> + <span class="author-g-ci9fz122zcotjn90xvng">I localizzatori devono:</span></div> +<div id="magicdomid14"> + <span class="author-g-ci9fz122zcotjn90xvng">1. Essere in grado di modificare e creare nuovi articoli su MDN (vedi [link alla pagina di MDN sulla modifica degli articoli])</span></div> +<div id="magicdomid15"> + <span class="author-g-ci9fz122zcotjn90xvng">2. Essere iscritti al forum di Mozilla Italia (</span><span class="author-g-ci9fz122zcotjn90xvng url"><a href="http://forum.mozillaitalia.org">http://forum.mozillaitalia.org</a></span><span class="author-g-ci9fz122zcotjn90xvng"> )</span></div> +<div id="magicdomid16"> + </div> +<div id="magicdomid17"> + <span class="author-g-ci9fz122zcotjn90xvng">I revisori devono:</span></div> +<div id="magicdomid18"> + <span class="author-g-ci9fz122zcotjn90xvng">1. Essere iscritti al forum di Mozilla Italia (</span><span class="author-g-ci9fz122zcotjn90xvng url"><a href="http://forum.mozillaitalia.org">http://forum.mozillaitalia.org</a></span><span class="author-g-ci9fz122zcotjn90xvng"> )</span></div> +<div id="magicdomid19"> + </div> +<h2 id="Il_processo_di_localizzazione"><span class="author-g-ci9fz122zcotjn90xvng">Il processo di localizzazione</span></h2> +<div id="magicdomid21"> + <span class="author-g-ci9fz122zcotjn90xvng">Questo elenco di operazioni copre il ciclo di vita di una localizzazione, da quando il localizzatore comincia il proprio lavoro a quando la localizzazione dell'articolo risulta terminata.</span></div> +<div id="magicdomid22"> + </div> +<div id="magicdomid23"> + <span class="author-g-ci9fz122zcotjn90xvng">1. Il localizzatore decide quale pagina localizzare.</span><span class="author-g-ywfp69kq6xj4einh"> Nella scelta di quant</span><span class="author-g-gqulvq7hq8g96crt">e</span><span class="author-g-ywfp69kq6xj4einh"> e quali pagine tradurre occorre tenere presente che il lavoro del localizzatore non si esaurisce con la traduzione della pagina allo stato attuale, ma continua con l’impegno di tenerla costantemente aggiornata.</span></div> +<div id="magicdomid24"> + <span class="author-g-ci9fz122zcotjn90xvng">2. Il localizzatore esegue il proprio lavoro.</span></div> +<div id="magicdomid25"> + <span class="author-g-ci9fz122zcotjn90xvng">3. Prima di salvare si assicura che, in fondo alla pagina dell'editor siano spuntate le voci "Localizzazione in corso" e "Editoriale" sotto la sezione "È necessaria una revisione?"</span></div> +<div id="magicdomid26"> + <span class="author-g-ci9fz122zcotjn90xvng">4. Il localizzatore aggiunge una riga sull'etherpad presente all'indirizzo </span><span class="author-g-ci9fz122zcotjn90xvng url"><a href="https://etherpad.mozilla.org/9LBcQCAbkA">https://etherpad.mozilla.org/9LBcQCAbkA</a></span><span class="author-g-ci9fz122zcotjn90xvng"> indicando il titolo dell'articolo, l'URL dell'articolo e il proprio nickname.</span></div> +<div id="magicdomid27"> + <span class="author-g-ci9fz122zcotjn90xvng">5. Il localizzatore aggiunge un post al topic "[MDN] Traduzione articoli" sul forum di Mozilla Italia all'indirizzo </span><span class="author-g-ci9fz122zcotjn90xvng url"><a href="http://forum.mozillaitalia.org/index.php?topic=54775.0">http://forum.mozillaitalia.org/index.php?topic=54775.0</a></span><span class="author-g-ci9fz122zcotjn90xvng"> </span></div> +<div id="magicdomid28"> + <span class="author-g-ci9fz122zcotjn90xvng">6. Il revisore controlla l'articolo tradotto e nello stesso topic suggerisce al localizzatore le correzioni da effettuare. Questi suggerimenti non sono vincolanti, sta al localizzatore decidere se accettarli o meno</span></div> +<div id="magicdomid29"> + <span class="author-g-ci9fz122zcotjn90xvng">7. Il localizzatore effettua le correzioni che ritiene opportune</span></div> +<div id="magicdomid30"> + <span class="author-g-ci9fz122zcotjn90xvng">8. Se i revisori si ritengono soddisfatti delle correzioni apportate, il localizzatore sbarra la voce dell'articolo sull'etherpad (selezionando la riga corrispondente e usando il pulsante con la "S" sbarrata in alto a destra dell'editor per applicare alla selezione lo stile "Strikethrough")</span></div> +<div id="magicdomid31"> + </div> +<h2 id="Suggerimenti"><span class="author-g-ci9fz122zcotjn90xvng">Suggerimenti</span></h2> +<ul> + <li id="magicdomid33"><span class="author-g-ci9fz122zcotjn90xvng">Si consiglia ai localizzatori di abbonarsi alla pagina originale che stanno traducendo, così da ricevere notifica quando l'originale viene modificato e poter aggiornare la localizzazione.</span><span class="author-g-ywfp69kq6xj4einh"> Anche in assenza di notifiche è buona norma controllare periodicamente i link della pagina per aggiornare i titoli degli articoli collegati che sono stati tradotti in italiano nel frattempo.</span><br> + <span class="author-g-ci9fz122zcotjn90xvng">Sarebbe poi auspicabile segnalare sul forum che sono state apportate delle modifiche in modo che i revisori possano verificare la bontà delle stesse.</span></li> +</ul> +<div id="magicdomid35"> + </div> +<h3 id="Consistenza_terminologica_e_aggiornamenti"><span class="author-g-ywfp69kq6xj4einh b"><b>Consistenza terminologica e aggiornamenti</b></span></h3> +<div id="magicdomid38"> + <span class="author-g-ywfp69kq6xj4einh">Essendo MDN una guida per sviluppatori, è di fondamentale importanza che la terminologia degli articoli sia consistente con quella utilizzata nella localizzazione ufficiale di Mozilla. Pertanto:</span></div> +<ul> + <li id="magicdomid39"><span class="author-g-ywfp69kq6xj4einh">È buona norma controllare sempre se a ogni termine è stata assegnata una traduzione ufficiale (verificando direttamente nei prodotti Mozilla localizzati in italiano o utilizzando questo motore di ricerca: </span><span class="author-g-ywfp69kq6xj4einh url"><a href="http://transvision.mozfr.org/">http://transvision.mozfr.org/</a></span><span class="author-g-ywfp69kq6xj4einh"> ) piuttosto che lasciare in inglese o dare una traduzione ex-novo;</span></li> + <li id="magicdomid39"><span class="author-g-ywfp69kq6xj4einh">in caso la terminologia ufficiale subisca dei cambiamenti nel tempo, è possibile che i membri del forum di Mozilla Italia intervengano sulla pagina del traduttore per aggiornare tempestivamente la terminologia obsoleta.</span></li> +</ul> +<h3 id="Traduzioni_incomplete"><span class="author-g-ywfp69kq6xj4einh b"><b>Traduzioni incomplete</b></span></h3> +<div id="magicdomid42"> + <span class="author-g-ywfp69kq6xj4einh">Se un traduttore interrompe la localizzazione di una pagina e desidera riprenderla in un secondo (ragionevolmente non troppo lontano) momento, è bene che spunti la casella “Localizzazione in corso” nella schermata di traduzione, in modo da informare gli altri utenti che quella pagina non è stata abbandonata a se stessa. Le pagine incomplete sprovviste dell’etichetta “Localizzazione in corso” verranno considerate a tutti gli effetti libere di essere modificate da altri localizzatori.</span></div> +<div id="magicdomid43"> + </div> diff --git a/files/it/mdn/contribute/localize/index.html b/files/it/mdn/contribute/localize/index.html new file mode 100644 index 0000000000..a322dd56f2 --- /dev/null +++ b/files/it/mdn/contribute/localize/index.html @@ -0,0 +1,28 @@ +--- +title: Localizzazione di MDN +slug: MDN/Contribute/Localize +tags: + - Documentation + - Localization + - MDN + - TopicStub +translation_of: MDN/Contribute/Localize +--- +<div>{{MDNSidebar}}</div><p>MDN è usato in tutto il mondo come riferimento e guida alle tecnologie del Web e come documentazione tecnica di Firefox. Le nostre comunità di localizzazione sono una componente fondamentale del progetto Mozilla; il loro sforzo nel tradurre e localizzare la documentazione permette alle persone in tutto il mondo di sviluppare per l'open Web. Se vuoi maggiori informazioni sui nostri gruppi di localizzazione, unirti a uno dei gruppi esistenti o magari iniziare una nuova localizzazione non ancora presente, sei nel posto giusto.</p> +<p>{{LandingPageListSubpages}}</p> +<h2 id="Strumenti_per_la_localizzazione">Strumenti per la localizzazione</h2> +<p>Questi sono alcuni degli strumenti che vengono utilizzati per la localizzazione:</p> +<dl> + <dt> + <a href="/it/docs/Mozilla/Localization/Localizing_with_Verbatim" title="/en-US/docs/Mozilla/Localization/Localizing_with_Verbatim">Verbatim</a></dt> + <dd> + Utilizzato per la traduzione delle stringhe di vari progetti Mozilla, tra cui l'interfaccia utente di MDN e quella di Firefox.</dd> + <dt> + <a href="http://transvision.mozfr.org/" title="http://transvision.mozfr.org/">Transvision</a></dt> + <dd> + Uno strumento fornito da Mozilla France che permette di cercare occorrenze di una stringa in inglese e di trovare, in base alla lingua di proprio interesse, tutte le varie traduzioni che vengono utilizzate all'interno del codice Mozilla. È molto utile per trovare le traduzioni più utilizzate per i vari termini o frasi.</dd> +</dl> +<h2 id="Vedi_anche">Vedi anche</h2> +<ul> + <li><a href="/it/docs/Mozilla/Localization" title="/en-US/docs/Mozilla/Localization">Localizzazione in Mozilla</a></li> +</ul> diff --git a/files/it/mdn/contribute/localize/progetti_localizzazione/index.html b/files/it/mdn/contribute/localize/progetti_localizzazione/index.html new file mode 100644 index 0000000000..5266f57222 --- /dev/null +++ b/files/it/mdn/contribute/localize/progetti_localizzazione/index.html @@ -0,0 +1,283 @@ +--- +title: I progetti di localizzazione +slug: MDN/Contribute/Localize/progetti_localizzazione +translation_of: MDN/Contribute/Localize/Localization_projects +--- +<div><section class="Quick_links" id="Quick_Links"> + <ol> + <li class="toggle"> + <details> + <summary>Informazioni su MDN</summary> + <ol> + <li><a href="/it/docs/MDN/About">Informazioni su MDN</a></li> + <li><a href="/it/docs/MDN/About/Reading">MDN guide for readers</a></li> + <li><a href="/it/docs/MDN/About/Promote">Promuovi MDN</a></li> + <li><a href="/it/docs/MDN/Feedback">Send feedback about MDN</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details> + <summary>Primi passi su MDN</summary> + <ol> + <li><a href="/it/docs/MDN/Getting_started">Primi passi su MDN</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details> + <summary>Contribuire a MDN</summary> + <ol> + <li><a href="/it/docs/MDN/Contribute">Contribuire a MDN</a></li> + <li><a href="/it/docs/MDN/Contribute/Howto">Guide come fare per</a></li> + <li><a href="/it/docs/MDN/Contribute/Localize">Localizzazione di MDN</a></li> + <li><a href="/it/docs/MDN/Contribute/Editor">Guida all'editor di MDN</a></li> + <li><a href="/it/docs/MDN/Contribute/Tools">Tools for power users</a></li> + <li><a href="/it/docs/MDN/Contribute/Guidelines">Guidelines</a></li> + <li><a href="/it/docs/MDN/Contribute/Processes">Work processes</a></li> + <li><a href="/it/docs/MDN/Contribute/Structures">Content structures</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details> + <summary>Kuma: the MDN wiki platform</summary> + <ol> + <li><a href="/it/docs/MDN/Kuma">Kuma: the MDN wiki platform</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details> + <summary>Join the MDN community</summary> + <ol> + <li><a href="/it/docs/MDN/Community">Join the MDN community</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details> + <summary>Doc status by topic</summary> + <ol> + <li><a href="/it/docs/MDN/Doc_status">Doc status by topic</a></li> + <li><a href="/it/docs/MDN/Doc_status/Overview">Panoramica sulla documentazione</a></li> + </ol> + </details> + </li> + </ol> +</section></div><p>Il lavoro di localizzazione e di traduzione su MDN viene svolto dalla nostra straordinaria comunità di volontari. In questo articolo vengono elencati i progetti di localizzazione, coloro che ve ne sono alla guida e chi vi collabora, oltre ad altri dettagli.</p> +<p>A capo della localizzazione vi è colui che guida una comunità di localizzazione su MDN, a localizzare i contenuti in base ad uno specifico luogo o tema. Insieme ai team di localizzazione, essi devono riportare i loro dati nella tabella progetti sottostante, in modo che, coloro interessati a contribuire, possano contattarli. Ognuno a capo della localizzazione ( o qualsiasi persona facente parte del team del progetto di localizzazione) è stimolato nel creare sul wiki una pagina team per i vostri progetti di localizzazione , da utilizzare per scopi organizzativi e amministrativi.</p> +<table class="fullwidth-table"> + <tbody> + <tr> + <th>Lingua</th> + <th style="width: 12em;">Capo Localizzazione</th> + <th>Collaboratori</th> + <th>Notes</th> + </tr> + <tr> + <td> + <p>ગુજરાતી</p> + <p>(Gujarati)</p> + </td> + <td><a href="/profiles/prafull_satasiya">prafull_satasiya</a></td> + <td><a href="/profiles/prafull_satasiya">prafull_satasiya</a></td> + <td>Cerchiamo traduttori</td> + </tr> + <tr> + <td>العربية</td> + <td> </td> + <td><a href="/profiles/wassim_h">wassim_h</a></td> + <td> </td> + </tr> + <tr> + <td>Persian</td> + <td> </td> + <td><a href="/profiles/amir.farsi">Amir Farsi</a>, <a href="/profiles/kazem82">Kazem Ebrahimi</a></td> + <td>Cerchiamo traduttori</td> + </tr> + <tr> + <td>Bengali (Bangladesh)</td> + <td><a href="/profiles/shafiul">Shafiul Azam Chowdhury</a></td> + <td> + <p><a href="/profiles/tuxboy">tuxboy</a>, <a href="/profiles/shafiul">shafiul</a>, <a href="/profiles/nasirkhan">Nasir Khan Saikat</a>, <a href="/profiles/towfiqueanam">Towfique Anam Rine</a>, <a href="/profiles/pink.devil.tanha">Tanha Islam</a>, <a href="/profiles/badsha_eee">Sekander Badsha</a><span id="cke_bm_269E" style="display: none;"> </span>, <a href="/profiles/mimzi_fahia">Fahia Nasnin</a>, <a href="/profiles/desh">Salman Rahman Desh</a>, <a href="/profiles/jaggedzak">jaggedzak</a></p> + </td> + <td>Il Team Mozilla Bangladesh cerca nuovi collaboratori. <a href="/bn-BD/docs/Project:MDN/%E0%A6%85%E0%A6%AC%E0%A6%A6%E0%A6%BE%E0%A6%A8/mozillabd-l10n-team">Maggiori informazioni</a></td> + </tr> + <tr> + <td>French</td> + <td><a href="/profiles/Jeremie">Jeremie Patonnier</a></td> + <td><a href="/profiles/FredB">FredB</a>, <a href="/profiles/Chbok">Alain Boquet</a>, <a href="/profiles/Fredchat">Fréderic Chateaux</a>, <a href="/profiles/VincentN">Vincent N.</a>, <a href="/profiles/BenoitL">Benoit Leseul</a>, <a href="/profiles/Shz">Shz</a>, <a href="/profiles/tregagnon">Thierry Régagnon (tregagnon)</a>, <a href="/profiles/xaky">xaky</a>, <a href="/profiles/Goofy">Goofy</a>, <a href="/profiles/sylzys">sylzys</a>, <a href="/profiles/the%20prisoner">the prisoner</a>, <a href="/profiles/Julien%20STUBY">Julien STUBY</a>, <a href="/profiles/poum">poum</a>, <a href="/profiles/sylvie">sylvie</a>, <a href="/profiles/Delapouite">Delapouite</a>, <a href="/profiles/SphinxKnight">Sphinx</a></td> + <td>(note o URL alla pagina del team del progetto di traduzione)</td> + </tr> + <tr> + <td>Italian</td> + <td> </td> + <td><a href="/profiles/Federico">Federico</a>, <a href="/profiles/mck89">mck89</a>, <a href="/profiles/marcostudios">marcostudios</a>, <a href="/profiles/loris94">loris94</a>, <a href="/profiles/MrW0lf">MrW0lf</a>, <a href="/profiles/Iacchi">Iacchi</a>, <a href="/profiles/camaleo">camaleo</a>, <a href="/profiles/marcantonio">marcantonio</a>, <a href="/profiles/Grino">Grino</a>, <a href="/profiles/Nicola_D">Nicola_D</a>, <a href="/profiles/EdoPut">EdoPut</a>, <a href="/profiles/Giona">Giona</a>, <a href="/profiles/klez">klez</a></td> + <td>Mozilla Italia cerca collaboratori! Se vuoi aiutare a localizzare MDN, ti chiediamo di guardare <a href="/it/docs/MDN/Contribute/Localize/GuidaItaliano">questa guida</a> per imparare come tradurre MDN.</td> + </tr> + <tr> + <td>Indonesian</td> + <td> </td> + <td><a href="/profiles/ariestiyansyah">ariestiyansyah</a>, <a href="/profiles/pieteru_insekai">Pieter Erlanda</a>, <a href="/profiles/imrizal">imrizal</a>, <a href="/profiles/lunybear79999">Vernando Simbolon</a></td> + <td> </td> + </tr> + <tr> + <td>Japanese</td> + <td> </td> + <td><a href="/profiles/Yoshino">Yoshino(ex.Mozilla Japan)</a>, <a href="/profiles/Yuichiro">Yuichiro</a>, <a href="/profiles/myakura">myakura(Masataka Yakura)</a>, <a href="/profiles/yyss">yyss</a>, <a href="/profiles/ethertank">ethertank</a>, <a href="/profiles/sosleepy">sosleepy</a>, <a href="/profiles/Marsf">Marsf(Masahiko Imanaka)</a>, <a href="/profiles/Masayuki">Masayuki</a>, <a href="/profiles/nobuoka">nobuoka</a>, <a href="/profiles/yoshitanaka">yoshitanaka</a>, <a href="/profiles/taguchi-ch">taguchi-ch</a>, <a href="/profiles/sii">sii</a>, <a href="/profiles/saneyuki_s">saneyuki_s</a>, <a href="/profiles/Shimono">Shimono(Atsushi Shimono)</a>, <a href="/profiles/Taken">Taken(Takeshi Kurosawa)</a>, <a href="/profiles/Electrolysis">Electrolysis</a>, <a href="/profiles/dextra">dextra</a>,<a href="/profiles/Potappo">Potappo</a></td> + <td><a href="http://mdc.mozilla.gr.jp">MDC Japan Project</a> (-2009)</td> + </tr> + <tr> + <td>Lao ພາສາລາວ</td> + <td> </td> + <td>Anousak Souphavanh, Angkhan Buasavanh, Phaynalinh Sypasert, Sulaxay Manivong, <a href="/profiles/rcampbelllaos">Robert M Campbell</a>, <a href="/profiles/laothor777">Lao Thor</a></td> + <td> </td> + </tr> + <tr> + <td>Polish</td> + <td> </td> + <td><a href="/profiles/Ptak82">Tomasz Sokół</a>,<a href="/profiles/Marcoos">Marcoos(Marek Stępień)</a>, <a href="/profiles/Dapi">Dapi</a></td> + <td> </td> + </tr> + <tr> + <td>Spanish</td> + <td><a href="/profiles/maedca">Manuel Camacho</a></td> + <td><a href="/profiles/Nukeador">Nukeador, </a><a href="/profiles/Superruzafa">Superruzafa</a>, <a href="/profiles/vhanla">vhanla</a>, <a href="/profiles/maedca">maedca</a>, <a href="/profiles/inma_610">inma_610</a>, <a href="/profiles/ccarruitero">ccarruitero</a>, <a href="/profiles/artopal">artopal</a>, <a href="/profiles/StripTM">StripTM</a>, <a href="/profiles/Jorge.villalobos">Jorge.villalobos</a>, <a href="/profiles/Scipion">Scipion</a>, <a href="/profiles/Verruckt">Verruckt</a>, <a href="/profiles/Nathymig">Nathymig</a>, <a href="/profiles/Rkovac">Rkovac</a>, <a href="/profiles/ajimix">ajimix</a>, <a href="/profiles/mhauptma73">mhauptma73</a>, <a href="/profiles/deimidis">deimidis</a>, <a href="/profiles/Joalar">Joalar</a>, <a href="/profiles/Maharba">Maharba</a>, <a href="/profiles/jessest">jessest</a>, <a href="/profiles/MPoli">MPoli</a>, <a href="/profiles/nekside">Daniel Pereyra</a>, <a href="/profiles/luisgm76">luisgm76</a>, <a href="/profiles/LeoHirsch">LeoHirsch</a>, <a href="/profiles/gorrotowi">gorrotowi</a></td> + <td>Cerchiamo urgentemente traduttori.</td> + </tr> + <tr> + <td>Portuguese (Brazil)</td> + <td> </td> + <td><a href="/profiles/jaydson">Jaydson Gomes</a>, <a href="/profiles/galvao">Galvão</a>, <a href="/profiles/atilafassina">Atila</a>, <a href="/profiles/francisco.hansen">francisco.hansen</a>, <a href="/profiles/francineemilia">francineemilia</a>, <a href="/profiles/battisti">battisti</a>, <a href="/profiles/jpalharini">jpalharini</a>, <a href="/profiles/LeonardoPacheco">LeonardoPacheco</a>, <a href="/profiles/Lehrerschuler">Lehrerschuler</a>, <a href="/profiles/hsteffano">hsteffano</a>, <a href="/profiles/lfz">lfz</a>, <a href="/profiles/-pedrohenrique-">-pedrohenrique-</a>, <a href="/profiles/eduardodx">eduardodx</a>, <a href="/profiles/mateus.m.luna">mateus.m.luna</a>, <a href="/profiles/josivansilva">josivansilva</a>, <a href="/profiles/TelaSocial">TelaSocial</a>, <a href="/profiles/mazulo">mazulo</a>, <a href="/profiles/vlopez5">vlopez5</a>, <a href="/profiles/robsonds">robsonds</a>, <a href="/profiles/HenriqueSilverio">HenriqueSilverio</a>, <a href="/profiles/srsaude">srsaude</a></td> + <td><a href="http://mzl.la/Odmaq9">Come collaborare con MDN</a></td> + </tr> + <tr> + <td>Portuguese (Portugal)</td> + <td> </td> + <td><a href="/profiles/Leandro%20Mercês%20Xavier">Leandro Mercês Xavier, </a><a href="/profiles/msvolenski">Matheus Smythe Svolenski</a>, <a href="/profiles/Luis%20Henrique%20Sousa">Luis Henrique Sousa</a>, <a href="/profiles/f.sanxz">f.sanxz</a></td> + <td> </td> + </tr> + <tr> + <td>Korean</td> + <td><a href="/profiles/Channy">Channy Yun </a></td> + <td><a href="/ko/docs/Project:Korean_Contributors">Korean Contributors</a></td> + <td><a href="http://groups.google.com/group/mdckorea">Google Groups</a></td> + </tr> + <tr> + <td>German</td> + <td><a href="/profiles/fscholz">fscholz</a></td> + <td><a href="/profiles/eminor">eminor</a>, <a href="/profiles/AlexPl">AlexPl</a>, <a href="/profiles/Sprottenwels">Sprottenwels</a>, <a href="/profiles/tessarakt3">tessarakt3</a>, <a href="/profiles/jwl">jwl</a>, <a href="/profiles/SJW">SJW</a>, <a href="/profiles/HolgerSinn.Com">Holger Sinn</a>, <a href="/profiles/SebastianZ">Sebastian Zartner</a></td> + <td>Cerchiamo traduttori</td> + </tr> + <tr> + <td> + <p>Greek</p> + </td> + <td> </td> + <td><a href="/profiles/syssgx">syssgx, </a><a href="/profiles/JasnaPaka">JasnaPaka</a>, <a href="/profiles/DJ.Maca">DJ.Maca</a></td> + <td>Cerchiamo traduttori</td> + </tr> + <tr> + <td>Russian</td> + <td> </td> + <td><a href="/profiles/Cobalt747">Cobalt747</a>, <a href="/profiles/Sky_Fox">Sky_Fox</a>, <a href="/profiles/Chernetsky">Chernetsky</a>, <a href="/profiles/uleming">uleming</a>, <a href="/profiles/karasiov">karasiov</a>, <a href="/profiles/Dionys">Dionys</a>, <a href="/profiles/Megapotz">Megapotz</a>, <a href="/profiles/hazestalker">hazestalker</a>, <a href="/profiles/Kwinto">Kwinto</a>, <a href="/profiles/kup">kup</a></td> + <td>Cerchiamo traduttori</td> + </tr> + <tr> + <td>Chinese (Traditional)</td> + <td> </td> + <td><a href="/profiles/BobChao">BobChao, </a><a href="/profiles/Dwchiang">dwchiang</a>, <a href="/profiles/happysadman">happysadman</a>, <a href="/profiles/petercpg">petercpg</a>, <a href="/profiles/sailplaneTW">sailplaneTW</a>, <a href="/profiles/Kourge">Kourge</a>, <a href="/profiles/Josesun">Josesun</a>, <a href="/profiles/Sonrisa">Sonrisa</a>, <a href="/profiles/Kennyluck">Kennyluck</a>, <a href="/profiles/sycheng">sycheng</a>, <a href="/profiles/naihsi">naihsi</a>, <a href="/profiles/evelynhung">evelynhung</a>, <a href="/profiles/ypwalter">ypwalter</a>, <a href="/profiles/steely.wing">steely.wing</a></td> + <td>Cerchiamo traduttori! Unisciti a noi! <a href="https://groups.google.com/d/forum/mdnzh" title="MDN中文社羣">Google Groups</a>!</td> + </tr> + <tr> + <td> + <p>中文 (简体)</p> + </td> + <td>ziyunfei</td> + <td></td> + <td><span style="line-height: 1.5;">如有问题讨论，请加 QQ 群 26079139 咨询带头人。</span></td> + </tr> + <tr> + <td>Hebrew</td> + <td> </td> + <td><a href="/profiles/ziv">Ziv Perry, </a><a href="/profiles/Inkbug">Inkbug</a></td> + <td>Cerchiamo traduttori</td> + </tr> + <tr> + <td>Romanian</td> + <td> </td> + <td><a href="/profiles/raul.malea">Raul Malea</a>, <a href="/profiles/Andrew_Pham">Andrew_Pham</a></td> + <td>Cerchiamo traduttori.</td> + </tr> + <tr> + <td>Telugu</td> + <td> </td> + <td><a href="/profiles/Dyvik">Dyvik Chenna Thirunahari</a>, <a href="/profiles/Dyvik">Dyvik</a></td> + <td>Cerchiamo traduttori</td> + </tr> + <tr> + <td>Thai</td> + <td> </td> + <td><a href="/profiles/hapztron">Hassadee Pimsuwan</a></td> + <td>Cerchiamo traduttori</td> + </tr> + <tr> + <td> + <p><span style="line-height: 1.5;">Turkish</span></p> + </td> + <td> </td> + <td><a href="/profiles/techexpert">Hakan Damar</a>, <a href="/profiles/ramesaliyev">ramesaliyev</a></td> + <td> + <p>Cerchiamo urgentemente traduttori</p> + </td> + </tr> + <tr> + <td>Hindi</td> + <td> </td> + <td><a href="profiles/Meghraj">Meghraj Suthar</a>, <a href="/profiles/meghraj">meghraj</a></td> + <td> + <p>Cerchiamo traduttori</p> + </td> + </tr> + <tr> + <td>Hawaiian</td> + <td> </td> + <td><a href="/profiles/Kolonahe">Kolonahe</a></td> + <td>Cerchiamo urgentemente traduttori</td> + </tr> + <tr> + <td>Serbian</td> + <td> </td> + <td><a href="https://developer.mozilla.org/en-US/profiles/VladimirKrstic">Vladimir Krstic</a></td> + <td>Iniziate a localizzare, siete i benvenuti. C'è molto da fare!</td> + </tr> + <tr> + <td>Sinhalese</td> + <td><a href="/profiles/pkavinda">pkavinda</a></td> + <td><a href="https://developer.mozilla.org/en-US/profiles/pkavinda">Pasindu Kavinda (පසිඳු කවින්ද)</a></td> + <td> + <p>Cerchiamo traduttori</p> + </td> + </tr> + <tr> + <td>Malayalam</td> + <td><a href="https://developer.mozilla.org/en-US/profiles/riginoommen">Rigin Oommen</a></td> + <td><a href="https://developer.mozilla.org/profiles/amjadm61">Amjad M</a>, <a href="https://developer.mozilla.org/en-US/profiles/Kumaresan.C.S">Kumaresan C.S</a>, <a href="https://developer.mozilla.org/en-US/profiles/alfasst">ST Alfas</a></td> + <td>Siamo alla ricerca di persone in grado di tradurre documenti in lingua malese.</td> + </tr> + <tr> + <td>Myanmar</td> + <td><a href="https://developer.mozilla.org/en-US/profiles/SetKyarWaLar">Set Kyar Wa lar</a></td> + <td><a href="https://developer.mozilla.org/en-US/profiles/SetKyarWaLar">Set Kyar Wa Lar</a></td> + <td>Siamo alla ricerca di persone in grado di tradurre documenti in lingua birmana.</td> + </tr> + </tbody> +</table> +<section id="Quick_Links"> + <ol> + <li><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Localization" title="Localizzazione">Localizzazione</a></li> + <li><a href="/en-US/docs/Localization_and_Plurals">Localizzazione e plurali</a></li> + <li><a href="/en-US/docs/Mozilla/Localization/Localizing_with_Verbatim">Localizzazione con Verbatim</a></li> + </ol> +</section> diff --git a/files/it/mdn/contribute/localize/translating_pages/index.html b/files/it/mdn/contribute/localize/translating_pages/index.html new file mode 100644 index 0000000000..f45ad0085f --- /dev/null +++ b/files/it/mdn/contribute/localize/translating_pages/index.html @@ -0,0 +1,55 @@ +--- +title: Come tradurre le pagine di MDN +slug: MDN/Contribute/Localize/Translating_pages +tags: + - Guide + - Localization + - MDN Meta + - Page Translation + - l10n +translation_of: MDN/Contribute/Localize/Translating_pages +--- +<p>{{MDNSidebar}}</p> + +<p>Questo articolo contiene una guida di base su come tradurre i contenuti su MDN, includendo sia le meccaniche di traduzione che consigli per la corretta gestione dei diversi tipi di argomenti.</p> + +<h2 id="Iniziare_una_nuova_traduzione">Iniziare una nuova traduzione</h2> + +<p>Quando t'imbatti in una pagina che vorresti vedere tradotta nella tua lingua, segui questi passaggi:</p> + +<ol style="list-style-type: decimal;"> + <li>Clicca sull'icona delle lingue per aprire il menu <strong>delle lingue</strong> e clicca su <strong>Add a Translation.</strong> Se non dovessi trovare questa voce, prova prima a passare alla lingua Inglese.</li> + <li>Nella pagina <strong>Select Languages</strong>, scegli la lingua in cui vuoi tradurre il testo. Si aprirà la pagina con l'articolo originale sulla sinistra e l'editor di testo per scrivere la nuova versione sulla destra dello schermo.</li> + <li>Nella sezione <strong>Translate Description,</strong> puoi tradurre il titolo e lo <em>slug</em> della pagina. Lo <em>slug</em> è l'ultima parte dell'url di una pagina (per esempio, "Translating_pages" in questo articolo). In alcune lingue lo slug non viene tradotto, mantenendo quello originale in inglese. Confronta dunque le altre pagine nella tua lingua per seguire una pratica comune. Per nascondere la sezione <strong>Translate Description</strong> puoi cliccare sul meno a sinistra del titolo, così da avere più spazio sullo schermo per la sezione <strong>Translate Content</strong>.</li> + <li>Nella sezione <strong>Translate Content</strong> puoi tradurre il testo principale e puoi vederne l'anteprima cliccando su <strong>Preview Changes</strong>.</li> + <li>Ricordati di scegliere almeno un <strong>tag</strong> per pagina.</li> + <li>Clicca <strong>Save Changes</strong> quando hai finito, <strong>Discard Changes </strong>se hai deciso di annullare le modifiche apportate.</li> +</ol> + +<div class="note"><strong>Nota:</strong> L'interfaccia di traduzione è inizialmente mostrata in inglese. Nelle successive visite verrà visualizzata nella tua lingua, sempre se il servizio di localizzazione di MDN riesce a stabilirla.<span style="line-height: 1.5em;"> La lingua viene scelta usando il servizio </span><a href="https://localize.mozilla.org/projects/mdn/" style="line-height: 1.5em;" title="https://localize.mozilla.org/projects/mdn/">Verbatim</a><span style="line-height: 1.5em;">.</span><br> +<span style="line-height: 1.5em;">Vai a </span><a href="/it/docs/Mozilla/Localization/Localizing_with_Verbatim" style="line-height: 1.5em;" title="/en-US/docs/Mozilla/Localization/Localizing_with_Verbatim">Localizzazione con Verbatim</a><span style="line-height: 1.5em;"> per i dettagli di questo strumento.</span></div> + +<h2 id="Modificare_una_pagina_già_tradotta">Modificare una pagina già tradotta</h2> + +<ul> + <li>In una pagina già tradotta, clicca il pulsante <strong>Edit</strong> (qualche volta già tradotto nella tua lingua). L’interfaccia di traduzione dell’artiolo si aprirà.</li> +</ul> + +<p>Se la versione originale in inglese è stata modificata dopo l'ultimo aggiornamento nella tua lingua, l'interfaccia di traduzione mostrerà le modifiche a livello del codice sorgente, che può essere utile per aggiornare la traduzione.</p> + +<h2 id="Tag">Tag</h2> + +<p>È importante che ogni pagina abbia almeno un tag. Anche se si tratta di una traduzione. Generalmente, usare gli stessi tag della versione originale dell’articolo è una buona prassi.</p> + +<p>Alcuni tag sono utilizzati come filtri per le ricerche, o come riferimento per chi contribuisce a MDN. Non dovrebbero essere tradotti. Per sapere quali sono questi tag, visita la pagina <a href="/it/docs/Project:MDN/Contributing/Tagging_standards">standard di etichettatura</a>. Sei libero di creare nuovi tag nella tua lingua, a patto che non siano parte di questa lista.</p> + +<h2 id="Suggerimenti_per_i_nuovi_localizzatori"><font face="x-locale-heading-primary, zillaslab, Palatino, Palatino Linotype, x-locale-heading-secondary, serif"><span style="font-size: 40px;"><strong>Suggerimenti per i nuovi localizzatori</strong></span></font></h2> + +<p>Se tu sei principiante nella localizzazione su MDN, qui sono alcuni suggerimenti:</p> + +<ul> + <li>Gli articoli nel <a href="/it/docs/User:Leofiore_Glossario">Glossario</a> sono molto utili per le nuove persone arrivate per la traduzione, perché sono corti e semplici.</li> + <li>Gli articoli che sono taggati <a href="https://developer.mozilla.org/en-US/docs/tag/l10n%3Apriority">l10n:priority</a> sono considerati come alta priorità da tradurre. Anche, generalmente, i tutoriali ed gli articoli concettuali sono alta priorità più che le pagine di riferimento, perché i lettori hanno più bisogno per le traduzioni quando vanno ad imparare nuovi concetti.</li> + <li>Se vedi del testo nelle doppie parentesi graffe, come \{{some-text("more text")}}, lascialo senza traduzione nell’articolo e non modificarli la puntuazione. Questa è una macro, che probabilmente crea la struttura della pagina, oppure fa qualcosa di utile. Probabilmente vedrai del testo non tradotto che viene generato da una maro; non preoccuparti affinché tu non accumuli più esperienza con MDN. (Cambiare questo testo richiede privilegi speciali perché le macro possono avere un gran potere.) Se sei curioso, dai un’occhiata sugli macro più usati per vedere le cose che gli macro possono fare.</li> + <li>Cerca la pagina della localizzazione degli progetti per trovare di più sulla localizzazione della tua zona.</li> +</ul> diff --git a/files/it/mdn/contribute/persona_sign-in/index.html b/files/it/mdn/contribute/persona_sign-in/index.html new file mode 100644 index 0000000000..5b89975a4d --- /dev/null +++ b/files/it/mdn/contribute/persona_sign-in/index.html @@ -0,0 +1,26 @@ +--- +title: MDN and Persona sign-ins +slug: MDN/Contribute/Persona_sign-in +translation_of: Archive/MDN/Persona_sign-ins +--- +<div>{{MDNSidebar}}</div><div class="warning"> +<p>Please <a href="/en-US/docs/MDN/Contribute/Howto/Link_a_GitHub_account">link your GitHub account to your MDN profile now</a> so you can continue to sign into MDN.</p> +</div> + +<p>Attualmente, MDN permette ai collaboratori di accedere utilizzando due differenti modalità: Mozilla Persona e GitHub. A partire dal 1 novembre 2016 verrà rimossa l'opzione Persona per il login. Di conseguenza, sarà necessario abilitare l'autenticazione Github sul proprio profilo per evitare di perdere l'accesso di login a MDN.</p> + +<p>Ci rendiamo conto che questo è un inconveniente e ci scusiamo per questo. Purtroppo questa cosa è al di fuori del nostro controllo.</p> + +<h2 id="Perché_Persona_verrà_rimosso">Perché Persona verrà rimosso?</h2> + +<p>Mozilla ha terminato il progetto Persona<span style="line-height: 1.5;">, e i suoi server verranno spenti nel Novembre 2016. You can </span><a style="line-height: 1.5;" href="https://wiki.mozilla.org/Identity/Persona_Shutdown_Guidelines_for_Reliers#FAQs">learn more about Mozilla's decision</a><span style="line-height: 1.5;"> to shut down Persona on the Mozilla wiki.</span></p> + +<h2 id="When_will_Persona_be_removed">When will Persona be removed?</h2> + +<p>We will disable Persona as an authentication provider on November 1, 2016; in other words, the last day you'll be able to sign into MDN using Persona will be October 31, 2016. We will be issuing increasingly frequent and increasingly urgent notifications to <a href="/en-US/docs/MDN/Contribute/Howto/Link_a_GitHub_account">add a GitHub account to your MDN profile</a> starting now. Please do this as soon as you can, in order to avoid any risk of losing access to your MDN account.</p> + +<h2 id="Will_MDN_offer_another_authentication_provider">Will MDN offer another authentication provider?</h2> + +<p>We would very much like to do so, but have not yet identified another provider which meets our requirements; in addition, we don't currently have the developer resources to integrate another provider. For the time being, your <em>only</em> option to keep contributor access to MDN is to <a href="/en-US/docs/MDN/Contribute/Howto/Link_a_GitHub_account">link your MDN profile to your GitHub account</a>.</p> + +<p>Keep in mind, of course, that you don't need to sign into MDN in order to read our content. But if you have an account for contributing, and wish to be able to contribute at any time in the future, be sure to <em><strong>add a GitHub account to your profile as soon as you can,</strong></em> before October 31, 2016.</p> diff --git a/files/it/mdn/editor/index.html b/files/it/mdn/editor/index.html new file mode 100644 index 0000000000..856ef1fc2d --- /dev/null +++ b/files/it/mdn/editor/index.html @@ -0,0 +1,9 @@ +--- +title: Guida all'editor di MDN +slug: MDN/Editor +translation_of: MDN/Editor +--- +<div>{{MDNSidebar}}</div><p><span class="seoSummary">L'editor WYSIWYG (what-you-see-is-what-you-get, ciò che vedi è ciò che ottieni) messo a disposizione dal wiki del Mozilla Developer Network semplifica la creazione di nuovi contenuti. La guida all'editor di MDN fornisce alcune informazioni sull'utilizzo dell'editor e su alcune caratteristiche utili che possono migliorare la tua produttività.</span></p> +<p>La <a href="/it/docs/MDN/Contribute/Content/Style_guide" title="/en-US/docs/Project:MDN/Style_guide">guida di stile di MDN</a> fornisce alcune informazioni sulla formattazione e lo stile da applicare ai contenuti, comprese le regole di grammatica che preferiamo vengano utilizzate.</p> +<p>{{LandingPageListSubpages}}</p> +<p>{{EditorGuideQuicklinks}}</p> diff --git a/files/it/mdn/guidelines/index.html b/files/it/mdn/guidelines/index.html new file mode 100644 index 0000000000..11412724a1 --- /dev/null +++ b/files/it/mdn/guidelines/index.html @@ -0,0 +1,13 @@ +--- +title: MDN content and style guides +slug: MDN/Guidelines +tags: + - Documentation + - Landing + - MDN + - NeedsTranslation + - TopicStub +translation_of: MDN/Guidelines +--- +<div>{{MDNSidebar}}</div><p><span class="seoSummary">These guides provide details on how MDN documentation should be written and formatted, as well as how our code samples and other content should be presented.</span> By following these guides, you can ensure that the material you produce is clean and easy to use.</p> +<p>{{LandingPageListSubpages}}</p> diff --git a/files/it/mdn/guidelines/macros/index.html b/files/it/mdn/guidelines/macros/index.html new file mode 100644 index 0000000000..a09cf37e30 --- /dev/null +++ b/files/it/mdn/guidelines/macros/index.html @@ -0,0 +1,42 @@ +--- +title: Using macros on MDN +slug: MDN/Guidelines/Macros +tags: + - italino tags +translation_of: MDN/Structures/Macros +--- +<div>{{MDNSidebar}}</div><p><span class="seoSummary">The <a href="/en-US/docs/Project:MDN/Kuma" title="/en-US/docs/Project:MDN/Kuma">Kuma</a> platform on which MDN runs provides a powerful macro system, <a href="/en-US/docs/Project:MDN/Kuma/KumaScript_guide" title="/en-US/docs/Project:MDN/Kuma/KumaScript_guide">KumaScript</a>, which makes it possible to do a wide variety of things automatically. This article provides information on how to invoke MDN's macros within articles.</span></p> + +<p>The <a href="/en-US/docs/Project:MDN/Kuma/KumaScript_guide" title="/en-US/docs/Project:MDN/Kuma/KumaScript_guide">KumaScript guide</a> provides an in-depth look at how to use macros on MDN, so this section is more of a brief overview. If you've already read the section above on {{SectionOnPage("/en-US/docs/Project:MDN/Contributing/Editor_guide/Links", "Using link macros")}}, you're already at least a little bit familiar with the concept.</p> + +<h2 id="How_macros_are_implemented">How macros are implemented</h2> + +<p>Macros on MDN are implemented using server-executed <a href="/en-US/docs/Web/JavaScript" title="/en-US/docs/Web/JavaScript">JavaScript</a> code, interpreted using <a href="http://nodejs.org/" title="http://nodejs.org/">Node.js</a>. On top of that we have a number of libraries we've implemented that provide wiki-oriented services and features to let macros interact with the wiki platform and its contents. If you're interested in learning more, see the <a href="/en-US/docs/Project:MDN/Kuma/KumaScript_guide" title="/en-US/docs/Project:MDN/Kuma/KumaScript_guide">KumaScript guide</a>; the <a href="/en-US/docs/Project:MDN/Kuma/KumaScript_reference" title="/en-US/docs/Project:MDN/Kuma/KumaScript_reference">KumaScript reference</a> provides details on the libraries and other KumaScript APIs we've implemented.</p> + +<h2 id="Using_a_macro_in_content">Using a macro in content</h2> + +<p>To actually use a macro, you simply enclose the call to the macro in a pair of double-braces, with its parameters, if any, enclosed in parentheses; that is:</p> + +<pre class="notranslate">\{{macroname(parameter-list)}}</pre> + +<p>A few notes about macro calls:</p> + +<ul> + <li>Macro names are case-sensitive, but some attempt is made to correct for common capitalization errors; you may use all lowercase even if the macro name uses caps within it, and you may capitalize a macro whose name normally starts with a lower-case letter.</li> + <li>Parameters are separated by commas.</li> + <li>If there are no parameters, you may leave out the parentheses entirely; <code>\{{macroname()}}</code> and <code>\{{macroname}}</code> are identical.</li> + <li>Numeric parameters can be in quotes, or not. It's up to you (however, if you have a version number with multiple decimals in it, it needs to be in quotes).</li> + <li>If you get errors, review your code carefully. If you still can't figure out what's going on, see <a href="/en-US/docs/MDN/Kuma/Troubleshooting_KumaScript_errors">Troubleshooting KumaScript errors</a> for help.</li> +</ul> + +<p>Macros are heavily cached; for any set of input values (both parameters and environmental values such as the URL for which the macro was run), the results are stored and reused. This means that the macro is only actually run when the inputs change.</p> + +<div class="note"> +<p><strong>Note:</strong> You can force all the macros on a page to be re-evaluated by force-refreshing the page in your browser (that is, a shift-reload).</p> +</div> + +<p>Macros can be as simple as just inserting a larger block of text or swapping in contents from another part of MDN, or as complex as building an entire index of content by searching through parts of the site, styling the output, and adding links.</p> + +<p>You can read up on our most commonly-used macros on the <a href="/en-US/docs/Project:MDN/Contributing/Custom_macros" title="/en-US/docs/Project:MDN/Contributing/Custom_macros">Custom macros</a> page; also, there's a <a href="https://developer.mozilla.org/en-US/docs/templates" title="https://developer.mozilla.org/en-US/docs/templates">complete list of all macros</a> here. Most macros have documentation built into them, as comments at the top.</p> + +<p>{{EditorGuideQuicklinks}}</p> diff --git a/files/it/mdn/guidelines/migliore_pratica/index.html b/files/it/mdn/guidelines/migliore_pratica/index.html new file mode 100644 index 0000000000..2aadc92c27 --- /dev/null +++ b/files/it/mdn/guidelines/migliore_pratica/index.html @@ -0,0 +1,34 @@ +--- +title: Migliore pratica +slug: MDN/Guidelines/Migliore_pratica +tags: + - Guida + - MDN Meta + - linee guida +translation_of: MDN/Guidelines/Conventions_definitions +--- +<div>{{MDNSidebar}}</div><p>Quest'articolo descrive i metodi raccomandati di lavoro con il contenuto su MDN. Queste linee guida descrivono i metodi preferiti per fare tutto ciò che porta ad un miglior risultato, o offrire un consiglio nel decidere tra diversi metodi nel fare cose simili.</p> + +<h2 id="Copiare_il_contenuto">Copiare il contenuto</h2> + +<p>A volte, avrai la necessità di utilizzare lo stesso testo su più pagine (oppure utilizzare il modello di una pagina per un'altra). Hai tre opzioni:</p> + +<ul> + <li>Se vuoi copiare un'intera pagina: + <ol> + <li>Visualizzando una pagina che vuoi copiare, nel menù Avanzate (ingranaggio), scegli <strong><a href="/en-US/docs/MDN/Contribute/Creating_and_editing_pages#Clone_of_an_existing_page">Clona questa pagina</a></strong>. Si aprirà l'editor per l'interfaccia utente per una nuova pagina, con il contenuto della pagina clonata già pronto.</li> + <li>Inserisci un nuovo <strong>Titolo</strong> e uno <strong>Slug</strong> per la pagina clonata.</li> + <li>Modifica il contenuto della pagina come necessario, e salva come sempre.</li> + </ol> + </li> + <li>Se vuoi copiare solamente una parte della pagina, <strong>non visitare semplicamente la pagina copiandolo da lì</strong>. Questo metodo aggiunge dei bit di HTML indesiderati nella pagina di destinazione, e qualcuno dovrà sistemarlo, tu o un altro editor. Nessuno vuole questo. Per copiare una parte di una pagina MDN in un'altra: + <ol> + <li>Nella pagina originale, clicca il pulsante <strong>modifica.</strong> n the source page, click the <strong>Edit</strong> button on the source page.</li> + <li><strong>Copia il contenuto che vuoi riutilizzare attraverso l'editor dell'interfaccia utente.</strong></li> + <li>Clicca <strong>Annulla</strong> per uscire dell'editor di quella pagina.</li> + <li>Apri l'editor della pagina di destinazione.</li> + <li>Incolla il testo copiato.</li> + </ol> + </li> + <li>A volte avrai bisogno di utilizzare lo stesso contenuto su diverse pagine in maniera letterale. In questo caso, sarebbe meglio posizionare il contenuto in una pagina, poi utilizzando la macro {{TemplateLink("Page")}} trasferire il materiale da una pagina all'altra. In questo modo, quando il testo della pagina sorgente sarà aggiornato, la pagina di destinazione lo sarà di conseguenza (ovvero, succederà quando ci sarà un aggiornamento forzato o la pagina andrà in manutenzione automatica).</li> +</ul> diff --git a/files/it/mdn/index.html b/files/it/mdn/index.html new file mode 100644 index 0000000000..16a5058327 --- /dev/null +++ b/files/it/mdn/index.html @@ -0,0 +1,29 @@ +--- +title: Il progetto MDN +slug: MDN +translation_of: MDN +--- +<div>{{MDNSidebar}}</div> + +<p><strong>Mozilla Developer Network</strong> (MDN) è un wiki che utilizziamo per documentare il Web open, le tecnologie Mozilla, Firefox OS e altri argomenti inerenti il lavoro degli sviluppatori. Tutti coloro che vogliono aggiungere o modificare contenuti sono i benvenuti. Non è necessario essere programmatori o sapere tutto sulla tecnologia; esistono vari compiti che necessitano di volontari, dai più semplici (revisione e correzione degli articoli) ai più complessi (scrivere documentazione per le API).</p> + +<div class="summary"> +<p>L'obiettivo del progetto MDN è quello di documentare l'Open Web, le tecnologie Mozilla e il progetto Mozilla. Ti invitiamo ad aiutarci!</p> +</div> + +<p>Ci serve il tuo aiuto! È semplice. Non serve che chiedi il permesso e non avere paura di commettere errori. D'altro canto, ti consigliamo di fare conoscenza con la <a href="/it/docs/MDN/Community" title="/it/docs/MDN/Community">comunità MDN</a>; siamo qui per aiutarti! La documentazione sottostante può essere un valido aiuto per iniziare.</p> + + + +<ul class="card-grid"> + <li><span><a class="new" href="/it/docs/MDN/Getting_started" rel="nofollow">Sono alle prime armi</a></span> + + <p>Sei nuovo su MDN e vuoi scoprire come aiutarci a rendere migliore il progetto? Comincia da qui!</p> + </li> + <li><span><a href="/en-us/docs/MDN/Contribute">Sono un utente avanzato</a></span> + <p>Hai già familiarità MDN e vuoi imparare di più? Continua a leggere!</p> + </li> + <li><span><a href="/en-US/docs/MDN/Promote">Spargi la voce</a></span> + <p>Se ti piace MDN, aiutaci a spargere la voce! Qui puoi trovare immagini, strumenti e guide per promuovere MDN.</p> + </li> +</ul> diff --git a/files/it/mdn/structures/index.html b/files/it/mdn/structures/index.html new file mode 100644 index 0000000000..b8df701dac --- /dev/null +++ b/files/it/mdn/structures/index.html @@ -0,0 +1,16 @@ +--- +title: Document structures +slug: MDN/Structures +tags: + - Landing + - MDN Meta + - NeedsTranslation + - Structures + - TopicStub +translation_of: MDN/Structures +--- +<div>{{MDNSidebar}}</div><div>{{IncludeSubnav("/en-US/docs/MDN")}}</div> + +<p>Throughout MDN, there are various document structures that are used repeatedly, to provide consistent presentation of information in MDN articles. Here are articles describing these structures, so that, as an MDN author, you can recognize, apply, and modify them as appropriate for documents you write, edit, or translate.</p> + +<p>{{LandingPageListSubPages()}}</p> diff --git a/files/it/mdn/structures/tabelle_compatibilità/index.html b/files/it/mdn/structures/tabelle_compatibilità/index.html new file mode 100644 index 0000000000..81ee695696 --- /dev/null +++ b/files/it/mdn/structures/tabelle_compatibilità/index.html @@ -0,0 +1,496 @@ +--- +title: Tabelle di compatibilità +slug: MDN/Structures/Tabelle_compatibilità +translation_of: MDN/Structures/Compatibility_tables +--- +<div>{{MDNSidebar}}</div><div>{{IncludeSubnav("/en-US/docs/MDN")}}</div> + +<p class="summary">MDN ha un formato standard di tabelle di compatibilità per la nostra documentazione web open; in altre parole, la documentazione di tecnologie come DOM, HTML, CSS, JavaScript, SVG, ecc., che viene condivisa attraverso tutti i browsers. Questo articolo spiega come usare le nostre funzionalità per aggiungere dati di compatibilità alle pagine MDN.</p> + +<div class="warning"> +<p><strong>Importante</strong>: Il modo in cui i dati sono generati è cambiato. Storicamente le nostre tabelle erano inserite sulla pagina e i dati inseriti manualmente<strong><em>. </em></strong>Questo è inefficiente, rende la manutenzione difficile e rende i dati inflessibili. Per questo, stiamo cambiando i dati di compatibilità per browser al fine di essere immagazzinati in una repository dati (vedi <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>) generando le tabelle programmaticamente.<br> + <br> + In questa guida, documentiamo il nuovo metodo per aggiungere dati di compatibilità in MDN, mantenendo tuttavia, la documentazione sul vecchio metodo, poiché saranno ancora presenti per un po' le tabelle popolate manualmente su MDN. Se hai bisogno di vedere la vecchia documentazione, controlla il nostro articolo <a href="/en-US/docs/MDN/Contribute/Structures/Old_compatibility_tables">Old compatibility tables</a>.</p> +</div> + +<div class="note"> +<p><strong>Nota</strong>: Se hai bisogno di aiuto con un qualsiasi step di questa guida, puoi contattarci al <a href="https://discourse.mozilla-community.org/c/mdn">MDN discussion forum</a>.</p> +</div> + +<h2 id="Come_accedere_alla_repository_dati">Come accedere alla repository dati</h2> + +<p>I dati sono conservati in un repository GitHub — vedi <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>. Per accedervi, hai bisogno di un account GitHub, fare un fork del repository browser-compat-data attraverso il tuo account, infine clonare il fork localmente sulla tua macchina.</p> + +<h2 id="Choosing_a_feature_to_add_data_for">Choosing a feature to add data for</h2> + +<p>First of all, find a feature that you want to add browser-compat-data for. This could be an HTML element, CSS property, JS language feature or JS API interface, for example. We would like to encourage you to work on API features, as we already have people working on HTML, JS, and CSS. You can find the status of features that need their data adding to the repo on our <a href="https://docs.google.com/spreadsheets/d/1ivgyPBr9Lj3Wvj5kyndT1rgGbX-pGggrxuMtrgcOmjM/edit#gid=926663640">Browser Compat Data migration</a> spreadsheet.</p> + +<p>The process for using this is as follows:</p> + +<ol> + <li>Go ahead and choose a feature that is not already being worked on or complete. Put your name in the "Who" column, preferably along with your MDN username so we can find your email address and contact you if we need to.</li> + <li>If the feature you want to work on is not already listed in the spreadsheet, add rows for it in an appropriate place, copying the format that is already there. You should also use the same granularity (e.g. per element for HTML, per property or selector for CSS, per object for JS, per interface for APIs).</li> + <li>Once you've started work on adding the data, put the status to "In progress".</li> + <li>Once you've added the data and submitted a pull request to the main repo, put the status to "PR done".</li> + <li>As your data is merged to the repo, then added to the npm package, update the status as necessary.</li> + <li>Once you've updated the documentation page(s) for your feature to use the new macro to dynamically generate the appropriate data table on each page, set the status to "Article updated". At this point, you are done.</li> +</ol> + +<h2 id="Preparing_to_add_the_data">Preparing to add the data</h2> + +<p>Before adding some new data, you should make sure that your fork is up-to-date with the main repo (it contains the same content), create a new branch inside your fork to contain your additions, then pull that branch into your local clone so you can start working inside it:</p> + +<p>Let's look at a simple way to make sure your fork is to-to-date is as follows:</p> + +<h3 id="Adding_the_main_browser-compat-data_repo_as_a_remote">Adding the main browser-compat-data repo as a remote</h3> + +<p>Go to your local clone of your fork in your terminal/command line, and add a remote pointing to the main (upstream) repo like so (you only need to do this once):</p> + +<pre class="brush: bash notranslate">git remote add upstream https://github.com/mdn/browser-compat-data.git</pre> + +<p>If you are unsure whether you've done this, you can check what remotes your repo has using</p> + +<pre class="brush: bash notranslate">git remote -v</pre> + +<h3 id="Updating_your_fork_with_the_remotes_content">Updating your fork with the remote's content</h3> + +<p>Now, whenever you want to update your fork, you can do so by:</p> + +<ol> + <li> + <p>Making sure you are in the master branch:</p> + + <pre class="brush: bash notranslate">git checkout master</pre> + </li> + <li> + <p>fetching the up-to-date repo contents using the following:</p> + + <pre class="brush: bash notranslate">git fetch upstream</pre> + </li> + <li> + <p>rebasing the contents of your master with the main repo's contents:</p> + + <pre class="brush: bash notranslate">git rebase upstream/master</pre> + </li> + <li> + <p>pushing these updates back to your remote fork using this:</p> + + <pre class="brush: bash notranslate">git push -f</pre> + </li> +</ol> + +<h3 id="Creating_a_new_branch_to_do_your_work_in">Creating a new branch to do your work in</h3> + +<p>Next, go to your remote fork (it will be at <code>https://github.com/<em>your-username</em>/browser-compat-data</code>) and create a new branch to store your changes for this data addition. This can be done by:</p> + +<ol> + <li>Clicking on the "Branch: Master" button.</li> + <li>Entering a new branch name into the "Find or create a branch..." text field.</li> + <li>Pressing the resulting "Create branch <em>name-of-branch</em> from Master" button.</li> +</ol> + +<p>For example, if you were wanting to add data for the WebVR API, you'd create a branch called something like "webvr".</p> + +<h3 id="Switching_to_the_new_branch">Switching to the new branch</h3> + +<p>At this point, go back to your terminal/command line, and update your fork's local clone to include your new branch using the following command:</p> + +<pre class="brush: bash notranslate">git pull</pre> + +<p>Now switch to your new branch using this:</p> + +<pre class="brush: bash notranslate">git checkout<em> name-of-branch</em></pre> + +<p>You should now be ready to start adding your data!</p> + +<h2 id="Adding_the_data">Adding the data</h2> + +<p>To add the data, you need to create a new file or files to store your compat data in. The files you need to create differ, depending on what technology you are working on:</p> + +<ul> + <li>HTML: One file per HTML element, contained in <a href="https://github.com/mdn/browser-compat-data/tree/master/html/elements">browser-compat-data/html/elements</a>. The file should be called the name of the element, all in lower case, e.g. <code>div.json</code>.</li> + <li>CSS: One file per CSS property or selector, contained in the appropriate directory (see <a href="https://github.com/mdn/browser-compat-data/tree/master/css">browser-compat-data/css</a>). The file should be called the name of the feature, all in lower case, e.g. <code>background-color.json</code>, or <code>hover.json</code>.</li> + <li>JS: One file per JS object, contained in <a href="https://github.com/mdn/browser-compat-data/tree/master/javascript/builtins">browser-compat-data/javascript/builtins</a>. The file should be called the exact name of the object, with the casing preserved, e.g. <code>Date.json</code> or <code>InternalError.json</code>.</li> + <li>APIs: One file per interface contained in the API, put in <a href="https://github.com/mdn/browser-compat-data/tree/master/api">browser-compat-data/api</a>. Each file should be called the exact name of the interface, with the casing preserved, e.g. The WebVR API has <code>VRDisplay.json</code>, <code>VRDisplayCapabilities.json</code>, etc.</li> +</ul> + +<div class="note"> +<p><strong>Note</strong>: You'll notice that the repo also contains data for <a href="/en-US/Add-ons/WebExtensions">Browser Extensions</a> and <a href="/en-US/docs/Web/HTTP">HTTP</a>. These data sets are basically finished as they stand, but more features may need to be added in the future.</p> +</div> + +<p>Each file you create has to follow the pattern defined in the schema contained within our repo; you can see the <a href="https://github.com/mdn/browser-compat-data/blob/master/schemas/compat-data-schema.md">detailed schema description here</a>.</p> + +<h3 id="Basic_compat_data_structure">Basic compat data structure</h3> + +<p>Let's look at an example. CSS property JSON files for example need the following basic structure:</p> + +<pre class="brush: json notranslate">{ + "css": { + "properties": { + "border-width": { + "__compat": { + ... + } + } + } + } +}</pre> + +<p>You have the <code>css</code> object, inside of which is a <code>properties</code> object. Inside the <code>properties</code> object, you need one member for each of the specific features you want to define the compat data for. Each of these members has a <code>__compat</code> member, inside of which the actual data goes.</p> + +<p>The above data is found in the <a href="https://github.com/mdn/browser-compat-data/blob/master/css/properties/border-width.json">border-width.json</a> file — compare this to the <a href="/en-US/docs/Web/CSS/border-width#Browser_compatibility">rendered border-width support table on MDN</a>.</p> + +<p>Other types of features work in the same way, but with different object names:</p> + +<ul> + <li>CSS selectors work in basically the same way as CSS properties, except that the top-level object structure is <code>css.selectors</code> instead of <code>css.properties</code>. See <a href="https://github.com/mdn/browser-compat-data/blob/master/css/selectors/cue.json">cue.json</a> for an example.</li> + <li>HTML data works in basically the same way, except that the top-level object structure is <code>html.elements</code>. See <code>article.json</code> for an example.</li> + <li>The top level object structure for JS built-in objects is <code>javascript.builtins</code>; see <a href="https://github.com/mdn/browser-compat-data/blob/master/javascript/builtins/Array.json">Array.json</a> for an example.</li> +</ul> + +<div> +<p>In HTML, CSS, and JS pages, you'll normally only need one feature. API interfaces work slightly differently — they always have multiple sub-features (see {{anch("Sub-features")}}, below).</p> + +<h3 id="Basic_structure_inside_a_feature">Basic structure inside a feature</h3> + +<p>Inside a feature <code>__compat</code> member, you need to include the following members:</p> + +<ul> + <li><code>mdn_url</code>: Contains the URL of the reference page for this feature on MDN. Note that this needs to be written without the locale directory inside, e.g. <code>/docs/...</code> not <code>/docs/en-US/...</code> (or whatever). This is added in by the macro when the data is put on the page, for localization purposes.</li> + <li><code>support</code>: Contains members representing the browser support information for this feature in all the different browsers we want to report.</li> + <li><code>status</code>: Contains members reporting the standards track status of this feature.</li> +</ul> + +<p>The names of the browser members are defined in the schema (see <a href="https://github.com/mdn/browser-compat-data/blob/master/schemas/compat-data-schema.md#browser-identifiers">Browser identifiers</a>). You should use the full list of currently defined identifiers. If you wish to add another browser, talk to us first, as this could have a wide-ranging impact and should not be done without careful thought.</p> + +<p>In a basic browser compat data file, you'll only need to include "version_added" inside the browser identifier members (we'll cover {{anch("Advanced cases")}} later on). The different values you might want to include are as follows:</p> + +<ul> + <li>A version number: If you know the exact version in which a browser started to support your feature, use a string representing the number, e.g. "47".</li> + <li><code>true</code>: If a browser supports a feature but you don't know the exact version number, use the value <code>true</code>. This equivalent to the <code>\{{CompatVersionUnknown}}</code> macro call in the old manual tables.</li> + <li><code>false</code>: If a browser does not support a feature, use the value <code>false</code>. This is equivalent to the the <code>\{{CompatNo}}</code> macro call in the old manual tables.</li> + <li><code>null</code>: If you don't know whether a browser supports a feature or not, use the value <code>null</code>. This is equivalent to the <code>\{{CompatUnknown}}</code> macro call in the old manual tables.</li> +</ul> + +<p>Inside the <code>status</code> member, you'll include three submembers:</p> + +<ul> + <li> "experimental": This should be set to <code>true</code> if the feature is <a href="/en-US/docs/MDN/Contribute/Guidelines/Conventions_definitions#Experimental">experimental</a>, or <code>false</code> otherwise.</li> + <li>"standard_track": This should be set to <code>true</code> if a feature is on some kind of standards track (most commonly W3C/WHATWG, but there are also other standards efforts such as Khronos, TC39, etc.) or <code>false</code> otherwise.</li> + <li>"deprecated": This should be set to <code>true</code> if the feature is <a href="/en-US/docs/MDN/Contribute/Guidelines/Conventions_definitions#Deprecated_and_obsolete">deprecated</a>, or <code>false</code> otherwise.</li> +</ul> + +<p>The feature data for <a href="/en-US/docs/Web/CSS/border-width#Browser_compatibility">border-width</a> (also see <a href="https://github.com/mdn/browser-compat-data/blob/master/css/properties/border-width.json">border-width.json</a>) is shown below as an example:</p> + +<pre class="brush: json notranslate">"__compat": { + "mdn_url": "https://developer.mozilla.org/docs/Web/CSS/border-width", + "support": { + "chrome": { + "version_added": "1" + }, + "webview_android": { + "version_added": "2" + }, + "edge": { + "version_added": true + }, + "edge_mobile": { + "version_added": true + }, + "firefox": { + "version_added": "1" + }, + "firefox_android": { + "version_added": "1" + }, + "ie": { + "version_added": "4" + }, + "ie_mobile": { + "version_added": "6" + }, + "opera": { + "version_added": "3.5" + }, + "opera_android": { + "version_added": "11" + }, + "safari": { + "version_added": "1" + }, + "safari_ios": { + "version_added": "3" + } + }, + "status": { + "experimental": false, + "standard_track": true, + "deprecated": false + } +}</pre> + +<h4 id="Adding_a_description">Adding a description</h4> + +<p>There is a fourth, optional, member that can go inside the __compat member — <code>description</code>. This can be used to include a human-readable description of the feature. You should only include this if it is hard to see what the feature is from glancing at the data. For example, it might not be that obvious what a constructor is from looking at the data structure, so you can include a description like so:</p> + +<pre class="brush: json notranslate">{ + "api": { + "AbortController": { + "__compat": { + ... + }, + "AbortController": { + "__compat": { + "mdn_url": "https://developer.mozilla.org/docs/Web/API/AbortController/AbortController", + "description": "<code>AbortController()</code> constructor", + "support": { + ... + } + } + } + + ... etc. + } + } +}</pre> + +<h3 id="Sub-features">Sub-features</h3> + +<p>In a page where the compat table has more than one row, you'll need multiple subfeatures inside each feature to define the information for each row. This can happen, for example, when you've got the basic support for a feature stored in one row, but then the feature also has a new property or value type that was addded much later in the specification's life and is only supported in a couple of browsers.</p> + +<p>As an example, see the <a href="https://github.com/mdn/browser-compat-data/blob/master/css/properties/background-color.json">compat data</a> and <a href="/en-US/docs/Web/CSS/background-color">corresponding MDN page</a> for the <code>background-color</code> property. The basic support exists inside the <code>__compat</code> object as explained above, then you have an additional row for browsers' support for "alpha channel for hex values", which contains its own <code>__compat</code> object.</p> + +<pre class="brush: json notranslate">{ + "css": { + "properties": { + "background-color": { + "__compat": { + ... + }, + "alpha_ch_for_hex": { + "__compat": { + ... + }, + } + } + } + } +}</pre> + +<p>For an API, you've got the top two levels defined as <code>api.<em>name-of-the-interface</em></code>, then a top-level <code>__compat</code> section to define the overall browser compatibility of the interface, then a sub-feature for each of the methods, properties, and constructors contained inside the interface. The basic structure looks like this:</p> + +<pre class="brush: json notranslate">{ + "api": { + "VRDisplay": { + "__compat": { + ... + }, + "cancelAnimationFrame": { + "__compat": { + ... + } + }, + "capabilities": { + "__compat": { + ... + } + }, + + ... etc. + + } + } +}</pre> + +<p>See <a href="https://github.com/mdn/browser-compat-data/blob/master/api/VRDisplay.json">VRDisplay.json</a> for a full example.</p> +</div> + +<h2 id="Adding_data_Advanced_cases">Adding data: Advanced cases</h2> + +<p>There are some advanced features that you'll want to include in browser compat data. The aim of this section is to list the most common ones, providing an example of each to show how you can implement them in your own compat data.</p> + +<h3 id="Including_a_footnote">Including a footnote</h3> + +<p>Often compat tables will include footnotes related to certain entries that explain useful details or strange behavior that developers will find useful. As an example, the Chrome Android entry for {{domxref("VRDisplay.capabilities")}} (see also <a href="https://github.com/mdn/browser-compat-data/blob/master/api/VRDisplay.json">VRDisplay.json</a>) (at the time of writing) had a footnote "<span class="pl-s">Currently supported only by Google Daydream." To include this in the capabilities data, we added a "notes" submember inside the relevant "chrome_android" submember; it would look like this:</span></p> + +<pre class="brush: json notranslate">"chrome_android": { + "version_added": true, + "notes": "Currently supported only by Google Daydream." +}</pre> + +<h3 id="Including_a_vendor_prefix">Including a vendor prefix</h3> + +<p>If a feature is supported behind a vendor prefix in one or more browsers, you'll want to make that clear in the browser compat data. imagine you had a feature that was supported with a <code>-moz-</code> prefix in Firefox. To specify this in the compat data, you'd need to add a "prefix" submember inside the relevant "firefox" submember. It would look something like this:</p> + +<pre class="brush: json notranslate">"firefox": { + "version_added": true, + "prefix": "-moz-" +}</pre> + +<h3 id="Including_browser_preferences_or_flags">Including browser preferences or flags</h3> + +<p>Some features may be supported in a browser, but they are experimental and turned off by default. If a user wants to play with this feature they need to turn it on using a preference/flag.</p> + +<p>To represent this in the compat data, you need to add the "flags" submember inside the relevant browser identifier submember. The value of "flags" is an array of objects each of which contains of three members:</p> + +<ul> + <li>"type": The type of flag or pref this is. The most common value is "preference", which is set inside the browser (for example, using <code>about:config</code> in Firefox, or <code>chrome://flags</code> in Chrome), but you might also sometimes use a value of <span class="pl-s"><span class="pl-pds">"</span>compile_flag<span class="pl-pds">", which is a preference set when the browser build is compiled.</span></span></li> + <li>"name": This is a string representing the name of the preference that needs to have a value set on it. For example, "Enable Experimental Web Platform Features" is a preference that exists in Chrome, found in <code>chrome://flags</code>.</li> + <li>"value_to_set": This is a string representing the value that needs to be set on the preference, for example "true".</li> +</ul> + +<p>So to add a preference/flag to the Chrome support for a feature, you'd do something like this:</p> + +<pre class="brush: json notranslate">"chrome": { + "version_added": "50", + "flags": [ + { + "type": "preference", + "name": "Enable Experimental Web Platform Features", + "value_to_set": "true" + } + ] +},</pre> + +<p>If a feature is behind two or more flags, you can add additional objects to the "flags" array, like in this case, for example:</p> + +<pre class="brush: json notranslate">"firefox": { + "version_added": "57", + "flags": [ + { + "type": "preference", + "name": "dom.streams.enabled", + "value_to_set": "true" + }, + { + "type": "preference", + "name": "javascript.options.streams", + "value_to_set": "true" + } + ] +},</pre> + +<h3 id="Including_a_version_where_support_was_removed">Including a version where support was removed</h3> + +<p>Sometimes a feature will be added in a certain browser version, but then removed again as the feature is deprecated. This can be easily represented using the "version_removed" submember, which takes as its value a string representing the version number it was removed on. For example:</p> + +<pre class="brush: json notranslate">"firefox": { + "version_added": "35", + "version_removed": "47", +},</pre> + +<h3 id="Including_multiple_support_points_for_the_same_browser_entry">Including multiple support points for the same browser entry</h3> + +<p>Sometimes you'll want to add multiple support data points for the same browser inside the same feature.</p> + +<p>As an example, the {{cssxref("text-align-last")}} property (see also <a href="https://github.com/mdn/browser-compat-data/blob/master/css/properties/text-align-last.json">text-align-last.json</a>) was added to Chrome in version 35, supported behind a pref.</p> + +<p>The support mentioned above was then removed in version 47; also in version 47, support was added for <code>text-align-last</code> enabled by default.</p> + +<p>To include both of these data points, you can make the value of the "chrome" submember an array containing two support information objects, rather than just a single support information object:</p> + +<pre class="brush: json notranslate">"chrome": [ + { + "version_added": "47" + }, + { + "version_added": "35", + "version_removed": "47", + "flags": [ + { + "type": "preference", + "name": "Enable Experimental Web Platform Features", + "value_to_set": "true" + } + ] + } +],</pre> + +<div class="note"> +<p><strong>Note</strong>: You should put the most current or important support point first in the array — this makes the data easier to read for people who just want to scan it for the latest info.</p> +</div> + +<h3 id="Including_an_alternative_name">Including an alternative name</h3> + +<p>Occasionally browsers will support a feature under a different name to the name defined in its specification. This might be for example because a browser added experimental support for a feature early, and then the name changed before the spec stabilized.</p> + +<p>To include such a case in the browser compat data, you can include a support information point that specifies the alternative name inside an "alternative_name" member.</p> + +<div class="note"> +<p><strong>Note</strong>: The alternative name might not be an exact alias — it might have differing behaviour to the standard version.</p> +</div> + +<p>Let's look at an example. The {{cssxref("border-top-right-radius")}} property (see also <a href="https://github.com/mdn/browser-compat-data/blob/2a0cc3f6bb17aa4345441bed47a059dffd847793/css/properties/border-top-right-radius.json">border-top-right-radius.json</a>) was supported in Firefox:</p> + +<ul> + <li>From version 4 onwards with the standard name <code>border-top-right-radius</code>.</li> + <li>From version 49 onwards with a <code>-webkit-</code> prefix, for browser compatibility purposes.</li> + <li>From version 1 onwards with the alternative name <code>-moz-border-radius-topright</code>. Support for this alias was removed in version 12.</li> +</ul> + +<p>To represent this in the data, we used the following JSON:</p> + +<pre class="brush: json notranslate">"firefox": [ + { + "version_added": "4", + "notes": "Prior to Firefox 50.0, border styles of rounded corners were always rendered as if <code>border-style</code> was solid. This has been fixed in Firefox 50.0." + }, + { + "prefix": "-webkit-", + "version_added": "49", + "notes": "From Firefox 44 to 48, the <code>-webkit-</code> prefix was available with the <code>layout.css.prefixes.webkit</code> preference. Starting with Firefox 49, the preference defaults to <code>true</code>." + }, + { + "alternative_name": "-moz-border-radius-topright", + "version_added": "1", + "version_removed": "12" + } +],</pre> + +<h2 id="Pushing_a_change_back_to_the_main_repo">Pushing a change back to the main repo</h2> + +<p>Once you are finished with adding your compat data, you should first test it using the following commands:</p> + +<ul> + <li><code>npm run lint</code> — tests all the compat data to make sure the JSON is valid, and is written in the correct style, for example correct indentation, no missing commas, etc. It will print out a long list of file names and test results; if an error is found, the linter will throw an error on the file it is found in, giving you useful debugging info like line number, error message, etc.</li> + <li><code>npm run show-errors</code> — validates the JSON against the data schema, and highlights errors such as invalid browser version numbers being used.</li> + <li><code>npm run render dotted.path.to.feature</code> — allows you to preview the markup for the compat table for a data file in the repo. As an example, <code>npm run render css.properties.background</code> shows the table markup for the {{cssxref("background")}} property.</li> +</ul> + +<p>If it is looking OK, you then need to commit it and push it back up to your remote fork on GitHub. You can do this easily with terminal commands like this:</p> + +<pre class="brush: bash notranslate">git add . +git commit -m 'adding compat data for name-of-feature' +git push</pre> + +<p>Now go to your remote fork (i.e. <code>https://github.com/<em>your-username</em>/browser-compat-data</code>) and you should see information about your push at the top of the files list (under "Your recently pushed branches"). You can create a pull request (starting the process of pushing this to the main repo) by pressing the "Compare & pull request" button, then following the simple prompts on the subsequent screen.</p> + +<p>At this point, you just need to wait. A reviewer will review your pull request, and merge it with the main repo, OR request that you make changes. If changes are needed, make the changes and submit again until the PR is accepted.</p> + +<h2 id="Inserting_the_data_into_MDN_pages">Inserting the data into MDN pages</h2> + +<p>Once your new data has been included in the main repo, you can start dynamically generating browser compat tables based on that data on MDN pages using the \{{Compat}} macro. This takes a single parameter, the dot notation required to walk down the JSON data and find the object representing the feature you want to generate the compat table for.</p> + +<p>Above the macro call, to help other contributors finding their way, you should add a hidden text that is only visible in MDN contributors in edit mode:</p> + +<pre class="brush: html notranslate"><div class="hidden"> +<p>The compatibility table on this page is generated from structured data. +If you'd like to contribute to the data, please check out +<a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> +and send us a pull request.</p> +</div></pre> + +<p>As an example, on the {{httpheader("Accept-Charset")}} HTTP header page, the macro call looks like this: \{{Compat("http.headers.Accept-Charset")}}. If you look at the <a href="https://github.com/mdn/browser-compat-data/blob/master/http/headers/accept-charset.json">accept-charset.json</a> file in the repo, you'll see how this is reflected in the JSON data.</p> + +<p>As another example, The compat table for the {{domxref("VRDisplay.capabilities")}} property is generated using \{{Compat("api.VRDisplay.capabilities")}}. The macro call generates the following table (and corresponding set of notes):</p> + +<hr> +<div class="hidden"> +<p>The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> +</div> + +<p>{{Compat("api.VRDisplay.capabilities")}}</p> + +<div class="note"> +<p><strong>Note</strong>: The filenames often match the labels given to the interfaces inside the JSON structures, but it is not always the case. When the macro calls generate the tables, they walk through all the files until they find the relevant JSON to use, so the filenames are not critical. Saying that, you should always name them as intuitively as possible.</p> +</div> |