gitpkg - عبر الإنترنت في السحابة

برنامج:

اسم

gitpkg - تصدير حزمة مصدر دبيان من مراجعات git المرشحة

موجز

gitpkg خيران [origbranch]

الوصف

If gitpkg يتم تشغيله في طائرة نفاثة(1) الريبو مع تحديد "فرع" واحد، ثم سيتم تنفيذ شخص سخيف-
أرشيف تصدير هذا الفرع إلى DEB_DIR الدليل. إذا كانت الحزمة أصلية في دبيان
سيقوم ببساطة بإنشاء حزمة مصدر منه. إذا كانت الحزمة تحتوي على إصدار دبيان، إذن
من المتوقع أن تكون كرة القطران الأصلية موجودة بالفعل لها. إذا لم يحدث ذلك في كرة القطران الأصلية
موجودة بالفعل ثم ما سيحدث بعد ذلك يعتمد على قيمة gitpkg.create-fake-orig
خيار التكوين (الموصوف أدناه).

If gitpkg يتم استدعاؤه مع تحديد فرعين، ثم سيتم تصدير الفرع الأول
كمصدر كامل مفكك، بينما سيتم تصدير الفرع الثاني لملف
orig.tar.gz. يسمح هذا بتسجيل جميع التغييرات المحلية على المصدر في النتيجة
diff.gz في حالة وجود فرع أصلي في المستودع. إذا كانت كرة القطران الأصلية
موجود بالفعل للإصدار الموجود في "الفرع"، ثم يعتمد ما يحدث بعد ذلك على قيمة
هيه gitpkg.force-overwrite-orig خيار التكوين (الموصوف أدناه).

و'خيران' يجب أن يكون لديك دائمًا ملف ديبيان/ دير ويمكن أن يكون أي شجرة العش الكائن الذي هو
قبلت من طرف git-archive(1). ال 'origbranch'، إذا تم توفيره، فيجب ألا يحتوي عادةً على ملف
ديبيان/ دير.

CONFIGURATION OPTIONS

تقريبا جميع gitpkg تتم معالجة التكوين باستخدام بوابة التكوين(١) الآن. الأتى
خيارات التكوين مدعومة:

gitpkg.deb-dir
قد يتم ضبطه لتجاوز دليل الوجهة الافتراضي للحزم المصدرة.
الافتراضي هو '../deb-packages'. متاح لربط البرامج النصية كما DEB_DIR. هذا ممكن
تم تجاوزه في سطر الأوامر باستخدام --deb-dir=مسار الخيار.

gitpkg.build-rootcmd
قد يتم ضبطه لتجاوز الأمر الافتراضي المستخدم للحصول على الجذر لبناء الحزمة
عمليات. الافتراضي هو 'com.fakeroot'. متاح لربط البرامج النصية كما BUILD_ROOTCMD.

gitpkg.prebuild-target
يمكن تعيينها على هدف أو أهداف من ديبيان / القواعد والذي سيتم استدعاؤه بعد
يتم تصدير شجرة مصدر دبيان، ولكن قبل إنشاء الحزمة المصدر. بعض
قد تستخدم الحزم هذا لإنشاء ملفات autoconf أو ما شابه ذلك، وهو ما ينبغي
بشكل عام، لا يكون موجودًا في الريبو، ولكن يجب أن يكون موجودًا في الحزمة الموزعة. ال
يتم استدعاء الهدف باستخدام ملف BUILD_ROOTCMD. الاستخدام الشائع لهذا الخطاف سيكون
اتصل بالحزمة 'نظيف' هدف. لم يتم تعيين هذا الخطاف افتراضيًا منذ gitpkg
0.18. قبل ذلك، تخلف عن الهدف النظيف. متاح للربط
البرامج النصية كما PREBUILD_TARGET.

gitpkg.orig-compressor
يمكن ضبطه لتجاوز الضغط الافتراضي لملف package.orig.tar المُصدَّر.
الافتراضي هو 'GZIP'. بالنسبة لحزم التنسيق 3.0، تتضمن القيم الصالحة أيضًا xz
bzip2. متاح لربط البرامج النصية كما ORIG_COMPRESSOR.

gitpkg.orig-مستوى الضغط
مستوى ضغط اختياري للاستخدام معه gitpkg.orig-compressor. 1 هو عادة
الأسرع و9 عادة ما يكون الأصغر، مع التفاصيل الدقيقة لكل شيء
بين أن يصل إلى الضاغط المختار. تم إلغاء تعيين الإعداد الافتراضي (والذي سيستخدم
مهما كان الضاغط الافتراضي). متاح لربط البرامج النصية كما
ORIG_COMPRESS_LEVEL.

