Secondo bando 2022 per progetti dei volontari/Integrazione del Wikisource book reader in tutti i progetti Wikisource
Responsabile del progetto
Alexander Albore
Titolo del progetto
Integrazione del Wikisource book reader in tutti i progetti Wikisource
Partecipanti
- Ruthven. Sono utente di Wikipedia in italiano dal 2004, amministratore su it.wikisource, nap.wikisource, Wikipedia in italiano e Commons, oltre ad essere amministratore VRTS della Foundation.
- Sam Wilson / SWilson (WMF) : Software Engineer, membro del Community Tech della Wikimedia Foundation. Ha elaborato il nuovo strumento OCR per Wikisource e segue le estensioni dei vari progetti. Sarà il supervisore tecnico di questo grant: la WMF lo ha "messo a disposizione", cofinanziando i lavori di questo progetto.
- Jay Prakash: svikuppatore, Lead Developer del Indic-TechCom, co-fondatore del Indic MediaWiki Developers User Group, membro ausiliario del Wikimedia technical Code of Conduct e Amministratore dell'interfaccia globale.
Il progetto è supportato e proposto dal Wikisource User Group.
Descrizione del progetto
Wikisource Book Reader è uno strumento Toolforge ospitato su https://bookreader.toolforge.org. Questo strumento è sviluppato in collaborazione con il lettore di libri di Internet Archive. Esempio del suo uso: https://bookreader.toolforge.org/bn/Intermediate_Bengali_Selections.pdf#mode/2up
Questo strumento è stato integrato nel progetto Wikisource in lingua indi ed è stato usato su le pagine Indice. Esempio: _https://bn.wikisource.org/wiki/ন:ির্ঘণ্ট_রায়_সুকুমার-রচনাবলী_খন্ড.djvu (Cliccare sulla seconda icona da in alto a destra). Attualmente, questo strumento è limitato alla comunità di Indi Wikisource. Però numerosi altri progetti vorrebbero beneficiarne, come Wikisource in napoletano oppure in altre lingue locali italiane. Per ciò, il tool ha bisogno di essere aggiornato. Oltre a ciò, il progetto prevede dei aggiungere caratteristiche come il login dell'utente, suggerimenti di libri da leggere, e l'aggiornamento dell'interfaccia utente (UI).
Abstract
Il progetto prevede il miglioramento e l'estensione del Wikisource Book Reader (https://bookreader.toolforge.org) affinché possa essere utilizzato in tutti i progetti Wikisource.
Richiesta di sostegno economico
Le spese previste sono quelle di sviluppo del software. Lo sviluppatore che abbiamo identificato è Jay Prakash (4816€ IVA inclusa sul calcolo di ore necessarie da parte di Jay). Sam Wilson, del Tech Group della WMF seguirà il progetto come supervisore tecnico, ma il suo stipendio è versato dalla WMF come cofinanziamento di questo progetto.
Non sono previsti compensi a soci di WMI.
Altre richieste
no.
Descrivi in breve e per punti le attività che intendi svolgere. Precisa i tempi nei quali iniziano e finiscono.
Sviluppo:
Attualmente, questo strumento è limitato alla comunità di Indi Wikisource. Però numerosi altri progetti vorrebbero beneficiarne, come Wikisource in napoletano oppure in altre lingue locali italiane. Per ciò, il tool ha bisogno di essere aggiornato. Oltre a ciò
- 1. Aggiunta delle opzioni di login dell'utente tramite OAuth - un protocollo di rete aperto e standard, progettato specificamente per lavorare con l'Hypertext Transfer Protocol (HTTP).
- 2. Aggiunta dell'opzione di suggerimenti di libri da leggere.
- 3. Aggiornamento dell'interfaccia utente (UI).
- 4. Raccolta di feedback da parte dell'User Group e degli utenti di Wikisource.
- 5. Adattamento del codice del software in modo tale che sia utilizzabile su tutti i progetti Wikisource.
- 6. Beta testing e correzione bug.
- Dettagli tecnici:
- Backend: Python’s Flask
- Frontend: ReactJs or VueJS
- UI Component: MaterialUI o Vuetify
Sito git: The Internet Archive BookReader https://github.com/internetarchive/bookreader software rilasciato con licenza AGPL v3.
Il tuo progetto è il proseguimento di attività già svolte in passato, e/o è un progetto che potrebbe proseguire in futuro? Sviluppo e estensione del The Internet Archive BookReader usato su Indic Wikisource. Vedi https://phabricator.wikimedia.org/T307539
Budget
| Tipo di spesa ammissibile | Descrizione | Spesa prevista (IVA compresa) | Fornitore |
|---|---|---|---|
| Compensi a professionisti | Implementazione | 4816 | Jay Prakash |
Importo richiesto a Wikimedia Italia (IVA compresa)
4816
Budget totale del progetto (IVA compresa)
4816€ + stipendio di Sam Wilson pagato dalla WMF in quanto cofinanziatore del progetto.
Relazione
Finanziamento accordato
- Spese previste: 4816 €
- Spese effettuate: 4700 € (il progetto ha richiesto meno ore di lavoro del previsto)
Attività svolte
- Aggiunta delle opzioni di login dell'utente tramite OAuth - un protocollo di rete aperto e standard, progettato specificamente per lavorare con l'Hypertext Transfer Protocol (HTTP).
- Aggiunta dell'opzione di suggerimenti di libri da leggere.
- Aggiornamento dell'interfaccia utente (UI) usando Vuetify.
- Raccolta di feedback da parte dell'User Group e degli utenti di Wikisource.
- Adattamento del codice del software in modo tale che sia utilizzabile su tutti i progetti Wikisource.
- Beta testing e correzione bug.
Obiettivi raggiunti
1. Nuovo BookReader: https://bookreader.toolforge.org
2. Phabricator task: https://phabricator.wikimedia.org/T307539
3. Codice sorgente: https://gerrit.wikimedia.org/g/labs/tools/bookreader
4. Documentazione: https://meta.wikimedia.org/wiki/BookReader
Difficoltà incontrate
Adattamento necessario per via dell’uso di alcuni strumenti da parte del tool (Javascript, CSS, fonts, etc.) che fanno appello a siti esterni, come Google. Toolforge non permette alle app di usare servizi esterni, dato che trasmette l’indirizzo IP degli utenti a questi servizi. Si è dunque dovuto ricorrere a servizi anonimi o a una implementazione specifica onde evitare questo problema.
È stata integrata sin dall’inizio VueJS come libreria di frontend; seguendo quanto annunciato dalla Wikimedia Foundation che VueJS diventerà la libreria primaria di frontend per i progetti.
Alcuni documenti appaiono deformati. Questo è dovuto all’uso della librerira JavaScript di InternetArchive per il rendering. La cosa è stata segnalata agli sviluppatori.
Possibili sviluppi futuri
La fase di beta testing su tutte le piattaforme (in tutte le lingue e alfabeti) è necessariamente abbastanza lunga, in quanto i vari progetti Wikisource devono integrare il BookReader e poi chiedere alla comunità di usarlo. Questo lavoro di integrazione e adattamento rappresenta il principale obiettivo futuro del progetto.