Proof of concept of Eta-Kappa-Notes integration

[eduardz1]

Questa è una proof of concept di come potrebbe avvenire l'integrazione del progetto Eta-Kappa-Notes all'interno del sito. La PR non è assolutamente pronta e come potete vedere gli appunti di Reti che sto scrivendo sono completamente rotti, questo perché il file HTML è stato ottenuto brutalmente convertendo il PDF in DOCX con Adobe Acrobat e successivamente in HTML con pandoc. Le immagini sono embedded.

Apro la PR per iniziare una discussione a riguardo.

Video_2024-11-27_12-44-50.mp4

Non sono familiare con la codebase quindi modificate pure se vedete qualcosa che non vi piace, in particolare riguardo al CSS.

[antox01]

Per quanto mi riguarda sembra una buona bozza, mi piace soprattutto la parte con il menù a selezione delle note che si vuole leggere. L'unica cosa che non sono proprio tanto convinto è l'embeddare totalmente il tutto sul sito, si potrebbe invece dare giusto la possibilità di dare un link al download e chi vuole si scarica il pdf direttamente da lì.

[eduardz1]

Per quanto mi riguarda sembra una buona bozza, mi piace soprattutto la parte con il menù a selezione delle note che si vuole leggere. L'unica cosa che non sono proprio tanto convinto è l'embeddare totalmente il tutto sul sito, si potrebbe invece dare giusto la possibilità di dare un link al download e chi vuole si scarica il pdf direttamente da lì.

La mia idea è di avere entrambe le opzioni, non ho avuto più tempo di refinirlo ma un pulsante download sarà sempre presente in hover sopra gli appunti. Rendere gli appunti (che dopo un po' di ragionamenti in realtà sul sito meglio dividerli ulteriormente per materia per ridurre il nesting degli header) disponibili come HTML permette il seguente:

• Migliore accessibilità: rispetto a PDF, HTML ci permette di avere maggior supporto per screen reader per studenti con problemi di vista. So che se ne parla e ci sono progetti interni al poli su come rendere più accessibili le lezioni, renderla già un'opzione fin dal principio ci distingue e rende più semplice la gestione rispetto ad una integrazione futura
• Responsiveness: i PDF non sono responsive, non c'è molto da aggiungere. Integrazione anche in HTML rende possibile leggere i nostri appunti da telefono in maniera molto più comoda. I tablet in particolare sono molto popolari per leggere appunti ed anche lì la responsiveness aiuta
• Pubblicità: aumentare il traffico sul sito non può che aiutarci come associazione. Certo nei PDF avremo il logo e tutto ma ipotizzo che avere persone fuori dall'associazione che utilizzano il sito per leggere appunti ci aiuti a pubblicizzarci almeno tanto quanto avere il logo in prima pagina nei PDF. Senza contare il fatto che le pagine dei singoli corsi con un po' di SEO potrebbero arrivare a comparire nei search results anche per persone esterne al poli, che sarebbe una gran cosa
• Interattività: è un'idea molto ottimista e ci vorrà realisticamente un bel po' ma in futuro mi immaginavo un sistema di commenti abbastanza integrato con il testo, penso sarebbe utile se i lettori potessero aggiungere commenti a certe sezioni per chiarire imprecisioni che sicuramente ci saranno. È vero esistono gli issue su GitHub ma fuori da informatica lo studente medio non è molto familiare col sistema

L'integrazione al momento è molto bruttina di aspetto, utilizza gli elementi già presenti nel sito. La mia idea è di renderla molto più "plain", testo nero su sfondo bianco, come il pdf, niente grafiche attorno, lascerei giusto in hover il tasto download ed un tasto per tornare indietro.