Sito Piano Triennale ICT
Clone or download
Latest commit aa71772 Nov 1, 2018

README.md

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

CircleCI

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://pianotriennale-ict.readthedocs.io/

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 2017 - 2019

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://pianotriennale-ict.readthedocs.io/

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).