Differences

This shows you the differences between two versions of the page.

--- apps:mousepad:start [2021/10/02 08:14] – [Mousepad] gael
+++ apps:mousepad:start [2026/11/02 17:46] (current) – minor formatting & grammar improvements kevinbowen
@@ Line 1: / Line 1: @@
 ~~NOTOC~~
-{{ :xfce:xfce.mousepad.png?no link|}}
+ {{ :apps:mousepad.png?nolink|}}
 ====== Mousepad ======
@@ Line 19: / Line 19: @@
 ===== Introduction =====
-**Mousepad** aims to be an easy-to-use and fast editor. Our target is an
+Mousepad aims to be an easy-to-use and fast editor. Our target is an
 editor for quickly editing text files, not a development environment or an
 editor with a huge bunch of plugins. On the other hand we try to use the latest
 GTK features available, which means that if GTK adds something new in a major
 release that is useful for the editor, we will likely bump the GTK dependency
-and integrate this new feature in **Mousepad**.
+and integrate this new feature in Mousepad.
 ----
 ===== Screenshots =====
-<figure "Main window">
+<figure "Mousepad Main Window">
-{{::apps:mousepad:mousepad_window.png|:apps:mousepad:mousepad_window.png}}
+{{::apps:mousepad:mousepad_window.png?600|Mousepad Main Window}}
 </figure>
-<figure "View and Editor Preferences">
+<figure "Mousepad View and Editor Preferences">
-{{:apps:mousepad:mousepad_view_preferences.png|:apps:mousepad:mousepad_window.png}}
+{{:apps:mousepad:mousepad_view_preferences.png|Mousepad View Preferences Window}}
-{{:apps:mousepad:mousepad_editor_preferences.png|:apps:mousepad:mousepad_editor_preferences.png}}
+{{:apps:mousepad:mousepad_editor_preferences.png|Mousepad Editor Preferences Window}}
 </figure>
-<figure "Window and File Preferences">
+<figure "Mousepad Window and File Preferences">
-{{:apps:mousepad:mousepad_window_preferences.png|:apps:mousepad:mousepad_window_preferences.png}}
+{{:apps:mousepad:mousepad_window_preferences.png|Mousepad Window Preferences}}
-{{:apps:mousepad:mousepad_file_preferences.png|:apps:mousepad:mousepad_file_preferences.png}}
+{{:apps:mousepad:mousepad_file_preferences.png|Mousepad File Preferences Window}}
 </figure>
-<figure "Plugins Preferences">
+<figure "Mousepad Plugins Preferences">
-{{:apps:mousepad:mousepad_plugins_preferences.png|:apps:mousepad:mousepad_plugins_preferences.png}}
+{{:apps:mousepad:mousepad_plugins_preferences.png|Mousepad Plugins Preferences Window}}
 </figure>
@@ Line 53: / Line 53: @@
 ===== Settings =====
-The preferences dialog shown above is the easiest way to set Mousepad settings. Some of them are also accessible via the menubar, e.g. "Word Wrap" and "Auto Indent" in the "Document" menu.
+The Preferences dialog, shown above, is the easiest way to set Mousepad settings. Some of them are also accessible via the menubar, e.g. "Word Wrap" and "Auto Indent" in the "Document" menu.
 All these settings, plus some "hidden" ones, are also accessible using Dconf Editor, normally available from your distribution repositories: see https://wiki.gnome.org/Apps/DconfEditor.
-From the command line, you can use ''gsettings'' or ''dconf''. You can get a list of everything about Mousepad in GSettings, except plugins, with this command:
+From the command line, you can use ''gsettings'' or ''dconf'' to get a list of everything about Mousepad in GSettings, except plugins, with this command:
    gsettings list-recursively org.xfce.mousepad
-Then, to enable e.g. automatic indentation, just do
+Then, to enable e.g. automatic indentation, use the following command:
    gsettings set org.xfce.mousepad.preferences.view auto-indent true
@@ Line 67: / Line 67: @@
 See ''man gsettings'' and ''gsettings help'' for more details.
