Bookmarks: Difference between revisions

From Bluefish Wiki
Jump to navigation Jump to search
Fal7i (talk | contribs)
mNo edit summary
Fal7i (talk | contribs)
mNo edit summary
Line 10: Line 10:


In Bluefish you can add bookmarks to a line in the text, and you can later use the bookmark to quickly jump to this location, or even to open the document referred to by the bookmark at that line.
In Bluefish you can add bookmarks to a line in the text, and you can later use the bookmark to quickly jump to this location, or even to open the document referred to by the bookmark at that line.
== Creating Bookmarks ==


Bookmarks can be added to the current cursor location by using the <tt>Document → Add Bookmark</tt> ('''Ctrl+K''') menu item; or by right-clicking in the text, and selecting Add bookmark. You can delete a bookmark using the Delete bookmark item in the document contextual menu.
Bookmarks can be added to the current cursor location by using the <tt>Document → Add Bookmark</tt> ('''Ctrl+K''') menu item; or by right-clicking in the text, and selecting Add bookmark. You can delete a bookmark using the Delete bookmark item in the document contextual menu.
Line 21: Line 23:
|}
|}


If the line number margin is visible <tt>Document → Line numbers</tt> <small>(see also [[Preferences#Non-project initial documents settings |Preferences]] and [[Projects]])</small> you can set/unset a bookmark by doubleclicking on a line number.
{{tip|text=If the line number margin is visible <tt>Document → Line numbers</tt> <small>(see also [[Preferences#Non-project initial documents settings |Preferences]] and [[Projects]])</small> you can set/unset a bookmark by doubleclicking on a line number.}}


You can't set a bookmark in an unsaved file.
{{warning|text=You can't set a bookmark in an unsaved file.}}


Each bookmark in a given document is marked by a black square in the line number margin.  
Each bookmark in a given document is marked by a black square in the line number margin.  
Line 44: Line 46:
The Edit option let you set a name, a description and and toggle permanent/temporary option.
The Edit option let you set a name, a description and and toggle permanent/temporary option.


 
You can navigate trough bookmarks using the arrows in the bookmark browser or in Menu: <tt>Go → arrows Bookmark</tt>




Line 52: Line 54:
Here is an example which bookmarks all functions in Shell script file with POSIX or PERL regular expressions:  
Here is an example which bookmarks all functions in Shell script file with POSIX or PERL regular expressions:  


 
[[File:Man2_bookmark_find_perl.png|none|frame|Bookmarking shell Functions via the Find Menu]]
[[File:Man2_bookmark_find_perl.png|none|frame|Bookmarking PHP Functions via the Find Menu]]




Line 59: Line 60:




;todo: Go menu
;see also:  
: [https://bugzilla.gnome.org/show_bug.cgi?id=611743 bug 611743]
: [https://bugzilla.gnome.org/show_bug.cgi?id=611743 bug 611743]
: [https://bugzilla.gnome.org/show_bug.cgi?id=611743 bug 612556]
: [https://bugzilla.gnome.org/show_bug.cgi?id=611743 bug 612556]

Revision as of 13:48, 11 March 2010


In Bluefish you can add bookmarks to a line in the text, and you can later use the bookmark to quickly jump to this location, or even to open the document referred to by the bookmark at that line.

Creating Bookmarks

Bookmarks can be added to the current cursor location by using the Document → Add Bookmark (Ctrl+K) menu item; or by right-clicking in the text, and selecting Add bookmark. You can delete a bookmark using the Delete bookmark item in the document contextual menu.

Adding or deleting a bookmark: right click on the Editing Area.

add bookmark
delete bookmark
if the line is still bookmarked, you can delete the bookmark, else you can create one.
If the line number margin is visible Document → Line numbers (see also Preferences and Projects) you can set/unset a bookmark by doubleclicking on a line number.
You can't set a bookmark in an unsaved file.

Each bookmark in a given document is marked by a black square in the line number margin.


The bookmark browser

The bookmark browser provides access to previously marked positions in a file.

Bookmarks can be found in the second tab of the side panel, sorted by document and line number.

If you right click a bookmark in the bookmark tab of the side panel, you get a pop up menu with several options.

Bluefish Bookmark Browser
bookmark browser menu
Show file sub-menu

Bookmarks can be temporary or permanent. Permanent bookmarks are stored, and temporary bookmarks are gone after Bluefish is closed. The default is set in the preferences under Editor.

The Edit option let you set a name, a description and and toggle permanent/temporary option.

You can navigate trough bookmarks using the arrows in the bookmark browser or in Menu: Go → arrows Bookmark


Generating several bookmarks at once

To add many bookmarks at once, use the Edit → Find (Ctrl+F) dialog, or the Search icon in Main Tool Bar. Check the Bookmark matches option, and all search results will be added to your bookmarks.

Here is an example which bookmarks all functions in Shell script file with POSIX or PERL regular expressions:

Bookmarking shell Functions via the Find Menu


Check Section 5.3, “Find and Replace Using Regular Expressions” for more information on finding and replacing with regular expression in Bluefish.


see also
bug 611743
bug 612556