Orari FSHN eshte nje aplikacion ne "command-line" qe gjeneron skedare kalendari (formati ICS) per studentet e Fakultetit te Shkencave te Natyres (FSHN). Ky program merr te dhena te orarit nga serveri i FSHN, perpunon HTML-ne dhe krijon skedare ICS qe mund te importohen ne aplikacione si Google Calendar, Apple Calendar, Outlook, etj.
- Gjenerim i ICS: Krijon skedare te kalendarit rreth orarit duke nisur nga data e krijimit deri ne fund te semestrit.
- Informacione te Detajuara: Per secilen ore shfaqet emri i lendes, profesori, email-i dhe klasa.
- Strukture Modulare: Projekt i ndare ne module per API, perpunim, gjenerator dhe funksione ndihmese.
- Interaktivitet: Perdor nje nderfaqe "command-line" me mesazhe me ngjyra per nje eksperience me vizuale dhe te kendshme.
Si fillim duhet te keni Node edhe git te instaluar.
-
Clone the repository:
git clone https://github.com/MrMuscleFreak/orari-FSHN.git cd orariFSHN -
Instaloni packages te nevojshme:
npm install
-
Nisni aplikacionin:
node src/index.js
-
Ndiqni udhezimet ne terminal per te zgjedhur parametrat e nevojshme (dega, vit, paralel, semestri).
-
Skedari ICS i gjeneruar do te gjendet ne folderin
/output. -
Importoni skedarin ICS ne aplikacionin tuaj te kalendarit (Google Calendar, Apple Calendar, Outlook etj.).
⚠️ Kujdes⚠️ : N.q.s doni ta importoni ne calendar ne iPhone, duhet te shkarkoni shortuct ICS to Calendar dhe me pas mbasi ta keni kaluar file ne telefonin tuaj nepermjet whatsapp/email etj, klikoni Share -> ICS To Calendar -> Add All
- Marrja e te Dhenave: Perdoret kerkese POST per te marre HTML-ne e orarit nga serveri i FSHN.
- Perpunimi i HTML: HTML perpunohet duke perdorur module qe ndajne dhe bashkojne informacionet per secilen dite te javes.
- Gjenerimi i ICS: Skedari ICS perfshin evente te cilat perseriten cdo jave deri ne fund te semestrit dhe permban informacione te detajuara per çdo ore (lende, profesori, email, klasen).
- Ngjyra ne Konsole: Aplikacioni perdor module si chalk, figlet dhe gradient-string per nje nderfaqe vizuale terheqese ne terminal.
Ky projekt eshte licencuar sipas Licences MIT.