1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
6
<meta name="generator" content="HTML Tidy, see www.w3.org">
8
<title>Bluefish manual chapter 2: Using Bluefish features</title>
9
<meta name="AUTHOR" content="Jim Batis">
10
<meta name="COPYRIGHT" content="Copyright (C) 2000, Dimitris Batis">
11
<meta name="generator" value="Bluefish 0.6">
12
<link rel="stylesheet" href="../manual.css" type="text/css">
17
<a href="chapter1.html">prev</a> | <a href="index.html">contents</a> | <a
18
href="chapter3.html">next</a>
21
<h1>Chapter 2: Using Bluefish features</h1>
23
<p>In the first chapter, we covered the basic concepts of using Bluefish.
24
Though many of the possibilities and usages this program has, not all of
25
them were mentioned, whereas those mentioned weren't thoroughly
26
explained. Most importantly, you haven't learnt how to configure the
27
program yet (apart from a few basic stuff that GTK+ itself allows you).</p>
29
<p>The purpose of this chapter is to cover all features of Bluefish in
30
detail, so that you can take full advantage of them. We will explain how you
31
can configure Bluefish (like window appearance, syntax highlighting, fonts,
32
etc.), how to use external programs and view your documents, the thumbnails,
33
and many more features.</p>
35
<a name=preferences><h2>The Preferences window</h2></a>
36
Most of the program's settings can be adjusted through the Preferences
37
window. To call this window:
40
<li>Select <code>Options->Preferences</code>.</li>
43
<table border="0" cellspacing="2">
45
<td align="LEFT" valign="TOP"><img src="../images/button_config.gif"
46
alt="Configuration"> </td>
48
<td align="LEFT" valign="CENTER">Press the 'Configure' button of
49
the main toolbar.</td>
55
<p>A window should pop up, with five tabs at the bottom and two buttons.
56
<code>Save & Close</code> saves any changes you have made and saves them
57
to disk. These settings will be re-loaded in the future sessions. In case
58
you've changed your mind about the changes you made, press
59
<code>Cancel</code> and the previous settings will be restored.</p>
61
<a name=editor_preferences><h3>Editor Preferences</h3></a>
63
<p align="CENTER"><img src="../images/config_editor.png" width="425" height=
64
"524" border="0" alt="Editor tab"></p>
68
<p>In this textbox, you can set the font of the text editing area. Though
69
you can try to write the font manually, it is preferable to click on
70
<code>Font...</code> button. A window pops up in which you can set the font,
71
its style and size. At the bottom, you can preview the font you have
72
selected. The 'Filter' tab will help you select the font you want,
73
by selecting the features it should have. 'Font Information' shows
74
the info for the selected font. To set the font, press <code>Ok</code>. If
75
you press <code>Apply</code>, the font is set, but this dialog doesn't
76
disappear, so that you can re-adjust the font selected. Press
77
<code>Cancel</code> if you've changed your mind about selecting a
80
<div class="note"><b>TIP:</b> Most users prefer to select fixed-width
81
fonts. As you will see, fixed width fonts are better for any code editors,
82
including HTML. It will help you organise your documents better and is
83
highly advised if you're using <PRE> tag, as you can see how the
84
text will actually appear. <i>Adobe courier</i> is often available and is
85
strongly suggested for usage.</div>
89
<p>This adjusts the width that Tab characters will have. This is measured in
90
compare with empty space characters. So, if you've set it to value 4,
91
for example, in a fixed-width font, it will look like there were 4 space
94
<p>The default tab width is 4.</p>
98
<p>You will usually want to use this feature together with 'Line
99
Wrap'. If this is checked, then the word typed will be wrapped to the
100
next line if the text reaches the right border of the text editing area
101
(without a line feed character placed).</p>
105
<p>If this is checked, then when the text typed reaches the right border of
106
the text editing area, it continues to the next line (without a line feed
109
<div class="note"><b>NOTICE:</b> A bug in the Gtk Text widget disables the
110
horizontal scrollbar, so disabling word and line wrap will make editing a
111
bit uncomfortable. Just try it out and you will see :-)</div>
113
<p>If you have this feature checked and not 'Word Wrap', then the
114
words may be broken in two lines, whereas if 'Word Wrap' is checked
115
the letters stay all together.</p>
117
<h4>Autoindent Code</h4>
119
<p>If checked, the cursor is positioned in the same column after pressing
120
Return as it is in the upper line. If disabled, a Return will always jump to
121
the first column of the new line.</p>
123
<h4>Highlight by default</h4>
125
<p>If checked, when an action, like opening a file is done, the text is
126
hightlighted automaticly, thus you don't need to select
127
<code>View->Highlight Syntax</code> yourself. If, however, you uncheck
128
it, then the text won't be highlighted unless you ask for it.</p>
130
<h4>Update syntax highlighting continuous</h4>
132
<p>If checked, the syntax will be automaticly highlighted as you type the
135
<h4>Update full widget instead of the current line</h4>
137
<p>Normally, when text is highlighted in the text editing area, only the
138
line in which the cursor is placed will be highlighted and not the whole
139
text. When pasting multiple lines some lines will not ne highlighted
140
correctly. You could use F5 (default shortcut for <code>View->refresh
141
highlighting</code>) to refresh. If however you want to check and highlight
142
the whole text each time you edit the document, then check this option.
143
Unfortunately updating the whole widget is slow in the GTK text widget due
144
to a scrolling bug.</p>
146
<h4>Automatic link management</h4>
148
<p>If you enable this option Bluefish will update any links when using
149
'move to' or 'save as' functionality. Only links found
150
between double quotes (i.e. "link") are scanned and updated.</p>
152
<h4>Allow multiple instances of the same file</h4>
154
<p>If you enable this option Bluefish will let you open a file several
155
times. This is useful for having 2 different versions in the editor and
156
checking layout-changes.</p>
158
<a name=html_preferences><h3>HTML Preferences</h3></a>
160
<p align="CENTER"><img src="../images/config_html.png" width="425" height=
161
"524" border="0" alt="HTML tab"></p>
163
<h4>Insert closing...</h4>
165
<p>As you know, all HTML tags usually have to be ended with a </tag>
166
comment. For example <i><B>Bold text</B></i>. However some tags
167
can be (and usually are) used without an ending tag. Two of them are
168
<LI> and <P>, which don't really need an ending tag.
169
However, if you want to strictly follow the HTML syntax rules, you might
170
want to insert them.</p>
172
<p>If the boxes are checked, then the ending tags are inserted for
173
<LI> and <P>, else they are omitted.</p>
175
<h4>Insert lowercase HTML tags</h4>
177
<p>By default, when a tag is inserted by Bluefish, it is in uppercase (this
178
is a common designer's technique in order to distinguish tags from
179
normal text). However, in case you want the tags to be in lowercase, check
182
<p>Note that WML needs the tags to be lowercased, so you should check this,
183
should you want to use WML.</p>
185
<h4>Allow the use of CSS</h4>
187
<p>This enables the support for CSS (Cascading Style-Sheets). CSS can be
188
inserted internal or as external documents.</p>
190
<h4>Allow deprecated Tags</h4>
192
<p>This allows the use of deprecated HTML-Tags. Actually the W3 reccomends
193
using CSS to format your documents, not the old Tags (e.g. <font> or
196
<h4>Use XHTML Syntax</h4>
198
<p>This makes Bluefish insert all tags according to the XHTML
199
1.0-Specification.</p>
201
<h4>Use an XML-Starting-Line</h4>
203
<p>Inserts a XML-Line in the Head of the Document (usually a standard
204
SGML-Line is inserted).</p>
206
<h4>Allow the Ruby-Tags included in XHTML 1.0</h4>
208
<p>"Ruby-Tags" are tags introduced in XHTML 1.0 that are used esp.
209
in japanese files to insert information thats helps in pronouncing.</p>
211
<h4>Allow new Tags of HTML 4</h4>
213
<p>When clicked, the Tags of HTML 4 instead of those in HTML 3.2 are used
214
(where applicable).</p>
216
<h4>Allow the Use of Frames</h4>
218
<p>Turns on Frame-support in Bluefish when selected.</p>
220
<h4>Require an DOCTYPE on first line of document</h4>
222
<p>Inserts a DOCTYPE-line in newly created documents.</p>
224
<h4>Set the DTD-URL in the DOCTYPE-line</h4>
226
<p>Inserts the DTD-URL into the DOCTYPE-Line.</p>
228
<h4>Allow the use of Internet Explorer proprietary Tags</h4>
230
<h4>Allow the use of Netscape proprietary Tags</h4>
232
<h4>Default charset</h4>
234
<p>This does not have any functionality yet.</p>
236
<h3>Main GUI options</h3>
238
<p align="CENTER"><img src="../images/config_gui.png" width="425" height=
239
"524" border="0" alt="GUI tab"></p>
241
<h4>Notebook tab font</h4>
243
<p>This works exactly as in the <a href="#set-font">Editor tab</a>, only
244
that it sets the font of the tabs in the editing area (i.e. the tabs that
245
contain the names of the files opened). It is advised that you keep it to a
246
small simple font.</p>
248
<h4>Font is a fontset</h4>
250
<p>Select this if your selected font is a fontset, i.e. it has a number of
251
different charsets and is therefor suitable for drawing international
254
<h4>Notebook position</h4>
256
<p>By default, the tabs are in top of the text area. If, however, you find
257
them more comfortable in another position, you can set them at the
258
<i>bottom, right and left</i> of the text area.</p>
260
<p>To select another position, press the button on the right and a list of
261
the positions will appear, from which you can select the prefered position.
262
Note that you can also change the position with the Up and Down cursors.</p>
264
<h4>Initial width & height</h4>
266
<p>These two variables set the width and height of the main window.</p>
268
<p>To adjust the width & height to your preferences, you can either
269
write the new values or use the up/down button at the right, which will
270
increase and decrease the value by 5. Furthermore, if you press the Up and
271
Down cursors, the value will also be increased or decreased by 5.</p>
273
<p>The default values are 600 for width and 400 for height.</p>
275
<h4>File list initial size</h4>
277
<p>Here you can set the minimum size of the file-list in the left. Standard
278
is 150. You can manually change the width of the filelist when working.</p>
280
<h4>Items in open recent menu</h4>
282
<p>The number of the last opened files that will appear under File ->
285
<h4>Items in directory history</h4>
287
<p>The number of the last used directories that will appear above the
290
<h4>Filter file browser default</h4>
292
<p>When selected the file-filter function of the file-browser is enabled by
295
<h4>Backup file before saving</h4>
297
<p>When selected, backup files are created upon file-save.</p>
299
<h4>Backup file suffix</h4>
301
<p>This suffix is appended to the filename when creating backup-files. It is
302
set to ´~´ by default.</p>
304
<a name=files_images><h3>Files and images</h3></a>
306
<p align="CENTER"><img src="../images/config_img.png" width="676" height="558" alt="image dialog tab"></p>
308
<h4>Thumbnail type</h4>
310
<h4>Thumbnail extension string</h4>
311
<h4>Allow multiple instances of the same file</h4>
312
<p>If enabled you can open the same file multiple times. This
313
can lead to unexpected results. If disabled (default) bluefish
314
will switch to the already opened document when you open a
315
file multiple times.</p>
316
<h4>Backup file before saving</h4>
317
<h4>Backup file suffix</h4>
318
<h4>Backup file by copy instead of rename</h4>
319
<p>usually bluefish renames the original file, and opens the
320
original filename as a new file. if you're working with links
321
this doesn't work (the link then is broken). Choose this option if
322
you're working with links.</p>
323
<h4>Backup failure action</h4>
324
<p>'ask', 'save' or 'abort'. If the backup fails (you have for
325
example bo write permissions in the directory, but you do have them
326
on the file itself), still continue, abort the save or ask at the very
328
<h4>Open commandline files in already running bluefish</h4>
329
<p>If you select this option (default) you can add 'bluefish %s'
330
as default program to filemanagers like gmc, and every file will
331
be opened in the same bluefish window.</p>
333
<h4>File filters</h4>
335
<a name=external><h3>External</h3></a>
337
<p align="CENTER"><img src="../images/config_external.png" alt=
340
<h4>Browser command</h4>
342
<p>This refers to the <code>View->View in Netscape</code> function. With
343
this function, you can view your document in Netscape, so as to preview how
344
it looks like so far.</p>
346
<p>Normally, you don't have to change this, but in case the default
347
setting doesn't work, you can write the command and parameters, just
348
like if you were calling the program from bash. The only thing you must note
349
is to put <code>%s</code> at the place where the filename would normally be
350
placed (Bluefish will replace that with the filename automaticly).</p>
352
<p>The default setting is: <code>netscape -remote OpenUrl\(%s\)</code></p>
354
<h4>Weblint command</h4>
356
<p>The commandline with which weblint is invoked. Weblint is a html
359
<h4>ispell command</h4>
361
<p>The commandline with which ispell is invoked. ispell is a spell-checking
364
<h4>default language</h4>
366
<p>The default language for ispell to check against.</p>
368
<h4>Accept compound words, Specify additional characters that might form a
369
word, Personal dictionary, Input encoding</h4>
371
<p>These are special switches for ispell to change its behaviour. For
372
further information look at ispells manpage.</p>
375
<a href="chapter1.html">prev</a> | <a href="index.html">contents</a> | <a
376
href="chapter3.html">next</a>