gitpkg.deb-ضاغط
قد يتم ضبطه لتجاوز الضغط الافتراضي الذي يستخدمه مصدر dpkg(١) للتصدير
الحزم. الافتراضي (إذا لم يتم ضبطه) هو استخدام أي شيء مصدر dpkg يريد استخدامه. ل
حزم التنسيق 3.0، تتضمن القيم الصالحة أيضًا xz bzip2. متاح للربط
البرامج النصية كما DEB_COMPRESSOR.

gitpkg.deb-مستوى الضغط
مستوى ضغط اختياري للاستخدام معه gitpkg.deb-ضاغط. 1 هو عادة
الأسرع و9 عادة ما يكون الأصغر، مع التفاصيل الدقيقة لكل شيء
بين أن يصل إلى الضاغط المختار. تم إلغاء تعيين الإعداد الافتراضي (والذي سيستخدم
مهما كانت مصدر dpkg الافتراضي هو حاليًا "9"). متاح لربط البرامج النصية كما
DEB_COMPRESS_LEVEL.

gitpkg.dpkg-source
قد يتم تعيينه لتمرير الخيارات التعسفية حرفيًا إلى مصدر dpkg(١) عند البناء
حزمة المصدر. استخدم بحذر وعلى مسؤوليتك الخاصة. لتمرير خيارات متعددة
إلى مصدر dpkg يجب عليك ضبط هذا الخيار عدة مرات (أي باستخدام طائرة نفاثة التكوين --يضيف
لكل خيار) نظرًا لمتطلبات الاقتباس المسلية لخيارات مثل
كـ "--format=3.0 (أصلي)". الافتراضي فارغ. متاح لربط البرامج النصية مثل
مجموعة مفهرسة DPKG_SOURCE_OPTS. لا تستخدم هذا لتعيين مصدر dpkg(1) -Z or -z
الخيارات، يجب بدلاً من ذلك تعيينها باستخدام ضاغط ديب مستوى ضغط deb
الخيارات على التوالي. قد يتم تجاوز هذا في سطر الأوامر باستخدام ملف
--dpkg-source=الأرجنتين الخيار، والذي يجب أيضًا تمريره عدة مرات لتعيينه
خيارات متعددة.

gitpkg.create-fake-orig
في بعض الأحيان يتم دمج كل من المصدر الرئيسي ودعم دبيان في ملف
فرع واحد من الريبو ولكنك لا تزال ترغب في إنشاء حزمة "غير أصلية" منه
هنا. gitpkg يمكنه تزييف كرة قطران أصلية من مثل هذه الشجرة من بين كل شيء ما عدا
محتويات دليل دبيان/. تعيين هذا الخيار على "صحيح" يجعل ذلك
السلوك هو السلوك الافتراضي إذا تم تمرير شجرة واحدة إليه gitpkg ولا المقابلة
تم العثور على كرة القطران الأصلية. سيؤدي تعيين هذا الخيار إلى "خطأ". gitpkg يفشل،
الإبلاغ عن خطأ، إذا تم تمرير شجرة واحدة ولم يتم تمرير كرة قطران أصلية مع
الإصدار الصحيح موجود بالفعل له (ولم يتم استرداد أي شيء بواسطة البرنامج النصي للربط
قبل الحاجة إليه). إذا لم يتم تعيين هذا الخيار، فستتم مطالبة المستخدم
للتصرف الصحيح إذا ظهرت هذه الحالة. تم إلغاء تعيين الإعداد الافتراضي. متاح
لربط البرامج النصية كما CREATE_FAKE_ORIG.

gitpkg.force-overwrite-orig
يتحكم هذا الخيار في سلوك gitpkg إذا كان الشجرة "أصلية" هي
المحدد والأصل الأصلي المطابق لـ "الفرع" موجود بالفعل. اذا هذا
تم ضبطه على "صحيح"، ثم سيتم استبدال orig.tar بمصدر الريبو (to
إعادة استخدام orig.tar الموجودة ببساطة اتصل gitpkg مع "فرع" دبيان الوحيد
Treeish الذي ترغب في تصديره). إذا تم تعيين هذا على "خطأ"، فهذا خطأ فادح
محاولة تصدير المصدر الرئيسي مرة أخرى عندما يكون orig.tar موجودًا بالفعل، و
gitpkg سوف أنهي ويوبخك إذا حاولت. إذا لم يتم تعيينه، فستتم مطالبتك بذلك
حول ما إذا كان سيتم الكتابة فوقه أم لا، وسيستمر البناء في استخدام أيهما
من الاثنين اللذين اخترتهما تم إلغاء تعيين الإعداد الافتراضي. متاح لربط البرامج النصية كما
FORCE_OVERWRITE_ORIG.

