ز-شرطة
✨ جيثب (gh
) امتداد CLI لعرض لوحة القيادة طلبات السحب و مشاكل بواسطة المرشحات التي تهمك.
✨ المميزات
- 🌅 قابل للتكوين بالكامل – حدد الأقسام باستخدام مرشحات جيثب
- 🔍 البحث عن كل من العلاقات العامة والقضايا
- 📝 تخصيص الأعمدة بها
hidden
,width
وgrow
الدعائم - ⚡️ التصرف على أساس الحد من الفقر والمشكلات المتعلقة بالخروج، والتعليق، والفتح، والدمج، والفرق، وما إلى ذلك…
- ⌨️ قم بتعيين الإجراءات المخصصة باستخدام روابط المفاتيح الجديدة
- 💅 استخدم السمات المخصصة
- 🔭 عرض تفاصيل حول قضية ما من خلال شريط جانبي مفصل
- 🪟 اكتب ملفات تكوين متعددة للتبديل بسهولة بين لوحات المعلومات المختلفة تمامًا
- ♻️ تحديد فاصل زمني للتحديث التلقائي للوحة القيادة
📦 التثبيت
-
تحميل هذا
gh
CLI – راجع تثبيتيتطلب التثبيت الحد الأدنى من الإصدار (2.0.0) من GitHub CLI الذي يدعم الامتدادات.
-
قم بتثبيت هذا الامتداد:
gh extension install dlvhdr/gh-dash
-
لعرض الأيقونات بشكل صحيح، يجب عليك تنزيل خط Nerd وتثبيته من https://www.nerdfonts.com/. ثم حدد هذا الخط ليكون الخط الخاص بك للمحطة.
التثبيت يدويًا
إذا كنت ترغب في تثبيت هذا التمديد يدويا، اتبع الخطوات التالية:
-
استنساخ الريبو
# gitgit clone https://github.com/dlvhdr/gh-dash# GitHub CLIgh repo clone dlvhdr/gh-dash
-
القرص المضغوط فيه
-
بنائها
-
تثبيته محليا
كيف يمكنني الحصول على هذه الألوان والخط بالضبط؟
أنا استخدم النشاط مع ال موضوع tokyonight و ال كود فيرا الطالب الذي يذاكر كثيرا الخط. للتحقق من الإعداد الكامل الخاص بي ملفاتي النقطية.
⚡️ الاستخدام
يجري
ثم اضغط ؟ للمساعدة.
يجري gh dash --help
لمزيد من المعلومات:
Usage: gh dash [flags]Flags: -c, --config string use this configuration file (default is $GH_DASH_CONFIG, or if not set, $XDG_CONFIG_HOME/gh-dash/config.yml) --debug passing this flag will allow writing debug output to debug.log -h, --help help for gh-dash
⚙️ التكوين
يتم تعريف القسم بواسطة:
- العنوان – هو موضح في TUI
- المرشحات – كيف ينبغي تصفية العلاقات العامة الخاصة بالريبو – هذه واضحة مرشحات جيثب
يتم توفير كافة التكوين داخل config.yml
الملف ضمن دليل الامتداد (إما $XDG_CONFIG_HOME/gh-dash
أو ~/.config/gh-dash/
أو دليل تكوين نظام التشغيل الخاص بك) أو $GH_DASH_CONFIG
.
مثال config.yml
يحتوي الملف على:
🗃 التشغيل بملف تكوين مختلف
يمكنك الجري gh dash --config
يهرب gh-dash
مقابل ملف تكوين آخر.
يتيح لك ذلك تحديد لوحات معلومات متعددة بأقسام مختلفة بسهولة.
يمكن أن يكون مفيدًا إذا كنت تريد الحصول على لوحات معلومات 🧳 عمل و👩💻 شخصية، أو إذا كنت تريد عرض لوحات معلومات متعددة في نفس الوقت.
⌨️ روابط المفاتيح
حدد روابط المفاتيح المخصصة الخاصة بك لتشغيل أوامر bash باستخدامها الذهاب إلى القوالب. هذا متاح لكل من العلاقات العامة والقضايا.
بالنسبة إلى العلاقات العامة، الحجج المتاحة هي:
دعوى | وصف |
---|---|
RepoName |
الاسم الكامل للريبو (على سبيل المثال dlvhdr/gh-dash ) |
RepoPath |
الطريق إلى الريبو باستخدام config.yml repoPaths مفتاح للحصول على الخرائط |
PrNumber |
رقم العلاقات العامة |
HeadRefName |
اسم الفرع البعيد للعلاقات العامة |
BaseRefName |
اسم الفرع الأساسي للعلاقات العامة |
بالنسبة للمشكلات، الوسيطات المتاحة هي:
دعوى | وصف |
---|---|
RepoName |
الاسم الكامل للريبو (على سبيل المثال dlvhdr/gh-dash ) |
RepoPath |
الطريق إلى الريبو باستخدام config.yml repoPaths مفتاح للحصول على الخرائط |
IssueNumber |
رقم الإصدار |
أمثلة
لمراجعة العلاقات العامة باستخدام Neovim أو VSCode، قم بتضمين ما يلي في ملفك config.yml
ملف:
لتثبيت مشكلة ما، قم بتضمين ما يلي في ملفك config.yml
ملف:
keybindings: issues: - key: P command: gh issue pin {{.IssueNumber}} --repo {{.RepoName}}
🚥 مطابقة مسار الريبو
يمكن أن يكون اسم الريبو لتعيينات المسار مطابقًا تمامًا (الاسم الكامل، المسار الكامل) أو مطابقة أحرف البدل باستخدام owner
والمسار الجزئي.
المطابقة التامة لاسم الريبو الكامل للمسار الكامل لها الأولوية على حرف البدل المطابق، ويجب أن تتطابق مطابقات أحرف البدل مع مسار حرف البدل.
ان :owner/:repo
يمكن تحديد القالب كبديل عام.
repoPaths: :owner/:repo: ~/src/github.com/:owner/:repo # template if you always clone github repos in a consistent location dlvhdr/*: ~/code/repos/dlvhdr/* # will match dlvhdr/repo-name to ~/code/repos/dlvhdr/repo-name dlvhdr/gh-dash: ~/code/gh-dash # will not match wildcard and map to specified path
ال RepoName
و RepoPath
يتم توسيع وسيطات ربط المفاتيح بالكامل عند إرسالها إلى الأمر.
💅 ثيمات مخصصة
لتجاوز المجموعة الافتراضية من الألوان الطرفية وإنشاء نظام الألوان الخاص بك بدلاً من ذلك، يمكنك تحديد واحد في ملفك config.yml
ملف. إذا اخترت السير في هذا الطريق، فيجب عليك تحديده الجميع من المفاتيح التالية كألوان بتنسيق سداسي عشري (#RRGGBB
)، وإلا فسوف تفشل عملية التحقق من الصحة.
theme: ui: table: showSeparator: true colors: text: primary: "#E2E1ED" secondary: "#666CA6" inverted: "#242347" faint: "#3E4057" warning: "#F23D5C" success: "#3DF294" background: selected: "#39386B" border: primary: "#383B5B" secondary: "#39386B" faint: "#2B2B40"
🪟 التخطيط
يمكنك تخصيص تخطيط كل قسم بالإضافة إلى التخطيط العام.
على سبيل المثال، لإخفاء author
عمود ل الجميع أقسام العلاقات العامة، قم بتضمين ما يلي في ملفك config.yml
.
defaults: layout: prs: author: hidden: true
- ل
prs
أسماء الأعمدة هي:updatedAt, repo, author, title, reviewStatus, state, ci, lines, assignees, base
. - ل
issues
أسماء الأعمدة هي:updatedAt, state, repo, title, creator, assignees, comments, reactions
. - الخصائص المتاحة للتحكم هي:
grow
(كاذب، صحيح)،width
(عدد الخلايا)، وhidden
(كاذبة، صحيح).
مؤلف
دوليف هدار dolevc2@gmail.com