Documenti | P o l l o S k y

[Chicche] Visual Studio: documentare il proprio codice sorgente 26 maggio 2010

Inviato da LukePet in : Chicche, Documenti, Guide, Informatica, Prodotti, Software, Sviluppo, Tecnologia, Tutorial, Windows , aggiungi un commento

Ecco un altro post che attraversa il versante più “tecnico” dei contenuti di questo blog. Dopo averne già parlato poco tempo fa, torno ad affrontare l’argomento Visual Studio…e per la precisione: “Visual Studio & documentazione del codice”.

Qualche settimana fa mi sono deciso a produrre un po’ di documentazione tecnica in riferimento ad un progetto che sto portando avanti dove lavoro, così mi sono messo a ricercare una soluzione che mi soddisfacesse. Dopo qualche test sono riuscito a trovare una configurazione ideale per tenere allineata la documentazione del mio codice sorgente. Ora, visto che in rete (aldilà di qualche discussione) non ho trovato grossi tutorials a riguardo, riporto in questo post tutte le linee guida che ho seguito. Magari può tornare utile a qualcuno.

Punto 1° – Commentare sempre il codice!

Avere del codice ben commentato è fondamentale, se poi i commenti sono ben strutturati sarà possibile integrarli nella propria documentazione senza problemi. Insomma, abituatevi a fare una cosa come questa:
/// <summary> /// This is MyFunction /// </summary> /// <param name="param1">First parameter</param> /// <param name="param2">Second parameter</param> /// <returns>My return value</returns> public int MyFunction(string param1, double param2) { }

per avere un’idea più chiara dei tags che potete sfruttare nella scrittura dei vostri commenti buttate un occhio qua: Recommended Tags for Documentation Comments.

Punto 2° – Impostare le proprietà del progetto

Per ogni class library della vostra solution dovete abilitare la generazione del file XML di documentazione; per farlo andate nella finestra delle proprietà e spuntate la voce “XML documentation file”, come mostrato qui sotto: Continua a leggere…

[Chicche] Visual Studio: suggerimenti per l’uso 28 aprile 2010

Inviato da LukePet in : Chicche, Documenti, Guide, Informatica, Prodotti, Software, Sviluppo, Tecnologia, Windows , aggiungi un commento

Ci sono due motivi per cui scrivo questo post; il primo motivo è per dare qualche utile consiglio a chi utilizza da poco l’IDE di casa Microsoft, l’altro motivo è per un mio personale esercizio mnemonico…questo post rientrerà diretto nel blocchetto degli appunti telematici.

Sono oramai più di due anni che ho iniziato a sviluppare in ambiente Microsoft e Visual Studio è stato il compagno di viaggio di ogni quotidiana istruzione di codice. Come ogni IDE che si rispetti, Visual Studio offre un’infinità di funzionalità/settaggi che possono semplificarci la vita…alcune di queste precauzioni mi stanno particolarmente a cuore ed ho deciso di appuntarle per bene su questo blog.

Le cose che scrivo si trovano già sparse nel web a quantità industriali, io mi limiterò a sintetizzare e segnalare qualche piccola “chicca” in grado di rendere più piacevole e “comoda” l’attività di scrittura del codice.

Punto primo: le opzioni.

Vi consiglio di spendere qualche minuto per spulciare le opzioni di configurazione che Visual Studio mette a disposizione, andando su Tools -> Options troverete una valanga di impostazioni da poter configurare. In particolar modo, nella sezione “Text Editor” potete scegliere la formattazione che più vi aggrada per ogni specifico linguaggio.

Personalmente, quando scrivo in C# o VB, non posso fare a meno di abilitare il display delle “Line numbers”; mentre ho da poco trovato delle comode configurazioni anche per la scrittura dei file XAML, le impostazioni che ho scelto sono le seguenti:

Punto secondo: le estensioni.