gitpkg.keep-unpacked-source
يتحكم هذا الخيار في ما إذا كان سيتم الاحتفاظ بالدليل المصدر الذي تم فك حزمته بعد الملف
تم إكمال ربط تصدير الحزمة والخروج بنجاح. إذا تم ضبط هذا على
"صحيح"، سيتم الاحتفاظ بالمصدر الذي تم فك حزمته. إذا تم ضبطه على "خطأ" أو عدم ضبطه، فهذا يعني أنه
ستتم إزالة الدليل كعملية نهائية من قبل gitpkg مخارج إذا كان كل شيء قبل ذلك
تمت العمليات بنجاح. تم إلغاء تعيين الإعداد الافتراضي. متاح لربط البرامج النصية كما
KEEP_UNPACKED_SOURCE. قد يتم تجاوز هذا في سطر الأوامر باستخدام ملف
--keep-unpacked-source=منطقي الخيار (حيث لن يحتفظ به "لا" أو "خطأ"، وأي
قيمة أخرى، بما في ذلك لا شيء، سوف).

SCRIPT HOOKS

يمكن استدعاء البرامج النصية المحددة من قبل المستخدم من عدد من النقاط أثناء إنشاء الحزمة
عملية. يتم الحصول عليها من gitpkg كمقتطفات bash Shell، في معظم الحالات في ملف
قذيفة فرعية، حتى يتمكنوا من قراءة متغيرات الحالة وتنفيذ إجراءات خارجية، ولكن لا يمكنهم التغيير
التكوين قيد التشغيل بمجرد أن يكون البناء قيد التقدم. إذا عاد الخطاف بغير الصفر
الوضع إذن gitpkg سيتم إنهاء. (الخطافات التي تنهي gitpkg يجب أن تستغرق بعض الوقت
احرص على عدم ترك الكثير من الفوضى، ولكن يجب أيضًا ترك أدلة كافية سليمة
المستخدم لتشخيص وإصلاح أي مشكلة كانت. رسائل خطأ مفيدة وغنية بالمعلومات
يجب أن ينبح حتى stderr قبل الخروج بهذه الطريقة.)

قد يتم تثبيت البرامج النصية للخطاف على النظام المضيف خارج شجرة الريبو، أو يمكن الحصول عليها من المصدر
نسخة تسيطر عليها الملفات في الريبو نفسه. كلتا الطريقتين لها مزايا ومخاطر
حالات استخدام مختلفة. يتم تنشيط البرامج النصية للخطاف بواسطة المسؤول المحلي، عن طريق تعيين كل منها
ذات الصلة بوابة التكوين(1) الخيار مع المسار إلى البرنامج النصي المراد تنفيذه. قد تكون المسارات
مطلق أو نسبة إلى الدليل الذي يتم استدعاء هذا الخطاف منه. إذا تم تعيين هوك،
النص يجب موجودة عندما يتم استدعاؤها. وينبغي الحرص على تمكينها للاستخدام فقط
بواسطة أشجار مصدر موثوقة عند ربط الملفات الموجودة في الريبو نفسه. عادة يجب عليك
تمكينهم على أساس كل الريبو مع بوابة التكوين(١) وليس في أ --عالمي or --النظام
.

A موجز عتاب ضد الحصول على معلق:
يجب عليك تجنب أن تصبح ترتيبات الخطاف المعقدة داخل العبوة ضرورية للتصدير
مصدر الحزمة الخاصة بك. إذا كنت في حاجة إليها لإنشاء حزمة معينة بشكل صحيح، وتحتاج
نسخة صارمة ملزمة بالمصدر الذي تم إصداره، وهي ليست مفيدة لأي شخص آخر
الحزمة على الإطلاق... فمن المحتمل جدًا أنك تفعل شيئًا ما، أو عدة أشياء، تمامًا
خطأ. وإلا فأنت في حالة من الفوضى العميقة التي تعمل حول نظام بناء معطل مثلك
لا تحتاج لي أن أقول لك عن ذلك. وفي كلتا الحالتين، يجب على المسؤول المحلي تمكين الخطافات الخاصة بك
قبل أن يتمكنوا من الركض، لذا إذا كنت تريد أن تكون ودودًا مع الآخرين (ونفسك)، فاحتفظ بالرمز
تعمل العبوة "العادية" بشكل صارم داخل أدوات بناء العبوة المعتادة، وتترك
خطافات gitpkg مجانية للمسؤولين المحليين الآخرين لتغليف أي عملية أتمتة هم حاجة
حول الأشياء. إذا كان إصدار معين من مصدر الحزمة يحتاج إلى بعض المواصفات
الإجراءات التي تم تنفيذها عليه قبل إنشاء الحزمة المصدر الأولى، ثم PREBUILD_TARGET
الخيار من الأعلى هو على الأرجح ما تريده وليس أحد هذه الخطافات. آخر
يمكن للأشخاص استخدام ذلك مرة أخرى لاحقًا دون الحاجة إلى وجود gitpkg. الهدف هو ل
هذا لمساعدتك. لبعض قيم لكم جميعا. لذا كن حذرًا لتجنب السماح بذلك
قم بإفساد الأشخاص الآخرين إذا لم يتم استدعاء الخطاف، و/أو دعهم يعرفون ما يحتاجون إليه
افعل بدلاً من ذلك إذا لم يكن الأمر كذلك. حسنًا، هناك الشوكة التي يجب الانتباه إليها، لذا عد إلى هذه النقطة
مرة أخرى:

