Giter VIP home page Giter VIP logo

italia / developers.italia.it Goto Github PK

View Code? Open in Web Editor NEW
229.0 35.0 116.0 1.63 GB

The developer community designing and developing public digital services in Italy

Home Page: https://developers.italia.it

License: BSD 3-Clause "New" or "Revised" License

Ruby 1.62% HTML 42.49% CSS 2.07% JavaScript 33.91% Makefile 0.36% Dockerfile 0.18% Shell 0.09% SCSS 19.28%
developers community italy government floss developers-italia hacktoberfest website

developers.italia.it's Introduction

Developers Italia


We develop public services, together

Description

Developers Italia is the reference point for the community of developers creating the next generation of digital public services in Italy.

This repository contains the sources of the website. The website is developed using Jekyll.

A GitHub action job builds the sources, getting some data from developers.italia.it-data, and commits the resulting artifacts to the gh-pages branch. The job is also triggered every night to get the latest data.

Documentation

Development

We use Docker and docker-compose to bring up the developer environment, just clone the repo and

  1. Copy the .env.example file into .env and modify the environment variables as it suits you. .env.example holds the detailed description of each variable.

    cp .env.example .env
  2. Set the RUNAS variable to your user:

    echo RUNAS=$(id -u):$(id -g) >> .env
  3. Build the container:

    docker-compose up

Wait until the Docker logs explicitly say that the website is served at 0.0.0.0:4000 and navigate to http://localhost:4000 to preview the website.

Jekyll will pick up changes to the Markdown files and recompile them on the fly.

If you change the Gemfile or package.json, you'll need to rebuild the image with:

docker-compose up --build

Makefile

Both the build and the Docker files leverage a Makefile, facilitating the execution of more complex routines. You can have a look at the Makefile to know more about the exact commands used to build the website.

Community

Code of Conduct

Please review our Code of Conduct to ensure a great collaboration with the rest of the community.

Contributing

Developers Italia exists also thanks to your contributions! Here is a list of users who already contributed to this repository:

This list is also displayed in the Developers Italia website.

Every contribution is welcome! However, before proceeding further please take a look at our contributing guidelines.

License

Copyright© 2018-present - Presidenza del Consiglio dei Ministri

The source code is released under the BSD license (SPDX code: BSD-3-Clause) and it's distributed with this license since May 30th 2018.

The previous code has been released under under the MIT license.

developers.italia.it's People

Contributors

alranel avatar ameybh avatar astagi avatar bfabio avatar chiarafauda-wellnet avatar dependabot-preview[bot] avatar dependabot-support avatar dependabot[bot] avatar emiliosp avatar francescomda avatar francescopog avatar francescozaia avatar gesposito avatar gmereu avatar gvarisco avatar iceonfire avatar ioggstream avatar libremente avatar lucaprete avatar lussoluca avatar matteovaba avatar mfortini avatar peppelinux avatar r3vit avatar rasky avatar ruphy avatar sbronzolo avatar sebbalex avatar vito80ba avatar zukka77 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

developers.italia.it's Issues

Introduzione breadcrumb

Introduzione breadcrumb nel rispetto dell'albero di navigazione del sito, come segue
cc @rasky

In ogni stringa l'ultimo elemento dell'alberatura non è cliccabile

Home / Progetti
https://developers.italia.it/it/progetti/

Home / Progetti / Spid

Home / Notizie / Titolo news

Home / FAQ

Home / Contatti

Home/ Strumenti
(manca pagina, da creare)

Home / Strumenti / Docs

Home / Strumenti / Forum

vedi esempi
esempio_1_bread_crumb

schermata 2017-04-04 alle 16 12 01

html-proofer warnings

bundle exec htmlproofer ./_site --check-html --allow-hash-href --empty-alt-ignore --only-4xx --disable-external introduced in #68 reports:

Ran on 30 files!


- ./_site/en/18app/index.html
  *  internally linking to /en/note-legali, which does not exist (line 818)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 815)
     <a href="/en/privacy-policy">Privacy policy</a>
