Merge pull request #1295 from TriliumNext/feat_add-link-to-swagger-ui

feat(options/etapi): improve etapi options page description

src/public/app/widgets/type_widgets/options/etapi.ts

@@ -10,7 +10,13 @@ const TPL = `
     <h4>${t("etapi.title")}</h4>
 
     <p>${t("etapi.description")} <br/>
-       ${t("etapi.see_more")} <a class="tn-link" href="https://triliumnext.github.io/Docs/Wiki/etapi.html">${t("etapi.wiki")}</a> ${t("etapi.and")} <a class="tn-link" onclick="window.open('etapi/etapi.openapi.yaml')" href="etapi/etapi.openapi.yaml">${t("etapi.openapi_spec")}</a>.</p>
+      ${t("etapi.see_more", {
+        link_to_wiki: `<a class="tn-link" href="https://triliumnext.github.io/Docs/Wiki/etapi.html">${t("etapi.wiki")}</a>`,
+        // TODO: We use window.open src/public/app/services/link.ts -> prevents regular click behavior on "a" element here because it's a relative path
+        link_to_openapi_spec: `<a class="tn-link" onclick="window.open('etapi/etapi.openapi.yaml')" href="etapi/etapi.openapi.yaml">${t("etapi.openapi_spec")}</a>`,
+        link_to_swagger_ui: `<a class="tn-link" href="#_help_f3xpgx6H01PW">${t("etapi.swagger_ui")}</a>`
+      })}
+    </p>
 
     <button type="button" class="create-etapi-token btn btn-sm">${t("etapi.create_token")}</button>
 

src/public/translations/cn/translation.json

@@ -1221,10 +1221,10 @@
   "etapi": {
     "title": "ETAPI",
     "description": "ETAPI 是一个 REST API，用于以编程方式访问 Trilium 实例，而无需 UI。",
-    "see_more": "更多详情见",
+    "see_more": "",
     "wiki": "维基",
-    "and": "和",
     "openapi_spec": "ETAPI OpenAPI 规范",
+    "swagger_ui": "",
     "create_token": "创建新的 ETAPI 令牌",
     "existing_tokens": "现有令牌",
     "no_tokens_yet": "目前还没有令牌。点击上面的按钮创建一个。",

src/public/translations/de/translation.json

@@ -1248,10 +1248,10 @@
   "etapi": {
     "title": "ETAPI",
     "description": "ETAPI ist eine REST-API, die für den programmgesteuerten Zugriff auf die Trilium-Instanz ohne Benutzeroberfläche verwendet wird.",
-    "see_more": "Weitere Details findest du unter",
+    "see_more": "Weitere Details können im {{- link_to_wiki}} und in der {{- link_to_openapi_spec}} oder der {{- link_to_swagger_ui }} gefunden werden.",
     "wiki": "Wiki",
-    "and": "und",
     "openapi_spec": "ETAPI OpenAPI-Spezifikation",
+    "swagger_ui": "ETAPI Swagger UI",
     "create_token": "Erstelle ein neues ETAPI-Token",
     "existing_tokens": "Vorhandene Token",
     "no_tokens_yet": "Es sind noch keine Token vorhanden. Klicke auf die Schaltfläche oben, um eine zu erstellen.",

src/public/translations/en/translation.json

@@ -1252,10 +1252,10 @@
   "etapi": {
     "title": "ETAPI",
     "description": "ETAPI is a REST API used to access Trilium instance programmatically, without UI.",
-    "see_more": "See more details on",
+    "see_more": "See more details in the {{- link_to_wiki}} and the {{- link_to_openapi_spec}} or the {{- link_to_swagger_ui }}.",
     "wiki": "wiki",
-    "and": "and",
     "openapi_spec": "ETAPI OpenAPI spec",
+    "swagger_ui": "ETAPI Swagger UI",
     "create_token": "Create new ETAPI token",
     "existing_tokens": "Existing tokens",
     "no_tokens_yet": "There are no tokens yet. Click on the button above to create one.",

src/public/translations/es/translation.json

@@ -1245,10 +1245,10 @@
   "etapi": {
     "title": "ETAPI",
     "description": "ETAPI es una REST API que se utiliza para acceder a la instancia de Trilium mediante programación, sin interfaz de usuario.",
-    "see_more": "Ver más detalles sobre",
+    "see_more": "",
     "wiki": "wiki",
-    "and": "y",
     "openapi_spec": "Especificación ETAPI OpenAPI",
+    "swagger_ui": "",
     "create_token": "Crear nuevo token ETAPI",
     "existing_tokens": "Tokens existentes",
     "no_tokens_yet": "Aún no hay tokens. Dé clic en el botón de arriba para crear uno.",

src/public/translations/fr/translation.json

@@ -1252,10 +1252,10 @@
   "etapi": {
     "title": "ETAPI",
     "description": "ETAPI est une API REST utilisée pour accéder à l'instance Trilium par programme, sans interface utilisateur.",
-    "see_more": "Voir plus de détails sur",
+    "see_more": "",
     "wiki": "wiki",
-    "and": "et",
     "openapi_spec": "Spec ETAPI OpenAPI",
+    "swagger_ui": "",
     "create_token": "Créer un nouveau jeton ETAPI",
     "existing_tokens": "Jetons existants",
     "no_tokens_yet": "Il n'y a pas encore de jetons. Cliquez sur le bouton ci-dessus pour en créer un.",

src/public/translations/ro/translation.json

@@ -479,7 +479,6 @@
   },
   "etapi": {
     "actions": "Acțiuni",
-    "and": "și",
     "create_token": "Crează un token ETAPI nou",
     "created": "Creat",
     "default_token_name": "token nou",
@@ -492,10 +491,11 @@
     "new_token_title": "Token ETAPI nou",
     "no_tokens_yet": "Nu există încă token-uri. Clic pe butonul de deasupra pentru a crea una.",
     "openapi_spec": "Specificația OpenAPI pentru ETAPI",
+    "swagger_ui": "UI-ul Swagger pentru ETAPI",
     "rename_token": "Redenumește token-ul",
     "rename_token_message": "Introduceți denumirea noului token",
     "rename_token_title": "Redenumire token",
-    "see_more": "Mai multe informații pe",
+    "see_more": "Vedeți mai multe detalii în {{- link_to_wiki}} și în {{- link_to_openapi_spec}} sau în {{- link_to_swagger_ui }}.",
     "title": "ETAPI",
     "token_created_message": "Copiați token-ul creat în clipboard. Trilium stochează token-ul ca hash așadar această valoare poate fi văzută doar acum.",
     "token_created_title": "Token ETAPI creat",

src/public/translations/tw/translation.json

@@ -1199,10 +1199,10 @@
   "etapi": {
     "title": "ETAPI",
     "description": "ETAPI 是一個 REST API，用於以編程方式訪問 Trilium 實例，而無需 UI。",
-    "see_more": "更多詳情見",
+    "see_more": "",
     "wiki": "維基",
-    "and": "和",
     "openapi_spec": "ETAPI OpenAPI 規範",
+    "swagger_ui": "",
     "create_token": "新增新的 ETAPI 令牌",
     "existing_tokens": "現有令牌",
     "no_tokens_yet": "目前還沒有令牌。點擊上面的按鈕新增一個。",