Notizie: puoi sempre seguire i nostri aggiornamenti su Twitter (@MozillaItalia) e Facebook (/MozillaItalia)

Autore Topic: <P> Come inserire commenti nel codice di un progetto Thimble  (Letto 1829 volte)

0 Utenti e 1 Visitatore stanno visualizzando questo topic.

Offline rancarlo

  • Post: 210
« Ultima modifica: 24 Novembre 2016 00:51:14 da michro »

Offline Underpass

  • I've got fabric to sell
  • Amministratore
  • Post: 22455
    • Mozilla Italia
Re: Come inserire commenti nel codice di Thimble
« Risposta #1 il: 23 Novembre 2016 10:09:56 »
Più che

Citazione
Commenta qui dentro

direi

Inserire qui il commento


Citazione
inserire un carattere di fine riga

si capisce? Non sarebbe forse meglio

andare a capo alla fine della riga

Offline michro

  • Moderatore
  • Post: 18561
Re: Come inserire commenti nel codice di Thimble
« Risposta #2 il: 23 Novembre 2016 11:10:08 »
Eccomi ;-)

Oltre alle giuste segnalazioni di Underpass, ecco i miei suggerimenti ;-)

Sommario:
Codice: [Seleziona]
Code comments do not show up when the page is rendered, and can be a helpful way to communicate information to people remixing your project.

I commenti del codice non vengono mostrati quando la pagina viene visualizzata, sono pertanto un modo utile di dare informazioni.
Come per altri articoli che hai tradotto, più che ripetere (grosso modo) l'introduzione, spiegherei di cosa parla l'articolo in modo che chi effettua una ricerca arriva subito al sodo. Proporrei:
Questo articolo spiega come aggiungere commenti del codice nei file Html, Css e JavaScript dei progetti Thimble.

Articolo:
Citazione
Code comments do not show up when the page is rendered, and can be a helpful way to communicate information to remixers, directly in the code, in context. This could include instructions for things to remix, coding tips, etc.

I commenti del codice non vengono mostrati quando la pagina viene visualizzata, sono pertanto un modo pratico di comunicare informazioni a chi si accinge a personalizzare un progetto di Thimble. Il commento è inserito direttamente nel'istruzione, nel contesto. Questo può includere instruzioni su cosa modificare, suggerimenti su come sviluppare il codice, etc.
noi, a differenza degli en-US, utilizziamo ecc.
Ti può andare bene questa mia proposta di modifica?
I commenti del codice non vengono mostrati quando la pagina viene visualizzata e possono essere pertanto un modo utile per comunicare informazioni a chi si accinge a personalizzare un progetto Thimble. I commenti vengono inseriti direttamente nel codice, nel contesto e possono includere istruzioni per le parti da personalizzare, suggerimenti su come sviluppare il codice, ecc.

Per quanto riguarda i titoli dei 3 paragrafi (metto qui solo il primo)
Citazione
To add a comment to an HTML file, use this syntax
Per aggiungere un commento in un documento HTML, usare la seguente sintassi
metterei "file" al posto di "documento" (come in originale) e "utilizzare" non "usare". Idem per i titoli dei paragrafi CSS e JavaScript ;-)

Offline rancarlo

  • Post: 210
Re: Come inserire commenti nel codice di Thimble
« Risposta #3 il: 23 Novembre 2016 13:02:32 »
Sommario
Citazione
Questo articolo spiega come aggiungere commenti del codice nei file Html, Css e JavaScript dei progetti Thimble.

Visto che li sto aggiungendo, sono commenti del o commenti al

Questo articolo spiega come commentare il codice nei file Html, Css e JavaScript dei progetti Thimble.  ?

Citazione
I commenti del codice non vengono mostrati quando la pagina viene visualizzata e possono essere pertanto un modo utile per comunicare informazioni a chi si accinge a personalizzare un progetto Thimble. I commenti vengono inseriti direttamente nel codice, nel contesto e possono includere istruzioni per le parti da personalizzare, suggerimenti su come sviluppare il codice, ecc.
Ok

Citazione
Per quanto riguarda i titoli dei 3 paragrafi (metto qui solo il primo)
To add a comment to an HTML file, use this syntax
Per aggiungere un commento in un documento HTML, usare la seguente sintassi
metterei "file" al posto di "documento" (come in originale) e "utilizzare" non "usare". Idem per i titoli dei paragrafi CSS e JavaScript ;-)

