تنقل أفضل في الوثائق مع الشريط الجانبي الجديد

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

:star2: ما الجديد؟

يظهر الشريط الجانبي الجديد في جميع فئات ومواضيع الوثائق، مما يسهل التنقل في محتواها. إليك ما يمكنك توقعه:

  1. تحسين التنقل: مع هيكل هرمي واضح، أصبح التنقل بين المواضيع المختلفة أسرع وأكثر مباشرة.
  2. الوعي بالسياق: يسلط الشريط الجانبي الضوء على المواضيع الحالية التي تشاهدها، مما يسهل فهم مكانك في الوثائق.
  3. أقسام قابلة للطي: يمكن طي كل قسم داخل الشريط الجانبي وتوسيعه حسب الحاجة، مما يسهل العثور على المواضيع التي تحتاجها.
  4. مرشح مباشر: ابحث بسرعة عن مواضيع محددة في الشريط الجانبي عن طريق كتابة الكلمات الرئيسية ذات الصلة - إذا لم يتم العثور على شيء، فسيتم دعوتك لإجراء بحث أعمق بنفس المطالبة.
  5. صديق للجوال: يعمل الشريط الجانبي الجديد بسلاسة على الجوال، مع جميع الميزات نفسها مثل العرض على سطح المكتب.

:eyes: دعنا نلقي نظرة

:boom: يمكنك مشاهدة الشريط الجانبي الجديد للوثائق أثناء العمل اليوم!

فيما يلي بعض لقطات الشاشة لتعطيك فكرة أفضل عما يمكن توقعه:

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

تُظهر كل فئة المواضيع بداخلها، مقسمة إلى أقسام محددة.

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

يمكن طي كل قسم، مما يسمح لك بالعثور على المحتوى الذي تحتاجه بسهولة أكبر.

يمكن توسيع الأقسام الفردية لإظهار محتواها بوضوح أكبر.

:building_construction: البناء على التحسينات الأخيرة

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

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

:ear: نريد ملاحظاتك!

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

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

شكرًا لكونك جزءًا من مجتمع Discourse. نحن متحمسون لرؤية كيف ستعزز هذه الميزة الجديدة تجربتك مع Discourse.

22 إعجابًا

تهانينا على التغييرات الجديدة؛ إنها رائعة حقًا. :clap:

  • تصفية مباشرة عبر جميع الفئات
    أعلم أن الطريقة التي تعمل بها حاليًا قد تكون صعبة؛ كنت أتمنى لو كان بإمكاني التصفية بغض النظر عن (الفئات الفرعية) التي أنا فيها. هذا هو أول شيء حاولت فعله بشكل طبيعي:

    بالطبع، هناك روابط للمساعدة، وهذا رائع. بدلاً من ذلك، كنت أتوقع:

  • انتقال المحتوى لأعلى عند استخدام Ctrl + /
    عند استخدام الاختصار للتركيز على حقل البحث، فإنه يقوم بالتمرير لأعلى الشريط الجانبي والمحتوى. لا أتوقع أن ينتقل المحتوى لأعلى هنا.

  • فقدان الوعي بالسياق
    إذا استخدمت المرشح، ونقرت على موضوع، ثم مسحت المرشح، فقد لا ترى الموضوع المميز. تعديل: أيضًا، إذا انتقلت إلى موضوع من منشور.

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

9 إعجابات

إضافة/تحسين رائع! :tada:

إنه أبسط بكثير للتنقل لأنه أكثر وضوحًا بكثير أين تبحث :wink:

شيء واحد بسيط هو ترتيب الفئات مقابل الترتيب في الشريط الجانبي للتنقل.

في Documentation آخر 3 فئات هي:

Documentation > Migrating to Discourse
Documentation > Contributing
Documentation > Developer Guides

ومع ذلك، في الشريط الجانبي للتنقل، تم تبديل Documentation > Developer Guides و Documentation > Contributing.

عمل رائع!

4 إعجابات

هل يجب أن تكون بنفس الترتيب؟

أين ترى الترتيب البديل؟

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

أنا على الهاتف المحمول.

غريب. لا أعرف لماذا يختلف لديك قليلاً. :thinking:

هذا ما أراه:

لا يبدو أن لديك وصف فئة دليل المطور في المربع. هل كتمت الفئة أم شيء من هذا القبيل؟

3 إعجابات

هل يمكنني تمكين شريط جانبي للفئات كهذا في مثيلات أخرى؟

إعجابَين (2)

إنها Theme component GitHub - discourse/discourse-docs-sidebar.

5 إعجابات

آه، كان هذا هو السبب، تم حل المشكلة! :wink:

5 إعجابات

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

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

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

8 إعجابات

هذا لطيف جدًا بالفعل. أتطلع إلى إصدار كامل.

إعجابَين (2)

من الأسهل بكثير استخدامه من القديم. أكثر… وضوحًا. لكن يمكنني المراهنة على أن الأكثر توجهاً نحو الجانب التقني قد يرونه مقيدًا.

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

ولكن إذا كان يحتاج إلى اهتمام ورعاية مستمرة من جانب المسؤول… :thinking:

3 إعجابات

شكرًا لملاحظتك هذه، @Arkshine! يجب أن تكون جميعها قابلة للإصلاح، لذا سنرى ما يمكننا فعله هنا.

إعجابَين (2)

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

لا يمكنني إعادة إنتاج المشكلة.

جربت للتو على جهاز الآيباد الخاص بي.

هل يمكنك التحقق مما إذا كانت لا تزال تحدث؟

لا يزال يحدث. يمكنني تكراره في Chrome و Edge، ولكن ليس باستخدام تطبيق Firefox.

لا يزال، لا يمكنني إعادة إنتاج المشكلة. لا أرى كيف يمكن لشريط الشريط الجانبي للمستندات أن يسبب هذا.

إنه لا يغير أي رمز بحث.

قد يكون شيئًا آخر.

هل يمكنك تقديم المزيد من التفاصيل حول الإعداد الذي تستخدمه؟ إصدار المتصفح، نظام التشغيل، إلخ.

جالاكسي تاب إس 9 إف إي
Android 14؛ SM-X510 Build/UP1A.231005.007
Chrome 126.0.6478.123

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

إعجابَين (2)

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

4 إعجابات

يجب حل المشكلة بواسطة:

إنها متاحة بالفعل على Meta

5 إعجابات