Marius Mutu
3af5813dd8
- generat de build_manual_ROAIMOB.py; cele 15 poze existente pastrate - adaugate Copiere, Transformare in N MF, prag fiscal 5.000 lei (OUG 8/2026) - .doc vechi inlocuit de .docx; CLAUDE.md: sectiunea ROAIMOB Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Hmc2BoKFNEQQWbj3ztiusQ
53 lines
2.9 KiB
Markdown
53 lines
2.9 KiB
Markdown
# 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.
|
|
|
|
## Manual ROAIMOB - docx + pdf (fara md/txt)
|
|
|
|
| Fisier | Rol |
|
|
|---|---|
|
|
| `build_manual_ROAIMOB.py` | genereaza `manualROAIMOB.docx` (stil clonat din `manual_ROAAUTO.docx`, poze din `pozeROAIMOB\`) |
|
|
| `manualROAIMOB.pdf` | generat din docx cu soffice (comanda de mai sus) |
|
|
|
|
- Modificarile se fac in **script**, nu direct in docx. Ruleaza `python build_manual_ROAIMOB.py`, apoi soffice, apoi verificarea vizuala.
|
|
- Versiunea si istoricul urmeaza aceleasi reguli ca la ROAAUTO.
|
|
- Livrare: copiezi pdf-ul in `D:\ROA\ROAIMOB\Help\manual_ROAIMOB.pdf` (comis in SVN). Se deschide din Ajutor -> Instructiuni de utilizare (`lansare_help_meniu`, COMUN r18244). La release, Marius il copiaza in `Y:\ROAUPDATE\ROAIMOB\Help\`, ca sa intre in zip-ul de update.
|