fiduswriter-gitrepo-export

一个将书籍导出到GitLab/GitHub的插件。

安装

1. 确保您已安装fiduswriter-books插件，并且已将fiduswriter和fiduswriter-books更新到最新补丁版本。

2. 安装此插件（例如，通过运行pip install fiduswriter-gitrepo-export）。

3. 在您的配置.py文件中，将"gitrepo_export"和"allauth.socialaccount.providers.github"以及/or "allauth.socialaccount.providers.gitlab"添加到INSTALLED_APPS。

4a. 将GitHub设置为连接的登录选项之一。请参见此处说明： https://django-allauth.readthedocs.io/en/latest/providers.html#github 。回调URL的格式为 https://DOMAIN.NAME/api/github/github/login/callback/

5a. 在您的配置.py文件中，确保添加github连接器的仓库权限如下：

SOCIALACCOUNT_PROVIDERS = {
    'github': {
        'SCOPE': [
            'repo',
            'user:email',
        ],
    }
}

4b. 将GitLab设置为连接的登录选项之一。请参见此处说明： https://django-allauth.readthedocs.io/en/latest/providers.html#gitlab 。回调URL的格式为 https://DOMAIN.NAME/api/gitlab/gitlab/login/callback/

5b. 在您的配置.py文件中，确保添加gitlab连接器的仓库权限如下：

SOCIALACCOUNT_PROVIDERS = {
    'gitlab': {
        'SCOPE': [
            'api',
        ],
    }
}

使用

1. 使用GitHub/GitLab登录Fidus Writer实例，或登录常规账户并在个人资料页面（https://DOMAIN.NAME/user/profile/）连接Gitlab/Github账户。

2. 转到书籍概览页面。

3. 输入一本书来设置该书的gitrepo设置。

4. 在概览中选择书籍，并通过下拉菜单导出到gitrepo。