Apicurio-studio: كيفية تمكين وحدة التحكم "جربها" في Redocly في Apicurio على OpenShift.

تم إنشاؤها على ٢٦ مايو ٢٠٢١  ·  7تعليقات  ·  مصدر: Apicurio/apicurio-studio

مرحبًا يا شباب ، آسف للدخول في سؤال ، لكنني بحثت في هذا المشروع و Google ولم أتمكن من معرفة كيفية القيام بذلك. تصف المستندات Redocly الموجودة في هذا الرابط كيفية القيام بذلك في ملف Redocly yaml https://redoc.ly/docs/api-reference-docs/console-overview/#enable -the-try-it-api-console لكنني لست متأكدًا من كيفية القيام بذلك في تثبيت Docker / k8s. لا أرى أي متغيرات بيئية يمكن تطبيقها. شكرا مقدما على أي مساعدة.

question

التعليق الأكثر فائدة

قد أكون مهتمًا بالمساهمة ، وسأكون على اتصال!

ال 7 كومينتر

سؤال جيد. من الجيد معرفة ما إذا كانت هناك طريقة لتمكين ميزة "Try It" في استوديو APICurio.

ما أفهمه هو أن ميزة Try It الخاصة بـ ReDoc ليست مدرجة في عرض المصدر المفتوح. لذلك لا أعتقد أن هناك طريقة لتمكينه في Studio. إذا كنت مخطئًا ، فسأكون سعيدًا جدًا بمعرفة ذلك. :)

تضمين التغريدة
لدى RapiDoc و SwaggerUI ميزة جربها ، لكن Redoc لا تفعل ذلك. سيكون من الجيد أن تكون قادرًا على التبديل بين واجهات مستخدم المستندات ، هل هناك أي خطط للقيام بذلك؟

RapiDoc
https://mrin9.github.io/RapiDoc/index.html
Swagger UI
https://swagger.io/tools/swagger-ui/

ومن المثير للاهتمام أن لدينا بالفعل دعمًا تجريبيًا لـ fastoc في ميزة المعاينة. إذا قمت بإضافة &rid=rapidoc إلى معاينة URL ، يمكنك رؤيته. على سبيل المثال:

image

الكود ذو الصلة موجود هنا:

https://github.com/Apicurio/apicurio-studio/blob/master/front-end/servlet/src/main/java/io/apicurio/studio/fe/servlet/servlets/PreviewServlet.java#L78 -L82

المساهمات لعارضين آخرين مثل Swagger UI لن تكون صعبة!

رائع ، يعجبني شكل ومظهر Rapidoc ، على الرغم من تعطيل ميزة Try it out في Apicurio:
https://github.com/Apicurio/apicurio-studio/blob/dfc277b03032562e4a3d37f16c851159340495b0/front-end/servlet/src/main/resources/io/apicurio/studio/fe/servlet/servlets/preview_rapidoc.temem

لتمكينه قم بتعيين allow-try=true أو قم بإزالة السمة على أنها true هي القيمة الافتراضية.

آه نعم - آسف لذلك ، لقد نسيت أنني قمت بتعطيل هذه الميزة على وجه التحديد. لا أتذكر عملية التفكير ، ولكن ربما لم يكن أي من أوصاف API الخاصة بي يحتوي على خدمات حقيقية تدعمها.

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

قد أكون مهتمًا بالمساهمة ، وسأكون على اتصال!

هل كانت هذه الصفحة مفيدة؟
0 / 5 - 0 التقييمات