The projects are a sort of saved state of Bluefish. Thus, they are a very convenient way to work with only the files you are interested in, or to work with specific settings. Projects features are accessible through the Project menu.
Creating a New Project
- Click on the Project → New Project
If some documents are already opened, check the appropriated box in the Create project dialog.
- Fill in the fields in the Create New Project dialog
Project specific settings
The initial document settings in the project dialog are specific to this project. The preferences panel also has a initial document settings, but these are overridden by the project settings. This is useful if you have for example a project in which you program in C (example settings mime type text/c-src, template with GPL headers, with line numbers and block folding) and another where you do HTML (example settings mime type text/html, no line numbers and block folding, HTML5 template).
There are many more settings that are stored per project, but these are accessible trough their normal means and not in the project edit dialog. These settings are amongst others:
- the recent files history
- the search history
- show main toolbar
- show html toolbar
- show sidebar
- sidebar filebrowser view mode (flat, tree or dual)
- sidebar filebrowser filter
- sidebar filebrowser basedir
- documentroot setting (for preview on webserver)
- etc. etc.
If a Template is selected, Bluefish will use the template file's contents for new files, which can be requested either via the New button on the main tool bar or File → New (CtrlN). You can ever choose the template to use (or none): File → New From Template.
If None is selected an empty document will be created.
- Once the project is created, you need to tell Bluefish where you want to save it. An Enter Bluefish project filename dialog will be displayed. Notice that you can save the project in a location different from the files to which the project points.
Working in a project
To open a project, you have the choice between Project → Open Project... or Project → Open recent, or simply click a project file in the side panel file browser. When you choose the former, a Selecting a Bluefish Project dialog is presented to you.
To save the project under its current name/location, use Project → Save or Project → Save & close; to save it under a new name/location, use Project → Save as.... If any file in the project has changed, a dialog will allow you to save the file, discard the changes, or cancel. All files open when the project is saved are automatically opened the next time you open the project.
Also, the recently used files in that project are shown in the File → Open recent menu item.
A project also saves a large set of Bluefish settings, giving the project its own customized Bluefish setup. Currently, a lot of preferences and the state of various tool and menu bars are saved in a project file. The project file itself is simply a text file in the standard Bluefish format (same format as the config file). This format is key: value.
Settings for an open project can bet managed using Project → Edit Project Options