Difference between revisions of "Bookmarks"

From Bluefish Wiki
Jump to: navigation, search
(moved Bookmarks to Old stuff, Bookmarks: Bookmarks needed in Man 2)
 
m
Line 1: Line 1:
#REDIRECT [[Old stuff, Bookmarks]]
+
{{Man2top
 +
|lang=en
 +
|rev=2.0.0
 +
|st=d
 +
|Title=4. Bookmarks
 +
|prev=Man 2 ch06s03
 +
|Subtitle=Chapter VI. Navigation and Managing documents
 +
|next=Man 2 ch06s05
 +
}}
 +
 
 +
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.
 +
 
 +
Bookmarks can be added to the current cursor location by using the <tt>Edit → Add Bookmark</tt> ('''Ctrl+D''') 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.
 +
 
 +
Each bookmark in a given document is marked by a blue background in the line number margin.
 +
 
 +
[[File:Man2_bookmark_marked.png|none|frame|How Bookmarks are marked]]
 +
 
 +
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.
 +
 
 +
Bookmarks can be found in the third tab of the side panel, sorted by document and line number.
 +
 
 +
[[File:Man2_bookmark_tab.png|none|frame|Bookmarks in the Side Panel]]
 +
 
 +
If you right click a bookmark in the bookmark tab of the side panel, you get a pop up menu with several options.
 +
 
 +
[[File:Man2_bookmark_cm.png|none|frame|Contextual Menu on Bookmark in the Side Panel]]
 +
 
 +
The Goto bookmark item allows you to go to the bookmark location in the document, opening it if needed.
 +
 
 +
The Edit item allows you to change a bookmark from temporary to permanent or the other way around, to name it, and to give it a short description.
 +
 
 +
[[File:Man2_bookmark_edit.png|none|frame|Editing a Bookmark]]
 +
 
 +
Note that after naming a bookmark, the default name - first characters of the bookmarked line - is displayed after the new name.
 +
 
 +
[[File:Man2_bookmark_name.png|none|frame|A named Bookmark]]
 +
 
 +
Via this contextual menu, you may also delete a bookmark, delete all bookmarks in the active document, or delete all bookmarks stored in the bookmark tab of the side panel. The latter ones are also available when you right click the name of a document in this tab.
 +
 
 +
[[File:Man2_bookmark_document_cm.png|none|frame|The Contextual Menu on a Document in the Bookmark Tab]]
 +
 
 +
== 4.1. Generating several bookmarks at once ==
 +
To add many bookmarks at once, use the <tt>Edit → Find</tt> ('''Ctrl+F''') dialog. Check the Bookmark result option, and all search results will be added to your bookmarks.
 +
 
 +
For example, the XML files for this manual have sections, each identified by a header like <tt><nowiki><sect1 id="nameofthesection"></nowiki></tt>. A way to automatically get a bookmark to every section is to search for the following posix regular expression pattern: <tt><nowiki><sect[0-9]+ id="[^"]+"></nowiki></tt> and bookmark all results.
 +
 
 +
[[File:Man2_bookmark_find_posix.png|none|frame|Bookmarking with Posix Regular Expression]]
 +
 
 +
Here is the result:
 +
 
 +
[[File:Man2_bookmark_find_posix_result.png|none|frame|Bookmarks with Posix Regular Expression]]
 +
 
 +
Here are two examples which bookmarks all functions in Objective-C and PHP files with POSIX or PERL regular expressions:
 +
 
 +
[[File:Man2_bookmark_find.png|none|frame|Bookmarking Objective C Functions via the Find Menu]]
 +
 
 +
[[File:Man2_bookmark_find_perl.png|none|frame|Bookmarking PHP Functions via the Find Menu]]
 +
 
 +
Check [[Man 2 ch06s05#Section 5.3, “Find and Replace Using Regular Expressions”|Section 5.3, “Find and Replace Using Regular Expressions”]] for more information on finding and replacing with regular expression in Bluefish.
 +
 
 +
 
 +
 
 +
{{Man2bottom
 +
|prev=Man 2 ch06s03
 +
|up=Man 2 ch06
 +
|next=Man 2 ch06s05
 +
|prevname= 3.&nbsp;Projects
 +
|nextname=5.&nbsp;Find and Replace
 +
}}

Revision as of 12:00, 11 March 2010

Man2 warning.png This page is a copy from Manual 1. It needs to be modified to match Bluefish version 2.0.0!
Once you have verified this page (and corrected if necessary),

please modify the status to u (updated), i.e. st=u (see Guidelines for Writing this Manual)


Man2 icon 48.png
Chapter VI. Navigation and Managing documents
Prev 
4. Bookmarks
 Next

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.

Bookmarks can be added to the current cursor location by using the Edit → Add Bookmark (Ctrl+D) 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.

Each bookmark in a given document is marked by a blue background in the line number margin.

File:Man2 bookmark marked.png
How Bookmarks are marked

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.

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

File:Man2 bookmark tab.png
Bookmarks in the Side Panel

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

File:Man2 bookmark cm.png
Contextual Menu on Bookmark in the Side Panel

The Goto bookmark item allows you to go to the bookmark location in the document, opening it if needed.

The Edit item allows you to change a bookmark from temporary to permanent or the other way around, to name it, and to give it a short description.

File:Man2 bookmark edit.png
Editing a Bookmark

Note that after naming a bookmark, the default name - first characters of the bookmarked line - is displayed after the new name.

Via this contextual menu, you may also delete a bookmark, delete all bookmarks in the active document, or delete all bookmarks stored in the bookmark tab of the side panel. The latter ones are also available when you right click the name of a document in this tab.

File:Man2 bookmark document cm.png
The Contextual Menu on a Document in the Bookmark Tab

4.1. Generating several bookmarks at once

To add many bookmarks at once, use the Edit → Find (Ctrl+F) dialog. Check the Bookmark result option, and all search results will be added to your bookmarks.

For example, the XML files for this manual have sections, each identified by a header like <sect1 id="nameofthesection">. A way to automatically get a bookmark to every section is to search for the following posix regular expression pattern: <sect[0-9]+ id="[^"]+"> and bookmark all results.

File:Man2 bookmark find posix.png
Bookmarking with Posix Regular Expression

Here is the result:

File:Man2 bookmark find posix result.png
Bookmarks with Posix Regular Expression

Here are two examples which bookmarks all functions in Objective-C and PHP files with POSIX or PERL regular expressions:

File:Man2 bookmark find.png
Bookmarking Objective C Functions via the Find Menu
Bookmarking PHP 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.


Prev 
Up
 Next
3. Projects
Home | ToC
 5. Find and Replace