فئات وثائق Discourse

قد يكون الارتباك والصعوبة نابعين من أن موضوع الفهرس يجب أن يكون بتنسيق معين، وهذا ليس مذكورًا بوضوح تام في الوثائق (أعلى منشور).

لقد قمت بتثبيت هذه الإضافة بنفسي، متبعًا التعليمات بعناية، لكنها لم تعمل بنفس الطريقة التي كان يواجهها @dennisjbr.

قد يكون من المفيد تقديم مثال على تنسيق Markdown المطلوب بدلاً من الارتباط بمثال Meta، لأن القاعدة الأساسية الوحيدة هي يجب أن تكون هناك قائمة نقطية/مرقمة بتنسيق Markdown. تقول الوثائق “قائمة” ولكن كلمة “قائمة” لها استخدام عادي في اللغة الإنجليزية يشمل القوائم غير بتنسيق Markdown!

هذا سيعمل كموضوع فهرس:

* https://meta.discourse.org/t/discourse-doc-categories/322376
* نص عشوائي: https://meta.discourse.org/t/discourse-doc-categories/322376

هذا لن يعمل:

https://meta.discourse.org/t/discourse-doc-categories/322376
نص عشوائي: https://meta.discourse.org/t/discourse-doc-categories/322376

بالإضافة إلى ذلك، يمكنك استخدام عناوين Markdown لإنشاء أقسام واستخدام قوائم متعددة، ولكن لن يظهر شيء في الشريط الجانبي ما لم تكن هناك قائمة بتنسيق Markdown. أقدر أن هذا واضح جدًا وقد لا يكون قد أربك أي شخص آخر، لكنه أربكني (بغباء أو لا) ولست جديدًا على Discourse و TCs والإضافات.

4 إعجابات

لقد أضفت مثالًا أكثر وضوحًا لموضوع فهرس منسق إلى المنشور الأصلي هنا: https://meta.discourse.org/t/discourse-doc-categories/322376#p-1584993-formatting-index-topics-4

ألقِ نظرة على ذلك وأخبرني إذا كنت لا تزال غير قادر على حل المشكلة.

8 إعجابات

يبدو جيدًا بالنسبة لي يا @hugh!

3 إعجابات

هل تم التفكير في توفير شخصية ذكاء اصطناعي للمجهولين؟ أعتقد على الأقل، في دردشة مؤقتة ومجهولة عبر الرسائل المباشرة؟ هل هذا ممكن؟

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

إعجابَين (2)

شكراً لتسليط الضوء على هذا! سنرى ما يمكننا فعله لمنع ذلك في المستقبل.

3 إعجابات

في الواقع، لا ينبغي للمرء أبدًا اعتبار أن شيئًا ما “واضح” عند توثيق أي شيء. هذا النوع من الملاحظات حيوي في أي نوع من المشاريع لضمان الوضوح.

أي شيء مكتوب سيكون منطقيًا عادةً للمؤلف بسبب فهمه العميق لما كتبه. بالنسبة للآخرين، قد يكون أقل وضوحًا.

أنا نفسي لا أحب مصطلحات مثل “بديهي” لأن الشيء يكون بديهيًا فقط إذا كانت لدى المرء خبرة في استخدام شيء مشابه.

6 إعجابات

شكرا لك! هذا يساعد كثيرا.

عمل رائع يا جماعة على هذا المكون الإضافي!!

أنا مبتدئ لذا أعتذر مقدمًا! لقد كنت أحاول حل هذه المشكلة بنفسي لفترة طويلة، لكنني لم أجد حلاً في أي مكان. :frowning:

أحاول استخدام هذا المكون الإضافي كوسيلة لتنظيم مشاريع المستخدمين الفردية على مستوى الفئة.

نحن نحاول إنشاء منتدى سيحتوي على مجموعة من مشاريع المستخدمين المختلفة. في الأصل، كانت جميعها تحت فئة “المشاريع”، لذلك عندما ينقر شخص ما على المشاريع، سيرى جميع مربعات الفئات الفرعية التي تسرد جميع المشاريع الفردية بمظهر واجهة مستخدم جميل (سوق مشاريع وهمي).
ولكن بفعل ذلك، نفقد هذا المستوى الواحد من تنظيم البيانات لأن المشاريع الفردية تبدأ كفئات فرعية بدلاً من فئات.

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

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

هل هناك طريقة لعرض الفئات في العمود الأوسط بحيث تشبه عرض صفحة “جميع الفئات” في موجز Discourse العادي؟

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

شكرًا مقدمًا على أي مساعدة وتوجيه.

3 إعجابات

هل يمكنك إضافة “روابط نسبية”، مثل “/t/topic/463”، والتي ستكون فعالة جدًا في تغيير “أسماء النطاقات” دون الكثير من العمل.

إعجاب واحد (1)

لا يتطلب الأمر الكثير من العمل حاليًا. قم فقط بإجراء بحث واستبدال - كم مرة تقوم بتبديل النطاقات؟

إعجابَين (2)

يبدو هذا مثل ما فعلناه هنا في Meta للفئات الفرعية للتوثيق.

يمكنك رؤية الفئات الفرعية في العرض الرئيسي وهي مرتبطة أيضًا في الشريط الجانبي هنا: Documentation - Discourse Meta

لجعل هذا يعمل، أضفنا موضوع فهرس لفئة التوثيق الرئيسية الذي يتضمن روابط لكل فئة فرعية: Documentation Index.

هل يساعدك هذا في إيجاد حل جيد في نسختك؟

3 إعجابات