صنارة صيد نقطة
تم إدراج نقاط الربط المتوفرة أدناه بالترتيب الذي كانت عليه عادةً
استدعى:

gitpkg.package-config-hook
يعمل هذا الخطاف في دليل المستوى الأعلى للريبو gitpkg تم استدعاؤه في السابق
إلى أي عمليات تجري، مع كافة بوابة التكوين(1) خيارات المصادر المتاحة ل
هو - هي. لا تتوفر معلومات تفصيلية حول الحزمة نفسها في الخطاف
البيئة حتى الآن، ولا حتى اسمها أو نسختها، فقط الشجرة (الأشجار) التي gitpkg
تم تمريره من قبل المستخدم، ولكن قد يقوم الخطاف بإجراء عمليات فحص ذاتية خاصة به بناءً على
المحتويات الحالية (وربما "القذرة") لشجرة العمل gitpkg تم استدعاؤه في.

هذا الخطاف قادر على تعديل gitpkg متغيرات التكوين اللاحقة
عمليات. يمكنه إجراء عمليات على الريبو إذا لزم الأمر، ولكن بما أنه يحتاج إلى ذلك
أن تكون ملتزمًا بالريبو قبل أن يتم استدعاؤه، فقد لا يكون ذلك مفيدًا جدًا
هنا في الممارسة العملية. في الأساس، يمكنها أن تفعل أي شيء تريده، إنها مجرد قوقعة
النص، لم يبدأ أي شيء آخر حقًا بعد، وقد تم نقله إلى الأعلى
مستوى القشرة gitpkg.

عملها يختلف عن admin-config-hook في جانب واحد فقط، وهو المسار
إلى هذا الخطاف يجب يكون مرتبطًا بـ TLD الخاص بالريبو ومراجعة الملف
التي سيتم الحصول عليها يتم سحبها من الشجرة "الفرعية". gitpkg وكان
طلبت التصدير. يجب أن يكون الملف موجودًا في هذا الإصدار في المسار المحدد.

متاح لربط البرامج النصية كما PACKAGE_CONFIG_HOOK.

gitpkg.admin-config-hook
يتم تشغيل هذا الخطاف بعد ربط الحزمة التكوين يعود، ويختلف عنه في
العملية فقط من خلال قراءة ملف ثابت من نظام الملفات الحالي بدلا من
استخراج نسخة يتم التحكم فيها من الريبو الذي يتم تصديره.

يمكن للمسؤول المحلي استخدام هذا لتجاوز أي خيارات محددة للحزمة
ربما تم تعيينها من قبل ربط الحزمة التكوين، مع تكوين خاص بالموقع.
هذه سيطرة سياسية وليست أمنية. كان الأمن في كل مكان عندما سمحت
هيه ربط الحزمة التكوين run، وهذا يتيح لك تجاوزه دون الحاجة إلى التزييف
تنفيذ التزام جديد بتغيير ربط الحزمة.

هذا هو الخطاف الأخير الذي يمكن تشغيله والذي يمكنه تعديل ملف gitpkg التكوين و
قم بتعيين خيارات البيئة التي ستكون مرئية للخطافات اللاحقة. متاح للربط
البرامج النصية كما ADMIN_CONFIG_HOOK. قد يتم تجاوز هذا في سطر الأوامر باستخدام ملف
--admin-config-hook=مسار الخيار.

gitpkg.pre-export-hook
يعمل هذا الخطاف في دليل المستوى الأعلى للريبو، بعد اسم الحزمة و
تم تحديد الإصدار، ومع التكوين النهائي للحزمة بما في ذلك
أي التغيير والتبديل من قبل السنانير السابقة. لا يمكن تغيير أي خيارات التكوين،
التصرف فقط عليها أو إنهاءها gitpkg.

يمكن استخدام هذا للقيام بأشياء مثل استدعاء القطران الأصلي أو الجلب المسبق لأصل موجود
كرة القطران من بعض المصادر الأجنبية. ويجوز له إجراء عمليات على الريبو إن وجدت
هذا هو المطلوب، أو أي فحص آخر في اللحظة الأخيرة يجب القيام به قبلنا
في الواقع، نقوم بمهمة تصدير المصدر الذي نريد تعبئته.

متاح لربط البرامج النصية كما PRE_EXPORT_HOOK.

