الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

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

TASHELL

CLI Kanban Board/Manage Manager لـ Mac و Linux

  • لكل قوائم مهام المشروع
  • vim نمط المفاتيح
  • مخزنة باستخدام Markdown
  • نظافة التصرفات لتحكم سهولة في الإصدار
  • دعم المهام الفرعية وتواريخ الاستحقاق
  • واردات Trello Board
  • واردات مشروع جيثب

اتبع taskellcli على Twitter للحصول على التحديثات

محتويات

  • تثبيت
  • باستخدام TASHELL
    • خيارات
    • تخزين
    • استيراد لوحات Trello
    • استيراد مشاريع جيثب
  • إعدادات
    • الضوابط
      • تواريخ استحقاق
    • هم
  • خريطة الطريق
  • المساهمة
    • المساهمون الأساسيون
  • شكر وتقدير

تثبيت

Homebrew (Mac)

يمكنك تثبيت Tashell على جهاز Mac باستخدام Homebrew: 

brew install taskell

ديبيان/أوبونتو

حزمة .deb متاحة لديبيان/أوبونتو. قم بتنزيله وتثبيته باستخدام dpkg -i <package-name> . قد تحتاج أيضًا إلى تثبيت حزمة libtinfo5 ( sudo apt install libtinfo5 ).

فيدورا

غير مدعوم رسميًا ، ولكن حاول تشغيل sudo dnf install ncurses-compat-libs ثم قم بتنزيل وتشغيل الثنائي كما هو موضح أدناه. إذا لم ينجح ذلك ، فقد تحتاج إلى بناء من الصفر (Cabal/Stack).

الثنائيات

يتوفر ثنائي لنظام Mac و Debian/Ubuntu. قم بتنزيله ونسخه إلى دليل في $PATH الخاص بك (على سبيل المثال /usr/local/bin أو /usr/bin ).

كابال

يمكنك تثبيت TASHELL مع cabal : 

cabal install taskell

تأكد من تشغيل cabal update إذا لم تقم بتشغيله مؤخرًا.

كومة

إذا لم يعمل أي من الخيارات المذكورة أعلاه ، فيمكنك إنشاء Taskell باستخدام Stack. قم بتثبيت المكدس أولاً على جهازك. ثم استنساخ repo و stack build && stack install : سيؤدي ذلك إلى إنشاء Taskell ثم تثبيته في ~/.local/bin (لذا تأكد من أن الدليل في $PATH الخاص بك). يمكن أن يستغرق البناء من نقطة الصفر وقتًا طويلاً وأحيانًا لا يعمل في المرة الأولى (إذا حدث ذلك ، فحاول تشغيله مرة أخرى).

باستخدام TASHELL

  • taskell : سوف تستخدم taskell.md في PWD - عروض لإنشاء إذا لم يتم العثور عليها
  • filename.md taskell filename.md

خيارات

  • -h : عرض المساعدة
  • -v : رقم الإصدار عرض
  • -t <trello-board-id> : استيراد لوحة trello (انظر أدناه)
  • -g <github-project-id> : استيراد مشروع github (انظر أدناه)

نصائح

  • إذا كنت تستخدم عمودًا بسيطًا "للقيام به" و "تم" ، فاستخدم شريط الفضاء لتمييز عنصر على أنه كامل أثناء البقاء في قائمة "HO". إذا كنت تستخدم إعداد عمود أكثر تعقيدًا ، فستحتاج إلى استخدام H / L لنقل المهام بين الأعمدة.

تخزين

بشكل افتراضي المتاجر في ملف taskell.md في دليل العمل: 

 ## To Do

- Do this

## Done

- Do That

استيراد لوحات Trello

يتضمن Taschell القدرة على جلب لوحة Trello وتخزينها كملف Taskell المحلي.

المصادقة

قبل إحضار لوحة Trello ، ستحتاج إلى إنشاء رمز الوصول وتخزينه في ~/.taskell/config.ini .

  • أولاً ، احصل على رمز Trello

  • ثم أضفه إلى ~/.taskell/config.ini : 

     [trello]
