开发附加组件

附加组件 是在 Weblate 中自定义本地化工作流的方法。

class weblate.addons.base.BaseAddon(storage: Addon)

Weblate 附加组件的基础类。

classmethod can_install(component: Component, user: User | None)

检查附加组件是否与给定部件兼容。

component_update(component: weblate.trans.models.Component) → None

部件更新的事件句柄。

configure(configuration) → None

保存配置。

daily(component: weblate.trans.models.Component) → None

事件句柄日报。

classmethod get_add_form(user: User | None, *, component: Component | None = None, project: Project | None = None, **kwargs)

返回用于添加新附加组件的配置表单。

get_settings_form(user: User | None, **kwargs)

返回此附加组件的配置表单。

post_add(translation: Translation) → None

添加新翻译后的事件句柄。

post_commit(component: weblate.trans.models.Component, store_hash: bool) → None

提交更改到仓库后的事件句柄。

post_push(component: weblate.trans.models.Component) → None

仓库推送到上游之后的事件句柄。

post_update(component: weblate.trans.models.Component, previous_head: str, skip_push: bool) → None

仓库从上游更新之后的事件句柄。

参数:

• previous_head (str) – 仓库更新前的 HEAD，在初始克隆时可以是空白的。

• skip_push (bool) – 附加组件操作是否应该跳过将更改推送到上游。通常可以将这个作为``commit_and_push``或 commit_pending 传递到底层方法。

pre_commit(translation: Translation, author: str, store_hash: bool) → None

更改被提交到仓库前的事件句柄。

pre_push(component: weblate.trans.models.Component) → None

仓库推送上游之前的事件句柄。

pre_update(component: weblate.trans.models.Component) → None

仓库从上游更新之前的事件句柄。

save_state() → None

保存附加组件状态信息。

store_post_load(translation: Translation, store: TranslationFormat) → None

文件解析后的事件句柄。

它接收文件格式类的事件作为变量。

这对修复该文件格式类参数有用，例如，调整文件如何存储。

unit_pre_create(unit: Unit) → None

创建新单元前的事件句柄。

user()

被此附加组件用来追踪变化的 Weblate 用户。

class weblate.addons.models.Addon

附加组件的 ORM 对象。

class weblate.trans.models.Component

部件的 ORM 对象。

class weblate.trans.models.Translation

翻译的 ORM 对象。

class weblate.trans.models.Project

项目的 ORM 对象。

class weblate.trans.models.Unit

一个单元的 ORM 对象。

class weblate.trans.models.User

一名用户的 ORM 对象。

class weblate.trans.models.TranslationFormat

翻译文件包装器。

这里是一个附加组件的示例：

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

from django.utils.translation import gettext_lazy

from weblate.addons.base import BaseAddon
from weblate.addons.events import AddonEvent


class ExampleAddon(BaseAddon):
    # Filter for compatible components, every key is
    # matched against property of component
    compat = {"file_format": {"po", "po-mono"}}
    # List of events add-on should receive
    events = (AddonEvent.EVENT_PRE_COMMIT,)
    # Add-on unique identifier
    name = "weblate.example.example"
    # Verbose name shown in the user interface
    verbose = gettext_lazy("Example add-on")
    # Detailed add-on description
    description = gettext_lazy("This add-on does nothing it is just an example.")

    # Callback to implement custom behavior
    def pre_commit(self, translation, author: str, store_hash: bool) -> None:
        return