gitpkg.deb-export-hook
يعمل هذا الخطاف في دليل المستوى الأعلى لمصدر دبيان المصدر،
مباشرة بعد تصدير المصدر من الطلب شجرة العشو
مباشرة قبل PREBUILD_TARGET يتم استدعاؤه (إذا تم توفيره). لا تستطيع
قم بتغيير أي خيارات تكوين، أو التصرف بناءً عليها فقط أو إنهاؤها gitpkg. لو هذا
ينتهي الخطاف gitpkg، سيتم ترك الدليل المصدر المصدر على النظام
ليقوم المستخدم بفحصها. الدعوات اللاحقة ل gitpkg لنفس الإصدار
الإصدار سوف يقوم بالكتابة فوقه بالرغم من ذلك. متاح لربط البرامج النصية كما DEB_EXPORT_HOOK.

gitpkg.orig-export-hook
يعمل هذا الخطاف في دليل المستوى الأعلى للمصدر "المنبع" المُصدَّر،
مباشرة بعد تصدير المصدر من المقدمة شجرة العشو
قبل أن يتم ضغطها في كرة القطران. لا يمكن تغيير أي تكوين
الخيارات، فلا يتصرف إلا بها أو ينهيها gitpkg. إذا انتهى هذا الخطاف gitpkg,
سيتم ترك الدليل المصدر الذي تم تصديره على النظام ليقوم المستخدم بفحصه.
الدعوات اللاحقة ل gitpkg لنفس الإصدار الإصدار سيتم الكتابة فوقه
بالرغم من ذلك.

هذا هوك فقط يتم استدعاؤه إذا تم تصدير "origbranch" الأولي بالفعل من
المستودع. إذا تم العثور على orig.tar موجود أو تم إنشاؤه بواسطة البعض
ربط سابق (ولا يتم الكتابة فوقه، انظر فرض الكتابة فوق الأصل فوق)،
ومن ثم يُفترض أن العمليات التي سيؤديها هذا الخطاف قد حدثت بالفعل
لهذا القطران ويتم تخطيه.

ليس من الآمن افتراض أنه سيتم تنفيذ هذا الخطاف قبله أو بعده ديب-
خطاف التصدير، وقد يتم تشغيله بالتوازي معه في مرحلة ما في
مستقبل. سيتم إدخالهما بعد ذلك خطاف ما قبل التصدير يعود، و خطاف الخروج
لن يبدأ إلا (على الأقل) بعد عودة كلاهما. ماذا يحدث أيضًا في
ووسط كل ذلك لا نقدم أي وعود قاطعة بشأنها في هذه المرحلة.

متاح لربط البرامج النصية كما ORIG_EXPORT_HOOK.

gitpkg.exit-hook
يعمل هذا الخطاف في الدليل حيث توجد الحزمة .dsc تم إيداعه بواسطة دبكج-
مصدر(١) أي داخلي gitpkg لقد اكتملت العمليات بنجاح. إنه
فات الأوان لتغيير أي خيارات التكوين، أو حتى إنهاء gitpkg هل حقا.
يمكنك أن تفعل ما تريد إلى حد كبير من هذا، أي شيء يحدث بشكل خاطئ
هنا هو عملك الخاص. متاح لربط البرامج النصية كما EXIT_HOOK. هذا ممكن
تم تجاوزه في سطر الأوامر باستخدام --exit-hook=مسار الخيار.

صنارة صيد البيئة
تم توفير المتغيرات التالية للبرامج النصية للربط، بالإضافة إلى تلك الموجودة بالفعل
مدرج على أنه تظليل أ بوابة التكوين الخيار من فوق. ليست جميعها صالحة/مفيدة في
جميع نقاط الربط، راجع وثائق الربط أعلاه للتعرف على الاستثناءات المطبقة على نقاط محددة
خطاف.

GITPKG_HOOK_API
يسمح للبرامج النصية للربط بالاستعلام عن الواجهات المتاحة لهم. لديه اثنين فقط
مكونات رقمية مفصولة بـ "." منها الرقم الموجود على يمين النقطة
ستزداد في كل مرة نضيف فيها متغيرًا جديدًا قد يصل إليه الخطاف، أو
أضف بعض المقابض الجديدة التي قد تعدل حيث لم تتغير الواجهات الحالية.
إذا أخطأنا واحتجنا إلى تغيير بعض الواجهة الحالية، فالرقم الموجود على اليسار
سوف تحصل على صدم. إصدار API الحالي هو 0.2

متوفرة in API الإصدار 0.1
كانت هذه المتغيرات متاحة للخطافات منذ إصدار gitpkg 0.13

GITPKG_TREEISH
شجرة "فرع" دبيان التي مررها المستخدم والتي تم استدعاء gitpkg لتصديرها.

GITPKG_ORIG_TREEISH
شجرة "Origbranch" التي تم استدعاء gitpkg بها. سيكون هذا فارغًا إذا فقط
تم تحديد شجرة "فرع" واحدة.

DEB_SOURCE
اسم الحزمة المصدر المطلوب إنشاؤها، بدون أي إصدار. كما رأينا في
المصدر : مجال dpkg-parsechangelog(1).