Ne esistono parecchie ma per il momento segnalo solo i PowerCommands (http://code.msdn.microsoft.com/PowerCommands). Installando questa estensione verranno aggiunte delle piccole ma utilissime nuove funzionalità al menu principale.

In particolar modo segnalo questi due nuovi comandi:

“Remove and Sort Usings”
(gustosa funzionalità per chi sviluppa in C#; scansiona tutti i file della Solution e, oltre ad ordinarli, rimuove tutti i riferimenti “using” superflui)
“Collapse Project”
(questa è per persone pignole come me; che ci volete fare, io non riesco proprio a chiudere Visual Studio se prima non ho fatto il collapse di tutti i progetti nella soluzione)

Punto terzo (ultimo ed il più importante): le shortcuts!

Ed è qui che arriva l’esercizio mnemonico; faccio un breve elenco di tutte le shortcuts più importanti che ho visto in azione e che piano piano ho imparato ad usare assiduamente. Eccole qua: Continua a leggere…

[Chicche] Editing di file Mkv…merge, demux, mux, delay e quant’altro 4 febbraio 2010

Inviato da LukePet in : Chicche, Informatica, Linux, Multimedia, Prodotti, Software, Soluzioni, Windows , aggiungi un commento

Chicca volante.

Se vi capitasse di avere a che fare con qualche file MKV dall’audio leggermente sfasato ed aveste bisogno di un tool in grado di fare, in modo rapido e semplice, il demux/mux della traccia video e di quella audio (con le opportune modifiche al delay settate), allora il mio caldo consiglio è di utilizzare MKVToolnix.

E’ ciò di cui avevo bisogno stasera e questo bel programmino è stata la mia salvezza. Il software è quasi banale da usare, caricate il file, settate tutte le vostre cosine e poi lo salvate in un nuovo file. Fatto.

Questo è il link per scaricarlo: http://www.bunkus.org/videotools/mkvtoolnix/index.html.

Dato che ci sono, posto pure un’altra piccola nozione utile da conoscere quando si ha a che fare con i ritardi dell’audio e/o dei sottotitoli. Se utilizzate VLC (www.videolan.org/vlc) come player potete agire in tempo reale sui delay del file che state riproducendo, vi basta conoscere le giuste short-key:

premendo h aumenterete il ritardo dei sottotitoli
premendo g ridurrete il ritardo dei sottotitoli
premendo k aumenterete il ritardo della traccia audio
premendo j ridurrete il ritardo della traccia audio

Chiaramente tutto ciò non vale solo per i file mkv, ma per ogni tipo di file video che state riproducendo…e questo potrebbe evitarvi di dover rielaborare il file sfasato.

Penso di aver detto tutto…buona notte.

[Acquistoni] Samsung UE40B6000…settaggi a gogò 11 gennaio 2010

Inviato da LukePet in : Acquistoni, Documenti, Software, Tecnologia , 70 commenti

Ecco il primo dei post di approfondimento legati ad i miei ultimi tecno-acquisti (il-mio-primo-piccolo-vero-home-cinema); parliamo del TV LCD con retroilluminazione a led che mi sono regalato per Natale, il Samsung UE40B6000.

Come ho già avuto modo di dire, prima di procedere all’acquisto mi sono fatto una piccola cultura spulciando e leggendo intera pagine di discussioni sui forum dedicati all’audio ed al video. E dopo attente valutazioni, legate anche alle mie esigenze, la scelta è ricaduta sulla tv di casa Samsung.

Ora quindi per chi, come me, è in possesso di questo televisore condivido qualche utile risorsa.

Punto primo. Reperire informazioni.

Per qualsiasi dubbio, richieste o domande riguardo alla serie 6 dei Samsung a led vi invito ad appuntarvi il link alla discussione ufficiale del forum di AVMagazine:
http://www.avmagazine.it/forum/showthread.php?t=146138.

Punto secondo. Aggiornamento software.

Come molti sapranno è possibile aggiornare il software della tv scaricando il file di update dal sito della Samsung ed eseguendolo via USB. Per scaricare il file di aggiornamento però non andate sul sito italiano ma recuperatelo dal “download center” del sito internazionale. Da lì trovate gli aggiornamenti per tutti i modelli di casa Samsung.

Se prendiamo, ad esempio, la serie 6 di Samsung a led, è possibile vedere come esistano due modelli di riferimento il B6000VW ed il B6000VP…il mio, per esempio, è un UE40B6000VP.

Vi basta andare su sito http://www.samsung.com/download/index.aspx?agreement=y, selezionare il vostro modello e scaricare il file e le istruzione di aggiornamento. Attualmente l’ultima versione disponibile per la serie “VP” è la “2007″.

Testato e tutto regolare.

Punto terzo. Settaggi.

Leggendo i vari forum è possibile visionare i diversi settaggi condivisi dagli utenti. Io ne ho preso nota ed ho fatto le mie prove…sono partito da quelli proposti, ma poi ho un pò ritoccato il tutto in funzione del mio gusto personale ed ho raggiunto un profilo che sembra soddisfarmi appieno.

Mi sono concentrato principalmente sul segnale che arriva via HDMI (collegato ad un lettore Blu-Ray); quindi, quelle che vi propongo adesso sono le impostazioni che uso quando guardo i film in alta definizione. Eccole:

Continua a leggere…

[Firefox] FF & Facebook Chat…pace fatta 8 gennaio 2010

Inviato da LukePet in : Chicche, Firefox, Informatica, Internet, Siti, Software, Soluzioni, Web , 2 commenti

Chicca volante.

Fino a qualche giorno fa ho convissuto con un innocuo, ma fastidiosissimo, problema con la chat di Facebook.

Ogni volta che ricevevo un messaggio con la pagina di Facebook aperta in Firefox mi imbattevo in una incomprensibile notifica che richiedeva l’installazione del plugin Apple QuickTime. Una stranezza su cui ho sorvolato per parecchio tempo ma che sotto sotto mi dava sempre più fastidio.

All’inizio ho erroneamente dato la colpa a Digsby (passo-a-digsby), che alla fine non c’entrava niente…poi, all’ennesima notifica di installazione del plugin “misterioso”, ho deciso di affrontare la questione di petto ed ho dedicato 5 minuti del mio prezioso (si fa per dire) tempo alla ricerca di una soluzione.

E’ venuto fuori che non sono stato il solo ad aver avuto questa noia e, tra le varie discussioni spulciate, la soluzione (in realtà più “workaround” che una soluzione) emersa si è dimostrata di una semplicità impensabile. Ebbene, per non aver più a che fare con quella seccante notifica visualizzata ad ogni messaggio che arriva dalla chat di Facebook non bisogna far altro che disabilitare l’opzione “Attiva suono per i nuovi messaggi”. Non chiedetemi perchè, ma è così.

Ora lo sapete, quindi se capitasse anche a voi…sapete come agire!

[Chicche] Filtrare file e directory nei trasferimenti con FileZilla 4 novembre 2009

Inviato da LukePet in : Chicche, Guide, Informatica, Internet, Linux, Software, Soluzioni, Windows , 6 commenti

Altra chicca volante…

E’ una cosa che ho scoperto e sperimentato pochi giorni fa, una sciocchezza di quelle che si ignorano con insana sufficienza e poi quando si svelano ti mettono un pizzico di beata soddisfazione.

In pratica ho scoperto che durante i trasferimenti via FTP con FileZilla c’è la possibilità di impostare dei filtri per evitare che vengano presi in considerazione file e cartelle non necessarie…e questa feature (ndr. disponibile dalla versione 3 del client) mi è stata parecchio utile. Dovevo tirare giù un sito evitando che venissero considerati tutti i files residenti nella directory di cache, mi è venuto così il sospetto che ci fosse un qualche modo per gestire questa esigenza…e non mi sbagliavo.

E’ bastato esplorare con un pò più di attenzione la toolbar di FileZilla per scoprire che esiste un settaggio apposito per filtrare i trasferimenti.

Ora, senza che mi stia a dilungare in superflue spiegazioni, vi posto un contributo visivo che più essenziale non si può:

(cliccate sull’immagine per vederla ingrandita)

Più chiaro di così non potevo essere…passo e chiudo.

[Chicche] Memorizzare la posizione delle icone sul Desktop 6 ottobre 2009

Inviato da LukePet in : Chicche, Informatica, Prodotti, Segnalazioni, Sistema, Software, Soluzioni, Windows , 1 commento finora

Chicca volante.

Probabilmente questa utility la trovate recensita in molti altri blog ma, visto che in questi giorni si è dimostrata un vero toccasana per combattere le mie “noie da pc”, la metto in evidenza anche qui.

In pratica per alcuni motivi (che non sto qui a spiegarvi) ultimamente mi capita di utilizzare la mia postazione di lavoro in desktop remoto da altre macchine…i vari cambi di risoluzione a cui sottopongo di volta in volta il desktop finisco sempre per incasinarmi tutte le icone che minuziosamente e con molto amore avevo disposto.

Una volta…ok. Seconda volta…e vabbè, lasciamo passare. Terza volta…adesso basta!

Stanco di questo fastidioso inconveniente mi sono messo rapidamente alla ricerca di una utility che mi venisse in soccorso…ed ho trovato un fedele alleato in DesktopOK.

Niente di più banale…si tratta di un semplicissimo e leggero programmino che consente agevolmente di salvare le posizioni delle icone, per poi ripristinarle quando ce ne sarà bisogno.

Efficiente ed efficace, se mai vi servisse lo trovate a questo indirizzo: http://www.softwareok.com/?seite=Software/DesktopOK.

[Chicche] Cheat Sheet …il potere della sinteticità 29 settembre 2009

Inviato da LukePet in : Chicche, Documenti, Informatica, Internet, Prodotti, Segnalazioni, Siti, Software, Sviluppo, Web , 1 commento finora

I Cheat Sheet mi ricordano molto gli schemi che usavo fare (nei bei tempi in cui ero studente) per assimilare, ricordare e “sbirciare” i concetti di un dato argomento.

Sinteticità, linearità, essenzialità…tre caratteristiche fondamentali per organizzare ed assorbire rapidamente le conoscenze; i Cheat Sheet nascono sull’onda di tali qualità e non rappresentano altro che una serie sintetica di note velocemente consultabili per dei rapidi riferimenti.

Ho riscoperto l’uso dei questa metodologia di schematizzazione proprio in ambito informatico; difatti sembra prendere sempre più piede l’abitudine a diffondere in rete dei precisi ed utilissimi documenti che delineano funzionalità e caratteristiche per diverse tecnologie di riferimento…e tutto ciò, dal punto di vista di uno sviluppatore software, rappresenta una preziosa risorsa.

Se ci fosse qualche appassionato di informatica che ancora non ha scoperto l’esistenza dei Cheat Sheet, riporto qualche documento e link da visionare:

CSS Cheat Sheet
(un quadro preciso che vi aiuterà costruire i vostri fogli di stile)
HTML5 Cheat Sheet
(in attesa del suo consolidamento ecco una panoramica dei tag HTML5)
Javascript Cheat Sheet
(il succo del linguaggio Javascript)
jQuery Visual Cheat Sheet
(un cheat sheet davvero ottimo sul framework JQuery)
WordPress Cheat Sheet
(uno schema imperdibile per chi usa WordPress)
Google Cheat Sheet
(non poteva mancare l’essenziale, ma sempre utile, cheat sheet di Google)

…e se non ne avete abbastanza potete sbizzarrirvi visitando il sito: www.cheat-sheets.org

Buona consultazione…e siate sintetici :)

[Chicche] WordPress: personalizzare le icone del plugin Sociable 14 settembre 2009

Inviato da LukePet in : Chicche, Informatica, Internet, Prodotti, Software, Sviluppo, Tutorial, Web , 11 commenti

E’ già da un pò che mi sono adoperato per fare un piccolo restyling alle icone di condivisione per i post di questo blog…ed il risultato è ormai da tempo ben visibile in coda ad ogni post. Giusto per essere più chiari, ecco di cosa sto parlando:

L’immagine soprastante mostra il riquadro utilizzato per la condivisione dei post sui principali servizi di comunicazione web. Dal punto di vista funzionale tutto è gestito dal plugin Sociable, che permette di selezionare da un elenco di servizi disponibili quelli per i quali si vuole predisporre il collegamento rapido per la condivisione.

Nulla da eccepire quindi, Sociable il suo lavoro lo svolge egregiamente…ma dal punto di vista grafico così com’era non mi convinceva; di default le icone mi sembravano troppo piccole e poco “interessanti”. Tutto ciò mi ha spinto a dare una ritoccata all’aspetto grafico, ottenendo il risultato mostrato nell’immagine precedente…non c’è voluto molto, qualche nuova icona ed un ritocco al foglio di stile ed il gioco è fatto.

Ora per la gioia di tutti gli smanettatori grafici espongo con chiarezza i passi da seguire per ottenere il mio stesso risultato:

1) Prima di tutto, chiaramente, installate il plugin Sociable (http://wordpress.org/extend/plugins/sociable). Fatto?

2) Dal pannello di configurazione del plugin selezionate i servizi per cui volete rendere disponibile la condivisione. Fatto?

