Archivi tag: markdown

Typora, l’editor Markdown che utilizzo per documentare il mio lavoro

Lascia una risposta

Dopo il recente articolo sull’uso di CoolTerm, ho ricevuto diverse mail di richieste consigli in riferimento ad editor alternativi per scrivere documentazione tecnica, quindi non per programmare ma per editare testo. Cosa uso io? Come più volte indicato su queste pagine uso scrivere la mia documentazione in Markdown e da molto tempo utilizzo Typora di cui ne ho parlato tempo fa in un mio post. Tutta la mia documentazione didattica per i miei corsi, per studenti ed insegnanti, ma anche per progetti personali in cui inserisco codice in diversi linguaggi di programmazione la scrivo con Typora salvandola in un’area privata su GitHub, ciò mi consente il grande vantaggio di gestire il versioning e creare file di lavoro indipendenti dall’applicazione e dal sistema operativo.
Typora è un editor Markdown in grado di rendere molto semplice la scrittura e la gestione di documenti, ha una gestione di tabelle, grafici, formule matematiche, codice di programmazione estremamente elegante e semplice. E’ possibile anche mantenere nascosta la sintassi Markdown ed utilizzarlo come un editor normale.

L’editor si presenta con una grafica minimal, priva di distrazioni in scrittura ed in lettura.
Typora fino a poco tempo fa era distribuito gratuitamente in versione beta, recentemente uscito in versione definitiva può essere provato per 15 gg dopo di che bisognerà acquistarlo per pochi dollari. Io ovviamente, visto l’uso che ne faccio ho subito acquistato il software. Typora è disponibile per diverse piattaforme.

Le funzionalità sono moltissime, di seguito dettaglio solo alcune e vi rimando al manuale esaustivo di utilizzo del software e di scrittura in Markdown.

Continua a leggere→

Articoli correlati:

  1. Formattazione del testo con Markdown
  2. Due papà  che si confrontano
  3. Documentare la didattica con la sintassi Markdown su GitHub

Documentare la didattica con la sintassi Markdown su GitHub

Lascia una risposta

In questi giorni sto svolgendo attività di formazione per un percorso ITS (per neodiplomati) presso l’IIS Vallauri di Fossano (Cn) il mio intervento ha l’obiettivo di insegnare a prototipare un kit robotico ad uso didattico, mentre a Torino presso l’IIS Primo Levi sto seguendo dei ragazzi di 4’ superiore in un percorso di Alternanza Scuola Lavoro di Digital Fabrication (dalla stampa 3D alla prototipazione elettronica). Per tutti queste attività l’azione del documentare da parte degli studenti è essenziale,  pertanto ho aggiunto un modulo specifico sulle metodologie di progettazione e sul tecniche di documentazione che integrerò, con opportuni aggiustamenti, nelle mie attività didattiche dal prossimo anno scolastico.

Occupandomi di argomenti molto tecnici ho deciso di insegnare a produrre documentazione usando la sintassi Markdown e la condivisione dei propri progetti su GitHub, ciò permetterà di gestire in modo ottimale il versioning dei progetti (di qualsiasi genere non solo informatici) e non ultimo produrre pagine web di progetto realizzate con Jekyll.

Ho incominciato quindi a produrre qualche breve tutorial (tutto ancora in costruzione) sull’uso di GitHub, GitHub Pages e Markdown, che potete trovare a questo link, inoltre qualche tempo fa avevo già prodotto un tutorial su Markdown che potete leggere a questo link.

Nel caso riteniate utile il tutorial copiate e migliorate.

Un caro saluto.

Articoli correlati:

  1. Formattazione del testo con Markdown

Due papà  che si confrontano

Lascia una risposta


Io ho i miei riferimenti, le persone che considero maestre, persone amiche, con cui ho un sincero scambio di opinioni e competenze tra queste Paolo detto il Sax 🙂

Questa sera lunga telefonata (1 ora) Paolo a Cambourne in UK ed io a Torino.
Ci si sente spesso per confrontarsi, per parlare di famiglia, lavoro e sperimentazioni e questa sera ci siamo scambiati decine di consigli e 3 sue segnalazioni sono state per me ORO e mi fa piacere condividerle con voi:

Segnalazione 1

