المزامنة مع GitHub

طُوّرت هذه الميزة بواسطة ayaka-notes/overleaf-pro، وعدّلها yu-i-i/overleaf-cep. وهي متاحة بدءًا من الإصدار v6.2.0 وما بعده. لا تزال في مرحلة تجريبية (beta). نحتاج إلى ملاحظاتك إذا واجهت أي مشكلة.

​

إعداد المزامنة مع GitHub

يجب عليك تفعيل git-bridge أولًا قبل استخدام المزامنة مع GitHub.

config/overleaf.rc

GIT_BRIDGE_ENABLED=true

انتقل إلى إعدادات المطورين لإنشاء تطبيق GitHub OAuth الخاص بك، وانسخ CLIENT_ID وSECRET.

ملاحظة: عنوان URL لاستدعاء OAuth (callback) الخاص بك هو: ${OVERLEAF_SITE_URL}/user/github-sync/oauth2/callback.

بعد ذلك، أضف الإعدادات التالية إلى ملفات متغيرات البيئة الخاصة بـ overleaf.

config/variables.env

# used to encrypt the user's GitHub access token.
# How to generate: `openssl rand -hex 32`
GITHUB_TOKEN_CIPHER_PASSWORD=0123456789ABCDEFG # changed to yours

# Github Sync Settings
GITHUB_SYNC_ENABLED=true
GITHUB_SYNC_CLIENT_ID=
GITHUB_SYNC_CLIENT_SECRET=

# OAuth callback is: ${OVERLEAF_SITE_URL}/user/github-sync/oauth2/callback
# (Optional) GITHUB_SYNC_PROXY_URL=http://10.0.0.1:10808

قبل تكوين عنوان URL لاستدعاء GitHub OAuth، تأكد من ضبط OVERLEAF_SITE_URL بشكل صحيح.

إذا كنت موجودًا في البر الرئيسي للصين، فقد تحتاج إلى تكوين وكيل (proxy) للوصول إلى GitHub. اضبط متغير البيئة التالي: GITHUB_SYNC_PROXY_URL=http://10.0.0.1:10808.

لا تستخدم 127.0.0.1 كمضيف للوكيل. إذا كان الوكيل يعمل على الخادم المضيف، فاستخدم عنوان IP الخاص بالخادم على الشبكة المحلية (مثل 192.168.1.xx) وتأكد من تكوين الوكيل لقبول الاتصالات من الأجهزة على الشبكة المحلية.