Sviluppo | 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] Mockuppare…Balsamiq vs. MockFlow 27 ottobre 2009

Inviato da LukePet in : Chicche, Informatica, Internet, Servizi, Software, Sviluppo , aggiungi un commento

Il bello della condivisione delle conoscenze è che puoi dare tanto agli altri e prendere altrettanto tanto da loro. Succede così che grazie alla segnalazione di un collega di lavoro e ad un messaggio di un amico che segui su Twitter vieni a conoscenza di alcuni strumenti che si lasciano subito apprezzare per la loro immensa utilità.

Questa riflessione nasce proprio da quel flusso di parole, interazioni e condivisione che mi ha portato a sperimentare l’utilizzo dei mockup software.

Si tratta di programmi che aiutano la fase di progettazione delle interfacce grafiche, permettendo di disegnare in maniera rapida i modelli dimostrativi di un’applicazione; le schermate applicative vengono create attraverso uno specifico editor che integra una libreria di oggetti preimpostati e configurabili, attraverso i quali comporre il modello della user interface…e tutto ciò aiuta non poco le varie fasi di analisi e progettazione che portano alla realizzazione di una soluzione software.

Di tool di questo genere ne esistono diversi, io ho avuto modo di provarne due ed ora vi posto le mie impressioni; le due soluzioni su cui ho messo le mani sono Balsamiq Mockups (www.balsamiq.com) e MockFlow (www.mockflow.com).

Per avere un metro di giudizio preciso e riuscire a paragonare bene i due software, ho fatto un piccolo esperimento. In pratica, ho disegnato la stessa interfaccia prima con Balsamiq e poi con MockFlow, mettendole a confronto per valutarne la resa complessiva. Qui sotto trovate ciò che ne è venuto fuori:

Il test con Balsamiq è stato condotto utilizzando la versione desktop dell’applicativo (concessa con licenza di prova), mentre con MockFlow ho utilizzato la versione free online.

Impressioni? Continua a leggere…

