跳转到主要内容
Beancount.io Logo
Share or Embed Your Ledger

Share or Embed Your Ledger

Learn how to share your Beancount ledger with collaborators for editing or embed it on websites for public viewing.

Beancount.io 为共享你的财务数据提供了灵活的选项。你可以将账本嵌入网站供公众查看，或邀请协作人员协助编辑和管理你的账户。

嵌入你的账本​

嵌入功能允许你在网站、作品集或文档中公开展示你的账本。这非常适合透明度报告、开源项目预算或教学演示。

Public Apple ledger dashboard embedded from beancount.io showing net worth and account balances

Explore the live ledger →

前提条件：将你的账本设为公开​

重要提示： 在嵌入账本之前，你必须先将其设置为公开可见。

  1. 导航到你的账本设置页面：https://beancount.io/ledger/{username}/{repo}/settings
  2. 将可见性设置从 “Private”（私有）更改为 “Public”（公开）
  3. 保存更改
安全提示

仅在你愿意与任何人共享所有财务数据时，才将账本设为公开。互联网上的任何人都可以查看公开账本，且公开账本将被搜索引擎收录和追踪。如果你的账本包含敏感的个人或商业财务信息，请保持其私有状态，并改用协作功能。

使用 iframe 嵌入​

一旦你的账本设为公开，你就可以使用 HTML iframe 将其嵌入任何网站。以下是嵌入概览页面的示例：

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="Beancount 账本概览"
    frameBorder="0"
    allow="clipboard-write"
    loading="lazy">
  </iframe>
</div>

自定义嵌入视图​

你可以通过更改 URL 路径来嵌入账本的不同页面：

  • 概览 (Overview): /ledger/{username}/{repo}/overview
  • 资产负债表 (Balance Sheet): /ledger/{username}/{repo}/balance-sheet
  • 损益表 (Income Statement): /ledger/{username}/{repo}/income-statement
  • 日记账 (Journal): /ledger/{username}/{repo}/journal
  • 统计 (Statistics): /ledger/{username}/{repo}/statistics

只需将 {username} 替换为你的用户名，将 {repo} 替换为你的账本仓库名称。

共享你的账本进行编辑​

如果你希望其他人协助编辑你的账本（如会计师、商业伙伴或团队成员），你可以邀请他们作为协作人员。协作人员拥有完整的读写权限，并可以通过基于 Git 的工作流进行提交。

操作步骤：邀请协作人员​

  1. 请你的协作人员注册 你的协作人员首先需要在 https://beancount.io 创建一个免费账户。

  2. 导航到协作人员页面 转到 https://beancount.io/ledger/{username}/{repo}/collaborators（将 {username} 和 {repo} 替换为你的账本详情）。

  3. 邀请协作人员 点击 “Invite Collaborator” 按钮，输入协作人员的用户名或电子邮件地址。

协作人员可以做什么​

一旦受邀并接受，协作人员可以：

  • 查看所有交易和财务数据
  • 直接通过 Web 界面编辑账本文件
  • 进行 Git 提交并查看提交历史
  • 上传文档和收据
  • 运行查询并生成报告
  • 使用 Git 命令推送 (Push) 和拉取 (Pull) 更改（如果在本地工作）

协作最佳实践​

  • 明确定义角色： 讨论谁负责哪些账户或时间段
  • 使用有意义的提交信息： 这有助于追踪谁做了哪些更改以及原因
  • 定期沟通： 就重大更改进行协调，以避免冲突
  • 共同审查更改： 使用 Git 历史记录相互审查工作
  • 定期备份： 尽管 Git 提供了版本控制，仍请保留自己的备份
基于 Git 的工作流

Beancount.io 使用 Git 进行版本控制。具备 Git 知识的协作人员可以将仓库克隆到本地，使用他们喜欢的文本编辑器进行更改，然后将更新推送回服务器。这为管理财务数据提供了强大的版本控制能力。

隐私注意事项​

公开账本 vs. 私有账本​

  • 公开账本：

    • 可以嵌入外部网站
    • 拥有 URL 的任何人均可查看
    • 被搜索引擎收录和追踪
    • 非常适合透明度项目、教育用途和作品集展示

  • 私有账本（默认）：

    • 仅限你和受邀的协作人员访问
    • 无法在外部嵌入
    • 建议用于个人和商业财务

何时使用各选项​

  • 使用公开模式： 开源项目预算、教育示例、透明度报告、作品集展示
  • 使用私有模式： 个人财务、企业会计、客户工作、敏感财务数据

你可以随时在账本的设置页面更改可见性设置。

上一页自定义链接与查询下一页行业特定的设置