# Manual ROA

Manualele de utilizare ale aplicatiilor ROA. Remote: `git@gitea.romfast.ro:romfast/manual-roa.git` (branch `main`).
Manualele vechi (`.doc`/`.odt` + `poze*`) sunt doar arhiva; cel intretinut activ e **ROAAUTO**.

## Manual ROAAUTO — 4 formate, mereu sincronizate

| Fisier | Rol |
|---|---|
| `manual_ROAAUTO.docx` | sursa pentru PDF |
| `manual_ROAAUTO.pdf` | generat din docx, livrat clientilor |
| `manual_ROAAUTO.md` | acelasi continut, cu diacritice |
| `manual_ROAAUTO.txt` | acelasi continut, fara diacritice, latime 80, separatori `=`/`-` |

Orice modificare de continut se face in **toate 4**.

## Versiune si istoric (obligatoriu la fiecare modificare)

- Sub titlu: `v. DD.MM.YYYY` (data zilei modificarii); in docx e paragraf italic, 10pt.
- La sfarsit, sectiunea **Istoric versiuni**, inainte de subsolul „Manual generat…”: un rand per versiune,
  cea mai noua sus, scurt: `v. DD.MM.YYYY — ce s-a adaugat/schimbat`.

## Flux de lucru

1. Editeaza docx cu `python-docx`: cloneaza (`copy.deepcopy(p._p)`) un paragraf existent cu stilul dorit
   (titlu de sectiune, rand cu run bold + run normal) si schimba doar textul — docx-ul nu foloseste stiluri
   Word, formatarea e pe run-uri.
2. Editeaza md si txt.
3. Regenereaza PDF-ul:
   `"/c/Program Files/LibreOffice/program/soffice.exe" --headless --convert-to pdf manual_ROAAUTO.docx --outdir .`
4. Verifica vizual: `pdftoppm -f N -l N -r 60 -png manual_ROAAUTO.pdf <scratchpad>/pN`, apoi citeste imaginea.
5. Commit + push, apoi copiaza PDF-ul in aplicatie: `cp manual_ROAAUTO.pdf /d/ROA/ROAAUTO/Help/manual_ROAAUTO.pdf`.

## Capcane de mediu

- Scripturile Python se scriu intr-un fisier in scratchpad si se ruleaza cu `python fisier.py`. `python - <<EOF`
  poate esua tacut (shim pyenv), iar `python -` fara stdin blocheaza shell-ul.
- Consola e cp1252: `print` cu diacritice da `UnicodeEncodeError`. Nu afisa textul cu diacritice sau
  foloseste `.encode('ascii','replace')`.
- `pdftotext` pierde diacriticele la afisare. E doar o problema de afisare, PDF-ul e corect.
- Versiunea anterioara a PDF-ului (pentru diff la istoric) e cea din `D:\ROA\ROAAUTO\Help\` inainte de copiere.