Add "Status Bar Widgets" documentation with feature details, visuals, and navigation updates. Refine "Other Tweaks Settings" with clearer descriptions and removed deprecated content.

Author: mallowigi

_data/nav.yml

@@ -22,10 +22,11 @@
     - title: Theme Randomizer
     - title: Other Tweaks Settings
     - title: Quick Actions Panel
+    - title: Status Bar Widgets
     - title: Excluded Files Colors
     - title: File Status Colors
     - title: Scrollbars
-    - title: Recommended Plugins
+    - title: Adaptive Theme
 
 - title: Icons
   pages:

docs/configuration/other-tweaks-settings.md

@@ -1,232 +1,51 @@
 ---
 layout: docs
 title: Other Tweaks
-description: Other Material Theme plugin tweaks
+description: Other miscellaneous plugin tweaks
 group: configuration
 comments: true
 toc: true
 
 previous:
-  url: '/docs/configuration/project-title-bar-settings'
-  title: Project Frame Settings
+  url: '/docs/configuration/theme-randomizer'
+  title: Theme Randomizer
 next:
   url: '/docs/configuration/quick-actions-panel'
   title: Quick Actions Panel
 ---
 
-These features are additional extras to the plugin, not related to the themes or Material Design but simply nice addons to the IDE experience.
+Here you can find other miscellaneous options for the plugin that can't fit in other categories.
 {:class='title'}
 
 {% include carbonads.html %}
 
