From e4cfe8aeecf3a94c9c7b6cbf8de754ad5f19ef9f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yann=20C=C3=A9bron?= <yann.cebron@jetbrains.com>
Date: Wed, 3 Apr 2024 10:49:45 +0200
Subject: [PATCH] Live Template: use i18n attributes, update docs

---
 .../src/main/resources/META-INF/plugin.xml             |  2 ++
 .../src/main/resources/liveTemplates/Markdown.xml      | 10 +++++-----
 .../main/resources/messages/LiveTemplates.properties   |  2 ++
 topics/tutorials/live_templates/template_support.md    |  8 +++++---
 4 files changed, 14 insertions(+), 8 deletions(-)
 create mode 100644 code_samples/live_templates/src/main/resources/messages/LiveTemplates.properties

diff --git a/code_samples/live_templates/src/main/resources/META-INF/plugin.xml b/code_samples/live_templates/src/main/resources/META-INF/plugin.xml
index 33828fc62..7eb46a929 100644
--- a/code_samples/live_templates/src/main/resources/META-INF/plugin.xml
+++ b/code_samples/live_templates/src/main/resources/META-INF/plugin.xml
@@ -32,6 +32,8 @@
   <!-- Text to display as company information on Settings | Plugin page -->
   <vendor url="https://plugins.jetbrains.com">IntelliJ Platform SDK</vendor>
 
+  <resource-bundle>messages.LiveTemplates</resource-bundle>
+
   <extensions defaultExtensionNs="com.intellij">
     <defaultLiveTemplates file="/liveTemplates/Markdown.xml"/>
     <liveTemplateContext implementation="org.intellij.sdk.liveTemplates.MarkdownContext"
diff --git a/code_samples/live_templates/src/main/resources/liveTemplates/Markdown.xml b/code_samples/live_templates/src/main/resources/liveTemplates/Markdown.xml
index 991f6e3c4..fb7edfebb 100644
--- a/code_samples/live_templates/src/main/resources/liveTemplates/Markdown.xml
+++ b/code_samples/live_templates/src/main/resources/liveTemplates/Markdown.xml
@@ -1,9 +1,9 @@
 <templateSet group="Markdown">
   <template name="{"
             value="[$TEXT$]($LINK$)$END$"
-            description="SDK: New link reference"
             toReformat="false"
-            toShortenFQNames="false">
+            toShortenFQNames="false"
+            key="live.template.{.description" resource-bundle="messages.LiveTemplates">
     <variable name="TEXT" expression="" defaultValue="" alwaysStopAt="true"/>
     <variable name="LINK" expression="complete()" defaultValue="" alwaysStopAt="true"/>
     <context>
@@ -12,12 +12,12 @@
   </template>
   <template name="mc"
             value="$TITLE$"
-            description="SDK: Convert to title case"
             toReformat="true"
-            toShortenFQNames="false">
+            toShortenFQNames="false"
+            key="live.template.mc.description" resource-bundle="messages.LiveTemplates">
     <variable name="TITLE" expression="titleCase(SELECTION)" defaultValue="the quick brown fox" alwaysStopAt="true" />
     <context>
       <option name="MARKDOWN" value="true" />
     </context>
   </template>
-</templateSet>
\ No newline at end of file
+</templateSet>
diff --git a/code_samples/live_templates/src/main/resources/messages/LiveTemplates.properties b/code_samples/live_templates/src/main/resources/messages/LiveTemplates.properties
new file mode 100644
index 000000000..c95e23be9
--- /dev/null
+++ b/code_samples/live_templates/src/main/resources/messages/LiveTemplates.properties
@@ -0,0 +1,2 @@
+live.template.mc.description=SDK: Convert to title case
+live.template.{.description=SDK: New link reference
diff --git a/topics/tutorials/live_templates/template_support.md b/topics/tutorials/live_templates/template_support.md
index a6173b892..c086d56cc 100644
--- a/topics/tutorials/live_templates/template_support.md
+++ b/topics/tutorials/live_templates/template_support.md
@@ -1,6 +1,6 @@
-# Providing Live Templates
+<!-- Copyright 2000-2024 JetBrains s.r.o. and other contributors. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file. -->
 
-<!-- Copyright 2000-2023 JetBrains s.r.o. and other contributors. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file. -->
+# Providing Live Templates
 
 <link-summary>Adding custom Live Templates.</link-summary>
 
@@ -57,7 +57,9 @@ The export produces a file called <path>Markdown.xml</path> with the following c
 </templateSet>
 ```
 
-The display `name` can also provide localized variants by specifying `key` and `resource-bundle` attributes additionally (2020.3 and later).
+The display `description` can also provide localized variants by specifying
+`key` and `resource-bundle` attributes instead (code insight is available in 2020.3 and later).
+A quick fix to extract the localized key is available since 2024.2.
 
 Copy this file into the [plugin's resources folder](%gh-sdk-samples%/live_templates/src/main/resources/liveTemplates).