فئات وثائق Discourse

هل يمكنني استخدام رابط خارجي هنا؟ واستخدام _blank لفتح علامة تبويب جديدة؟

يمكنك البدء بوصف موجز اختياري للفئة.

## اختبار خارجي
* جوجل: https://google.com

## القسم الأول
* https://discourse.example.com/t/topic-title/12
* https://discourse.example.com/t/another-topic-title/34
* عنوان قصير: https://discourse.example.com/t/topic-with-a-long-title/56
* عنوان آخر: https://discourse.example.com/t/another-topic-with-a-long-title/78

## القسم الثاني
* عنوان الموضوع: https://discourse.example.com/t/documentation-topic/98
* https://discourse.example.com/t/new-topic/76
إعجاب واحد (1)

عادةً ما تتلقى أي تثبيتات غير مدعومة رابطًا للتثبيتات غير المدعومة. كإخلاء مسؤولية، حيث يمكن أن تكون أي مشكلات متعلقة جزئيًا.

عادةً ما تحتوي الإضافات والسمات ومكونات السمات على ملف يتعلق بملف توافق الإصدار

انظر أدناه

سيؤدي فتح هذا الملف إلى تقديم ملاحظات مهمة حول توافق الإصدار. قد يكون لدى الآخرين ذلك ضمن الوصف. على سبيل المثال، تعزز إضافة “Category Moderators” إخلاء المسؤولية بأنها تدعم الفرع المستقر فقط.

يوفر Pavilion تردد تحديث discourse الموصى به لضمان حصولهم على وقت لتحديث إضافاتهم.

إعجابَين (2)

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

نعم. يمكنك رؤيتها هنا في Documentation. الفئة الرئيسية هي في الأساس جدول محتويات للفئات الفرعية.

3 إعجابات

لقد عثرت للتو على هذا ولدي بعض الأسئلة من فضلك: كيف يمكننا تثبيته على موقعنا المستضاف على السحابة؟ وكم من الوقت ستظل المستندات القديمة متاحة، برأيك؟

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

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

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

5 إعجابات

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

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

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

5 إعجابات

تم تقسيم 9 مشاركات إلى موضوع جديد: Discourse Docs Plugin – Topics Not Updating in Docs Page

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

إنه رائع على سطح المكتب؛ وللأسف، الغالبية يستخدمون هواتفهم الذكية.

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

لا يوجد الكثير من الخيارات، أو أود أن أقول إنه لا توجد خيارات على الإطلاق. الهواتف المحمولة لا تملك مساحة كافية.

هذا أحد الأسباب التي تجعلني أفكر في ترك المستندات تمامًا. من بين مستخدمي حوالي 95٪ يستخدمون الهواتف المحمولة، وهم يستخدمون الشريط الجانبي نادرًا أو لا يستخدمونه على الإطلاق. لذا فإن تنظيم قائمة المستندات يستغرق وقتًا طويلاً ولا أعتقد أن نسبة الوقت/الفائدة متوازنة :smirking_face:

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

أعتقد أن نقل أيقونة الهامبرغر إلى اليسار (كما في سطح المكتب) من شأنه أن يحسن تجربة المستخدم قليلاً.

الوثائق قوية حقًا، لا أريد تعطيلها ولكن المستخدمين لدينا لا يستخدمونها تقريبًا لأن الفهارس مخفية (!)

إعجابَين (2)

قد يكون مكون السمة هذا ذا أهمية

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

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

إذا ذهبت إلى https://checkin.technospider.com وكشفت عن بعض العناصر في الشريط الجانبي، يمكنك رؤية كيفية عمل التداخل في مثال واقعي. يتم إنشاء الشريط الجانبي بأكمله ديناميكيًا ببساطة عن طريق تداخل الصفحات تحت صفحات أخرى (علاقة الأصل/الفرع). يحتوي هذا الموقع على حوالي 150 صفحة فقط ولكنه كان سيستغرق مني ضعف الوقت لإكماله إذا كان عليّ إنشاء فهارس لإنشاء كل ذلك.

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

3 إعجابات

نعم، هذا لمواضيع إدارة الموقع، صفحة الفهرس موجودة هنا. (index هي علامة تكشف عن جميع صفحات الفهرس)

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

إعجابَين (2)

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

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

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

على سبيل المثال، لا أستطيع أن أجد طريقة لإنشاء مربعات المعلومات/التحذير/الخطأ.

هنا في ميتا، يتم استخدام الاقتباسات والرموز التعبيرية.
ربما يناسبك هذا #theme-component، الذي يقدم أنماطًا بديلة:

3 إعجابات

شكرًا، يبدو أن هذا سيكون مفيدًا بمجرد عدم الحاجة إلى الفهرسة اليدوية.

تم تقسيم 7 مشاركات إلى موضوع جديد: إعادة البحث في الشريط الجانبي في مكون المكونات الإضافية لفئات مستندات Discourse

تم دمج مشاركة في موضوع موجود: إضافة دعم الشريط الجانبي “أيقونة Discourse” والمزيد

:loudspeaker: تحديثات للمستضيفين الذاتيين

بالنسبة للمستضيفين الذاتيين الذين يستخدمون هذه الإضافة، سيتطلب آخر تحديث لدينا إعادة بناء الفهرس يدويًا. سيتضمن ذلك تشغيل مهمة الـ rake التالية:

bundle exec rake doc_categories:build_sidebar

# إذا فشلت المهمة أعلاه بسبب خطأ NoDatabaseError،
# قم بتشغيلها بالإعدادات التالية للإعدادات المستضافة ذاتيًا النموذجية
sudo -E -u discourse bundle exec rake doc_categories:build_sidebar

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


لماذا نقوم بذلك؟

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

9 إعجابات