بلانت يو إم إل لجيت هاب: عرض مخططات بلانت يو إم إل مباشرة في جيت هاب
PlantUML لـ GitHub، من PlantUML، هو ملحق لـ Firefox يقوم بإدراج معاينات مخططات PlantUML في صفحات GitHub لوثائق العمل ومراجعة سير العمل. يقوم بعرض مصدر PlantUML في المكان باستخدام محرك جانب المتصفح بحيث لا يحتاج المساهمون إلى تصدير الصور يدويًا. يدعم الملحق سمات GitHub، ويقدم تبديل المصدر/المخطط، ويستهدف مهندسي البرمجيات، والمطورين، والكتاب الفنيين الذين يحتاجون إلى معاينات مخططات سريعة وخاصة داخل واجهات المستودعات.
كيف يغير توثيق العمليات ومراجعة التدفقات
تزيل الإضافة خطوة التصدير اليدوي من سير عمل التوثيق من خلال عرض المخططات بشكل متداخل، مما يسرع التحقق البصري أثناء مراجعة الشيفرة والكتابة. تعمل عبر معظم واجهات المستودعات، بما في ذلك الأسطح الإضافية مثل المناقشات وGists، وتقلد نمط العزل الخاص بـ GitHub للمخططات المدمجة بحيث يجلس المحتوى المعروض بصريًا بجانب Markdown دون الحاجة إلى عارض خارجي.
ما هي صيغ المخططات وأنماطها التي تتعرف عليها
يدعم الأنواع القياسية لمخططات PlantUML والألقاب، لذا يتم عرض مخططات التسلسل والفئة والنشاط من نصها الأصلي. تقبل الإضافة ألقاب اللغات مثل 'puml' و 'wsd' وتحافظ على المصدر الأصلي في عرض قابل للتبديل يظهر النص مع تمييز الصيغة الأصلية من GitHub، مما يساعد المراجعين على فحص أو نسخ النموذج الأساسي مباشرة.
كيف تتعامل مع الخصوصية والأذونات والأداء
تم تصميم العرض لتجنب الخوادم الخارجية والتتبع، باستخدام بنية خالية من التتبع وخالية من الخوادم وفلسفة خالية من الأذونات التي تقلل من الوصول المطلوب للمتصفح. تعمل الإضافة محليًا في سياق الصفحة وهي متوافقة أيضًا مع المتصفحات المعتمدة على Chromium حيث ينطبق نفس النهج. يؤدي العرض المحلي إلى إنتاج مخططات فورية في الموقع، وهو سلوك تم الإبلاغ عنه بأنه سريع في تعليقات المجتمع.
خيار عملي للمساهمين الأفراد والفرق التي تهتم بالخصوصية
PlantUML لـ GitHub هو أداة عملية للمطورين ومؤلفي الوثائق الذين يرغبون في معاينات سريعة داخل المستودع دون إرسال بيانات المخطط إلى خدمات الطرف الثالث، وهو ما يتضح من التقييمات الإيجابية على متجر إضافات فايرفوكس. إنه أقل ملاءمة للفرق التي تتطلب خطوط أنابيب صور مركزية على الخادم أو أصول صور مستضافة في المستودع. للمراجعين، قم بتمكين الإضافة أثناء الجولات لتقصير الفحوصات البصرية.
