docs: aggiorna documentazione cartelle speciali con percorsi corretti

Aggiunge sezione __SALTATI nella guida utente e nella sidebar.
Corregge i percorsi di __NON_SMISTATI e __DUPLICATI (Windows: C:\cadroute\,
Linux: ~/.cadroute/) e aggiorna i riferimenti da duplicati/ a __DUPLICATI
in tutta la documentazione. Aggiorna README con i percorsi corretti
This commit is contained in:
2026-03-16 14:33:19 +01:00
parent fea0699ff1
commit 57f8b230b2
2 changed files with 36 additions and 10 deletions

View File

@@ -27,6 +27,7 @@
<a href="#nomi">Convenzione nomi file</a>
<a href="#nonsmistati">File non smistati</a>
<a href="#duplicati">File duplicati</a>
<a href="#saltati">File saltati</a>
</nav>
<main>
@@ -62,7 +63,7 @@
<tr>
<td><span class="badge skip">altri</span></td>
<td></td>
<td>Ignorati (PDF, immagini, documenti, ecc.)</td>
<td>Copiati in <code>__SALTATI</code> (PDF, immagini, documenti, ecc.)</td>
</tr>
</tbody>
</table>
@@ -100,7 +101,7 @@
<ol class="steps">
<li><span>Clicca <strong>Process Folder</strong> per selezionare una cartella, oppure <strong>Process ZIP</strong> per selezionare un archivio. In alternativa, trascina la cartella o il file <code>.zip</code> nell'area tratteggiata.</span></li>
<li><span>L'app scansiona tutti i file e identifica automaticamente quelli CAD.</span></li>
<li><span>I file CAD vengono copiati nella sottocartella di destinazione corrispondente. I file non CAD vengono saltati.</span></li>
<li><span>I file CAD vengono copiati nella sottocartella di destinazione corrispondente. I file non CAD vengono copiati in <code>__SALTATI</code>.</span></li>
<li><span>Al termine vengono mostrate le statistiche nell'area di output.</span></li>
</ol>
@@ -127,7 +128,7 @@
</div>
<div class="stat-item muted">
<div class="stat-label">Saltati</div>
<div class="stat-desc">File ignorati perché non CAD (PDF, immagini, ecc.).</div>
<div class="stat-desc">File non CAD copiati in <code>__SALTATI</code> (PDF, immagini, ecc.).</div>
</div>
<div class="stat-item warn">
<div class="stat-label">Non smistati</div>
@@ -172,7 +173,7 @@ Esempi:
</tr>
<tr>
<td>File già presente in destinazione</td>
<td>Copiato in <code>duplicati/</code> per revisione</td>
<td>Copiato in <code>__DUPLICATI</code> per revisione</td>
</tr>
<tr>
<td>Versione inferiore presente nella sorgente</td>
@@ -210,8 +211,8 @@ Esempi:
<h3>Dove si trovano</h3>
<p>I file non smistati vengono copiati nella cartella <code>__NON_SMISTATI</code>:</p>
<ul style="margin: 8px 0 12px 20px; color: var(--muted);">
<li><strong>Windows:</strong> <code>C:\cadroute\__NON_SMISTATI\</code></li>
<li><strong>Linux:</strong> <code>~/.cadroute/__NON_SMISTATI/</code></li>
<li><strong>Windows:</strong> <code>%APPDATA%\CadRoute\__NON_SMISTATI\</code></li>
</ul>
<h3>Visualizzare e pulire</h3>
@@ -231,16 +232,16 @@ Esempi:
<h2>File duplicati</h2>
<p>Un file CAD viene classificato come <strong>duplicato</strong> quando la sua chiave (<code>CODICE.tipo</code>, senza versione) è già presente nella cartella di destinazione al momento dello smistamento.</p>
<p>I duplicati non sovrascrivono i file già presenti in destinazione: vengono messi da parte nella cartella <code>duplicati/</code> per permettere una revisione manuale.</p>
<p>I duplicati non sovrascrivono i file già presenti in destinazione: vengono messi da parte nella cartella <code>__DUPLICATI</code> per permettere una revisione manuale.</p>
<h3>Dove si trovano</h3>
<ul style="margin: 8px 0 12px 20px; color: var(--muted);">
<li><strong>Linux:</strong> <code>~/.cadroute/duplicati/</code></li>
<li><strong>Windows:</strong> <code>%APPDATA%\CadRoute\duplicati\</code></li>
<li><strong>Windows:</strong> <code>C:\cadroute\__DUPLICATI\</code></li>
<li><strong>Linux:</strong> <code>~/.cadroute/__DUPLICATI/</code></li>
</ul>
<h3>Gestione versioni nei duplicati</h3>
<p>Anche all'interno della cartella <code>duplicati/</code> viene applicata la logica delle versioni: se arriva una versione più alta di un file già presente nei duplicati, la versione vecchia viene eliminata e sostituita con quella nuova.</p>
<p>Anche all'interno della cartella <code>__DUPLICATI</code> viene applicata la logica delle versioni: se arriva una versione più alta di un file già presente nei duplicati, la versione vecchia viene eliminata e sostituita con quella nuova.</p>
<h3>Visualizzare e pulire</h3>
<ol class="steps">
@@ -254,6 +255,31 @@ Esempi:
</div>
</section>
<!-- ── SALTATI ────────────────────────────── -->
<section id="saltati">
<h2>File saltati</h2>
<p>Un file viene classificato come <strong>saltato</strong> quando non è riconosciuto come file CAD, cioè non ha estensione <code>.prt</code>, <code>.asm</code> o <code>.drw</code>. Rientrano in questa categoria PDF, immagini, documenti Word e qualsiasi altro formato non CAD.</p>
<p>I file saltati non vengono ignorati completamente: vengono copiati nella cartella <code>__SALTATI</code> per permettere una verifica manuale.</p>
<h3>Dove si trovano</h3>
<ul style="margin: 8px 0 12px 20px; color: var(--muted);">
<li><strong>Windows:</strong> <code>C:\cadroute\__SALTATI\</code></li>
<li><strong>Linux:</strong> <code>~/.cadroute/__SALTATI/</code></li>
</ul>
<h3>Visualizzare e pulire</h3>
<ol class="steps">
<li><span>Clicca <strong>Anteprima saltati</strong> per aprire la lista dei file presenti.</span></li>
<li><span>Verifica che nessun file CAD sia finito qui per errore di denominazione.</span></li>
<li><span>Se vuoi svuotare la cartella, clicca <strong>Pulisci cartella</strong> (rosso) e conferma.</span></li>
</ol>
<div class="callout info">
<strong>Nota:</strong> la cartella <code>__SALTATI</code> è utile per individuare file CAD rinominati erroneamente o con estensione mancante.
</div>
</section>
</main>
<script>