共享或嵌入您的账本

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

嵌入您的账本

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

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

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

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/puncsky/example/overview"
    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 的任何人均可查看
  • 被搜索引擎收录（取决于设置）
  • 非常适合透明度项目、教育用途和作品集展示

• 私有账本（默认）：

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

何时使用各选项

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

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