© licenza CC BY

Cirospat MKDocs-style

Modello per la creazione di un progetto di documentazione online, creato con MKDocs. Le pagine per inserire contenuti vengono redatte utilizzando il linguaggio MarkDown (.MD).

Lavoro realizzato con il prezioso supporto tecnico di @gbvitrano, @aborruso e #opendatasicilia a cui va un caro ringraziamento e un grande grazie per la pazienza.

Compilazione con Github pages

GitHub ghpages

Link al progetto creato su pagine di Github

Documentazione con mkdocs

Strumenti integrati nel progetto

• Addthis per la condivisione sui social, e stampa pagine del progetto. Loghi social visualizzabili nella parte destra della pagina web su desktop e in basso su dispsitivi mobile. IL codice di Addthis si inserisce nel file main.html che si trova al seguente percorso mkdocs-style/docs/overrides/main.html
• Disqus per permettere di inserire commenti in ogni singola pagina, tranne nell'home page. L'istruzione per inserire il codice di Disqus viene data nel file mkdocs.yml
• Strumento di generazione dei contenuti del progetto in formato PDF, indicato in ogni pagina con il simbolo della stampante posizionato in alto a destra
• feed RSS per avere un link per gli aggiornamenti automatici dei contenuti del progetto di documentazione. L'istruzione per inserire l'integrazione dell feed RSS viene data nel file mkdocs.yml

Questi strumenti sono opzionali e possono non essere inclusi nella visualizzazione del progetto di documentazione online che si intende creare

Cosa deve cambiare l_utente per generare progetti di documentazione online con MKDocs a partire da questo modello

• i parametri del file mkdocs.yml
• i contenuti nel file index.md che si trova nella directory docs
• i contenuti dei file .md che si trovano dentro la cartella madre docs (ed eventualmente sotto cartelle) e che rappresentano il nome dei capitoli o sezioni del documento. Ogni file .md è la pagine web del progetto di documentazione
• inserire le immagini nella cartella img che si trova nel percorso mkdocs-style/docs/img/
• inserire il favicon che si trova al seguente percorso mkdocs-style/docs/overrides/.icons/favicon.png. E' facoltativo e non è importante.