Ok

@michro
Attendo tuo ok a quanto esposto sopra per intervenire sulla traduzione.

Offline michro

  • Moderatore
  • Post: 18561
Re: Come inserire commenti nel codice di Thimble
« Risposta #4 il: 23 Novembre 2016 15:31:01 »
Dubbio più che lecito. La cosa mi era sfuggita...
Visto che li sto aggiungendo, sono commenti del o commenti al
Direi "commenti nel codice" (come avevi messo anche nel titolo)
Sommario:
Questo articolo spiega come aggiungere commenti nel codice dei file Html, Css e JavaScript dei progetti Thimble.

Secondo te, a proposito di titolo (puoi ancora modificarlo personalmente visto che l'articolo non è stato ancora approvato), è meglio l'attuale titolo
Come inserire commenti nel codice di Thimble
o integrare così
Come inserire commenti nel codice di un progetto Thimble ?

In ogni caso come slug utilizzerei: inserire-commenti-codice-thimble

Vedi di applicare anche i suggerimenti di Underpass.

Ti volevo far notare una cosa. Nel campo di modifica dell'articolo, nel paragrafo
==Per un commento in un documento CSS, usare la seguente sintassi==
credo tu abbia notato che
Codice: [Seleziona]
/* Commenta qui dentro */ (che dovrai modificare come suggerito da Underpass) è bordato/evidenziato in nero.
Significa che c'è uno spazio in eccesso prima di /* Commenta qui dentro */, spazio che devi togliere e vedrai che l'evidenziazione sparisce. Non è colpa tua, è un errore del sorgente originale en-US ;-)

Offline rancarlo

  • Post: 210
Re: Come inserire commenti nel codice di Thimble
« Risposta #5 il: 23 Novembre 2016 16:09:16 »
Citazione
si capisce? Non sarebbe forse meglio

andare a capo alla fine della riga
Ok

Citazione
Sommario:
Questo articolo spiega come aggiungere commenti nel codice dei file Html, Css e JavaScript dei progetti Thimble.
Ok

Citazione
Come inserire commenti nel codice di un progetto Thimble

In ogni caso come slug utilizzerei: inserire-commenti-codice-thimble
Ok michro una domanda, lo slug ha altre funzioni oltre a quelle evidenti di essere un URL e standardizzarne la composizione abbreviando?

Citazione
Significa che c'è uno spazio in eccesso prima di /* Inserire qui il commento */,
Ok, non mi ero reso conto di come farlo scomparire.

Offline michro

  • Moderatore
  • Post: 18561
Re: Come inserire commenti nel codice di Thimble
« Risposta #6 il: 23 Novembre 2016 18:00:51 »
Ok michro una domanda, lo slug ha altre funzioni oltre a quelle evidenti di essere un URL e standardizzarne la composizione abbreviando?
No, non ha altre funzioni. Serve solo a reindirizzare all'articolo a cui è associato ;-)
Qui c'è una breve spiegazione: https://support.mozilla.org/it/kb/tradurre-articolo#w_che-cosa-si-deve-tradurre



Offline rancarlo

  • Post: 210
Re: Come inserire commenti nel codice di Thimble
« Risposta #9 il: 23 Novembre 2016 23:21:06 »

@michro, questo passaggio su https://support.mozilla.org/it/kb/tradurre-articolo#w_che-cosa-si-deve-tradurre non mi è chiaro, mi aiuti a capire?

Citazione
Ricordarsi di mantenere inalterata la posizione del marcatore dell'Indice dei contenuti (se presente nell'articolo). Si tratta di questo tipo di dicitura: __TOC__

Offline michro

  • Moderatore
  • Post: 18561
Re: Come inserire commenti nel codice di Thimble
« Risposta #10 il: 23 Novembre 2016 23:29:02 »
Last???? ;-)
Cerca di variare i commenti alle diverse revisioni mettendo una breve descrizione tipo "QA Underpass", "Sommario e titoli paragrafi" o simili, altrimenti che storico è? ;-)
Queste sono le ultime modifiche che devi fare così poi approviamo.
Citazione
==Per aggiungere un commento in un file HTML, utilizzare la seguente sintassi==

<code><<!-- -->!--Inserire qui il commento--> <!-- --></code>

==Per aggiungere un commento in un file CSS, utilizzare la seguente sintassi==

