CERERI DE CONCEDIU — GENERATOR ONLINE PENTRU JEKYLL 2.11

Versiunea 2.11 face mai vizibil butonul de descărcare a aplicației complete,
afișează instrucțiunile lângă el și încarcă motorul PDF odată cu pagina.

Versiunea 2.10 afișează în previzualizare erorile care apar la pregătirea
documentului și permite reîncercarea după o sesiune de printare întreruptă.
La actualizare, copiază integral folderul cerere-concediu din arhiva nouă.

CE CONȚINE PACHETUL

Folderul cerere-concediu include pagina concediu.html, folderul aplicatie-concediu
cu stilurile, logica și motorul PDF, arhiva Concediul_meu.zip și acest fișier
INSTALARE_JEKYLL.txt. Păstrează aceste elemente împreună.

INSTALARE

1. Dezarhivează arhiva ediției Jekyll.
2. Copiază folderul cerere-concediu în directorul sursă al site-ului Jekyll.
   În configurația obișnuită, îl pui lângă _config.yml. Dacă folosești opțiunea
   source, îl pui în acel director sursă. Nu îl copia doar în _site: acel folder
   este rezultatul build-ului și poate fi regenerat.
3. Păstrează numele fișierelor și structura din aplicatie-concediu. Verifică să nu excluzi
   cerere-concediu sau fișierele ZIP prin opțiunea exclude din _config.yml.
4. Publică site-ul prin procedura lui obișnuită. Aplicația nu cere pluginuri
   Jekyll, instalări npm, bază de date sau un serviciu care să genereze PDF-uri.
5. Deschide adresa site-ului urmată de /cerere-concediu/concediu.html.
   Dacă site-ul este publicat într-un subfolder, păstrează și acel subfolder.

Exemple de adrese:
  https://exemplu.ro/cerere-concediu/concediu.html
  https://utilizator.github.io/proiect/cerere-concediu/concediu.html

Deschide explicit concediu.html; adresa folderului singur nu mai este suficientă.
Căile aplicației sunt relative la folderul paginii. Nu trebuie să modifici în
aplicație domeniul, baseurl sau căile către aplicatie-concediu pentru un site de proiect.

Dacă pui concediu.html direct lângă _config.yml, mută și aplicatie-concediu,
Concediul_meu.zip, INSTALARE_JEKYLL.txt și LICENTA_FONT.txt alături de el. Adresa
devine /concediu.html, precedată de baseurl dacă site-ul este publicat într-un
subfolder. Descărcările folosesc căi relative la pagina concediu.html.

LEGĂTURĂ ÎN MENIUL SITE-ULUI

Într-un fișier al temei procesat de Jekyll, poți adăuga:

<a href="{{ '/cerere-concediu/concediu.html' | relative_url }}">Cereri de concediu</a>

Dacă pagina este direct în rădăcina site-ului, folosește în schimb:

<a href="{{ '/concediu.html' | relative_url }}">Cereri de concediu</a>

Filtrul relative_url adaugă baseurl-ul configurat al site-ului. Meniul exact
se editează după structura temei tale. Aplicația este o pagină separată și își
păstrează designul; nu trebuie inclusă în layoutul temei.

FIȘIERE STATICE, FĂRĂ FRONT MATTER

concediu.html și fișierele din aplicatie-concediu nu au antet YAML de forma --- ... ---.
Lasă-le în această formă. Jekyll le tratează ca fișiere statice, fără să fie
nevoie de Liquid în aplicație. Adăugarea unui layout, a codului de analiză sau
a altor scripturi ale temei schimbă comportamentul paginii originale.

UTILIZAREA GENERATORULUI ONLINE

1. Completează societatea, funcția și numele. Dacă scrii SC sau S.C. la începutul
   societății, prefixul apare o singură dată în cerere.
2. Apasă O zi sau O perioadă și alege datele în calendar. Pentru o perioadă,
   selectează începutul și sfârșitul și introdu numărul efectiv de zile în aceeași
   fereastră. Totalul manual este cel înscris în cerere; trebuie să fie între 1
   și durata calendaristică a intervalului. Nu trebuie să bifezi separat fiecare
   zi efectivă în ediția online. Pe desktop vezi două luni alăturate, pe telefon
   una. Apasă titlul lunii pentru a alege direct luna și anul.
3. Data cererii este data curentă. Apasă pe rândul ei pentru a o modifica.
   Formulări deschide textele editabile, cu variabilele necesare protejate.
4. Verifică previzualizarea și apasă Descarcă PDF. PDF-ul A4 se generează în
   browser, cu text selectabil și diacritice. Rezultatul rămâne accesibil în
   pagina deschisă, pentru redescărcare sau deschiderea PDF-ului.
5. Printează deschide dialogul browserului, fără o descărcare automată a PDF-ului.
   Alegi imprimanta și confirmi acolo. Foaia A4 folosește același text, font și
   poziții ca PDF-ul. Închiderea dialogului nu confirmă că documentul a fost
   imprimat fizic.