3) A questo punto dovete ricercare il pacchetto di icone che più vi piace, da associare ai servizi che avete selezionato precedentemente (io, per esempio, le ho trovate sul sito http://www.iconspedia.com). Fatto?

Se per caso vi interessassero le stesse mie icone potete scaricare il pacchetto direttamente da qui: newsociable.

NB: è fondamentale che rinominiate le nuove icone con gli stessi nomi delle icone di default del plugin Sociable.

4) Ora, via FTP, caricate le nuove icone in una directory a scelta del vostro spazio web; tornate nel pannello di configurazione di Sociable e nel settaggio “Image directory” inserite l’url che punta alla directory appena uploadata. Fatto?

5) Bene, adesso abbiamo le nuove icone…non resta che modificare il foglio di stile. Dal pannello di configurazione di Sociable nel settaggio “Use CSS” disabilitate l’opzione “Use the sociable stylesheet” (andremo a ridefinire le nuove classi direttamente nel foglio di stile del tema in uso); aprite il file style.css del tema che state usando ed aggiungete le seguenti istruzioni:
Continua a leggere…

[Firefox] Quando il panda non carica tutti componenti aggiuntivi al primo avvio 11 settembre 2009

Inviato da LukePet in : Chicche, Firefox, Informatica, Internet, Prodotti, Software, Soluzioni , aggiungi un commento