- ./_site/en/anpr/index.html
  *  internally linking to /en/note-legali, which does not exist (line 846)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 843)
     <a href="/en/privacy-policy">Privacy policy</a>
- ./_site/en/cie/index.html
  *  internally linking to /en/note-legali, which does not exist (line 818)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 815)
     <a href="/en/privacy-policy">Privacy policy</a>
- ./_site/en/credits/index.html
  *  internally linking to /en/note-legali, which does not exist (line 1618)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 1615)
     <a href="/en/privacy-policy">Privacy policy</a>
- ./_site/en/datigov/index.html
  *  internally linking to /en/note-legali, which does not exist (line 857)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 854)
     <a href="/en/privacy-policy">Privacy policy</a>
- ./_site/en/faq/index.html
  *  internally linking to /en/note-legali, which does not exist (line 885)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 882)
     <a href="/en/privacy-policy">Privacy policy</a>
- ./_site/en/fatturapa/index.html
  *  internally linking to /en/note-legali, which does not exist (line 818)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 815)
     <a href="/en/privacy-policy">Privacy policy</a>
- ./_site/en/index.html
  *  internally linking to /en/note-legali, which does not exist (line 1199)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 1196)
     <a href="/en/privacy-policy">Privacy policy</a>
- ./_site/en/pagopa/index.html
  *  internally linking to /en/note-legali, which does not exist (line 818)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 815)
     <a href="/en/privacy-policy">Privacy policy</a>
- ./_site/en/projects/index.html
  *  internally linking to /en/note-legali, which does not exist (line 1294)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 1291)
     <a href="/en/privacy-policy">Privacy policy</a>
- ./_site/en/spid/index.html
  *  internally linking to /en/note-legali, which does not exist (line 872)
     <a href="/en/note-legali">Terms and conditions</a>
  *  internally linking to /en/privacy-policy, which does not exist (line 869)
     <a href="/en/privacy-policy">Privacy policy</a>
htmlproofer 3.7.2 | Error:  HTML-Proofer found 22 failures!

Some pages are indexed twice

The page /it/come-partecipo is indexed twice in Elasticsearch.

I suspect it may be seen by Searchyll both as a "document" and as a "post" (see searchyll.rb).

Errore Redirect Logo

Cercando di ritornare alla home dalla pagina Errori Anpr, cliccando sul logo .it si viene rediretti ad una pagina di errore 404 anziché alla homepage effettiva.

Steps per riprodurre:

  • Recarsi sulla pagina ANPR
  • Cliccare su tabella codici ed errori
  • Nella pagina aprire il menú 'errori' e selezionare una delle due opzioni
  • Cliccare sul logo
  • Errore 404

Docker build failing (new-version-master)

Docker build fails with the following output:

Step 7/19 : RUN cd /go/src/$PROJECT && go get -u github.com/golang/dep/cmd/dep && dep ensure
 ---> Running in 1a63a6a707ca
root project import: dep does not currently support using GOPATH/src as the project root
The command '/bin/sh -c cd /go/src/$PROJECT && go get -u github.com/golang/dep/cmd/dep && dep ensure' returned a non-zero code: 1

Version:

# docker --version
Docker version 17.09.0-ce, build afdb6d4