/* Inserire qui il commento */

==Per aggiungere un commento su una singola riga in un file JavaScript, utilizzare la seguente sintassi==

// Inserire qui il commento [assicurarsi di andare a capo alla fine della riga]

<code><<!-- -->!-- Inserire qui il commento --> <!-- --></code>
va messo senza spazi tra i due trattini -- prima di Inserire e quelli dopo commento, così:
<<!-- -->!--Inserire qui il commento-->--> <!-- -->

Strano che non abbiano messo anche i commenti su più righe. Ma non è un nostro problema ;-)

Offline rancarlo

  • Post: 210
Re: Come inserire commenti nel codice di Thimble
« Risposta #11 il: 24 Novembre 2016 00:08:40 »
Citazione
Last???
autoironia!! :)

Quando esci ricordati di chiudere la porta!!

Non mi fa entrare!! @michro ooooo


Offline michro

  • Moderatore
  • Post: 18561
Re: Come inserire commenti nel codice di Thimble
« Risposta #12 il: 24 Novembre 2016 00:15:49 »
Ok, sono uscito! Ho chiuso la porta. Stavo verificando una cosa nella sintassi della traduzione ;-)


@michro, questo passaggio su https://support.mozilla.org/it/kb/tradurre-articolo#w_che-cosa-si-deve-tradurre non mi è chiaro, mi aiuti a capire?

Citazione
Ricordarsi di mantenere inalterata la posizione del marcatore dell'Indice dei contenuti (se presente nell'articolo). Si tratta di questo tipo di dicitura: __TOC__
Negli articoli che hai tradotto il __TOC__ non c'è perché non hanno inserito un indice dei contenuti negli articoli Thimble.
"TOC" è l'acronimo di "Table Of Contents" che noi abbiamo tradotto come "Indice dei contenuti".

Negli articoli per Firefox invece viene utilizzato quasi sempre. Ti faccio un esempio concreto con un articolo a caso.
Questo è l'articolo
https://support.mozilla.org/it/kb/risolvere-errori-data-ora-siti-web-sicuri
noterai che dopo l'introduzione c'è un riquadro in grigio con un testo all'interno
Indice dei contenuti
e in azzurro ci sono i titoli dei paragrafi che compongono l'articolo (sono dei link che se "cliccati" portano esattamente al paragrafo e vengono utilizzati come àncore per andare a quello specifico paragrafo quando quei link vengono utilizzati in un altro articolo... ma procediamo con una questione per volta per non creare confusione)

Quel riquadro e quel testo vengono creati automaticamente quando si utilizza l'istruzione __TOC__

Adesso fai clic su "Sorgente della versione" qui
https://support.mozilla.org/it/kb/risolvere-errori-data-ora-siti-web-sicuri/revision/135092
potrai visualizzare il sorgente e noterai che all'interno non compare né la scritta "Indice dei contenuti" né i link con i titoli dei paragrafi ma compare semplicemente il __TOC__

Se tu per sbaglio elimini il __TOC__, nell'articolo il riquadro e i link spariscono e se lo sposti in un'altra posizione (ad esempio dopo un paragrafo) l'articolo risulta "sballato".
Spero di essere stato comprensibile.

Puoi anche fare un test. Prova a entrare in modifica in questo articolo Thimble, inserisci __TOC__ tra l'introduzione e il titolo paragrafo ==Per aggiungere un commento in un file HTML, utilizzare la seguente sintassi== poi fai clic su "Anteprima dei contenuti" e vedrai cosa ti compare... Naturalmente poi non salvare la modifica facendo clic su "Proponi per revisione" ;-)

Offline rancarlo

  • Post: 210
« Ultima modifica: 24 Novembre 2016 00:45:02 da rancarlo »

Offline michro

  • Moderatore
  • Post: 18561
Re: Come inserire commenti nel codice di Thimble
« Risposta #14 il: 24 Novembre 2016 00:29:33 »
Ti tiro le orecchie!!! :roll: :wink:
Dai che voglio andare a dormire che domani ho una giornatina...
Codice: [Seleziona]
==To add a single-line comment to a JavaScript file, use this syntax==
==Per una linea di commento in un file JavaScript, utilizzare la seguente sintassi==
==Per aggiungere un commento su una singola riga in un file JavaScript, utilizzare la seguente sintassi==

0 Utenti e 1 Visitatore stanno visualizzando questo topic.