Entrambi utilizziamo software per ottimizzare la gestione dei progetti e la documentazione  che produciamo, alla ricerca dell’applicativo software migliore che ci consente ottimizzare il nostro lavoro, nel mio caso produco documentazione didattica per i miei corsi e che ora mantengo in un’area privata su GitHub.
Typora potrebbe essermi estremamente utile, è uno stupendo editor Markdown in grado di rendere molto semplice la scrittura e la gestione di documenti scritti in Markdown, ha una gestione di tabelle e grafici estremamente elegante e semplice. Tantissime sono le funzionalità e lo sto in questo momento provando su un progetto reale… guardartelo perché ne vale proprio la pena, attualmente gratuito, in beta per Mac OS X e disponibile anche per tutte le altre piattaforme.

Segnalazione 2

Slidium un programma che permette la produzioni di slide in Markdown, semplicissima la gestione della grafica. Il software è a pagamento, ma non costa molto, provate la versione Trial, lo sto sperimentando per creare le prossime slide che utilizzerò per i miei corsi sul Coding e la Stampa 3D

Segnalazione 3

GeomLab

Questa ve la descrivo con la mail di Paolo…
due papà che si scambiano consigli per i propri figli

Ciao Ragazzo… sei mica già a dormire?
🙂
Stavo per mandarti una serie di messaggi iMessage… poi ho pensato che magari era meglio mandarti una email. 🙂
E ne approfitto… e metto anche tua sorellina in copia.

Volevo solo dirti che a scuola di F. (12 anni) stanno usando un programma interessante per insegnare a programmare.

Magari ti può interessare.

In pratica è un programma che non ti insegna un linguaggio… ma la logica.

E’ in java… un file .jar che lanci col doppio click (almeno sul mac).
Ti apre una finestra con due aree, a dx e a sx.

In una scrivi, nell’altra vedi.

conosce una serie di figure… scrivi il nome ed appare l’immagine.
Poi però puoi comporre le immagini tra loro con i caratteri $ e &.
Col primo li affianchi orizzontalmente, col secondo li metti uno sull’altro.

Il progetto e dell’università di Oxford, didatticamente interessante per alcune modalità di lavoro ricorda OpenSCAD.
Non fatevi trarre in inganno dal design essenziale dell’applicazione, se ne avete l’occasione provatelo, secondo me vale la pena utilizzarlo in un percorso di Coding.

Buon making a tutti.

Articoli correlati:

  1. DotBot al Politecnico di Torino nel corso di Algoritmi e Calcolatori
  2. I miei corsi per La Tecnica della Scuola – Seconda edizione di: Starter kit delle competenze digitali
  3. Seminario formativo: a Scuola con i Robot
  4. I miei corsi per La Tecnica della Scuola “Terza edizione di: Starter kit delle competenze digitali”
  5. ROB-O-COD

Formattazione del testo con Markdown

Lascia una risposta

markdown
È questo il periodo dell’anno che dedico parte del tempo al pensiero creativo in cui cerco strategie diverse per migliorare il mio lavoro.
Ho deciso di riprendere la tradizione incominciata qualche tempo fa di scrivere gli articoli non solo per i miei studenti, ma anche per me 🙂 in modo che possa conservare in maniera ordinata informazioni che posso riprendere per la mia formazione e organizzazione.

Nella lunghissima lista dei ToDo trovo la nota: “imparare ad usare il Markdown per velocizzare la scrittura di documenti su internet“.

Procedo… seduto all’ombra di un albero con l’iPad sulle gambe.

Estraggo l’elemento dal ToDo e ne costruisco una mappa mentale che mi consente di progettare e pensare a “a ruota libera“.

Ma cos’è il Markdown?

Tutto nasce dall’esigenza di poter scrivere in ogni luogo con qualsiasi strumento, in modo rapido, senza vincoli tecnologici legati allo strumetto hardware o software, in breve concentrarsi sul contenuto.

Markdown è un linguaggio di markup creato da John Gruber e Aaron Swartz che consente a blogger e scrittori di ogni tipo di scrivere testi in maniera veloce utilizzando una sintassi estremamente semplice ed efficace permettendo poi di convertire i testi in (X)HTML immediatamente fruibile senza la paura di dimenticare la chiusura di tag HTML o fare errori di scrittura di tag.

Continua a leggere→

Articoli correlati:

  1. Documentare la didattica con la sintassi Markdown su GitHub