Bluefish: The Definitive Guide
Bluefish: The Definitive Guide
Table of Contents
Preface
1. About this Manual
2. What is Bluefish?
2.1. History of Bluefish
2.2. Main Features of Bluefish
2.3. How Stable is Bluefish?
2.4. Contact Us
I. Getting Bluefish
1. Choosing a Version
1.1. How and When Updates are Released
1.2. Operating Systems Supported by Bluefish
2. Latest Stable Version
3. Latest Developmental Version
II. Installing Bluefish
1. Requirements
2. Quick Standard Installation
3. System Specific Installation Issues
4. Installing a Bluefish Source Distribution
4.1. Quick Installation Overview
4.2. Installing from Development Source Tree
4.3. Problems Compiling?
5. Configure Options
5.1. Standard configuration flags
5.2. Flags personal to bluefish
6. Installing a Binary Distribution
7. Post-installation Setup
III. Using Bluefish
1. Starting Bluefish
1.1. Command line options
2. The user interface
3. Working with files and folders
3.1. Creating files
3.2. Managing directories
3.3. Opening files
3.4. Saving files
3.5. Renaming files
3.6. Deleting files
3.7. Closing files
3.8. Inserting files
3.9. Editing
3.9.1. Undo and Redo
3.9.2. Cut, Copy, and Paste
3.9.3. Input methods
3.10. Basic Find and Replace
3.10.1. Searching for a word within a whole document
3.10.2. Setting limits to the search scope
3.10.3. Case sensitive search
3.10.4. Overlapping searches
3.10.5. Retrieving previous search strings
3.10.6. More on find
3.10.7. Replacing features
3.10.8. Retrieving previous replace strings
3.10.9. Changing letter case when replacing
3.10.10. Choosing strings to replace
3.10.11. More on replace
3.11. File types
3.11.1. Syntax highlighting
3.12. More on files
3.12.1. Remote files
3.12.2. Character encoding
3.12.3. Open advanced
4. Navigation and Managing documents
4.1. Navigating through a document
4.2. Navigating through many documents
4.3. Projects
4.4. Bookmarks
4.4.1. Generating several bookmarks at once
4.5. Find and Replace
4.5.1. Find Again
4.5.2. Find from Selection
4.5.3. Find and Replace Using Regular Expressions
5. More than a Text Editor
5.1. Indenting
5.2. Auto tag closing
5.3. Spell checker
5.4. Function reference
5.5. HTML
5.5.1. Special find and replace features
5.5.2. Thumbnail generation
5.6. Customizing the Quick bar
5.7. Custom menu
5.7.1. Adding a custom menu dialog
5.7.2. Adding a custom replace dialog
5.8. External programs, filters
5.8.1. Customizing browsers
5.8.2. Customizing Commands menu
5.8.3. Customizing Ouputbox menu
6. Customising Bluefish
6.1. Modifying shortcut keys
6.2. Showing hidden files and folders
6.3. Showing backup files
6.4. Editor appearance
6.5. Customizing the bookmarks path
6.6. Customizing the html tags style
6.7. Changing the author meta tag on the fly
6.8. Customizing files handling and browsing
6.8.1. Setting the encoding meta tag on save
6.8.2. Setting the default base directory
6.8.3. Merging file browser views
6.8.4. Backup files
6.8.5. Using multiple instances of a file
6.9. Customizing the user interface
6.10. Modifying file types
6.11. Modifying the files filters
6.12. Modifying the highlighting patterns
IV. Debugging Bluefish
1. Using the Debugger
V. Reference
VI. Development guidelines
1. Indenting and formating style
2. Naming
3. Declaring procedures
4. Header files
5. New files
6. File reference
7. Patches
8. Translations
8.1. Introduction
8.2. PO files basics
8.3. Shortcut keys
8.4. How to contribute
9. Some tips
10. Making releases
11. Useful stuff
A. Credits
1. Bluefish developers
2. Bluefish package maintainers
3. Bluefish translators
4. Supporters to bluefish
B. Bluefish change history
1. Changes in release GTK2-port
2. Changes in release GTK1-version
C. Guidelines for Writing this Manual
1. Introduction to DocBook
2. Manual building requirements
3. Make HTML/PDF/PostScript Versions of the Bluefish manual
4. Conventions for Writing this Manual
4.1. The
id
Attribute
4.2. Using Screen shots
4.3. Referencing Bluefish interface elements
4.4. Using procedures
4.5. Using notes, tips, warnings
4.6. Using links
4.7. Others tags
4.8. Recommendation
4.9. Contact us
D. GNU GENERAL PUBLIC LICENSE
1. Preamble
2. TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
3. How to Apply These Terms to Your New Programs
List of Figures
III.1.
Bluefish Editor Array
III.2.
Bluefish Main Menu
III.3.
Bluefish Main Tool Bar
III.4.
Bluefish HTML Tool Bar
III.5.
Bluefish Custom Tool Bar
III.6.
Bluefish File Browser
III.7.
Bluefish Function Reference Browser
III.8.
Bluefish Bookmark Browser
III.9.
Bluefish Status Bar
III.10.
Bluefish View Menu
III.11.
Bluefish About Window
III.12.
Bluefish File Menu
III.13.
The file browser contextual menu
III.14.
The File name dialog
III.15.
Bluefish Open File Dialog
III.16.
Filtering Files with the Bluefish File Browser
III.17.
Info on open file with the Bluefish File Browser
III.18.
Tool Tip for Modified File
III.19.
Saving a File under a new Name
III.20.
Moving a file to another location
III.21.
Closing a file with the document tab icon
III.22.
Closing a modified file
III.23.
Closing all files
III.24.
The Input Methods Contextual menu
III.25.
Writing in Japanese with Bluefish
III.26.
Finding a word in a document, from start to end
III.27.
Unsuccessful search window
III.28.
Highlighted search result in the document window
III.29.
Setting the cursor location
III.30.
Choosing a limited search method
III.31.
Limited search result
III.32.
Making the search case sensitive
III.33.
Case sensitive search result
III.34.
Finding overlapping strings
III.35.
An overlapping string retrieved with the Find dialog
III.36.
Retrieving recent searches
III.37.
The Replace dialog
III.38.
Changing letter case when replacing
III.39.
The Replace confirm dialog
III.40.
Opening an URL from the web
III.41.
A style sheet opened via the Open URL menu
III.42.
Using the Open Advanced dialog
III.43.
Bluefish Go Menu
III.44.
Using the Goto Line dialog
III.45.
The Bluefish Project Menu
III.46.
The Create Project dialog
III.47.
Creating a New Project
III.48.
Entering Bluefish Project Filename
III.49.
Selecting a Bluefish Project
III.50.
Opening a Bluefish Project
III.51.
How bookmarks are marked
III.52.
Bookmarks in the side panel
III.53.
Contextual menu on bookmark in the side panel
III.54.
Editing a bookmark
III.55.
A named bookmark
III.56.
The contextual menu on a document in the bookmark tab
III.57.
Bookmarking with Posix regular expression
III.58.
Bookmarks with Posix regular expression
III.59.
Bookmarking Objective C functions via the Find menu
III.60.
Bookmarking PHP functions via the Find menu
III.61.
Nth occurrence with Find Again
III.62.
Nth+1 occurrence with Find Again
III.63.
Selecting a string for subsequent search
III.64.
Finding a string from selection
III.65.
The table before transformation
III.66.
The table after transformation
III.67.
Indenting part of a text
III.68.
Bluefish Spell Checker
III.69.
The reference browser contextual menu
III.70.
The reference browser options menu
III.71.
A function reference dialog window
III.72.
Info available for a function
III.73.
The HTML Tags menu
III.74.
The HTML Dialogs menu
III.75.
An HTML button with a three-dotted tool tip
III.76.
A simple HTML tool tip button
III.77.
The Replace special menu
III.78.
The Insert thumbnail icon
III.79.
The Multi thumbnail icon
III.80.
The Insert thumbnail dialog
III.81.
The Multi thumbnail dialog
III.82.
The Table icon in the html tool bar
III.83.
Adding an element to the Quick bar
III.84.
The added element in the Quick bar
III.85.
Adding a pop up menu element to the Quick bar
III.86.
Removing an element from the Quick bar
III.87.
Moving an element within the Quick bar
III.88.
Accessing the custom menu
III.89.
The Custom Menu Editor
III.90.
Extract of the default custom menu path
III.91.
The Custom Replace Dialog
III.92.
A new custom entry in the Menu path list
III.93.
A new menu in the custom menu tool bar
III.94.
A block of selected text before activating the menu
III.95.
A block of text after activating the menu
III.96.
The new div with class dialog
III.97.
The block of text after entering the value
III.98.
The HTML page before the transformation
III.99.
The HTML page after the transformation
III.100.
The custom menu replace dialog filled in
III.101.
The Add Title dialog
III.102.
Bluefish External Menu
III.103.
The Browsers panel in Preferences
III.104.
Selecting the browser's line to be moved
III.105.
Dragging the browser's line
III.106.
Dragging the browser's line to the bottom
III.107.
Utilities and Filters panel in Preferences
III.108.
The tidy output box in Bluefish 1.0
III.109.
The Output parsers tab in Preferences panel
III.110.
Adding a shortcut to a menu item
III.111.
Turning files and folders visibility on
III.112.
Bluefish with a customized Gtk theme
III.113.
The Editor tab in Preferences
III.114.
The Bookmarks path pop up menu in Preferences
III.115.
The HTML tab in Preferences
III.116.
The author meta tag filled in on save
III.117.
Update of the author meta tag on save
III.118.
The Files preference panel
III.119.
Choosing an action on backup failure
III.120.
The User interface preference panel
III.121.
The HTML pattern
III.122.
The <html> Tags pattern
III.123.
The HTML Attributes pattern
III.124.
The HTML Attribute Contents pattern
III.125.
The PHP Block pattern
III.126.
The Comment (C++/single line) pattern
III.127.
Syntax highlighting example
List of Examples
III.1.
Retrieving all sections in an xml book
III.2.
Retrieving all functions in an Objective C file
III.3.
Retrieving all functions in a PHP file
III.4.
Transforming a table into a definition list
III.5.
Adding a file type
III.6.
Adding a file filter
List of Procedures
I.1.
Getting the source
II.1.
Getting the new defaults after upgrading - First method
II.2.
Getting the new defaults after upgrading - Second method
III.1.
Writing in Japanese with Bluefish on a non-Japanese system
III.2.
Searching from selection
III.3.
Creating a New Project
III.4.
Generating a photos album with multi thumbnails
III.5.
Adding a custom menu based on custom dialog
III.6.
Adding a custom menu based on replace dialog
III.7.
Changing the order of browsers items
III.8.
Customizing an existent browser
III.9.
Adding a new browser
III.10.
Adding a Commands menu item
III.11.
Adding an Outputbox menu item
IV.1.
Running bluefish under gdb
C.1.
Getting the Bluefish manual source files
C.2.
Installing DocBook and DocBook XSL
C.3.
Installing the xslt processors and parsers