Da quando ho installato Firefox 3.5 ho avuto a che fare con un piccolo problema le cui cause mi sono tuttora ignote.

Nulla di tragico, in realtà il problema non aveva alcun effetto compromettente ma il fastidio che induceva non era poi così minimo. La situazione era questa: ogni volta che avviavo il browser per la prima volta (dopo il caricamento del sistema) una serie di estensioni tra quelle che ho installato rimanevano disabilitate senza motivo alcuno; a questo punto ero costretto ad aprire la finestra di gestione dei componenti aggiuntivi lanciare una ricerca degli aggiornamenti e poi riavviare il browser…ed a questo punto mi ritrovavo tutti i componenti caricati correttamente. Ma fare questa semplice operazione ogni volta iniziava un pò ad infastidirmi…così mi sono messo in cerca di una possibile soluzione.

Ho fatto qualche ricerca sul web ed è venuto fuori che il problema, se pur raro, non è del tutto isolato. Alcuni utenti in qualche forum hanno riscontrato lo stesso mio comportamento…questo link lo testimonia: http://forum.mozillaitalia.org/index.php?topic=40330.0

Ho provato, come suggerito nella discussione, a creare un nuovo profilo ma il problema è rimasto. Quale possa essere la causa di tutto ciò non è proprio facile capirlo…forse qualche incompatibilità con specifiche configurazioni di sistema o, addirittura, con specifiche versioni del sistema operativo (io, ad esempio, l’ho riscontrato con Vista 64) oppure, semplicemente, un bug della versione 3.5. Bo, per il momento rimane un mistero.

