Grist是一个现代关系型电子表格。它结合了电子表格的灵活性和数据库的健壮性。

• 砂芯（本回购）具备运行强大的电子表格托管服务器所需的功能。
• 砂粒电子是一个Linux/macOS/Windows桌面应用程序，用于查看和编辑本地存储的电子表格。
• 静态砂粒是Grist的完全浏览器内版本，用于在网站上显示电子表格，无需后端支持。

这个灰色岩心回购是Grist的核心，包括Grist提供的托管服务Grist实验室，一家总部位于纽约的公司🇺🇸 和Grist的主要开发人员。法国政府机构ANCT Données et Territoires公司🇫🇷 对代码库也做出了重大贡献。

这个砂芯,砂粒电子、和静态砂粒存储库都是开源的（Apache许可证，2.0版）。

问题？反馈？想与Grist分享您正在构建的内容吗？加入我们的官方Discord服务器或访问我们的社区论坛.

Grist是一个混合数据库/电子表格，这意味着：

• 列的工作方式与它们在数据库中的工作方式类似：它们被命名，并且保存一种数据。
• 列可以由公式、电子表格样式填充，并在引用的单元格更改时自动更新。

这种差异可能会使直接来自Excel或谷歌表的人感到困惑。给它一个机会！还有一个Grist for Spreadsheet用户文章来帮助你定位。如果你来自Airtable，你会发现这个模型很熟悉（还有我们的砂砾vs气垫文章进行直接比较）。

以下是Grist的一些特定功能亮点：

• Python公式。
  • 完全支持Python语法，包括标准库。
  • 许多Excel函数也可用。
  • 安人工智能助理专门针对公式生成进行了调整（使用OpenAI gpt-3.5-turbo或拉马通过美洲驼-赛珍珠).
• 一种可移植的、自包含的格式。
  • 基于部署最广泛的数据库引擎SQLite。
  • 任何可以读取SQLite的工具都可以从Grist文件中读取数字和文本数据。
  • 使能够备份您可以放心地完全恢复。
  • 非常适合在不同主机之间移动。
• 可以在静态网站上显示静态砂粒–无需特殊服务器。
• 用于本地查看和编辑的独立桌面应用程序：砂粒电子.
• 方便的编辑和格式化功能。
  • 选择和选项列表，用于向记录添加彩色标签。
  • 工具书类和引用列表，用于交叉引用其他表中的记录。
  • 附件，将媒体或文档文件包含在记录中。
  • 日期和时间、切换和货币等特殊数字都有专门的编辑器和格式选项。
  • 条件格式，使您可以使用公式控制单元格的样式，以引起人们对重要信息的注意。
• 拖放式仪表板。
  • 图表,卡片视图和a日历小部件用于可视化。
  • 摘要表用于跨组求和和计数。
  • 小工具链接简化筛选和编辑数据。Grist有一种独特的可视化方法，您可以将不同的小部件布局并链接在一起显示，不用把混合材料塞进桌子里。
  • 滤棒用于快速切片和切丁。
• 增量导入.
  • 从您的银行导入过去三个月活动的CSV。。。
  • …并在一个月后导入新活动，无需大惊小怪或重复。
• 集成。
  • A类REST API,Zapier动作/触发器，以及来自类似公司的支持积分器.
  • 导入/导出到谷歌驱动器、Excel格式、CSV。
  • 将数据链接到自定义小部件，在外部托管。
  • 可配置的传出webhook。
• 许多模板首先，从投资研究到组织寻宝活动。
• 访问控制选项。
  • （您需要设置SSO登录才能使用这些选项；灰色公共汽车如果配置它让人望而却步，则有一个预打包的解决方案）
  • 分享单个文档、工作空间或工作组站点.
  • 控制访问单个行、列和表.
  • 基于单元格值和用户属性控制访问。
• 自我维护。
  • 适用于内部网操作和特定的合规性要求。
• 不受信任文档的沙盒选项。
  • 在Linux或使用Docker时，您可以启用g遮阳板在单个文档级别进行沙盒处理。
  • 在macOS上，您可以使用本机沙箱。
  • 在任何操作系统（包括Windows）上，都可以使用基于wasm的沙箱。
• 翻译成多种语言。
• F1key提供了一些快速帮助。这过去是不言而喻的，但总的来说，Grist有很好的键盘支持。
• 我们将进度发布在𝕏 或者推特什么的并发布每月通讯.

如果您对Grist的去向感到好奇，请参阅我们的路线图，插入一个问题我们的论坛，或浏览我们的大量文档.

如果您只想快速演示一下Grist：