DEB_VERSION
إصدار الحزمة المصدر المطلوب إنشاؤه، دون أي حقبة. كما رأينا في
اسم الملفات .diff.gz و.dsc.

UPSTREAM_VERSION
إصدار الحزمة المصدر المراد إنشاؤها، بدون أي إصدار دبيان. كما تبدو
بإسم القطران الأصلي . بالنسبة للحزم الأصلية، سيكون هذا هو نفسه
DEB_VERSION.

DEB_ORIG
اسم الملف ذو الإصدار الكامل من tarball الأصلي لاستخدامه أو إنشائه. هذا المتغير هو
فارغ للحزم الأصلية التي لا تحتوي على جزء إصدار دبيان.

DEB_DSC
اسم الملف الكامل للحزمة .dsc التي سيتم أو تم إنشاؤها.

DEB_PACKAGE
اسم الدليل للشجرة المصدرية المنقحة للتمرير إليها مصدر dpkg(1).

REPO_DIR
المسار المطلق إلى دليل المستوى الأعلى لـ git repo الذي نقوم بالتصدير منه.
عادة، إذا كنت بحاجة إلى النظر خارج الشجرة التي أسقطت فيها، فأنت كذلك
ربما تفعل شيئا (في) خطأ (الوقت)، ولكن هناك استثناءات، ويجري
قادرة على الاستعلام بوابة التكوين الخيارات هي واحدة منهم. هذا في الغالب ما هو هذا
في الوقت الحالي. انظر الريبو التكوين المساعد موثقة أدناه. كن حذرا إذا قمت بذلك
استخدمه في أشياء أخرى كثيرة.

متوفرة in API الإصدار 0.2
كانت هذه المتغيرات متاحة للخطافات منذ إصدار gitpkg 0.24

GITPKG_AOPTS
مصفوفة ترابطية تحتوي على خيارات سطر الأوامر التي لم يتم تحليلها بواسطة gitpkg
نفسها والتي يمكن استخدامها لتجاوز سلوك الخطاف. المصفوفة مرتبطة
على أسماء الخيارات مع إزالة "--". إذا تم تمرير الخيار
عدة مرات، سيتم تخزين القيمة الأخيرة التي تم تمريرها فقط في هذه المصفوفة. ل
مثال:

$ gitpkg --my-option=foo --option2 --opt=oops --opt='bar baz'

سنعطي:

${GITPKG_AOPTS[my-option]} = "foo"
${GITPKG_AOPTS[option2]} = ""
${GITPKG_AOPTS[opt]} = "شريط باز"

GITPKG_IOPTS
مصفوفة مفهرسة تحتوي على خيارات سطر الأوامر التي لم يتم تحليلها بواسطة gitpkg نفسها
والتي يمكن استخدامها لتجاوز سلوك الخطاف. تحتوي المصفوفة على
تم تمرير سلاسل الخيارات الحرفية وبالتالي يمكن استخدامها للوصول إلى الخيارات الموجودة
المقصود أن يتم تمريرها عدة مرات. على سبيل المثال:

$ gitpkg --my-option=foo --option2 --opt=oops --opt='bar baz'

سنعطي:

${GITPKG_IOPTS[0]} = "--my-option=foo"
${GITPKG_IOPTS[1]} = "--option2"
${GITPKG_IOPTS[2]} = "--opt=oops"
${GITPKG_IOPTS[3]} = "--opt=شريط باز"

إنّ extract_values_for_option وظيفة في الريبو التكوين المساعد (انظر أدناه للحصول على التفاصيل
منه) يمكن استخدامه لتحليل هذه المصفوفة بشكل أكبر للحصول على جميع القيم (القيم) لـ a
خيار محدد.

صنارة صيد المكتبة
هناك بعض البرامج النصية المعلبة لمختلف المهام المتوفرة في /usr/share/gitpkg/hooks
والتي تشمل حاليا:

خطاف الخروج من البقر
خطاف خروج بسيط يرسل الحزمة المصدرة للبناء باستخدامها البقر(1).
لتمكينه:

$ git config gitpkg.exit-hook /usr/share/gitpkg/hooks/cowpoke-exit-hook

إضافي بوابة التكوين(1) خيارات التكوين:

gitpkg-cowpoke-exit-hook.ask-first
إذا كانت الإجابة "صحيحة"، فاطلب التأكيد قبل الاتصال البقر. الافتراضي هو فقط
استمر وقم بذلك.

gitpkg-cowpoke-exit-hook.options
قد يتضمن أي خيارات أخرى لتمريرها حرفيًا البقر. لتمرير متعددة
الخيارات، اضبط هذا عدة مرات، مرة واحدة لكل خيار. هذا قد يكون
تم تجاوزه في سطر الأوامر باستخدام --cowpoke=الأرجنتين الخيار، وهو كذلك
يجب تمريرها عدة مرات لتعيين خيارات متعددة.

