إضافة Hledger - عرض دفاتر المحاسبة النصية في المواضيع

تخصيص إضافة
1
:information_source: الملخص عرض دفاتر hledger كلوحة بيانات حية في المنشور الأول للموضوع.
:hammer_and_wrench: المستودع gitea.kosmos.org/raucao/discourse-hledger
:open_book: دليل التثبيت README

الميزات

ضع دفتر hledger داخل كتلة كود محاطة بعلامات hledger في المنشور الأول للموضوع، وسيتم استبداله بلوحة بيانات تحتوي على خمسة تقارير، يتم توليدها عند الطلب بواسطة ملف تنفيذي hledger على الخادم:

  • :clipboard: الحسابات — شجرة الأرصدة الكاملة، مع توسيع جميع الحسابات الأب.

  • :balance_scale: الميزانية العمومية — الأصول والالتزامات وحقوق الملكية، مجمعة في أقسام.

  • :chart_increasing: قائمة الدخل — الإيرادات والمصروفات.

  • :busts_in_silhouette: حقوق الملكية — توزيع لكل سلعة على رأس المال المُسهم به.

  • :receipt: الدفتر — سجل معاملات مع كل قيد محاسبي.

  • يمكن تصفية التقارير حسب نطاق تاريخ من/إلى؛ تاريخ النهاية شامل.

  • تتحول مقاطع الحسابات المكتوبة على شكل @username (مثل equity:@alice) إلى روابط إشارات Discourse مع بطاقة الملف الشخصي المعتادة؛ يتم إنشاء الروابط للمستخدمين الموجودين فقط.

  • يتم توليد التقارير عند الطلب وتخزينها مؤقتًا لكل مراجعة منشور، لذا فإن تحرير الدفتر يحدّثها.

مثال على الكتلة

```hledger
2024-01-01 Opening balances
    assets:bank:checking       1000.00 EUR
    equity:alice               -600.00 EUR
    equity:bob                 -400.00 EUR
```

لقطات الشاشة

Accounts
Accounts1400×1200 72.7 KB

P&L
P&L1400×1200 52.1 KB

Journal
Journal1400×1200 103 KB

المتطلبات

  • الملف التنفيذي hledger على الخادم (تم الاختبار مع hledger 1.32.3).
  • Discourse 2.7.0 أو أحدث.

عند استخدام تثبيت Docker القياسي، قم بتثبيت الإضافة وحزمة hledger من خلال ملف app.yml الخاص بك ثم أعد البناء:

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://gitea.kosmos.org/raucao/discourse-hledger.git discourse-hledger
    - exec:
        cd: $home
        cmd:
          - apt-get update
          - DEBIAN_FRONTEND=noninteractive apt-get install -y hledger

الإعدادات

  1. فعّل الإضافة من الإدارة > الإعدادات > الإضافات (hledger enabled).
  2. أضف دفتر hledger إلى المنشور الأول للموضوع.
  3. اختياريًا، اضبط hledger path إذا لم يكن الملف التنفيذي موجودًا في المسار الافتراضي PATH.

الخيارات

الاسم الوصف
hledger enabled تفعيل الإضافة.
hledger path المسار إلى الملف التنفيذي hledger (الافتراضي hledger).
hledger max journal bytes الحد الأقصى لحجم الدفتر المقبول، بالبايت (الافتراضي 262144).
hledger max journal lines الحد الأقصى لعدد الأسطر في الدفتر (الافتراضي 5000).
hledger timeout seconds الحد الزمني (ساعة الحائط) لكل استدعاء لـ hledger (الافتراضي 10).
hledger max output bytes الحد الأقصى للمخرجات المحصودة من hledger (الافتراضي 1048576).
hledger memory limit mb الحد الأقصى للذاكرة لعملية hledger؛ 0 لتعطيله (الافتراضي 256).
hledger global rate limit per minute الحد الأقصى لتوليد التقارير عبر جميع المستخدمين؛ 0 لتعطيله (الافتراضي 120).

الأمان

الدفاتر مدخلات غير موثوق بها. تعمل الإضافة على hledger كعملية فرعية غير مخصصة مع بيئة مُنظّفة، ومجلد عمل خاص، ومهلة زمنية صارمة، وحدود للمعالج/حجم الملفات/الذاكرة، وحد للمخرجات، كما ترفض أوامر include. لا تُعاد التقارير إلا للمواضيع التي يمكن للمشاهد رؤيتها، وتُخضع الطلبات لحدود المعدل لكل عنوان IP (30/دقيقة) وحصريًا.

التوافق والترخيص

  • ترخيص MIT
  • نرحب بالملاحظات وتقارير الأخطاء والترجمات في هذا الموضوع أو عبر البريد الإلكتروني، أو وسائل التواصل الاجتماعي (ActivityPub)، أو الدردشة (XMPP) على raucao@kosmos.org
إعجابَين (2)