Update: 2024-10-17

config/yazi/plugins/max-preview.yazi/README.md

@@ -7,7 +7,7 @@ https://github.com/yazi-rs/plugins/assets/17523360/8976308e-ebfe-4e9e-babe-153eb
 ## Installation
 
 ```sh
-ya pack -a yazi-rs/plugins#max-preview
+ya pack -a yazi-rs/plugins:max-preview
 ```
 
 ## Usage
@@ -22,3 +22,26 @@ desc = "Maximize or restore preview"
 ```
 
 Make sure the <kbd>T</kbd> key is not used elsewhere.
+
+## Tips
+
+This plugin only maximizes the "available preview area", without actually changing the content size.
+
+This means that the appearance of your preview largely depends on the previewer you are using.
+However, most previewers tend to make the most of the available space, so this usually isn't an issue.
+
+For image previews, you may want to tune up the [`max_width`][max-width] and [`max_height`][max-height] options in your `yazi.toml`:
+
+```toml
+[preview]
+# Change them to your desired values
+max_width  = 1000
+max_height = 1000
+```
+
+[max-width]: https://yazi-rs.github.io/docs/configuration/yazi/#preview.max_width
+[max-height]: https://yazi-rs.github.io/docs/configuration/yazi/#preview.max_height
+
+## License
+
+This plugin is MIT-licensed. For more information check the [LICENSE](LICENSE) file.

config/yazi/plugins/max-preview.yazi/init.lua

@@ -17,4 +17,6 @@ local function entry(st)
 	ya.app_emit("resize", {})
 end
 
-return { entry = entry }
+local function enabled(st) return st.old ~= nil end
+
+return { entry = entry, enabled = enabled }