dpkg-buildpackage-exit-hook
خطاف خروج بسيط لبناء الحزم الثنائية محليًا dpkg-buildpackage(1). ل
تمكينه:

$ git config gitpkg.exit-hook /usr/share/gitpkg/hooks/dpkg-buildpackage-exit-hook

إضافي بوابة التكوين(1) خيارات التكوين:

gitpkg-dpkg-buildpackage-exit-hook.ask-first
إذا كانت الإجابة "صحيحة"، فاطلب التأكيد قبل الاتصال dpkg-buildpackage. إفتراضي
هو مجرد القيام بذلك.

gitpkg-dpkg-buildpackage-exit-hook.options
قد يتضمن أي خيارات أخرى لتمريرها حرفيًا dpkg-buildpackage. ليمر
خيارات متعددة، اضبط هذا عدة مرات، مرة واحدة لكل خيار. هذا قد يكون
تم تجاوزه في سطر الأوامر باستخدام --dpkg-bp=الأرجنتين الخيار، وهو كذلك
يجب تمريرها عدة مرات لتعيين خيارات متعددة.

gitpkg-dpkg-buildpackage-exit-hook.build-log
إذا تم تعيين "خطأ" فلا تقم بحفظ سجل لعملية الإنشاء، فالإعداد الافتراضي هو التسجيل
.

خطاف القطران الأصلي قبل التصدير
خطاف لاستخراج كرة القطران الأصلية باستخدام القطران البكر. ما هو الأصل الذي يجب استخراجه
يتم تحديده بواسطة إصدار حزمة الشجرة "الفرعية". لتمكينه:

$ git config gitpkg.pre-export-hook /usr/share/gitpkg/hooks/pristine-tar-pre-export-hook

إذا لم يتم العثور على فرع القطران الأصلي في الريبو، فسيتم إنهاء gitpkg.

لحاف-بقع-ديب-تصدير-هوك
يقرأ هذا الخطاف قائمة نطاقات المراجعة المناسبة لها بوابة تنسيق التصحيح(1) من
ملف ديبيان/المصدر/git-patches، واحد في كل سطر، ويتم تصديرها إلى ديبيان / بقع
الدليل في شكل مناسب لحزم اللحاف (تنسيق 3.0). ليس مطلوبا ل
إنشاء مثل هذه الحزم، ولكنه يسمح لك بفصل التصحيحات الفردية كيفما شئت
يرجى من التصحيح الفردي الافتراضي الذي تم إنشاؤه بواسطة مصدر dpkg.

لتمكينه:

$ git config gitpkg.deb-export-hook /usr/share/gitpkg/hooks/quilt-patches-deb-export-hook

