Condividi o Incorpora il Tuo Ledger

Beancount.io offre opzioni flessibili per condividere i tuoi dati finanziari. Puoi incorporare il tuo ledger in siti web per la visualizzazione pubblica o invitare collaboratori per aiutarti a modificare e gestire i tuoi conti.

Incorporare il Tuo Ledger​

L'incorporamento ti permette di visualizzare pubblicamente il tuo ledger su siti web, portfolio o documentazione. È perfetto per rapporti di trasparenza, budget di progetti open-source o dimostrazioni educative.

Esplora il ledger live →

Prerequisiti: Rendi Pubblico il Tuo Ledger​

Importante: Prima di poter incorporare il tuo ledger, devi prima impostarlo come pubblico.

1. Vai alla pagina delle impostazioni del tuo ledger: https://beancount.io/ledger/{username}/{repo}/settings
2. Cambia l'impostazione di visibilità da "Privato" a "Pubblico"
3. Salva le modifiche

Incorporamento con un iframe​

Una volta che il tuo ledger è pubblico, puoi incorporarlo in qualsiasi sito web utilizzando un iframe HTML. Ecco un esempio che incorpora la pagina di panoramica:

Esempio di Codice iframe​

<div
  style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 2rem;"
>
  <iframe
    style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
    src="https://beancount.io/ledger/open_ledger/example"
    title="Panoramica Ledger Beancount"
    frameborder="0"
    allow="clipboard-write"
    loading="lazy"
  >
  </iframe>
</div>

Personalizzare la Vista Incorporata​

Puoi incorporare diverse pagine dal tuo ledger modificando il percorso URL:

• Panoramica: /ledger/{username}/{repo}/overview
• Stato Patrimoniale: /ledger/{username}/{repo}/balance-sheet
• Conto Economico: /ledger/{username}/{repo}/income-statement
• Giornale: /ledger/{username}/{repo}/journal
• Statistiche: /ledger/{username}/{repo}/statistics

Semplicemente sostituisci {username} con il tuo nome utente e {repo} con il nome del repository del tuo ledger.

Condividere il Tuo Ledger per la Modifica​

Se desideri che altri ti aiutino a modificare il tuo ledger (come un commercialista, un socio in affari o un membro del team), puoi invitarli come collaboratori. I collaboratori hanno accesso completo in lettura e scrittura al tuo ledger e possono effettuare commit tramite il flusso di lavoro basato su Git.

Guida Passo Passo: Invita un Collaboratore​

1. Chiedi al collaboratore di registrarsi Il tuo collaboratore deve prima creare un account gratuito su https://beancount.io.

2. Vai alla pagina dei collaboratori Vai a https://beancount.io/ledger/{username}/{repo}/collaborators (sostituisci {username} e {repo} con i dettagli del tuo ledger).

3. Invita il collaboratore Clicca sul pulsante "Invita Collaboratore" e inserisci il nome utente o l'indirizzo email del tuo collaboratore.

Cosa Possono Fare i Collaboratori​

Una volta invitati e accettati, i collaboratori possono:

• Visualizzare tutte le transazioni e i dati finanziari
• Modificare direttamente i file del ledger tramite l'interfaccia web
• Effettuare commit Git e visualizzare la cronologia dei commit
• Caricare documenti e ricevute
• Eseguire query e generare report
• Eseguire push e pull delle modifiche utilizzando i comandi Git (se si lavora in locale)

Buone Pratiche di Collaborazione​

• Definisci chiaramente i ruoli: Discutere chi è responsabile per quali conti o periodi di tempo
• Usa messaggi di commit significativi: Questo aiuta a tracciare chi ha fatto quali modifiche e perché
• Comunicazione regolare: Coordinarsi sulle modifiche importanti per evitare conflitti
• Rivedere le modifiche insieme: Utilizzare la cronologia Git per rivedere il lavoro degli altri
• Esegui backup regolari: Anche se Git fornisce il controllo di versione, mantieni i tuoi backup

Considerazioni sulla Privacy​

Ledger Pubblici vs. Privati​

• Ledger Pubblici:

  • Possono essere incorporati in siti web esterni
  • Visibili da chiunque abbia l'URL
  • Indicizzati e tracciati dai motori di ricerca
  • Ottimi per scopi di trasparenza e educativi

• Ledger Privati (Predefinito):

  • Accessibili solo a te e ai collaboratori invitati
  • Non possono essere incorporati esternamente
  • Raccomandati per finanze personali e aziendali

Quando Usare Ogni Opzione​

• Usa Pubblico per: Budget di progetti open-source, esempi educativi, rapporti di trasparenza, dimostrazioni in portfolio
• Usa Privato per: Finanze personali, contabilità aziendale, lavoro con clienti, dati finanziari sensibili

Puoi sempre modificare le impostazioni di visibilità in qualsiasi momento dalla pagina delle impostazioni del tuo ledger.