Web

A Compromís utilitzem una sèrie de ferramentes pròpies per a desenvolupar les nostres pàgines web. A aquest paquet de ferramentes l'anomenem Blobby. A continuació hi ha una documentació i una guia de com emprar-les.

Aquesta part de la guia d'estil requereix tindre coneixements en desenvolupament web i és només per a crear pàgines altament personalitzades. Si el que vols és una web per al teu col·lectiu local, posa't en contacte amb web@compromis.net

Blobby

Blobby és el nom de la llibreria d'interfície d'usuari de Compromís, ideada per a crear pàgines i aplicacions web que segueixen el manual d'estil de Compromís. En aquesta guia dividim Blobby en dues parts: per una banda, les utilitats , que és com li diem al a les variables CSS i SASS i les classes CSS del projecte; i per l'altra, els components basats en Vue, que permeten incloure amb facilitat elements de la interfície d'usuari ja estilitzats i personalitzables.

Instal·lació

Per incloure Blobby al teu projecte recomanem importar-lo amb un gestor de paquets com yarn o npm

yarn add @compromis/blobby
npm install @compromis/blobby

Importar Blobby i afegir el seu CSS a un projecte et permetrà usar les utilitats, però per emprar els components hauràs o bé d'importar Vue o bé treballar amb un projecte basat en Vue.

Nosaltres recomanem Nuxt, un framework basat en Vue que facilita la creació de webs estàtiques. Per a iniciar un projecte amb Nuxt primaer instala'l:

yarn create nuxt-app [nom-del-projecte] 
npm init nuxt-app [nom-del-projecte] 

A continuació, afegeix Blobby.

yarn add @compromis/blobby
npm install @compromis/blobby

Blobby utilitza Sass, recomanem afegir-lo per a tindre major control sobre el CSS.

yarn add -D sass-loader node-sass
npm install -D sass-loader node-sass

Si no estàs familiaritzat amb aquestes ferramentes recomanem llegir amb deteniment la seua documentació.

Documentació de Nuxt Documentació de Sass