A questo punto mi sono adoperato per aggirare il malfunzionamento…ed ho trovato la soluzione.

Sono ricorso al buon vecchio metodo (se pur “pericoloso”) di disabilitare il controllo di compatibilità delle estensioni…disattivandolo il problema è scomparso e mi sono ritrovato le estensioni tutte belle attive anche al primo avvio.

Ora, per chi si trovasse nella mia stessa situazione (mi auguro per voi di no) riporto i passi da seguire per disabilitare il controllo di compatibilità su Firefox 3.5:

andate nella barra degli indirizzi e digitate about:config (vi ritroverete davanti la lista dei parametri di configurazione del browser)
cliccate con il destro del mouse e dal menu contestuale selezionate Nuovo -> Booleano
si aprirà la finestra per la creazione di un nuovo parametro di configurazione, inserite come nome extensions.checkCompatibility ed impostate il valore a false
a questo punto riavviate il browser ed il gioco è fatto…al riavvio il controllo di compatibilità delle estensioni risulterà disabilitato

Dovrete giusto fare un pò più di attenzione quando installate nuovi componenti assicurandovi che siano compatibili con la versione del browser, ma per il resto, il fastidioso problema delle estensioni disattivate non si presenterà più (perlomeno così è stato per me).

E’ tutto…alla prossima “assistenza”.