• 您可以在Grist实验室运行的托管服务中尝试Grist out，网址为docs.getgrist.com网站（无需注册）。
• 或者您可以在gristlabs.gitub.io/grist-静态.
• 或者您可以从下载Grist作为桌面应用程序github.com/gristlabs/grist-electrone公司.

得到灰色岩心在您的计算机上运行码头工人，执行：

码头工人拉动软骨docker运行-p 8484:8484-it gristlabs/grist

然后访问http://localhost:8484在浏览器中。您可以创建、编辑、导入、，和导出文档。要跨驳接器运行保留您的工作，请将目录共享为/坚持:

docker运行-p 8484:8484-v$PWD（美元）/persistent:/presisten-it gristlabs/grist

在获取模板模板.getgrist.com工资单，库存管理、开票、D&D遭遇跟踪等更多，或使用您在其上创建的任何文档docs.getgrist.com网站.

如果需要更改Grist运行的端口，请设置港口变量，不要只更改端口映射：

docker运行--env PORT=9999-p 9999:9999-v$PWD/persist:/persist-it gristlabs/grist

要启用gVisor沙盒，请设置--env GRIST_SANDBOX_FLAVOR=护目镜.这应该适用于默认驳接器设置，但可能不适用于所有设置环境。

您可以找到更多有关配置Grist、设置身份验证、，并在我们的公共服务器上运行自我管理砂砾手册。

您可以打开一个特殊的“引导页面”来检查安装。只需访问/行李箱有关说明，请访问Grist服务器。因为即使在身份验证时也可以使用引导页面未设置，您可以通过设置给它一个特殊的访问密钥GRIST_BOOT_键.

docker运行-p 8484:8484-e GRIST_BOOT_KEY=secret-it gristlabs/GRIST

启动页面应可在/引导/<GRIST_boot_KEY>.我们是开始收集常见问题的探针。如果你遇到一个问题未涵盖，如果您可以在中为其添加一个探针，那就太好了BootProbe（引导探测器）.或者提交一个问题，以便其他人可以添加，我们才刚刚开始。

要从源代码构建Grist，请执行以下步骤：

纱线安装纱线运行构建：prod纱线运行安装：python纱线起动#Grist将在本地主机：8484/

文档中的Grist公式将使用直接在您的机器。您可以使用GRIST_SANDBOX_FLAVOR格栅环境变量。

• 在macOS上，导出GRIST_SANDBOX_FLAVOR=macSandboxExec使用本机沙盒执行器沙盒命令。
• 在Linux上gVisor跑步记录安装，导出GRIST_SANDBOX_FLAVOR=gvisor是一个选项。
• 在包括Windows在内的任何操作系统上，export GRIST_SANDBOX_FLAVOR=密码可用。

这些沙箱方法是为我们在Grist实验室和可能需要调整才能在您自己的环境中工作-拉请求非常欢迎来到这里！

与git一样，Grist也具有跟踪文档修订历史的功能。因此，为了全面运营，Grist希望知道修改文档的用户是谁。在知道之前，它会进行操作以有限的匿名模式。为了让您继续，docker映像配置为当您单击“登录”按钮时，Grist会将您的工作归因于你@example.com.通过设置更改此设置GRIST_DEFAULT_邮件:

docker运行--env GRIST_DEFAULT_EMAIL=我的@电子邮件-p 8484:8484-v$PWD/persist:/persist-it gristlabs/grist

您可以在中更改您的姓名配置文件设置在里面这个用户菜单.

对于多用户操作，或者如果您希望通过公共互联网，您需要将其连接到您自己的Single Sign-On服务。有很多方法可以做到这一点，包括SAML和转发身份验证.砂砾已经过测试Authentik公司,授权0,和Google/Microsoft登录，通过德克斯.

我们使用网页版管理翻译。感谢所有参与其中的人。特别感谢ANCT开发人员做了大量的工作，使应用程序可以本地化。谢谢你！

此存储库，砂芯由Grist Labs维护。我们的旗舰产品位于getgrist.com网站是根据您在这里看到的代码构建的，结合了特定于业务的软件，该软件设计用于扩展到多个用户，处理帐单等。

Grist Labs是一家开放式公司。我们提供Grist托管服务，并提供免费和付费计划。我们还使用专有许可证开发和销售与Grist相关的功能，以满足拥有大型自主安装的企业的需求。

我们将数据可移植性和自主性视为一项关键价值砂芯是其中的一个重要部分。我们致力于维护和改进砂芯代码库，并考虑专有产品如何影响数据可移植性和自治性。

通过打开源代码并提供OSI公司-经批准的免费许可证，Grist使其用户受益：

