From ab095395b44451bb4e0eb74b0d2611e81c2a1624 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yann=20C=C3=A9bron?= <yann.cebron@jetbrains.com>
Date: Wed, 24 Jul 2024 15:14:06 +0200
Subject: [PATCH] Theme: more links to theme sample plugin

---
 .../basics/getting_started/theme/developing_themes.md  | 10 +++++++++-
 topics/basics/getting_started/theme/theme_structure.md |  4 +---
 .../basics/getting_started/theme/themes_customize.md   |  2 ++
 topics/basics/getting_started/theme/themes_extras.md   |  6 ++++--
 4 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/topics/basics/getting_started/theme/developing_themes.md b/topics/basics/getting_started/theme/developing_themes.md
index f8035d57f..cd62b97d6 100644
--- a/topics/basics/getting_started/theme/developing_themes.md
+++ b/topics/basics/getting_started/theme/developing_themes.md
@@ -1,4 +1,4 @@
-<!-- Copyright 2000-2023 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
+<!-- Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
 # Developing a Theme
 
@@ -14,3 +14,11 @@ The DevKit-based theme development workflow includes:
 * [Building and Running a Theme](running_and_debugging_a_theme.md)
 * [Deploying a Theme in IDE](deploying_theme.md)
 * [Uploading a Theme to JetBrains Marketplace](publishing_plugin.md#uploading-a-plugin-to-jetbrains-marketplace)
+
+<snippet id="themeSamplePlugin">
+
+> To see a full example theme project, see the [Theme Basics](%gh-sdk-samples-master%/theme_basics) in IntelliJ SDK Code Samples.
+>
+{title="Theme Plugin Sample" style="note"}
+
+</snippet>
diff --git a/topics/basics/getting_started/theme/theme_structure.md b/topics/basics/getting_started/theme/theme_structure.md
index 0a150d10e..cb2ad291a 100644
--- a/topics/basics/getting_started/theme/theme_structure.md
+++ b/topics/basics/getting_started/theme/theme_structure.md
@@ -7,9 +7,7 @@
 Themes are components within [IntelliJ Platform plugins](plugin_structure.topic).
 The theme plugins should be stand-alone and not combined with other plugin functionality.
 
-> To see a full example theme project, see the [Theme Basics](%gh-sdk-samples-master%/theme_basics) in IntelliJ SDK Code Samples.
->
-{style="note"}
+<include from="developing_themes.md" element-id="themeSamplePlugin"/>
 
 Themes have several components:
 * A required Theme description (JSON) file in the plugin project's <path>resources</path> folder.
diff --git a/topics/basics/getting_started/theme/themes_customize.md b/topics/basics/getting_started/theme/themes_customize.md
index 07e8d239b..ab7e29c03 100644
--- a/topics/basics/getting_started/theme/themes_customize.md
+++ b/topics/basics/getting_started/theme/themes_customize.md
@@ -17,6 +17,8 @@ For plugin developers, [Exposing Theme Metadata](themes_metadata.md) discusses t
 > [Color Highlighter Plugin](https://plugins.jetbrains.com/plugin/13309-color-highlighter) adds additional color preview inside the editor.
 >
 
+<include from="developing_themes.md" element-id="themeSamplePlugin"/>
+
 ## Introduction to Theme Description File Syntax
 
 The syntax of a Theme description file follows the JSON open-standard file format of key-value pairs.
diff --git a/topics/basics/getting_started/theme/themes_extras.md b/topics/basics/getting_started/theme/themes_extras.md
index 30456b5bc..047d2afcb 100644
--- a/topics/basics/getting_started/theme/themes_extras.md
+++ b/topics/basics/getting_started/theme/themes_extras.md
@@ -1,11 +1,13 @@
-# Themes - Editor Schemes and Background Images
+<!-- Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
-<!-- Copyright 2000-2023 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
+# Themes - Editor Schemes and Background Images
 
 <link-summary>Customizing editor schemes and editor or application background images in a theme plugin.</link-summary>
 
 Themes can also provide custom color and font settings, as well as custom images for display in the IDE application window.
 
+<include from="developing_themes.md" element-id="themeSamplePlugin"/>
+
 ## Adding a Custom Editor Scheme
 
 Users of IntelliJ Platform-based IDEs, such as IntelliJ IDEA, can set preferences to configure the colors and fonts used in the Editor.