------
-
-### Colored open directories
-
-This feature is only available for premium users.
-{:class='card-panel warn'}
-
-When this feature is on, the directories that have files open in the editor will be colored with the accent color.
-
-{% include figure.html content="/screens/boldDirectories.png" caption="Open Colored Directories" %}
-
-----
-
-### Show What's New page on each update
-
-This feature is available for all users.
-{:class='card-panel warn'}
-
-This setting allows you to toggle whether the [What's New](/docs/what-s-new) page would show up on each update.
-
------
-
-#### Show Wizard on Welcome Screen
-
-This feature is available for all users.
-{:class='card-panel warn'}
-
-This setting allows you to toggle the **Material Theme Wizard** option in the Welcome Screen.
-
-{% include figure.html content="/screens/welcomeScreen.png" caption="Welcome Screen Wizard Option" %}
-
-
------
-
-### Automatically reset color schemes
-
-This feature is available for all users.
-{:class='card-panel warn'}
-
-One of the main complaints of the plugin is that it constantly asks the user to **reset their color schemes**,
-but in actuality most users have no idea how to nor do want to do so.
-Even though a lot of documentation is available regarding the subject, since the plugin relies a lot on the color schemes,
-relying on user interaction means that there is a high chance they're going to miss new updates.
-
-Therefore, from version **6.12.0** users can now decide to let the plugin **automatically reset the color scheme** during theme activation,
-that's during startup and whenever the theme is changed.
-
-{% include figure.html content="/screens/archive/autoResetSettings.png" caption="Auto Reset Color Scheme" %}
-
-This setting only affects the **bundled themes**, excluding the *Custom themes*.
-{:class='card-panel'}
-
-**Note**: this feature is **opt-in**, meaning it's **disabled by default**, to prevent accidental erasure of user custom modifications.
-Make sure to back up your custom changes before enabling the feature!
+These features are available for all users.
 {:class='card-panel warn'}
 
 ----
 
-### Status Bar Widgets
-
-This isn't a setting, but rather a set of toggleable widgets for the _Status Bar_.
-You can find them by right-clicking the status bar and enabling the widgets you'd like.
-
-#### Material theme widget
-
-Since version 7.4.0, the old _Material Theme widget_ has been redone to better blend with the other widgets.
-It sports the current theme name and icon, and you can open a menu with the list of available themes.
-
-<div class="masonry">
-
-{% include figure.html content="/screens/newWidgets.png" caption="Material Theme + Accent Widget" %}
-
-{% include figure.html content="/screens/widgetsMenu.png" caption="Theme Selection Widget" %}
-
-</div>
-
-#### Accent color widget
-
-Just besides the theme widget, you can also display the _Accent Color Widget_.
-It sports the current accent color, and displays the list of available predefined accent colors when clicked.
-
-<div class="masonry">
-
-{% include figure.html content="/screens/newWidgets.png" caption="Material Theme + Accent Widgets" %}
+## Show What's New page on each update
 
-{% include figure.html content="/screens/accents/accentColorWidget.png" caption="Accent Color Widget" %}
+By default, whenever there's a new version of the plugin, a new tab is opened showcasing the release notes of the new version, taken directly from the [Material Theme UI Documentation](https://material-theme.com/docs/what-s-new).
 
-</div>
+This setting allows you to toggle whether to display this page on each update.
 
-### Current Project Widget
+{% include figure.html content="/screens/other/whatsnew.png" caption="What's New Tab" %}
 
-Version 7.5.3 introduces yet another widget to the Status Bar, which displays the current project and gives the ability to open other projects via a menu. This
-is based on a similar widget available on the title bar in the new UI.
 
-<div class="masonry">
+**Note**: You can also manually open this page via the [Quick Actions Panel](/docs/configuration/quick-actions-panel.md) through the action "Show What's New Page".
 
-{% include figure.html content="/screens/projectsWidget.png" caption="Recent Projects Widget" %}
+{% include figure.html content="/screens/other/actions.png" caption="Show What's New Page Action" %}
 
-</div>
-
-#### Material theme legacy widget
-
-You can still find the previous legacy widget:
-
-<div class="masonry">
-
-{% include figure.html content="/screens/archive/widgetStatusbar.png" caption="Status Bar Widget" %}
-
-{% include figure.html content="/screens/archive/statusAccentWidget.png" caption="Accent Widget" %}
-
-</div>
-
----------
-
-## Deprecated features
-
-### Themed title bar
-
-**Note**: this feature has been incorporated into the main product as of version 2021.2.
-As a result, it has been removed from the plugin.
-{:class='card-panel warn'}
-
-##### Windows 10
-
-This setting also allows the theming of the application title bar in Windows 10. To do so, it is actually setting the
-[Windows Accent Color](https://www.howtogeek.com/225893/how-to-personalize-windows-10s-appearance/) set by Windows.
-
-**Note**: since this modifies the color OS-wide, the color set by the plugin will stick even if you close the
-IDE/uninstall the plugin. Just follow the instructions at
-<https://www.howtogeek.com/225893/how-to-personalize-windows-10s-appearance/> to set it to another color of your choice.
-
-**Note:**: this feature has been removed since version 4.0
-{:class='card-title warn'}
-
-##### macOS with JRE 8
-
-From version 2.5.0 the option came back with support for macOS. And unlike in Windows, this does not change the
-Registry but actually applies the background color to the IDE title bar only!
-
-{% include figure.html content="/screens/archive/titlebarThemed.png" caption="Themed Title Bar Mac" %}
-
-##### macOS with JRE 11
-
-Starting from 2019.1, all IDEs are now bundled with JRE 11 by default.
-But the developers at JetBrains removed the ability to set the transparent title bar, instead they completely removed it!
-
-However, instead of mourning the disparition of the title bar and removing the feature altogether,
-we found out a solution by implementing a _custom title bar_ and by delegating the events to the real, hidden title bar.
-
-{% include figure.html content="/screens/archive/customTitleBar.png" caption="Custom Title Bar" %}
-
-Now the title bar looks more embedded than ever! However, it is still in its **experimental** state, so it can still contain bugs.
-For instance, sometimes the titlebar would not show for some dialogs; the text could be out of sync with what's supposed to show, font rendering issues etc.
-
-We're still working on improving this feature by the time, until perhaps JetBrains finally decides to implement it.
-
-**Note**: this is only for IDEs with JRE 11 enabled, with the JRE bundled by JetBrains.
-Custom JREs would however display **two** titlebars, the real and the fake one together.
-
-**Note 2**: this custom title bar is in experimental state, so bugs may happen.
-If you find a bug, please open an issue at <https://github.com/ChrisRM/material-theme-jetbrains/issues>, if it's not something that has already been discussed.
-In the meanwhile, if you can't work with these issues, you can still switch to JRE 8 or disable the _Themed Title Bar_ option and restart the IDE.
-
-##### Linux
-
-This feature is currently not available in Linux.
-As non-Linux users, we currently have no clue how to achieve that.
-Besides, there are many distributions/frameworks of Linux, being Ubuntu, Gentoo, KDE, Gnome etc…
-
-If someone is interested in a way to do so, please send us a PM by email or Slack; it would be great!
 
 -----
 
-### Theme in status bar
-
-This setting adds a "widget" to the status bar to indicate which theme you are currently on.
-You can also click on it to open the Material Theme Settings.
-
-{% include figure.html content="/screens/archive/widgetStatusbar.png" caption="Status Bar Widget" %}
-
-Starting from version 2.9.4/2.10.4, you can also see your current accent color.
+## Show Wizard on Welcome Screen
 
-{% include figure.html content="/screens/archive/statusAccentWidget.png" caption="Accent Widget" %}
-
-**Note**: this feature has been merged into the Status bar's context menu as of version 2020.3.
-As a result, it has been removed from the plugin.
-{:class='card-panel warn'}
-
-{% include figure.html content="/screens/archive/statusbar.png" caption="Status Bar Toggles" %}
-
------
-
-## FAQ/troubleshooting
-
-**Q**: **I've got two title bars! / My title bar is gone! / My title bar is …**
-
-**A**: This is due to the _Experimental Themed Title Bar_ implemented since 4.3.0. This feature is still in its experimental state so there could still be bugs.
-Please open an issue in the GitHub repository, and if it bothers you, you can either revert to the JRE 8, or disable the feature and restart the IDE to get back
-the real title bar.
-
-**Q**: **Somehow I've updated the plugin and now my window is empty!!!!!**
+This setting allows you to toggle the **Material Theme Wizard** option in the Welcome Screen.
 
-**A**: This is a rare and weird case due to the custom title bar implementation.
-Reports have indicated that this issue happens only once and can be fixed by… resizing the window!
-Theoretically, it should be enough to fix the issue, but if it's not the case, please disable the _Themed Title Bar_ until a fix is found.
+{% include figure.html content="/screens/other/welcomeScreen.png" caption="Welcome Screen Wizard" %}
 
-**Q**: **My Custom background image is gone!**
+**Note**: You can also manually open the wizard via the [Quick Actions Panel](/docs/configuration/quick-actions-panel.md) through the action "Show Material Theme Wizard".
 
-**A**: Sorry, this is due to the _Material Wallpapers_ feature, since it replays the empty frame background with the themes' background image. To resort to
-this, first disable the feature and then set the image back as explained in
-the [instructions here](https://www.jetbrains.com/help/idea/setting-background-image.html)
+{% include figure.html content="/screens/other/actions.png" caption="Show Material Theme Wizard Action" %}

docs/configuration/quick-actions-panel.md

@@ -10,8 +10,8 @@ previous:
   url: '/docs/configuration/ui-components-settings'
   title: Component Settings
 next:
-  url: '/docs/configuration/excluded-files-colors'
-  title: Excluded File Colors
+  url: '/docs/configuration/status-bar-widgets'
+  title: Status Bar Widgets
 ---
 
 Here you can find an explanation of the actions found in the `Quick Actions Panel`.

docs/configuration/status-bar-widgets.md

@@ -0,0 +1,74 @@
+---
+layout: docs
+title: Status Bar Widgets
+description: Neat Status Bar Widgets to quickly access some of the plugin's features.
+group: configuration
+toc: true
+comments: true
+
+previous:
+  url: '/docs/configuration/quick-actions-panel'
+  title: Quick Actions Panel
+next:
+  url: '/docs/configuration/excluded-files-colors'
+  title: Excluded File Colors
+---
+
+Here you can find an explanation of the actions found in the `Quick Actions Panel`.
+{:class='title'}
+
+{% include carbonads.html %}
+
+## Status Bar Widgets
+
+This isn't a setting, but rather a set of toggleable widgets for the _Status Bar_.
+You can find them by right-clicking the status bar and enabling the widgets you'd like.
+
+### Material theme widget
+
+Since version 7.4.0, the old _Material Theme widget_ has been redone to better blend with the other widgets.
+It sports the current theme name and icon, and you can open a menu with the list of available themes.
+
+<div class="masonry">
+
+{% include figure.html content="/screens/newWidgets.png" caption="Material Theme + Accent Widget" %}
+
+{% include figure.html content="/screens/widgetsMenu.png" caption="Theme Selection Widget" %}
+
+</div>
+
+### Accent color widget
+
+Just besides the theme widget, you can also display the _Accent Color Widget_.
+It sports the current accent color, and displays the list of available predefined accent colors when clicked.
+
+<div class="masonry">
+
+{% include figure.html content="/screens/newWidgets.png" caption="Material Theme + Accent Widgets" %}
+
+{% include figure.html content="/screens/accents/accentColorWidget.png" caption="Accent Color Widget" %}
+
+</div>
+
+### Current Project Widget
+
+Version 7.5.3 introduces yet another widget to the Status Bar, which displays the current project and gives the ability to open other projects via a menu. This
+is based on a similar widget available on the title bar in the new UI.
+
+<div class="masonry">
+
+{% include figure.html content="/screens/projectsWidget.png" caption="Recent Projects Widget" %}
+
+</div>
+
+### Material theme legacy widget
+
+You can still find the previous legacy widget:
+
+<div class="masonry">
+
+{% include figure.html content="/screens/archive/widgetStatusbar.png" caption="Status Bar Widget" %}
+
+{% include figure.html content="/screens/archive/statusAccentWidget.png" caption="Accent Widget" %}
+
+</div>

docs/configuration/theme-randomizer.md

@@ -70,6 +70,10 @@ You can manage and view the current playlist via the **Favorite Theme Shuffle**
 
 Within this tool window, you can manually select a theme, skip to the next or previous theme, or shuffle the playlist to generate a new random sequence. You can also view the remaining time until the next rotation.
 
+**Note**: You can also switch themes via the [Quick Actions Panel](/docs/configuration/quick-actions-panel.md).
+
+{% include figure.html content="/screens/randomizer/randomizerActions.png" caption="Randomizer Actions" %}
+
 The tool window also features a **Disable Selected Theme** button, allowing you to quickly exclude the current theme from future rotations without opening the settings. Disabling a theme will automatically re-shuffle the playlist.
 
 **Note**: Manually adding or removing themes, or switching the current theme, will trigger a re-shuffle of the playlist.