• 开发人员社区。检查源代码、修复错误和开发的自由对于像电子表格这样的通用产品来说，新功能是一件大事，因为它有对某个地方的某人至关重要的长尾特征。
• 增加信任。因为任何人都可以检查源代码，所以“模糊安全”不是一个选项。代码中的漏洞可以被其他人发现，并在其导致之前报告损坏。
• 独立性。无论Grist Labs的业务前景如何，您都可以使用Grist，因为它是开源的，可以自托管。使用我们的托管解决方案很方便，但您未锁定。
• 价格灵活性。如果你资金不足但有时间投资，那么自我托管是一个不错的选择选项。DIY用户可能有技术悟性和动机去钻研和改进，这可以使Grist的所有用户受益。
• 可扩展性。对于开发人员来说，开源使构建扩展（例如提升自订控件). 您可以更轻松地将Grist包括在您的管道中。如果缺少某个功能，您可以只使用源代码并在其基础上进行构建。

有关Grist实验室历史和原则的更多信息，请参阅我们的关于我们第页。

• 抓住ProductHunt
• AppSumo上的Grist（终身协议已售罄）
• 卡佩特拉,G2级,TrustRadius（信任半径）

砂砾可以通过多种方式进行配置。以下是其敏感的主要环境变量：

在撰写本文时，已知AI Assistant可以针对gpt-3.5-turbo和gpt-4的OpenAI聊天完成端点运行。它还可以针对提供的聊天完成端点运行美洲驼-赛珍珠.

正向身份验证支持两种模式，区别在于网格_导航_会话:

1. 使用会话，并在登录端点上进行转发验证。

   例如，使用traefik反向代理traefik前向授权中间件：

   • 网格_导航_会话：不要设置，或设置为错误的值。
   • 确保反向代理将前向身份验证中间件应用于GRIST_FORWARD_AUTH_LOGIN_PATH公司和GRIST_FORWARD_AUTH_LOGOUT_PATH公司.
   • 如果要在某些情况下允许匿名访问，请确保所有其他路径都没有前向认证中间件。砂砾将根据需要通过重定向到触发GRIST_FORWARD_AUTH_LOGIN_PATH公司。用户登录后，Grist将使用会话在注销之前识别用户。

2. 没有会话，并且在所有端点上都进行了转发身份验证。

   例如，使用HTTP Basic Auth和服务器配置来设置标头（在GRIST_FORWARD_AUTH_HEADER公司)登录用户。

• 网格_导航_会话：设置为真的。将不使用网格会话。
• 确保反向代理为所有可能需要的请求设置指定的头登录信息。用户不能伪造此标头，因为格里斯特会相信里面的一切。

使用正向身份验证时，您可能还希望设置以下变量：

• GRIST_FORCE_LOGIN=真禁用匿名访问。

Grist有一个插件系统，内部使用。你能做的一件有用的事这样做的目的是在Grist的构建中包含自定义小部件。自定义小部件通常只需设置GRIST_WIDGET_LIST_URL公司,但这也有外部依赖性的缺点不适合脱机使用或存档。插件提供了一种替代方案。

要将自定义小部件“捆绑”为插件，请执行以下操作：

• 添加的子目录插件，例如。插件/my-widgets.或者，您可以设置GRIST_USER_ROOT公司环境变量设置为所需的任意路径，然后创建插件/my-widgets在这个范围内。
• 添加清单.yml该子目录中的文件，如下所示这个：

name:我的小工具组件：小部件：widgets.json

• 这个小部件.json文件的格式应为这个粗砂小工具存储库，并应放置在与清单.yml.任何材料插件/my-widgets将由Grist提供服务，并且可以在小部件.json.
• 所有文件就绪后，重新启动Grist。你的小部件应该现在可以在自定义小部件下拉列表中使用，以及其他来自GRIST_WIDGET_LIST_URL公司.
• 如果您愿意，可以添加多个插件子目录多组小部件，它们都将可用。

打开请购单时，测试将作为CI的一部分自动运行。然而，在本地运行测试可能很有帮助将更改推送到GitHub之前。首先，您需要确保已安装所有依赖项：

纱线安装纱线安装：python

然后，您可以这样运行主测试套件：

纱线测试

Python测试也可以在本地运行。（注意：当前需要Python 3.9-3.11。）

纱线测试：python

对于运行特定测试，可以使用GREP_测试变量：

env GREP_TESTS=ChoiceList纱线测试env GREP_TESTS=纱线测试摘要：python

此存储库，砂芯，根据Apache许可证，2.0版，这是一个OSI公司-批准的自由软件许可证。有关更多信息，请参阅LICENSE.txt和NOTICE.txt。