Vai al contenuto

Home⚓︎

Raccolta di appunti, file, slides, etc. relativi al corso di Informatica L31, dell'Università di Bari "Aldo Moro".

Attenzione

Gli appunti sono in fase di stesura e cambiano continuamente.

Utilizzo offline⚓︎

Per poter sfogliare gli appunti offline bisogna innanzitutto clonare la repository dopodiché, utilizzando Mask1:

mask bootstrap && mask build

Il sito sarà presente nella cartella ./site/ e lo si può sfogliare con un qualsiasi web browser aprendo il file index.md. La pagina visualizzata dovrebbe essere proprio questa.

Come contribuire⚓︎

Per contribuire:

  1. clonare la repository:

    git clone https://github.com/sRavioli/L31.git

    gh repo clone sRavioli/L31

  2. recarsi nella cartella (cd L31) e installare i pacchetti python richiesti (richiesti: python e mask):

    mask bootstrap

  3. avviare il server:

    mask serve --dirty

    Verrà fatto partire un server al link http://localhost:8000/L31 che ospiterà gli appunti. L'opzione --dirty permette di avere dei tempi di caricamento più brevi poiché mkdocs compilerà solo la pagina corrente. Per interrompere il server bisogna premere Ctrl+C.

  4. effettuare le modifiche;

  5. creare un nuovo ramo con Git:

    git checkout -b feat/nuova-feature

    effettuare gli eventuali commit sullo stesso

    git commit -m "feat: add new feature"

    effettuare il push del nuovo ramo:

    git push -u origin feat/nuova-feature

  6. recarsi su GitHub e aprire una pull request.

Keymaps⚓︎

Il sito possiede della mappature dei tasti personalizzate:

  • H e L – naviga verso la pagina precedente e verso la successiva (se) esistono);
  • K e J – scorri verso l'alto e verso il basso;
  • G e Shift+G – scorri verso l'inizio e verso la fine della pagina;
  • Shift+K e Shift+J – naviga verso l'intestazione precedente e verso l'intestazione successiva;
  • Shift+H – torna alla pagina principale.

  1. Nel caso in cui non sia possibile usare mask, è possibile eseguire manualmente i due script. Bisogna aprire il file maskfile.md, e recarsi nelle sezioni ## bootstrap e ## build e eseguire i comandi lì presenti, esclusi i messaggi (mask msg ... "..."). ↩