collective.bluesky

collective.bluesky 是一个提供 Plone 内容规则操作的包，用于在Bluesky发布状态。

安装

此包支持使用Volto和ClassicUI的Plone站点。

为了正确支持Volto，要求如下

• plone.restapi >= 8.34.0
• Volto >= 16.10.0

使用 pip 将 collective.bluesky 添加到Plone安装

pip install collective.bluesky

或将其作为您的包的 setup.py 依赖项添加

    install_requires = [
        "collective.bluesky",
        "Plone",
        "plone.restapi",
        "setuptools",
    ],

配置

获取应用密码

在您可以使用此包之前，您必须在Bluesky上注册一个应用密码。为此，请登录您的账户，访问 应用密码 并添加一个新的 应用密码。转到新创建的应用程序页面并复制 您的访问令牌 的值。

配置Plone

此包通过 BLUESKY_APPS 环境变量进行配置，它应包含包含您的Bluesky应用程序信息的有效JSON数组。

每个应用程序注册都需要以下信息

使用上述信息，环境变量看起来像

BLUESKY_APPS='[{"host":"bsky.app","handle":"demo","app_password":"1232434323234"}]'

启动Plone

现在，您可以使用以下命令启动您本地的Plone安装：

BLUESKY_APPS='[{"host":"bsky.app","handle":"demo","app_password":"1232434323234"}]' make start

或者，如果您正在使用docker compose配置，请在environment键下添加新的环境变量

    environment:
      - BLUESKY_APPS=[{"host":"bsky.app","handle":"demo","app_password":"1232434323234"}]

启动后，访问内容规则控制面板，创建一个新的内容规则。

不需要为Volto支持进行任何额外的配置。

贡献

如果您想帮助开发（改进、更新、修复错误等）collective.bluesky，这是一个很好的主意！

• 问题跟踪器
• 源代码
• 文档

我们感谢任何贡献，如果需要在PyPI上发布版本，请与我们中的任何一位联系。

本地开发

您需要一个工作状态下的python环境（系统、virtualenv、pyenv等），版本为3.8或更高。

然后使用以下命令安装依赖项和开发实例：

make build

更新翻译

make i18n

格式化代码库

make format

运行测试

此包的测试使用pytest和tox进行。

运行所有测试

make test

运行所有测试，但在第一个错误时停止并打开pdb会话

./bin/tox -e test -- -x --pdb

仅运行匹配TestAppDiscovery的测试

./bin/tox -e test -- -k TestAppDiscovery

仅运行匹配TestAppDiscovery的测试，但在第一个错误时停止并打开pdb会话

./bin/tox -e test -- -k TestAppDiscovery -x --pdb

翻译

此产品已翻译成

• 英语（Érico Andrei）
• 葡萄牙语（巴西）（Érico Andrei）

许可证

项目采用GPLv2许可证。

最后一件事

最初由巴西圣保罗的你的朋友们@Simples Consultoria用爱制作。

现在由Plone Collective维护

贡献者

• Érico Andrei，@ericof

变更日志

1.0.0a3（2023-09-22）

错误修复

• 修复超过1MB的图像的缩放上传@ericof #4

1.0.0a2（2023-09-13）

错误修复

• 实现回退到超过300个字符的帖子。[@ericof] #1
• 实现超过1MB的图像的回退。[@ericof] #2

1.0.0a1（2023-08-29）

新功能

• collective.bluesky的初始实现[@ericof] #0