[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…

[Chicche] Generatori di GIF animate per l’attesa durante i caricamenti 1 luglio 2009

Inviato da LukePet in : Chicche, Informatica, Internet, Segnalazioni, Servizi, Siti, Software, Sviluppo, Web , aggiungi un commento

“Frecciarossa PolloSky”…ecco un post rapido rapido per segnalare un paio di link che potrebbero tornare utili al popolo degli sviluppatori software.

Oggi a lavoro avevo bisogno di una GIF animata da inserire su un’applicazione web come attesa durante i caricamenti delle pagine…così ho fatto una ricerca al volo ed ho trovato due generatori molto interessanti.

Li segnalo anche sul blog…magari è un’informazione che può tornare utile a qualcuno, eccoli:

Banalissimi da usare e molto efficaci. Provateli.

[Chicche] Più icone per tutti 23 giugno 2009

Inviato da LukePet in : Chicche, Internet, Segnalazioni, Siti, Sviluppo, Web , aggiungi un commento

Come è facilmente notabile, ho aggiunto qualche icona alla sidebar qui di fianco, per mettere in evidenza i principali canali paralleli a questo blog. Prendo spunto da questa piccola novità per scrivere un post a tema…parliamo quindi di icone.

Diverso tempo fa scrissi un post in cui segnalavo il sito iconfinder.net (chicche-cercate-un-icona-ecco-il-motore-di-ricerca-che-fa-per-voi), il sito è tuttora attivo e gode di ottima salute…quindi tenetelo sotto osservazione.
Ora però, segnalo un’altra bella risorsa sul genere (dal quale ho preso le nuove icone comparse sulla barra laterale)…parlo del sito http://www.iconspedia.com.

Più che un motere di ricerca per icone è un vero e proprio raccoglitore di pack suddivisi in categorie. Il link mi è capitato tra le mani spulciando i miei feed ma al momento non ricordo qual’è la fonte. Poco male, io comunque rigiro la segnalazione…se siete amanti delle chicche grafiche vi consiglio di farci un salto.

Ci sono parecchie tipologie di icone da spulciare…web, sport, games, cinema, tv, musica…insomma, tanta roba. Se vi piace allestire il vostro sito web o il vostro desktop con delle icone colorite, questa è sicuramente una delle tante risorse cui potete attingere.

Io per le icone della sidebar ho sfruttato le Aquaticus Social Icons, le trovate qui: http://www.iconspedia.com/pack/aquaticus-social-1367.

Ora iconizzatevi a dovere.

[Chicche] Tutsplus per tutti 1 giugno 2009

Inviato da LukePet in : Chicche, Guide, Hard Disk Recording, Informatica, Internet, Segnalazioni, Siti, Sviluppo, Tutorial, Web , 1 commento finora

Tempo fa scrissi un post in cui segnalavo dei tutorial su Photoshop (chicche-a-tutto-photoshop). Tra i vari link compariva anche il sito PSDTuts+…uno tra i blog più interessanti per chi ama creare con Photoshop.

La famiglia di siti “Tutsplus” però è molto più vasta e non si limita al solo blog su Photoshop…essa rappresenta un vero e proprio network con contenuti di altissima qualità che toccano differenti sponde. Vediamo nel dettaglio.

PsdTuts+ [http://psd.tutsplus.com]
(come già detto un eccezionale blog con tutorials per Photoshop)
VectorTuts+ [http://vector.tutsplus.com]
(analogamente a PsdTuts questo blog è dedicato al software Illustrator, con guide e tutorial sull’elaborazione di immagini vettoriali)
FlashTuts+ [http://flash.tutsplus.com]
(qui invece entriamo nel mondo Flash, con una serie di post sulla creazione di applicazioni Flash e ActionScript)
AeTuts+ [http://ae.tutsplus.com]
(blog in cui si parla di animazione grafica, con guide e dimostrazioni sull’utilizzo del software After Effects)
NetTuts+ [http://net.tutsplus.com]
(NetTuts è interamente dedicato allo sviluppo web, contiene numerosi tutorial e articoli sul web design con riferimenti ai linguaggi HTML, CSS e Javascript)
AudioTuts+ [http://audio.tutsplus.com]
(questo blog invece è dedicato ai produttori di musica, raccoglie articoli su tecniche di registrazione e missaggio…una risorsa molto interessante per chi ama giocare con l’audio)

Per avere tutto il network sotto controllo potete far riferimento a questo indirizzo: http://tutsplus.com; inoltre, per chi volesse, c’è anche la possibilità di seguire gli aggiornamenti dei siti via Twitter…trovate tutti i riferimenti nelle pagine che ho segnalato.

Ed ora, non mi resta che augurare un buon apprendimento a tutti!

[Chicche] WordPress: modificare la modalità di invio delle mail 12 maggio 2009

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

Negli ultimi giorni mi sono trovato ad affrontare un altro piccolo ostacolo nella gestione di un blog WordPress (non questo) che sto curando per conto terzi.

Il problema era questo: avevo installato il plugin Subscribe2 (http://subscribe2.wordpress.com) per la gestione della newsletter e riscontravo dei messaggi di errore quando andavo a testare l’invio delle mail per la conferma delle iscrizioni.

In pratica, ad ogni tentativo di iscrizione, ritornava questo alert:

“Sorry, there seems to be an error on the server. Please try again later.”
(tradotto italiano: “Siamo spiacenti, sembra esserci un errore sul server. Riprovare più tardi.”)

Il problema era presumibilmente legato alla procedura di invio delle e-mail dal sito. Dopo qualche ricerca in rete ho trovato la conferma; sul sito ufficiale del plugin, in risposta ad un quesito su questo problema, l’autore dice: “Subscribe2 uses PHPMailer that is built in to WordPress. When an attempt is made to send an email success or failure is reported back to the calling function. In your case the PHPMailer function is reporting failure. You need to check with your host provider why this is happening as it is a server issue.”

In pratica questo genere di malfunzionamento è causato da qualche restrizione del server che impedisce l’invio delle e-mail utilizzando la modalità di default del PHPMailer (cioè la modalità Sendmail). Continua a leggere…

[Chicche] WordPress: pubblicare i post di una specifica categoria in una pagina dedicata 4 maggio 2009

Inviato da LukePet in : Chicche, Guide, Informatica, Prodotti, Software, Soluzioni, Sviluppo, Tutorial, Web , 51 commenti

Proprio ieri mi sono cimentato in una piccola personalizzazione per un blog WordPress che sto gestendo; niente di particolare, avevo giusto un’esigenza di impostazione e sono riuscito a soddisfarla.

Vi spiego meglio.

In pratica dovevo creare una sezione dedicata in cui visualizzare tutti i post che rientravano in una specifica categoria. Niente di insormontabile insomma, mi è bastata qualche piccola ricerca per individuare la soluzione; ma visto che gran parte delle info che ho trovato sono in inglese, riporto qui la descrizione dei passi in italiano; così, semmai qualcuno ne avesse bisogno, ha tutto scritto per bene.

Dunque, prima di tutto vi segnalo il link che mi ha fatto da guida, eccolo qua: http://codex.wordpress.org/Template_Tags/query_posts.

E questi sono i passi da seguire per implementare questa piccola personalizzazione:

1. Andate sul vostro database WordPress ed individuate l’ID della categoria che vi interessa gestire in un’altra pagina. La tabella cui dovete far riferimento è wp_terms (da cui dovete individuare il term_id); se si tratta di una nuova categoria naturalmente dovete prima crearla e poi consultare la tabella.

2. Ora dovete andare nel vostro tema e creare un template per la nuova pagina che raccoglierà i post.

Ecco come fare… Continua a leggere…