6. Cerere nouă golește perioada și totalul, păstrează datele personale și
   formulările în pagina curentă și readuce data cererii la astăzi.

DATELE FORMULARULUI ȘI CACHE-UL BROWSERULUI

Datele formularului, selecția și formulările stau numai în memoria paginii.
Aplicația le elimină la reîncărcare, la părăsirea paginii sau când apeși
Golește tot. Schimbarea filei păstrează completarea din pagina deschisă.
Generatorul procesează local datele, fără să le scrie în IndexedDB, localStorage,
sessionStorage sau cookie-uri și fără să le trimită serverului. Ediția online
oferă completarea și generarea cererii, fără profil, istoric sau evidență anuală.

Browserul poate păstra în cache fișierele statice ale aplicației, cum ar fi
pagina, stilurile și scripturile, potrivit regulilor de cache ale găzduirii.
Datele completate și PDF-ul generat în pagină rămân în memoria filei.
Prima încărcare necesită acces la site. După ce pagina și motorul PDF s-au
încărcat, poți genera cererea în fila deschisă chiar dacă se întrerupe conexiunea.
Deschiderea ulterioară a paginii depinde de accesul la site și de cache-ul
obișnuit al browserului.

Un PDF descărcat la alegerea utilizatorului rămâne pe dispozitivul lui. Documentul
online nu conține înregistrarea JSON pentru recuperarea istoricului, identificatori
de arhivă sau autor personal în metadatele PDF. Datele vizibile ale cererii apar
în document, conform formularului completat. Găzduirea site-ului poate avea
propriile jurnale de acces; aplicația nu le trimite conținutul formularului.

Dacă anterior ai folosit la aceeași adresă o ediție care memora date, generatorul
online nu citește și nu șterge acea evidență. Pagina online pornește cu formularul
gol, indiferent de datele mai vechi ale aplicației complete.

EDIȚIA COMPLETĂ DESCĂRCABILĂ

Butonul Descarcă aplicația completă este afișat separat lângă generator și
descarcă fișierul static Concediul_meu.zip. Arhiva conține ediția PC 2.10.
Butonul Instrucțiuni deschide ghidul din pagină. Din ghid, folosește
Descarcă documentația Jekyll pentru a obține fișierul INSTALARE_JEKYLL.txt.

După dezarhivare, utilizatorul deschide Cerere_concediu.html din arhivă și își
configurează profilul. Ediția completă funcționează fără conexiune la internet
și include setări memorate, zile alocate și rămase pe an, istoric, calendar anual,
PDF-uri și JSON separat. Instrucțiunile proprii se află în CITESTE.txt din arhivă.

Pentru JSON și PDF-uri salvate în folder, utilizatorul alege folderul aplicației
și acordă acces într-un browser compatibil. Aplicația creează Cereri_concediu,
cu evidenta-concedii.json și documentele organizate pe ani. Când accesul direct
la folder nu este disponibil, rămân descărcarea PDF-urilor și exportul evidenței.
Datele nu se sincronizează automat între calculatoare; se transferă prin folder
sau backup. Se poate importa un JSON existent al aplicației complete.

PDF-urile online nu includ metadatele necesare reconstruirii automate a istoricului
ediției complete. Pentru evidență, cererile se generează din aplicația completă.

VERIFICARE DUPĂ PUBLICARE

Deschide pagina de la adresa finală și verifică:
  - formularul și calendarul se afișează;
  - o cerere pentru o zi și una pentru o perioadă se descarcă în PDF;
  - totalul manual al unei perioade poate fi mai mic decât numărul de zile
    luni–vineri, fără bifarea suplimentară a fiecărei zile;
  - Printează deschide o foaie A4, fără interfața aplicației;
  - rezultatul permite redescărcare, iar Cerere nouă păstrează doar profilul
    și formulările din pagina curentă;
  - reîncărcarea și revenirea cu butonul Înapoi deschid un formular gol;
  - Descarcă aplicația completă este vizibil pe desktop și telefon și
    descarcă arhiva ZIP;
  - Instrucțiuni deschide ghidul și Descarcă documentația Jekyll
    descarcă fișierul text;
  - pagina funcționează și de pe telefon.

Dacă stilurile sau PDF-ul nu se încarcă, verifică dacă ai copiat întregul folder
aplicatie-concediu și dacă îl publică site-ul. Dacă descărcarea aplicației sau
a documentației lipsește, verifică prezența fișierelor Concediul_meu.zip și
INSTALARE_JEKYLL.txt în același folder cu concediu.html.
Servește pagina prin site-ul Jekyll; pentru deschiderea directă de pe disc,
folosește fișierul autonom din arhiva aplicației complete.

SURSE OFICIALE

https://jekyllrb.com/docs/static-files/
https://jekyllrb.com/docs/configuration/options/
https://jekyllrb.com/docs/liquid/filters/
https://developer.mozilla.org/en-US/docs/Web/API/Window/print