Projects: Difference between revisions

From Bluefish Wiki
Jump to navigation Jump to search
mNo edit summary
(removed links to images, as they are all not available. There are only empty image frames which aren't helpful. Also removed the deleted content)
 
(8 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{Man2top
The projects are a sort of ''saved state'' of Bluefish. Thus, they are a very convenient way to work with files scattered all over your disks or to pick up only the files you are interested in within a huge tree. Projects features are accessible through the <tt>Project</tt> menu.  
|lang=en
|rev=2.0.0
|st=d
|Title=3.&nbsp;Projects
|prev=Man 2 ch06s02
|Subtitle=Chapter&nbsp;VI.&nbsp;Navigation and Managing documents
|next=Man 2 ch06s04
}}


[[File:Man2_project_menu.png|left|frame|The Bluefish Project Menu]]
The projects are a sort of ''saved state'' of Bluefish. Thus, they are a very convenient way to work with files scattered all over your disks or to pick up only the files you are interested in within a huge tree. Projects features are accessible through the Project menu.
<br style="clear:both"/>
<br style="clear:both"/>


'''Procedure&nbsp;VI.1.&nbsp;Creating a New Project'''
== Creating a New Project ==


# Click on the <tt>Project → New Project</tt><br/> If some documents are already opened, check the appropriated box in the Create project dialog. <br/> [[File:Man2_project_create_dialog.png|none|frame|The Create Project Dialog]]
# Click on the <tt>Project → New Project</tt><br/> 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 <br/> [[File:Man2_project_new_dialog.png|none|frame|Creating a New Project]]<br/> With a Basedir the file browser in the side panel shows only the files within its hierarchy. With gnome-vfs support, the Basedir can be remote, as smb://user:pass@server/someshare/ or sftp://someserver/somedir.<br/> The Preview URL allows Bluefish to launch the browser to the appropriate URL, for example http://localhost/ Bluefish. This can be very convenient for testing server side scripting languages like PHP, JSP, etc.<br/> If the Template field is used, 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'''). Otherwise an empty document will be created.
# Fill in the fields in the Create New Project dialog <br/> '''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 <tt>File → New</tt> ('''CtrlN'''). You can ever choose the template to use (or none): <tt>File → New From Template</tt>.<br/>If <tt>'''None'''</tt> 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. <br/> [[File:Man2_project_save_dialog.png|none|frame|Entering Bluefish Project Filename]]
# 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 (which is also advisable). <br/>  
{{top}}


To open a project, you have the choice between Project → Open Project... or Project → Open recent. When you choose the former, a Selecting a Bluefish Project dialog is presented to you.
== Working in a project ==


[[File:Man2_project_open_dialog.png|none|frame|Selecting a Bluefish Project]]
To '''open a project''', you have the choice between <tt>Project → Open Project</tt>... or <tt>Project → Open recent</tt>. 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<nowiki>; to save it under a new name/location, use </nowiki>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.  
To '''save the project''' under its current name/location, use <tt>Project → Save</tt> or <tt>Project → Save & close</tt>; to save it under a new name/location, use <tt>Project → Save as</tt>.... 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 <tt>File → Open recent</tt> menu item.


[[File:Man2_project_open.png|none|frame|Opening a Bluefish Project]]
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 tools 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 <tt>key: value</tt>.


Notice that the side panel only shows the tree related to the project.
Settings for an open project can be managed using <tt>Project → Edit Project Options</tt>


Also, the recently used files in that project are shown in the File → Open recent menu item.
== See also: [[Templates]] ==


A project also saves some basic Bluefish settings, giving the project its own customized Bluefish setup. Currently, the word wrap preference 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 <tt>key: value</tt>. Here is an example:
{{top}}
 
name: BluefishDoc
basedir: ~/bluefishcvs/bluefish-gtk2/doc/
webdir: http://micmacfr.homeunix.org/bluefish/doc
template:
view_main_toolbar: 1
view_left_panel: 1
view_custom_menu: 1
view_html_toolbar: 1
word_wrap: 1
 
 
 
{{Man2bottom
|prev=Man 2 ch06s02
|up=Man 2 ch06
|next=Man 2 ch06s04
|prevname= 2.&nbsp;Navigating through many documents
|nextname=4.&nbsp;Bookmarks
}}

Latest revision as of 18:45, 14 December 2022

The projects are a sort of saved state of Bluefish. Thus, they are a very convenient way to work with files scattered all over your disks or to pick up only the files you are interested in within a huge tree. Projects features are accessible through the Project menu.


Creating a New Project[edit]

  1. Click on the Project → New Project
    If some documents are already opened, check the appropriated box in the Create project dialog.
  2. Fill in the fields in the Create New Project dialog
    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.
  3. 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 (which is also advisable).

Top.png

Working in a project[edit]

To open a project, you have the choice between Project → Open Project... or Project → Open recent. 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 tools 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 be managed using Project → Edit Project Options

See also: Templates[edit]

Top.png

Retrieved from "https://bfwiki.tellefsen.net//index.php?title=Projects&oldid=2773"