كيفية استخدام @link و @code في KDoc (Kotlin) لتوثيق الكود بشكل صحيح؟

مرحبًا بالجميع! لقد بدأت مؤخرًا في تعلم Kotlin وأحاول توثيق دوالّي باستخدام KDoc. قرأت أنه يمكن استخدام الوسوم `@link` و `@code`، لكنني لا أستطيع جعلها تعمل بشكل صحيح. إليك مثال على الدالة الخاصة بي: ```kotlin /** * تحسب مجموع رقمين. * تستخدم @link Calculator لإجراء العمليات الحسابية. * @param a الرقم الأول من النوع @code Int. * @param b الرقم الثاني من النوع @code Int. * @return النتيجة من النوع @code Int. */ fun add(a: Int, b: Int): Int { return a + b } ``` المشكلة هي أنه في التوثيق المُنشأ (مثل Dokka)، أرى فقط النص `@link Calculator` و `@code Int`، وليس روابط منسقة أو نصًا أحادي المسافة. كنت أتوقع أن `@link` سينشئ رابطًا قابلًا للنقر على الفئة `Calculator`، وأن `@code` سيميز `Int` ككود. لقد جربت صيغًا مختلفة: كتبت `{@link Calculator}`، `[Calculator]`، لكن لا شيء يعمل. في التوثيق الرسمي لـ KDoc، مكتوب أن الوسوم `@link` و `@code` مدعومة.