محتويات ديبيان/المصدر/git-patches قد تتضمن تعليقات (في أي بداية سطر
بعلامة #)، وأسطر فارغة، وتعبيرات لمجموعة من الالتزامات. نطاقات المراجعة
قد يتضمن $DEB_VERSION, $UPSTREAM_VERSION, $DEB_REF or $UPSTREAM_REF. الأول
سيتم استبدال الزوج بإصدار الحزمة التي يتم تصديرها، والثاني
قم بالاقتران بسلاسل الإصدار هذه بعد تشويهها sanitise_git_ref لإعادة رسم خريطة لهم إلى أ
البوابة القانونية refname. يفضل استخدام الإصدارات المعقمة في معظم الحالات.
فمثلا:

# تصدير جميع الالتزامات بين هاتين الشجرتين،
# بناءً على إصدار الحزمة التي يتم تصديرها.

المنبع/$UPSTREAM_REF..patches/$DEB_REF

خطاف تصدير ديبشيري
يستدعي هذا الخطاف بوابة ديبشيري(1) للعثور على التصحيحات وتصديرها إلى المصدر الرئيسي
في شكل مناسب للاستخدام مع عبوات اللحاف (تنسيق 3.0). إنه يسمح بالمزيد
سير العمل الطبيعي (والتلقائي) من ربط بقع اللحاف أعلاه من خلال البحث عن
التصحيحات التي تم إجراؤها على فرع التغليف والتي لم يتم تطبيقها بعد في المنبع.

لتمكينه:

$ git config gitpkg.deb-export-hook /usr/share/gitpkg/hooks/debcherry-deb-export-hook

من أجل استخدام هذا الخطاف، أ ${DEB_ORIG}.الالتزام يجب إنشاء ملف يحتوي على
شجرة المصدر المصدر في المستودع. سيتم إنشاء هذا
تلقائيًا (إذا تم تمكين هذا الخطاف) عند تصدير كرة قطران من المنبع عن طريق التمرير
على حد سواء خيران origbranch إلى gitpkgأو إذا كنت تستخدم خطاف القطران الأصلي قبل التصدير,
الذي يحدد الالتزام المناسب المتوافق مع كرة القطران. إذا كان المنبع الخاص بك
يتم إنشاء tarball باستخدام بعض الآليات الأخرى التي ستحتاجها للتأكد من أن الملف
خلقت نفسك.

إذا كنت تستخدم هذا الخطاف، فقد ترغب في توثيق ذلك في مستودعك بشيء ما
مشابه للنص في /usr/share/doc/gitpkg/examples/README.debcherry-export ك
الراحة للمستخدمين الآخرين. ستظل الحزمة الخاصة بك قابلة للتصدير بدون هذا الخطاف
تم تمكينه، فلن يتم فصل التصحيحات الأولية بشكل فردي في ملف
سلسلة لحاف.

صنارة صيد المكتبة المساعدون
هذه مقتطفات أكثر تافهة، للعمليات التي قد تكون مشتركة بين عدة أشخاص
نصوص. وجدت أيضا في /usr/share/gitpkg/hooks. وعادة ما يتم الحصول على هذه من قبل الآخرين
البرامج النصية بدلاً من الارتباط بها مباشرة.

الريبو التكوين المساعد
يوفر غلافًا بسيطًا حول `طائرة نفاثة التكوين`، مما يضمن أنه يتم استدعاؤه من
شجرة الريبو حيث يمكن تخزين أي خيارات تكوين خاصة بالريبو. مفيدة للنصوص
والتي لم يتم استدعاؤها من داخل شجرة الريبو، ولكن تم استدعاؤها بوابة التكوين خيارات
الخاصة بهم للاستعلام.

يوفر sanitise_git_ref وظيفة Shell التي تعيد تعيين سلاسل الأحرف الموجودة
غير قانوني للاستخدام في git refname.

يوفر extract_values_for_option وظيفة shell التي يمكن استخدامها لاستخراج ملف
مجموعة من القيم لخيار معين من GITPKG_IOPTS.

راجع محتوى هذا الملف نفسه للحصول على وثائق أكثر تفصيلاً حول الوظائف
التي يقدمها.

تفاعلية

إذا كنت تنوي الاتصال gitpkg من البرامج النصية الخاصة بك، ثم يجب عليك ملاحظة أن هناك
حالتين عندما قد يطالب بشكل تفاعلي بشكل افتراضي. لا يوجد عاقل حقيقي
الافتراضي لهذه الحالات، لذلك من الأفضل أن تطلب من المستخدم فقط وتستمر بدلاً من القيام بذلك
يبدأون العملية برمتها مرة أخرى في الحالة المحتملة التي اتصلوا بها gitpkg
مباشرة. للحصول على التفاصيل، راجع gitpkg.force-overwrite-orig gitpkg.create-fake-orig
خيارات التكوين أعلاه. يجب عليك ضبط كليهما بشكل صريح على السلوك الذي تريده
منهم إذا gitpkg لا ينبغي أبدا أن تصبح تفاعلية.

العمل

رغم أن gitpkg لا يحاول صراحةً فرض أي إجراء معين لسير العمل عليك
ومن أجل الاستفادة الكاملة منه، ربما يكون من المفيد أن نذكر سريعًا واحدًا على الأقل
طريقة بسيطة لإدارة حزم دبيان في git.

أحد هياكل الريبو الشائعة هو الحفاظ على مصدر المنبع الأصلي في فرع واحد، وهو
يتم تحديثه إما مباشرة من الريبو الأولي أو عن طريق استيراد أرشيفات القطران إليه
بشكل دوري، مع مصدر دبيان المصحح على فرع آخر. في هذه الحالة
قد تبدو مهمة إعداد إصدار أولي جديد من كرة القطران كما يلي:

تحقق من فرع المنبع
$ مؤتمر نزع السلاح myrepo
$ git الخروج المنبع

قم بإزالة كافة الملفات الأولية القديمة من الريبو
$ rm -rf $(all_files_except .git)

قم بفك كرة القطران الجديدة في مكانها
$ القطران zxf $new_upstream.tar.gz

اسمح لـ git بمعرفة ما تمت إعادة تسميته/جديد/ذهب من تلقاء نفسه.
تأكد من عدم وجود أشياء مثل ملفات vim .swp الكامنة
في الشجرة لا تزال في هذه المرحلة.
إضافة بوابة $.
$ git الالتزام -a
علامة $ git v$upstream_version

تحضير فرع دبيان
$ بوابة الخروج ديبيان
$ git دمج المنبع
$ $(تحديث سجل التغيير وتصحيحات دبيان الأخرى وما إلى ذلك)
$ git الالتزام -a
علامة $ git v${upstream_version}-$debian_version

قم بالإفراج
$ gitpkg v${upstream_version}-$debian_version v$upstream_version
$ cd ../deb-packages/mypackage && dpkg-buildpackage ...

استخدم gitpkg عبر الإنترنت باستخدام خدمات onworks.net