نظرًا لأن الربط النسبي يعمل بالفعل. لماذا لا تضيفه وتزيل أي عمل لا داعي له؟ هذه روابط داخلية في النهاية وهذا من شأنه أن يساهم في تكافؤ discourse حيث تعمل الروابط الداخلية أيضًا مع مجموعة متنوعة من TC والإضافات.

إعجاب واحد (1)

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

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

هذه هي الفئة الرئيسية للمشاريع: تجريبي - سيكون له فئات فرعية أخرى

وهذه هي “الفئات الفرعية الفرعية” التي تعمل، وتحول الفئة الفرعية إلى فئة.
جنبًا إلى جنب مع سهولة التنقل في موضوع الفهرس.


شكراً مرة أخرى على كل العمل الذي تقومون به.
آمل أن أكون أكثر وضوحًا قليلاً في هذا المنشور. :frowning:

لقد وجدت حلاً نحن سعداء جدًا به وهو مزيج من الإضافتين.

إعجابَين (2)

يسعدني أنك وجدت حلاً يناسبك!

إعجابَين (2)

ما هي ميزة هذه الإضافة مقارنة بإضافة المستندات القديمة؟

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

هل يمكنك توضيح الاختلافات بين النهجين، ولماذا اخترت هذا النهج، وكيف تنوي سد الفجوة بين الإضافة القديمة والجديدة؟ :heart:

تعليق خارج الموضوع على "callouts"

يستخدم HedgeDoc امتداد Markdown التالي لدعم callouts (يسمونها alert areas):

### منطقة تنبيه
:::success
نعم :tada:
:::
:::info
هذه رسالة :mega:
:::
:::warning
انتبه :zap:
:::
:::danger
يا إلهي! :fire:
:::

سيتم عرضه

(سيكون من السهل جدًا تنسيق هذا باستخدام CSS بالنظر إلى فئة).

تعليق خارج الموضوع على الكسل والذكاء الاصطناعي

هل يمكنك تخيل الطاقة الزائدة والمياه المستهلكة لثلاثة أسطر فقط من Markdown التي كان يمكنك نسخها ولصقها يدويًا؟ :slightly_frowning_face:

تعليق خارج الموضوع على الروابط النسبية مقابل المطلقة

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


بعد التجربة قليلاً، إليك استنتاجاتي (المؤقتة):

  1. استخدام موضوع وصف الفئة لتوفير فهرس توثيق مفيد (على سبيل المثال، Singular Docs - Documentation - petites singularités)
  2. فئة توثيق المستوى الأعلى تمكن من استخدام الفئات الفرعية لتغيير فهرس شريط التمرير الخاص بالتوثيق (على سبيل المثال، يظهر “تثبيت Ruby” ضمن “أدلة كيفية الاستخدام” في https://ps.zoethical.org/c/docs/204، ولكن ضمن “نصائح وحيل” في Sysadmin Docs - petites singularités) لتوفير هيكل لطيف (انظر Documentation هنا، عرض الفئات الفرعية كصناديق)
  3. يمكن أن تكون مواضيع التوثيق في أي مكان في المنتدى، بما في ذلك في المساحات الخاصة - على الرغم من أن فهرس التوثيق يكشف عن وجودها بعد ذلك
  4. الشريط الجانبي غير مستقر حاليًا:
    • أحيانًا يعرض عناوين URL، وأحيانًا العنوان
    • أحيانًا نص مسبوق فقط
    • عند تسجيل الخروج، قد يفقد بعض المواضيع المفهرسة
  5. عند الترحيل من إضافة المستندات القديمة، يجب إعادة إنشاء رابط المستندات في القسم المخصص للشريط الجانبي (ولكن يمكن إنشاؤه تلقائيًا عن طريق تغيير /docs إلى فئة التوثيق في إعداد الإضافة، أو إنشاء/تغيير الرابط الدائم /docs للربط بتلك الفئة)
  6. رابط “العودة إلى المنتدى” يبدو غريبًا، لأن مواضيع التوثيق تظل مواضيع في المنتدى: ما زلنا هناك نقرأ المستندات!
  7. التصفية لا تأخذ في الاعتبار حاليًا أسماء (الفئات الفرعية) التي تنتمي إليها موضوعات التوثيق.
3 إعجابات

يُدخل التحديث الأخير خطأً صغيرًا في واجهة المستخدم عند وجود شريط تمرير.

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

لكنك تفقد الشريط الجانبي “المنتدي” العادي، لذا فإن العودة إلى المنتدى منطقية هنا.

إعجاب واحد (1)

استغرق الأمر بعض الوقت لمعرفة أن الشريط الجانبي لم يظهر لأنه لسبب ما تم تعيين إعداد القائمة التنقلية إلى “قائمة منسدلة للرأس” بدلاً من “الشريط الجانبي”. بالنسبة لأولئك الذين لم يتمكنوا أيضًا من ظهور الشريط الجانبي، قد يكون هذا هو السبب.

الآن أنا عالق أحاول معرفة كيفية إضافة رأس الفئة وصناديق الفئة الفرعية كما نراها هنا:

لا أرى أي إعداد لتمكين/تعطيل ذلك ويبدو أنه لا يرغب في الظهور للأسف.
إذا كان لدى أي شخص أي أفكار، فسأكون ممتنًا للبصيرة.
شكرًا.

إعجاب واحد (1)
4 إعجابات

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

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

إذا كان عليك اختيار فئة واحدة للمستند، فماذا تفعل عندما يجب أن يكون نفس المستند موجودًا أيضًا في فئات أخرى متعددة؟

كانت العلامات هي الفهرس التلقائي الذي يجب الآن إنشاؤه يدويًا وصيانته.

6 إعجابات