Alcune modifiche alle issues mostrate nella pagina "da fare"

  1. le uniche issues mostrate nella tabella (o equivalentemente, scaricate da github) sono quelle che hanno l'etichetta "help wanted". dunque la label "help wanted" diventa un modo con cui qualunque sviluppatore in "italia" marca la task per essere pubblicate
  2. i "tipi", la cui visualizzazione può essere controllata tramite caselle di spunta, dovrebbero essere sempre mostrati in qualche modo con la task, o differenziandola (tipo con un'iconcina, o colore, o simile; opzione preferita perché meno invasiva), oppure con una label

Creazione di una pagina contatti

Content design per creazione di una pagina di contatti
@rasky

La pagina è organizzata in capitoli e utilizza il menù contestuale come strumento di navigazione

I contenuti sono statici, a parte un widget per twitter e un feed per gli ultimi comunicati stampa

I testi sono già quasi tutti a posto, mancano alcuni indirizzi cui rimandare gli utenti

Va data la possibilità di scaricare foto "ufficiali" e logo, da preparare

https://developers.italia.it/it/contatti/

In allegato il wireframe
schermata 2017-04-06 alle 16 52 51

Zoom
Uploading Schermata 2017-04-06 alle 16.54.13.png…
Uploading Schermata 2017-04-06 alle 16.54.02.png…

Liquid 4.0 syntax errors

I've started working on jekyll-3.5.x upgrade in a separate branch. When building the site with Liquid 4.0, we get a few warnings:

Liquid Warning: Liquid syntax error (line 3): Expected end_of_string but found id in "{{site.projects where: 'lang', active_lang | sort 'order' | reverse }}" in /_layouts/credits.html
Liquid Warning: Liquid syntax error (line 21): Expected end_of_string but found string in "{{site.projects | where: 'lang', active_lang | sort 'order' | reverse }}" in /_layouts/projects.html
Liquid Warning: Liquid syntax error (line 3): Expected end_of_string but found id in "{{site.projects where: 'lang', active_lang | sort 'order' | reverse }}" in /_layouts/credits.html
Liquid Warning: Liquid syntax error (line 21): Expected end_of_string but found string in "{{site.projects | where: 'lang', active_lang | sort 'order' | reverse }}" in /_layouts/projects.html

Voci di menù da eliminare "Progetti in evidenza" e "Dove partecipare"

Sia nel menù “progetti” sia “in strumenti” è presente un ulteriore livello di navigazione che non era previsto e che penalizza decisamente la navigazione in ambito mobile.
Clicco su “progetti” e vedo “progetti in evidenza”. Devo cliccare di nuovo per vedere la lista dei progetti.
Per questo motivo vanno eliminati sia “Progetti in evidenza” sia “Dove partecipare”.
Va lasciata la voce “Tutti i progetti”

Riformulare pagina Chi Siamo

Riformulare pagina Chi siamo per dare risalto a tutte le persone coinvolte sui vari progetti: maintainers, project leader, contributori...

  1. Elaborare proposta grafica
  2. Verificare capacità di ottenere dati dai progetti github

Pagina "Cosa fare"

Aggiungiamo una pagina "Cosa fare" che elenchi un subset di tutte le issue aperte in tutti i repositori GitHub di Developers Italia.

In particolare, la pagina deve mostrare del testo iniziale di introduzione, e poi una tabella che contenga dei "record" composti da:

  • Titolo della issue (con link verso Github)
  • Eventuali label della issue
  • Titolo del sotto-progetto (cioè del progetto GitHub, es: Plugin Wordpress di SPID). NOTA: questo non è il nome git del repositorio GitHub, è il titolo descrittivo associato che si può inserire dentro github.
  • Titolo del progetto di riferimento (es: SPID). Questo può essere dedotto dal prefisso del nome del repo su GitHub (es: spid-wordpress -> SPID).

Inoltre, deve essere possibile filtrare per:

  • Progetto (es: SPID).
  • Sottoprogetto (non è prioritario).
  • Tecnologia (sottoinsieme delle label su GitHub che indica la tecnologia di riferimento, es: tech-php).
  • Difficoltà (sottoinsieme delle label su GitHub che dà una stima di massima della complessità del task, es: diff-easy).
  • Tipologia (sottoinsieme delle label, es: "feature" o "bug")

Do not index individual FAQs

As of now, FAQs are indexed automatically. But they point to URLs like /faqs/it/40.yml which do not exist as we only render a single page containing all of them.

Pagina "Chi siamo"

  • Verificare se opportuno lasciare Carlo C. come "mantainer"
  • Ercolani: modfiicare/cambiare foto

Metriche per dashboard

Con l'obiettivo di arrivare ad una dashboard di monitoraggio della community, iniziamo a scrivere un tool che raccolga alcune informazioni a livello numerico e le invii ad un'istanza di statsd:

GitHub:

  • Numero progetti attivi
  • Interazioni su GitHub (issue / PR)

Discourse:

  • Numero post sul forum
  • Iscritti al forum

Mailup:

  • Iscritti alla newsletter

Feed RSS non funzionante

L'XML prodotto da jekyll-feed è errato nel caso si imposti l'attributo lang nel post; manca uno spazio prima dell'attributo lang nel tag <entry>

La version 0.9.2 di jekyll-feed fissa questo bug

Presenza sui social e icone su sito

Sviluppando il front-end per la nuova versione del sito disegnata da @spizzichi mi sono accorto che nella intestazione sono presenti i seguenti socials: facebook, github e twitter.
Mentre nell'attuale sito ci sono twitter e medium.
Quale devo inserire?

url newsletter

developers.italia.it/_faqs/it/40.yml Inserire link alla newsletter @rasky me lo dai?

Mancanza meta open graph

Mancano i metatags og nell'head, andrebbero inseriti per migliorare la diffusione del sito sui social

Introduzione menù nelle sezioni docs e forum

  • Problemi*

in allego ipotesi di architettura dell'informazione e struttura navigazione
@matteodesanti

*navigazione desktop *

  • introdurre nelle wl un menù identico a quello del sito nelle funzionalità, ma di forma ridotta per non appesantire la navigazione della sezione docs. e di quella forum (trattandosi di whitelabel, ereditano la navigazione verticale del prodotto originario)
  • nel menù, inserire nome della sezione ben evidente in modo da garantire accesso rapido alla home della wl (viste le sue specificità)
  • navigazione mobile*
  • si propone di spostare hamburger menu a sinistra in tutto il sito
  • limitatamente alle white label, si propone di inserire il nome della wk nel menù
  • limitatamente alle white label, mantenere lo spazio a destra per la navigazione contestuale (area personale, search e altre funzioni specifiche della wl)

studio_menu_sito_e_wl

Fattura elettronica

Salve, vorrei integrare nel gestionale che stiamo progettando un sistema di invio automatico della fattura elettronica che pare diventi obbligatoria per tutti dal 2019, ma il funzionamento non ci è ben chiaro, c'è qualcuno che possa darci una mano?

API pages are not indexed

Searchyll does not index pages generated by data_page_generator.rb.

This repository contains a modified data_page_generator.rb (upstream here) that allows to add default data values to generated pages (we need lang and type).

Creazione Stack Overflow tags

as seen on https://forum.developers.italia.it/t/stack-overflow-meta-e-tag/229

Riporto un riassunto.

Per evitare di riempire il forum di Q&A alla Stack Overlflow possiamo andare ad indicare nei manuali che se si ha una domanda per uno dei macrotemi(eg. SPID, ANPR, dati.gov.it, ...) si puo' procedere aprendo la domanda su SO aggiungendo il tag correlato.

Per iniziare bisogna decidere il naming, una prima proposta e' di utilizzare come macrotag "dit" che potrebbe stare per "Developers Italia" e da quello partire a generare un tag per ogni macrotema:

  • dit-spid
  • dit-anpr
  • dit-dati
  • dit-cie
  • dit-pagopa
  • dit-fatturapa
  • dit-18app

Per esempio una classica domanda "Cosa vuol dire saml.Exception24567 in Assertion durante AuthnRequest" sara' taggata con "dit" e "dit-spid", inoltre magari ci aggiunge anche altri tag gia' esistenti su SO tipo "java", cosi magari se il problema non e' tanto legato a "dit-spid" ma e' un problema java e' molto probabile che dall'altra parte del mondo qualcuno risolva determinate domande.

In questo modo, seguendo le classifiche di Stack Overflow, si potranno identificare dei champion sulle varie tematiche e puo' essere considerato anche un buono specchio mediatico per tutto cio' che ruota attorno a developers italia.

Per aprire un tag nuovo serve almeno 1500 di reputazione, attualmente ne ho 800, penso non sia un problema arrivare a 1500 oppure trovare qualcuno che gia' ce l'ha.
selection_609

Le regole per il tagging si SO sono qua

http://stackoverflow.com/help/tagging

Il tag "dit" e' libero, si possono controllare da qua i tag utilizzati

http://stackoverflow.com/tags

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.