token = <your-trello-access-token>

يمكنك إلغاء رموز الوصول على Trello

جلب

من شأن تشغيل ما يلي سحب لوحة Trello مع معرف "TRE1L0ID" إلى ملف يسمى trello.md ثم افتح Taskell مع هذا الملف. 

taskell -t TRe1l0iD trello.md

تأكد من الحصول على إذن لعرض لوحة Trello ، وإلا ستحصل على خطأ.

القيود

  • هذا إجراء لمرة واحدة: إنه يستورد بشكل فعال لوحة Trello إلى Taskell
  • الواردات حاليا:
    • قوائم
    • البطاقات
    • أوصاف البطاقة
    • بطاقة الاستحقاق
    • قوائم مراجعة البطاقات (تم دمجها في قائمة واحدة لكل بطاقة)

استيراد مشاريع جيثب

يتضمن Taskell القدرة على جلب مشروع GitHub وتخزينه كملف Taskell المحلي.

المصادقة

قبل إحضار لوحة github ، ستحتاج إلى إنشاء رمز الوصول إلى الشخص وتخزينه في ~/.taskell/config.ini .

  • أولاً ، احصل على رمز الوصول الشخصي github

  • تأكد من وضع علامة على نطاق repo

  • ثم أضفه إلى ~/.taskell/config.ini : 

     [github]
token = <your-github-personal-access-token>

يمكنك حذف رموز الوصول الشخصية على جيثب

جلب

يمكن أن تنتمي المشاريع إلى المنظمات أو للمستودعات الفردية.

تأكد من الحصول على إذن لعرض مشروع GitHub ، وإلا ستحصل على خطأ.

المنظمات

لاستيراد مشروع لمؤسسة تسمى "اختبار org" ، يمكنك استخدام ما يلي: 

taskell -g orgs/test-org github.md

هذا من شأنه أن يوضح لك قائمة بالمشاريع الممكنة للاستيراد. أدخل رقم المشروع الذي ترغب في استيراده.

المستودعات

لاستيراد مشروع للمستودع "اختبار REPO" للمستخدم "المستخدم الاختبار": 

taskell -g repos/test-user/test-repo github.md

هذا من شأنه أن يوضح لك قائمة بالمشاريع الممكنة للاستيراد. أدخل رقم المشروع الذي تستورده.

القيود

  • هذا إجراء لمرة واحدة: إنه يستورد بشكل فعال مشروع GitHub إلى Taskell
  • الواردات حاليا:
    • الأعمدة
    • البطاقات

إعدادات

يستخدم Taskell مواصفات الدليل الأساسي XDG ، لذلك سيبحث عن متغير بيئي $XDG_CONFIG_HOME وإنشاء دليل يدعى taskell بداخله. إذا لم يتم العثور على هذا المتغير ، فسيقوم بإنشاء دليل taskell في ~/.config/ . (إذا كنت تستخدم Taschell منذ <= 1.3.5 ، فسيكون ذلك في دليل ~/.taskell ، لا تتردد في نقل هذا إلى دليل XDG.)

لدى Taskell ملف config.ini : 

 [general]
; the default filename to create/look for
filename = taskell.md

[layout]
; top/bottom padding for the taskell window
padding = 1

; the width of a column
column_width = 30

; the padding of a column
; for both sides, so 3 would give a gap of 6 between two columns
column_padding = 3

; the icon to use when a task has a description
; the default icon may not display on all systems
description_indicator = " ≡ "

; whether to show the statusbar
statusbar = true

[markdown]
; the markdown to start a title line with
title = " ## "

; the markdown to start a task line with
task = " - "

; the markdown to start a sub-task line with
subtask = "    * "

; by default times are stored in UTC to avoid diffs if you
; change locations. Set this to true if it will always be
; edited in the same timezone
localTimes = false

تأكد من أن القيم الموجودة في قسم [markdown] محاطة بمواقع مزدوجة .

إذا كنت تستخدم دائمًا المهام الفرعية ، فقد يكون إعداد بديل لـ [markdown] : 

 [markdown]
