digiserver-v2/documentatie/CONVERSIE-DOCX.md

Cum convertesc acest manual în format .DOCX

Acest fișier explică pașii pentru a transforma Manual-Utilizare-DigiServer.md într-un document Word (.docx) gata de printat sau distribuit.

---

Metoda 1 – Pandoc (recomandată)

Pandoc este cea mai bună soluție: convertește Markdown în DOCX păstrând titluri, tabele, liste și imagini.

1.1. Instalare Pandoc

Pe Debian/Ubuntu (inclusiv pe acest server):

sudo apt-get update
sudo apt-get install -y pandoc

Verificare:

pandoc --version

1.2. Conversie simplă

Din folderul documentatie/:

cd /srv/digiserver-v2/documentatie
pandoc Manual-Utilizare-DigiServer.md -o Manual-Utilizare-DigiServer.docx

1.3. Conversie cu cuprins automat (Table of Contents)

pandoc Manual-Utilizare-DigiServer.md \
  --toc \
  --toc-depth=2 \
  --number-sections \
  -o Manual-Utilizare-DigiServer.docx

Opțiune	Efect
--toc	Adaugă cuprins automat
--toc-depth=2	Cuprinsul include titluri de nivel 1 și 2
--number-sections	Numerotează secțiunile (1, 1.1, 1.2...)

1.4. Conversie cu șablon personalizat (logo, fonturi corporate)

Dacă doriți un aspect personalizat:

1. Generați un șablon de referință:

   pandoc -o template-referinta.docx --print-default-data-file reference.docx
   

2. Deschideți template-referinta.docx în Word
3. Modificați stilurile (fonturi, culori, antet, logo)
4. Salvați și folosiți-l la conversie:

   pandoc Manual-Utilizare-DigiServer.md \
     --toc --number-sections \
     --reference-doc=template-referinta.docx \
     -o Manual-Utilizare-DigiServer.docx
   

1.5. Conversie cu imagini redimensionate (pentru capturile de ecran)

pandoc Manual-Utilizare-DigiServer.md \
  --toc --number-sections \
  --resource-path=screenshots \
  -o Manual-Utilizare-DigiServer.docx

Notă: Pentru ca imaginile să apară în document, ele trebuie să existe în folderul screenshots/ cu numele exacte din Anexa B și trebuie referite în Markdown.

---

Metoda 2 – VS Code (fără instalări suplimentare)

Dacă editați în VS Code:

1. Instalați extensia „Markdown PDF" sau „Markdown Preview Enhanced"
2. Deschideți Manual-Utilizare-DigiServer.md
3. Click dreapta → „Markdown: Export to DOCX" (sau PDF)
4. Salvați documentul rezultat

Alternativ, extensia „Markdown All in One" + „Pandoc" permite export direct DOCX din Command Palette.

---

Metoda 3 – Online (fără instalare)

Pentru conversie rapidă fără a instala nimic:

1. Accesați un convertor online (ex: https://www.markdowntodocx.com)
2. Încărcați sau lipiți conținutul din Manual-Utilizare-DigiServer.md
3. Descărcați fișierul .docx rezultat

Atenție: Nu folosiți convertizoare online pentru documente cu informații sensibile (adrese IP interne, credențiale). Preferați Metoda 1 sau 2.

---

Pașii compleți pentru un document final (cu capturi de ecran)

Pasul 1 – Faceți capturile de ecran

Deschideți aplicația în browser și faceți capturi pentru fiecare punct din Anexa B a manualului.

Sfaturi pentru capturi bune:

• Folosiți rezoluția completă a ferestrei (nu tăiați meniurile)
• Evitați să apară date sensibile (parole, IP-uri reale dacă nu e necesar)
• Salvați în format PNG pentru claritate
• Denumiți exact ca în Anexa B (ex: 01-login.png)

Pasul 2 – Salvați capturile

Puneți toate fișierele în:

/srv/digiserver-v2/documentatie/screenshots/

Pasul 3 – Referiți imaginile în Markdown

Înlocuiți liniile de tip:

**[SCREENSHOT: 03-dashboard.png – Dashboard după autentificare]**

cu:

![Dashboard după autentificare](screenshots/03-dashboard.png)

*Figura 1 – Dashboard-ul principal al aplicației*

Pasul 4 – Convertiți în DOCX

cd /srv/digiserver-v2/documentatie
pandoc Manual-Utilizare-DigiServer.md \
  --toc \
  --toc-depth=2 \
  --number-sections \
  --resource-path=screenshots \
  -o Manual-Utilizare-DigiServer.docx

Pasul 5 – Verificați documentul

Deschideți Manual-Utilizare-DigiServer.docx în Word / LibreOffice și verificați:

• Cuprinsul este corect și complet
• Toate capturile de ecran apar
• Tabelele sunt formatate corect
• Numerotarea secțiunilor este consecventă
• Textul diacriticilor românești (ă, â, î, ș, ț) se afișează corect

---

Script automat de conversie

Un script care face totul automat:

#!/bin/bash
# convert_manual.sh - Converteste manualul in DOCX cu cuprins si imagini

cd "$(dirname "$0")"

echo "Verificare Pandoc..."
if ! command -v pandoc &> /dev/null; then
    echo "Pandoc nu este instalat. Rulati: sudo apt-get install -y pandoc"
    exit 1
fi

echo "Numar capturi de ecran disponibile:"
ls -1 screenshots/*.png 2>/dev/null | wc -l

echo "Conversie in DOCX..."
pandoc Manual-Utilizare-DigiServer.md \
  --toc \
  --toc-depth=2 \
  --number-sections \
  --resource-path=screenshots \
  -o Manual-Utilizare-DigiServer.docx

if [ -f Manual-Utilizare-DigiServer.docx ]; then
    echo "✓ Document creat: Manual-Utilizare-DigiServer.docx"
    ls -lh Manual-Utilizare-DigiServer.docx
else
    echo "✗ Eroare la conversie"
    exit 1
fi

Salvați ca convert_manual.sh, apoi:

chmod +x convert_manual.sh
./convert_manual.sh

---

Rezumat rapid

Metodă	Necesită	Calitate	Recomandat pentru
Pandoc	instalare	★★★★★	Document final profesional
VS Code	extensie	★★★★	Utilizatori VS Code
Online	browser	★★★	Conversie rapidă, documente nesensibile

Recomandare: Folosiți Pandoc cu --toc și --number-sections și un șablon de referință personalizat pentru un document final profesionist.

---

Pentru întrebări despre conversie, consultați documentația Pandoc: https://pandoc.org/MANUAL.html