BicoccaHUB

La più grande collezione di appunti del corso di informatica degli studenti della Bicocca

🚀 Quick start

Clona i sorgenti.

Usa il comando git clone per clonare i sorgenti del sito

# Clona la repository mediante Git
git clone https://github.com/BicoccaHUB/bicoccahub.git

Intalla le dipendenze.

Naviga nel sito e installa le dipendenze necessarie mediante NPM
```
cd bicoccahub/
npm install
```
Inizia a sviluppare.

Avvia il server di sviluppo con il comando gatsby develop
```
gatsby develop
```
Inizia a modificare il sorgente!

La versione in sviluppo del sito è accessible a http://localhost:8000!

Nota: Avrai bisogno anche di un secondo link: http://localhost:8000/___graphql. È uno strumento che puoi usare per fare query sui dati. Per saperne di più, controlla questo Tutorial Gatsby.

Apri la cartella my-default-starter con il tuo editor prefereito e modifica il file src/pages/index.js. Salva e vedrai i tuoi cambiamenti immediatamente visibili!

🧐 Come modifico il sito?

Ecco una rapido sguardo ai file e cartelle principali che trovi in un progetto Gatsby.

.
│
└┬─ src
 └┬─ data
  ├── staff.yml
  └── subjects.yml

staff.yml: Questo file contiene i dati relativi alle persone che hanno contribuito, diviso in varie sezioni (coders, autori e ringraziamenti speciali)
subjects.yml: Questo file contiene i dati relativi agli indirizzi degi repository contenenti gli appunti. Il file è diviso per anno e per materie. Ogni materia successivamente contiene i vari repositori (indirizzo, autore e se sono in corso di sviluppo)

🎓 Aggiunta di una repository

Come specificato nella sezione precedente, il file da modificare per aggiungere nuove repository è il file subjects.yml, che è scritto mediante la sintassi di YAML

- year: <Anno del corso>
  subjects:
    - name: <Nome del corso>
      repositories:
        - owner: <Nome utente>
          url: <L'indirizzo della repository>

Per aggiungere un nuovo repository sarà quindi sufficiente seguire lo schema sopra citato seguendo le corrette regole di spaziatura, aggiungendo un record di questo tipo:

- owner: <Il tuo nome utente>
  url: <L'indirizzo della tua nuova repository>

ottenendo quindi il seguente risultato

- year: <Anno del corso>
  subjects:
    - name: <Nome del corso>
      repositories:
        - owner: <Nome utente>
          url: <L'indirizzo della repository>
        - owner: <Il tuo nome utente>
          url: <L'indirizzo della tua nuova repository>

Prima di inviare una pull request è necessario accertarsi che il sito compili senza nessun error e possibilmente senza nessun warning.

Ulteriori guide sono disponibili all'indirizzo https://bicoccahub.netlify.com/contribuisci