title = " ## "

; each task is a header
task = " ### "

; subtasks are list items under the header
subtask = " - "

تحذير : في الوقت الحالي ، إذا قمت بتغيير إعدادات [markdown] الخاصة بك ، فلن يتم قراءة أي ملفات قديمة مخزنة بإعدادات مختلفة.

نموذج

يمكنك تحرير ملف التكوين template.md لتغيير شكل ملف Taskell الجديد.

الضوابط

يمكنك تحرير روابط لوحة المفاتيح في ملف config bindings.ini .

يمكن العثور على الروابط الافتراضية في bindings.ini .

مفاتيح خاصة متوفرة: <Space> ، <Enter> ، <Backspace> ، <Left> ، <Right> ، <Up> ، <Down>

على جهاز Mac ، يمكنك استخدام أحرف alt : على سبيل المثال quit = œ يعادل alt+q .

يجب ألا تحاول تعيين مفاتيح 1 - 9 ، لأنها لن تكتب السلوك الافتراضي.

تواريخ استحقاق

يجب إدخال تواريخ الاستحقاق بتنسيق YYYY-MM-DD أو YYYY-MM-DD HH:MM . لن يتم قبول التاريخ بخلاف ذلك.

يمكنك أيضًا المرور في الأوقات النسبية مثل 1w 2d (لمدة أسبوع واحد و 2 أيام). الوحدات الصالحة هي:

  • s (ثواني)
  • m (دقائق)
  • h (ساعات)
  • d (أيام)
  • w (أسابيع)

هذه يمكن استخدامها في أي مجموعة. إذا كان الوقت يتكون من أيام و/أو أسابيع فقط ، فلن يتضمن تاريخ الاستحقاق وقتًا.

يتم تخزين الأوقات الافتراضية في ملف Markdown كـ UTC. إذا كنت ترغب في الحصول على الأوقات المحلية (ومن غير المرجح أن تفتح الملف في الكثير من المناطق الزمنية المختلفة) ، فيمكنك تعيين localTimes على true في قسم markdown في ملف التكوين. إذا كان لديك هذا الإعداد وتغيير المنطقة الزمنية ، فستحصل على فرق في جميع الأوقات الخاصة بك في المرة القادمة التي تقوم فيها بإجراء تغييرات على الملف.

هم

يمكنك تحرير مجموعة ألوان Taskell عن طريق تحرير theme.ini : 

 [other]

; list title
title.fg = green

; status bar
statusBar.bg = blue
statusBar.fg = black

; current list title
titleCurrent.fg = blue

; current task
taskCurrent.fg = magenta

; subtasks
; selected
subtaskCurrent.fg = magenta
; incomplete
subtaskIncomplete.fg = blue
; complete
subtaskComplete.fg = yellow

; disabled
disabled.fg = yellow

يمكنك أيضًا تغيير الخلفية ولون النص الافتراضي: 

 [default]

; the app background colour
default.bg = brightBlack

; the app text colour
default.fg = white

الألوان المتوفرة هي: black ، red ، green ، yellow ، blue ، magenta ، cyan ، white ، براقة ، brightBlack ، brightRed ، brightGreen ، brightYellow ، brightBlue brightCyan brightMagenta brightWhite ، أو default

خريطة الطريق

انظر Roadmap.md للحصول على الميزات المخطط لها

المساهمة

يرجى التحقق من Roadmap.md قبل إضافة أي طلبات Bugs/الميزات إلى المشكلات.

أي شخص مرحب به للمساهمة في المشروع ، ولكن يرجى قراءة من خلال المساهمة.

المساهمون الأساسيون

  • مارك ويلز (smallhadroncollider)
  • علي أحمد (alinisarahmed)

شكر وتقدير

بنيت باستخدام الطوب. بفضل جوناثان دوجيرتي على الإجابة على جميع أسئلتي وإشارةني في الاتجاه الصحيح. أيضًا بفضل Jack Leigh و Thom Wright لمساعدتي في البدء. أيضا بفضل Katja Durrani لتقديمه Shashell إلى homebrew-core .

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل