italia / pianotriennale-ict.italia.it

Sito Piano Triennale ICT

PIANO TRIENNALE PER L’INFORMATICA NELLA PUBBLICA AMMINISTRAZIONE 2019 - 2021

Questo repository contiene il codice sorgente del sito tematico relativo al Piano Triennale per l'informatica nella pubblica amministrazione. Il sito è sviluppato con Jekyll.

Se vuoi contribuire allo sviluppo del sito, è sufficiente aprire una pull-request.

Sito tematico di presentazione del Piano Triennale

https://pianotriennale-ict.italia.it/

Forum di discussione sui temi del Piano Triennale

https://forum.italia.it/c/piano-triennale/

Testo integrale del Piano Triennale

https://docs.italia.it/italia/piano-triennale-ict/pianotriennale-ict-doc/

Generazione del sito e pubblicazione

Prerequisiti

È necessario installare ruby, ruby-dev, ruby-bundler e nodejs.

Linux (Ubuntu)

Per installare Ruby:

$ apt-get install ruby-bundler
$ apt-get install ruby-dev

Istruzioni per installare nodejs

macOS

Istruzioni per installare nodejs su macOS

Installazione delle dipendenze

Per configurare un ambiente di sviluppo è sufficiente eseguire i seguenti comandi nella directory principale del progetto:

$ bundle install
$ npm install

Come generare automaticamente il sito mentre si lavora sui contenuti o la struttura

Jekyll prevede la possibilità di generare automaticamente il sito ogni volta che viene fatta una modifica.

Questo può essere fatto tramite il comando serve:

$ bundle exec jekyll serve

Oltre a generare il sito, questo comando pubblica il sito in locale all'indirizzo web http://localhost:4000.

Come generare il sito per la pubblicazione

La generazione del sito per la pubblicazione richiede un po' più di tempo poiché comprende una serie di ottimizzazioni che rendono il sito più leggero ed efficiente.

In questo caso la generazione viene fatta tramite gulp:

$ gulp build

Il risultato della generazione di troverà nella directory _site.

Pubblicare il sito

Per pubblicare il sito è necessario creare un file .pianotriennale-ict_site.json nella propria home directory con questo formato:

{
  "production": {
    "server": "...",
    "path": "...",
    "port": ...
  },
}

Dove server è nel formato user@host, path è il percorso completo alla directory di pubblicazione e port è la porta SSH per accedere al server (la pubblicazione avviene tramite rsync via SSH).

---

THREE-YEAR PLAN FOR ICT IN PUBLIC ADMINISTRATION 2019 - 2021

This repository contains the source code for the descriptive website about the Three-Year Plan for ICT in Public Administration. This website is based on Jekyll.

If you want to contribute to the development, just go on and open a pull-request.

Descriptive website about the Three-Year Plan

https://pianotriennale-ict.italia.it/

Discussion forum

https://forum.italia.it/c/piano-triennale/

Full text of the Three-Year Plan

https://docs.italia.it/italia/piano-triennale-ict/pianotriennale-ict-doc/

Build and deployment

Prerequisites

Install ruby, ruby-dev, ruby-bundler and nodejs.

Linux (Ubuntu)

Install Ruby:

$ apt-get install ruby-bundler
$ apt-get install ruby-dev

Instructions about installation of nodejs

macOS

Instructions about installing nodejs on macOS

Dependencies

In order to set-up a development environment just run the following commands within the project root directory:

$ bundle install
$ npm install

Automatic rebuild

Jekyll allows to rebuild automatically while editing files. See documentation for the serve command:

$ bundle exec jekyll serve

In addition, serve will run a local webserver at http://localhost:4000.

Build for publishing

In order to build website for deployment a few additional optimizations are run for lightness and efficiency. For such purpose, use gulp:

$ gulp build

Results will be placed in the _site/ directory.

Deployment

In order to publish the website just create a file named .pianotriennale-ict_site.json under your home directory with the following format:

{
  "production": {
    "server": "...",
    "path": "...",
    "port": ...
  },
}

Where server has the format user@host, path is the full path to the deplyment directory and port is the SSH port to access the server (rsync over SSH will be used).

pianotriennale-ict.italia.it's Issues

Add circleci build

It'd be great to have circleci build enabled on this project.

tracking google analytics non funzionante

Vi segnalo che il tracciamento dei dati del sito con Google analytics è fermo dal 27 gennaio 2018 @pdavide @vito80ba

Sostituzione email info@agid in privacy policy

Ciao, poichè la mail [email protected] sta per essere disabilitata, andrebbe sostitutita con [email protected] in questa pagina
https://pianotriennale-ict.italia.it/privacy-policy/

Add sitemap.xml

• Add 'jekyll-sitemap' gem to Gemfile
• Add ' - jekyll-sitemap' to the list of gems in _config.yml
• Remove unneeded HTML files
• Generate sitemap.xml (JEKYLL_ENV=production bundle exec jekyll build) and make sure the hostname is correct
• Copy the generated sitemap.xml file to the production environment

Json feed - linee d'azione

We shall provide a JSON feed that gets built periodically and reflects what is displayed on our website at the following link: https://pianotriennale-ict.italia.it/azioni/

Such page is generated from the following YAML file: https://github.com/italia/pianotriennale-ict.italia.it/blob/master/_data/linee_azione.yml

Ideas:

• Similar to what's been built here, we can probably rely on Liquid without having to write any plugins and Ruby code.
• Otherwise, if the data is an array or hash we can directly use the jsonify filter filter to convert it to JSON. I'd probably also rely on the smartify filter to sanitize it further.

The feed's permlink should be easy to remember, eg. /azioni/azioni.json

Additional references:

• Medium post "A caccia di date nel Piano Triennale per l’informatica nella Pubblica Amministrazione", by Andrea Borruso: https://medium.com/@aborruso/a-caccia-di-date-nel-piano-triennale-per-linformatica-nella-pubblica-amministrazione-2b355ce5cbd0

Mention required for the 'azioni.json' JSON file

Following the work done in #35 and given the fact that https://pianotriennale-ict.italia.it/azioni/azioni.json is now LIVE, we shall probably mention it somewhere under https://pianotriennale-ict.italia.it/azioni/ (a text label? an icon? no idea, to be honest.)

Adding og:image meta tag

The SEO section of the meta tags lacks an og:image

Also, in config.yml we currently have logo: /assets/images/logo-it.svg
but I think SVG is not good for open graph so we need to add an alternate format.