fiduswriter-gitrepo-export
A plugin to export books to GitLab/GitHub.
To install:
-
Make sure you have installed the
fiduswriter-books
plugin and you have updated bothfiduswriter
andfiduswriter-books
to the latest patch release. -
Install this plugin (for example by running
pip install fiduswriter-gitrepo-export
). -
In your configuration.py file, add "gitrepo_export" and "allauth.socialaccount.providers.github" and/or "allauth.socialaccount.providers.gitlab" to
INSTALLED_APPS
.
4a. Set up GitHub as one of the connected login options. See instructions here: https://django-allauth.readthedocs.io/en/latest/providers.html#github . The callback URL will be in the format https://DOMAIN.NAME/api/github/github/login/callback/
5a. In your configuration.py file, make sure to add repo rights for the github connector like this::
SOCIALACCOUNT_PROVIDERS = {
'github': {
'SCOPE': [
'repo',
'user:email',
],
}
}
4b. Set up GitLab as one of the connected login options. See instructions here: https://django-allauth.readthedocs.io/en/latest/providers.html#gitlab . The callback URL will be in the format https://DOMAIN.NAME/api/gitlab/gitlab/login/callback/
5b. In your configuration.py file, make sure to add repo rights for the gitlab connector like this::
SOCIALACCOUNT_PROVIDERS = {
'gitlab': {
'SCOPE': [
'api',
],
}
}
To use:
-
Login to your Fidus Writer instance using GitHub/GitLab, or login with a regular account and connect a Gitlab/Github account on the profile page (https://DOMAIN.NAME/user/profile/)
-
Go to the books overview page.
-
Enter a book to set the gitrepo settings for the book.
-
Select the book in the overview and export to gitrepo via the dropdown menu.