About
Geanynumberedbookmarks is a plugin to provide users with 10 numbered bookmarks (in addition to the usual bookmarks). It started out as part of the ConText feature parity plugin, which was split into individual plugins to better suit Geany's ethos of being as light as possible while allowing users to select which features they want to add to the core editor. The idea was taken from a Text Editor for Windows called ConText.
Normally if you had more than one bookmark, you would have to cycle through them until you reached the one you wanted. With this plugin you can go straight to the bookmark that you want with a single key combination.
Usage
To set a numbered bookmark press Ctrl+Shift+(a number from 0 to 9). You will see a marker appear next to the line number. If you press Ctrl+Shift+(a number) on a line that already has that bookmark number then it removes the bookmark, otherwise it will move the bookmark there if it was set on a different line, or create it if it had not already been set. To move to a previously set bookmark press Ctrl+(bookmark number). You can also specify when in the bookmarked line the cursor is moved to when you move to a previously set bookmark. You can choose to move to the start of the line, the end of the line, how far into the line the cursor was when the bookmark was set, or try and keep the cursor in the column that you are in at the moment (line length allowing). Only the most recently set bookmark on a line will be shown, but you can have more than one bookmark per line. This plugin does not interfere with regular bookmarks. When a file is saved, Geany will remember the numbered bookmarks and make sure that they are set the next time you open the file.
This plugin also will remember the state of folds in a file (open or not) if you want it to and re-apply this the next time you open the file.
This plugin will also remember standard non-numbered bookmarks and restore these when a file is next reloaded if you want it to.
Configuration
You can alter the default behaviour of this plugin by selecting Plugin Manager under the Tools menu, selecting this plugin, and clicking Preferences. You can change:
- Remember fold state
- if this is set then this plugin will remember the state of any folds along with the numbered bookmarks and set them when the file is next loaded.
- Center view when goto bookmark
- If this is set it will try to make sure that the numbered bookmark that you are going to is in the center of the screen, otherwise it will simply be on the screen somewhere.
- Move to...
- This allows you to choose where in the bookmarked line the cursor is placed when you move to a bookmarked line.
- Save file settings...
- This allows you the option of saving the settings of a file (the numbered bookmark positions, folding states, and standard bookmark positions) in either the central settings file for geany plugins, or to a file with the same name but a suffix (by default this is ".gnbs.conf") in the same directory as the file. This allows the user the ability to synchronise the settings for a file along with the file itself across more than one computer. The default suffix can be changed by editing the numbered bookmarks plugin settings file. This will vary from OS to OS but will always be "settings.conf" in a directory called "Geany_Numbered_Bookmarks". On my OS it's ".config/geany/plugins/Geany_Numbered_Bookmarks/settings.conf" in my home directory, but otherwise you'll have to search for it. In the Settings section of the file near the top will be a line "File_Details_Suffix=.gnbs.conf". Simply change this to whatever you would prefer (if geany is running while you edit this file it may over-write your new suffix so best close geany before editing this file).
- Remember normal Bookmarks
- If this is set then the plugin will remember standard non-numbered bookmarks, and restore them when the file is next loaded.
License
This plugin is distributed under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. You should have received a copy of the GNU General Public License along with this plugin. If not, see <https://www.gnu.org/licenses/>.
