#17 Posso collegare una cartella locale?
Sì — ed è potente. Collega una directory di progetto e PenPage diventa un editor live per tutto l'albero di cartelle. Sotto-cartelle, file annidati, configurazioni agenti AI — tutto si sincronizza in entrambe le direzioni, automaticamente.
Due modi per collegare
- Qualsiasi cartella — clic destro su una cartella → Link Directory per collegarla a una cartella su disco.
- Directory workspace (🗂️) — un intero workspace dedicato a cartelle locali e di rete, tenuto separato dagli altri appunti. (#6 Cosa sono i Workspace?)
Entrambi usano la stessa sincronizzazione bidirezionale descritta sotto.
Collega un intero albero di directory
File Link non connette solo un file — connette un'intera directory, incluse le sotto-cartelle fino a 4 livelli di profondità. Ogni file .md diventa una pagina PenPage. Ogni sotto-directory diventa una cartella annidata.
- Clicca l'icona link su una cartella (o clic destro → Collega directory)
- Seleziona una directory dal computer
- PenPage scansiona l'albero e mostra un selettore sotto-directory — scegli quali includere
- Fatto — il tuo albero di directory è ora live in PenPage
Un collegamento, l'intero progetto AI
Qui la cosa diventa interessante. Collega la root del progetto e PenPage scopre automaticamente tutti i file .md usati dai tuoi strumenti AI:
| Strumento AI | Cosa PenPage trova |
|---|---|
| Claude Code | CLAUDE.md, .claude/agents/, .claude/rules/, .claude/plans/ |
| Gemini CLI | GEMINI.md e config correlate |
| Codex CLI | AGENTS.md e definizioni agenti |
Un collegamento → agenti, regole, piani, skill, prompt — tutto modificabile nell'editor di PenPage. L'AI legge le modifiche all'istante. Niente copia-incolla, niente cambiare finestra.
Vedi #16 AI Coding Agent per il flusso completo modifica-esecuzione-sincronizzazione.
Sincronizzazione bidirezionale
Ogni modifica si sincronizza in entrambe le direzioni — PenPage su disco, disco su PenPage.
| Evento | Cosa succede |
|---|---|
| Modifichi una pagina in PenPage | Il file su disco si aggiorna automaticamente |
| Modifichi un file su disco | PenPage rileva alla prossima sincronizzazione |
| Entrambi i lati cambiati | Auto-fork — crea due versioni, nessun dato perso |
| File eliminato su disco | La pagina va nel Cestino |
| Pagina eliminata in PenPage | Il file .md viene rimosso dal disco |
Quando avviene la sincronizzazione?
- Cambio pagina: la pagina corrente si sincronizza subito
- Focus sulla tab: torni su PenPage → tutte le cartelle collegate vengono riscansionate
- In background: riscansione periodica ogni 60 secondi
- Manuale: clic destro sulla cartella → Sincronizza directory
Conflitto? PenPage non sovrascrive mai nessun lato. Se entrambi sono cambiati, crea due versioni — decidi tu quale tenere.
Modalità progetto AI: Quando PenPage rileva una directory .penpage, le modifiche ai file vincono sempre nei conflitti — l'output del tuo strumento AI non viene mai sovrascritto da una copia obsoleta di PenPage.
Aggiornamento collegamento — scopri nuove sotto-cartelle
Hai aggiunto nuove directory al progetto dopo il collegamento? Clic destro sulla cartella collegata → Aggiorna collegamento. PenPage scansiona per nuove sotto-directory e offre di collegarle — senza bisogno di scollegare e ricollegare.
Scollegare
Vuoi disconnettere? Clic destro sulla cartella → Scollega directory.
- Le pagine restano in PenPage — nulla viene eliminato
- I file su disco sono intoccati
- Solo la connessione di sincronizzazione live viene rimossa
- Puoi ricollegare la stessa directory in qualsiasi momento
Deduplicazione intelligente
PenPage usa l'hashing del contenuto per prevenire duplicati:
- Colleghi una directory che si sovrappone a pagine esistenti? I duplicati vengono rilevati e saltati
- La riscansione trova e pulisce automaticamente i file
.mdduplicati - I file
.mdvuoti (da pagine mai modificate) vengono rimossi automaticamente
Requisiti del browser
File Link richiede la File System Access API:
| Browser | Supporto |
|---|---|
| Chrome / Edge (desktop) | Supporto completo — consigliato |
| Safari / Firefox | Non disponibile |
| Browser mobile | Non disponibile |
Il browser ricorda a quali directory hai concesso l'accesso. Dopo il riavvio, PenPage verifica i permessi silenziosamente — nessun dialogo di ri-autorizzazione nella maggior parte dei casi.
Se vuoi solo prendere appunti...
File Link è pensato per utenti avanzati e sviluppatori. Se stai solo scrivendo appunti:
- L'archiviazione integrata di PenPage è più semplice e veloce
- Per l'accesso da più dispositivi, usa Cloud Sync (#12)
- Per il backup, usa Salva/Ripristina con un clic (#7)
Tipi di file supportati
Solo .md e .markdown. I file nascosti (che iniziano con .) vengono saltati.