-For technical reasons, to access plugin preferences, one has to specify each plugin name separately, e.g.
+For technical reasons, to access the plugin preferences, one has to specify each plugin name separately, e.g.
    gsettings list-recursively org.xfce.mousepad.plugins.gspell
@@ Line 76: / Line 76: @@
 See ''man dconf'' and ''dconf help'' for more details.
 ==== Printing ====
 The settings for printing are treated separately, in the file ''~/.config/Mousepad/mousepadrc''. Carry out a printing operation to the end (you can print in a file), and Mousepad will fill in the configuration file with the values set in the print dialog. Be sure to leave the value of ''PageSetupSaved'' at ''true'' so that all settings are reloaded the next time you print.
+NB: Before Mousepad 0.5.6, you must first create the configuration file if it does not exist:
+  >> ~/.config/Mousepad/mousepadrc
 [[|Back to Top]]
@@ Line 85: / Line 90: @@
 ===== Keybindings =====
-After its first use, Mousepad will generate the file ''~/.config/Mousepad/accels.scm'', containing the list of configurable keybindings. To customize a keybinding, uncomment the corresponding line by removing the semicolon at the beginning, then change the shortcut at the end of the line, without touching the rest.
+After its first use, Mousepad will generate the file ''~/.config/Mousepad/accels.scm'', containing the list of configurable keybindings. This file is overwritten by Mousepad at the end of each session, so to customize a keybinding you have to:
+  * quit Mousepad;
+  * open this file with a different text editor;
+  * uncomment the line corresponding to the shortcut you want to customize by removing the semicolon at the beginning;
+  * change the shortcut at the end of the line, without touching the rest.
+As of version 0.5.9, Mousepad has a shortcuts editor that can be accessed from the "Edit" menu or the preferences dialog, "Plugins" tab. However, it requires Libxfce4ui 4.17.5 to work, which is a development version. It is therefore likely that until Xfce 4.18 is released, this plugin will not be available in the versions of Mousepad packaged by your distribution.
+[[|Back to Top]]
+----
+===== Theming =====
+As of version 0.5.9, Mousepad has a CSS style class "mousepad" to ease theming, which is used for example in this way:
+    .mousepad { color: red; }
+It is also possible to mitigate some bugs by this way, like scrollbar grabbing when Mousepad is maximized (see https://gitlab.xfce.org/apps/mousepad/-/issues/34):
+    .mousepad.maximized > box > notebook > stack,
+    .mousepad.maximized > box > notebook > stack > scrolledwindow {
+      border-left: 0;
+      border-right: 0;
+    }
 [[|Back to Top]]
@@ Line 101: / Line 129: @@
   * [[https://wiki.gnome.org/Projects/gspell|gspell]] >= 1.6.0
+  * [[https://gitlab.xfce.org/xfce/libxfce4ui|libxfce4ui]] >= 4.17.5
 [[|Back to Top]]
@@ Line 116: / Line 145: @@
    sed -Ei.bak 's/([=;])(mousepad.desktop)/\1org.xfce.\2/' ~/.config/mimeapps.list
-The original file of mime types will be kept as ''~/.config/mimeapps.list.bak'' after running this command.
+The original mime type file will be kept as ''~/.config/mimeapps.list.bak'' after running this command.
+----
 ===== Latest Release =====
-{{rss>https://archive.xfce.org/feeds/project/mousepad 1 date description 2h}}
+{{rss>https://archive.xfce.org/feeds/project/mousepad 1 date 2h}}
+[[https://gitlab.xfce.org/apps/mousepad/-/blob/master/NEWS|Read the CHANGELOG]]
-  * **[[https://archive.xfce.org/src/apps/mousepad/|Previous Releases]]**
+  * **[[https://archive.xfce.org/src/apps/mousepad/|Download current release]]** (older versions of this component are also available here)
 [[|Back to Top]]
@@ Line 132: / Line 166: @@
 ----
 ===== Reporting Bugs =====
-  * **[[:apps:mousepad:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs
+  * **[[:apps:mousepad:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports
 [[|Back To Top]]
 ----
-[[:start|Back to main Xfce documentation page]]
+[[:start|Return to Xfce Main Documentation Page]]

Xfce Wiki

Sub domains

Differences

Xfce Wiki

Sub domains

Differences

Tools