https://bfwiki.tellefsen.net//api.php?action=feedcontributions&user=DrMartinus&feedformat=atomBluefish Wiki - User contributions [en]2024-03-29T08:59:59ZUser contributionsMediaWiki 1.38.2https://bfwiki.tellefsen.net//index.php?title=Launching_Bluefish&diff=2902Launching Bluefish2023-03-05T06:19:26Z<p>DrMartinus: Added the hint that Bluefish can be started from the Application menu also on other desktops</p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=d<br />
|Title=Chapter&nbsp;III.&nbsp;Starting Bluefish<br />
|prev=Man 2 pt02<br />
|Subtitle=Part&nbsp;2.&nbsp;Using Bluefish<br />
|next=Man 2 ch03s02<br />
}}<br />
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;"><br />
*[[#1. Launching Bluefish|1. Launching Bluefish]] <br />
*[[Man 2 ch03s02|2. Command line options]] <br />
</div><br />
<br />
== 1. Launching Bluefish ==<br />
In GNOME, Bluefish can be started from the Applications/Programming menu. This should also be valid for every other Linux desktop, if bluefish has been installed using the distro's package manager. If Bluefish can not be found in the Applications menu, you can start Bluefish from a terminal: simply launch bluefish using the command <tt>'''bluefish'''</tt>.<br />
<br />
{{note|text=In GNOME, bluefish is launched conforming to the system language. If you want to launch it with another language, first rename the directory $HOME/.bluefish to $HOME/.bluefish-xx, where xx is the previous language. This way you will retrieve your previous settings easily. Then use this command in a terminal: <br/><tt>'''export LANGUAGE=fr_FR; export LANG=fr_FR; export LC_ALL=fr_FR; bluefish &'''</tt><br/> if you use a bash-like shell.}}<br />
<br />
== 2. Command Line Options ==<br />
There are several useful command line options:<br /><br />
<tt>'''$''' man bluefish</tt> shows a list of possible commands.<br />
<br />
;-c, --curwindow<br />
:Open a file in an existing window. This can be used to overwrite the chosen default.<br />
<br />
;-n, --newwindow<br />
:Open a file in a new window. This can be used to overwrite the chosen default.<br />
<br />
;-?, --help, --help-*, --help-all<br />
:Print all or just a group of help options. Some of these options may be documented in gtk-options(7) and gnome-options(7).<br />
<br />
:;--help-gtk<br />
:GTK+ Options<br />
:: --class=CLASS Program class as used by the window manager<br />
:: --name=NAME Program name as used by the window manager<br />
:: --display=DISPLAY X display to use<br />
:: --screen=SCREEN X screen to use<br />
:: --sync Make X calls synchronous<br />
:: --gtk-module=MODULES Load additional GTK+ modules<br />
:: --g-fatal-warnings Make all warnings fatal<br />
<br />
:;--help-gnome<br />
:: todo<br />
<br />
<br />
;-v, --Version<br />
:Print version information.<br />
<br />
<br />
Many programs like browsers, email clients and file managers can be configured to open files in Bluefish. For example, '''bluefish '%s'''' will open a file in the current window, '''bluefish -n '%s'''' will open a file in a new window.<br />
<br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 pt02<br />
|up=Man 2 pt02<br />
|next=Man 2 ch03s02<br />
|prevname= Part&nbsp;2.&nbsp;Using Bluefish<br />
|nextname=2.&nbsp;Command line options<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=History_of_Bluefish&diff=2901History of Bluefish2023-03-05T06:09:39Z<p>DrMartinus: added version 2.2.13</p>
<hr />
<div>== History of Bluefish ==<br />
Bluefish development started under a different name. A good and free text editor targeted towards web development was not available. Olivier Sessink started the project ProSite. Chris Mazuc also started an HTML editor. On a GTK development mailing list, Olivier Sessink and Chris Mazuc saw each others postings, and decided to team up. Olivier had a basic editor, Chris had many HTML dialogs ready. After merging the code this was for a while known as the Thtml editor.<br />
<br />
After a while Neil Millar joined the project to add weblint integration and a color dialog. Because the project became larger and more mature, a logo was wanted. After many discussions about boring logos, Neil Millar came up with a cute blue fish. Because this logo was appreciated by all, the name changed into the final name Bluefish.<br />
<br />
After this initial stage, many developers, translators, testers and users joined the project.<br />
<br />
Several years have passed since the first Bluefish release. Since that time, the fish has gained a reputation as an excellent editor, with qualities like stability, usability and numerous features. Also, Bluefish is small, fast and efficient, making it usable even on slow machines.<br />
<br />
{| class="wikitable" style="margin:auto"<br />
!Year<br />
!Version<br />
!Major New features<br />
|-<br />
|2011<br />
|align="center"|2.2.0<br />
|GTK3-support, Search & Replace, block selection and more<br />
|-<br />
|2011<br />
|align="center"|2.2.1<br />
|Zen-Coding support (requires Python)<br />
|-<br />
|2012<br />
|align="center"|2.2.2<br />
|many bugfixes and minor improvements<br />
|-<br />
|2012<br />
|align="center"|2.2.3<br />
|lorem ipsum generator, HTML5 code creation dialogs, bugfixes<br />
|-<br />
|2013<br />
|align="center"|2.2.4<br />
|improved split view and language syntax detection; new: paste special; new: pylint, cssmin, jsmin, csstidy and php_beautifier integration<br />
|-<br />
|2014<br />
|align="center"|2.2.5<br />
|Improvements on projects, indenting and bookmarks; <br />
|-<br />
|2014<br />
|align="center"|2.2.6<br />
|many improvements and bugfixes<br />
|-<br />
|2015<br />
|align="center"|2.2.7<br />
|Added various HTML5 tags, better syntax support, improved autocompletion, charmap for OSX<br />
|-<br />
|2016<br />
|align="center"|2.2.8<br />
|Various improvements and bugfixes, SASS style language has been added<br />
|-<br />
|2016<br />
|align="center"|2.2.9<br />
|fix incompatability with GTK 3.2, some improvements<br />
|-<br />
|2017<br />
|align="center"|2.2.10<br />
|wayland support, import/export syntax color styles<br />
|-<br />
|2020<br />
|align="center"|2.2.11<br />
|python 3 compatibility, insert output from an external command in the current cursor position, CSS, Python and HTML updates, search within the filebrowser<br />
|-<br />
|2020<br />
|align="center"|2.2.12<br />
|Supports Enchant2 for spell checking, bugfixes and some improvements<br />
|-<br />
|2023<br />
|align="center"|2.2.13<br />
|Full CSS support, bugfixes<br />
|}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Compiling_Bluefish_from_source&diff=2897Compiling Bluefish from source2023-01-04T15:30:30Z<p>DrMartinus: /* Building (assumes required packages have been installed) */ corrected the path to autogen.sh</p>
<hr />
<div>= Compiling bluefish from source tarballs =<br />
<br />
== installing the requirements ==<br />
<br />
Build requirements:<br />
* a C compiler (for example gcc or clang-gcc)<br />
* gnu make<br />
<br />
Library / header file requirements:<br />
* gtk+ 2 or 3 development files (sometimes called libgtk2.0-dev or libgtk2-devel, or libgtk-3-dev)<br />
* libxml2 development files (sometimes called libxml2-dev or libxml2-devel)<br />
<br />
Optional libraries / header files:<br />
* libenchant + development files (for spell checking, libenchant-dev)<br />
* libgucharmap + development files (for the character map side pane plugin, libgucharmap-dev)<br />
* python development files (python-dev or python-devel)<br />
<br />
=== Debian and Ubuntu packages required ===<br />
* automake<br />
* autoconf<br />
* make<br />
* libtool<br />
* intltool<br />
* libgtk-3-dev<br />
* libxml2-dev<br />
and optional<br />
* libenchant-dev<br />
* libgucharmap-2-90-dev<br />
* python-dev<br />
<br />
== Getting and compiling ==<br />
* get the latest source from http://www.bennewitz.com/bluefish/stable/source/<br />
* unpack <br />
** for a gzipped file '''tar -xzf bluefish-2.2.xxxx.tar.gz'''<br />
** for a bzipped file '''tar -xjf bluefish-2.2.xxxx.tar.bz2'''<br />
* '''cd bluefish-2.2.xxxx'''<br />
* run '''./configure'''<br />
* run '''make'''<br />
* switch to root and run '''make install'''<br />
<br />
= Compiling bluefish straight from subversion =<br />
=== Building (assumes required packages have been installed) ===<br />
{{SVN|checkout}}<br />
cd bluefish-code/bluefish<br />
./autogen.sh<br />
./configure<br />
make<br />
sudo make install<br />
<br />
=== Debian and Ubuntu packages required to build from subversion ===<br />
* libtool<br />
* intltool<br />
* automake<br />
* autoconf<br />
* make<br />
* libgtk-3-dev<br />
* libenchant-dev<br />
* libgucharmap-2-90-dev<br />
* libxml2-dev<br />
* subversion<br />
* python-dev</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Translations&diff=2896Translations2022-12-28T11:13:16Z<p>DrMartinus: Added Ralf Kestler for German translation</p>
<hr />
<div>== Translations ==<br />
<br />
Please send a message to the developer's list if you have questions, suggestions or would like to help with translations. By all means, don't wait for someone to give you the OK to start translating. Here are some instructions on [[How To Translate]].<br />
<br />
== Current translation teams ==<br />
<br />
It is good if there are multiple people for every language, so if anybody is on holidays or something and we want to do a Bluefish release we can have all languages updated, so please work in teams.<br />
<br />
=== Active translators / teams ===<br />
These translations are kept up to date (last updated Feb 13 2014):<br />
<br />
Basque (EU) dooteo (at) euskalgnu org / Language-Team: itzulpena (at) euskalgnu org<br />
Brazilian Portuguese (PT_BR) esfingemetal (at) gmail com<br />
Catalan (CA) monica (at) probeta.net <br />
Chinese (ZH_CN) mzf9527 (at) gmail com<br />
Czech (CS) marek (at) manet cz / Language-Team: gnome-cs-list (at) gnome org<br />
Danish (DA) fc (at) stilheden net / Language Team: dansk (at) dansk-gruppen dk<br />
Dutch (NL) olivier (at) bluefish openoffice nl<br />
Farsi (FA) Paymon Menhadji<br />
French (FR) falsetti (at) clansco org<br />
Galician (GL) correo.xmgz (at) gmail com<br />
German (DE) Ralf.Kestler (at) gmx net, linux (at) drmartinus de<br />
Hungarian (HU) urbalazs (at) gmail com / Language-Team: hu (at) li org<br />
Italian (IT) bellingeri (at) netguru it<br />
Japanese (JA) hmatrjp (at) users sourceforge jp<br />
Norwegian (NB) chris (at) tellefsen net<br />
Nynorsk (NN) l10n (at) landro net<br />
Polish (PL) dawajpoczte (at) gmail com<br />
Russian (RU) george (at) altlinux org / Language-Team: gnome-cyr (at) lists gnome org<br />
Spanish (ES) daniel.mustieles (at) gmail com / Language-Team: gnome-es (at) gnome org<br />
Ukrainian (UK) yurchor (at) ukr net<br />
<br />
=== Current development translation status ===<br />
updated 2018-02-16 15:02:49 GMT for revision: 8787<br />
* ca.po: 18 fuzzy, 5 untranslated<br />
* cs.po: 18 fuzzy, 5 untranslated<br />
* da.po: 18 fuzzy, 5 untranslated<br />
* de.po: 18 fuzzy, 5 untranslated<br />
* es.po: 19 fuzzy, 5 untranslated<br />
* eu.po: 58 fuzzy, 87 untranslated<br />
* fa.po: 34 fuzzy, 16 untranslated<br />
* fr.po: 18 fuzzy, 5 untranslated<br />
* gl.po: 36 fuzzy, 61 untranslated<br />
* hu.po: 18 fuzzy, 5 untranslated<br />
* it.po: 18 fuzzy, 5 untranslated<br />
* ja.po: 16 fuzzy, 3 untranslated<br />
* nb.po: 18 fuzzy, 5 untranslated<br />
* nl.po: 23 fuzzy, 8 untranslated<br />
* nn.po: 18 fuzzy, 5 untranslated<br />
* pl.po: 18 fuzzy, 5 untranslated<br />
* pt.po: 73 fuzzy, 78 untranslated<br />
* pt_BR.po: 35 fuzzy, 61 untranslated<br />
* ru.po: 35 fuzzy, 25 untranslated<br />
* uk.po: 15 fuzzy, 2 untranslated<br />
* zh_CN.po: 44 fuzzy, 66 untranslated<br />
<br />
<br />
<br />
[[File:Stats.png]]<br />
<br />
These languages have actually no active translators:<br />
* bg.po: 717 fuzzy, 525 untranslated<br />
* el.po: 715 fuzzy, 642 untranslated<br />
* fi.po: 668 fuzzy, 553 untranslated<br />
* ko.po: 263 fuzzy, 257 untranslated<br />
* ro.po: 764 fuzzy, 644 untranslated<br />
* sk.po: 679 fuzzy, 443 untranslated<br />
* sr.po: 712 fuzzy, 518 untranslated<br />
* sv.po: 715 fuzzy, 515 untranslated<br />
* ta.po: 676 fuzzy, 414 untranslated<br />
* tr.po: 702 fuzzy, 513 untranslated<br />
* zh_TW.po: 712 fuzzy, 518 untranslated<br />
<br />
== check yourself ==<br />
<br />
* to check the status yourself, run <tt>make update-po</tt> in the po/ directory, this also updates the po files to reflect any changes in the .c files.<br />
* to check only fr.po run `<tt>LINGUAS=fr make update-po</tt>´<br />
* if <tt>make update-po</tt> fails you have to run <tt>./configure</tt> in the top directory.<br />
* In bluefish-2.0 there are 8 po directories:<br />
** po/<br />
** src/plugin_about/po/ <br />
** src/plugin_charmap/po/ <br />
** src/plugin_entities/po/ <br />
** src/plugin_htmlbar/po/<br />
** src/plugin_infbrowser/po/ <br />
** src/plugin_snippets/po/<br />
** src/plugin_xmltools/po/<br />
but:<br />
* only po/ make have rule to use `LINGUAS=fr´.<br />
* <tt>make distclean</tt> do not remove gmo files in src/plugin_*/po/<br /> you have also to run <tt>rm src/plugin_*/po/*.gmo</tt> before <tt>make</tt> to apply your changes in plugins po files.<br />
<br />
== Notes and references ==<br />
<references/><br />
<br />
[[Category:i18n]]</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=History_of_Bluefish&diff=2895History of Bluefish2022-12-28T06:18:11Z<p>DrMartinus: updated the years in the table according to the source code download page http://www.bennewitz.com/bluefish/stable/source/</p>
<hr />
<div>== History of Bluefish ==<br />
Bluefish development started under a different name. A good and free text editor targeted towards web development was not available. Olivier Sessink started the project ProSite. Chris Mazuc also started an HTML editor. On a GTK development mailing list, Olivier Sessink and Chris Mazuc saw each others postings, and decided to team up. Olivier had a basic editor, Chris had many HTML dialogs ready. After merging the code this was for a while known as the Thtml editor.<br />
<br />
After a while Neil Millar joined the project to add weblint integration and a color dialog. Because the project became larger and more mature, a logo was wanted. After many discussions about boring logos, Neil Millar came up with a cute blue fish. Because this logo was appreciated by all, the name changed into the final name Bluefish.<br />
<br />
After this initial stage, many developers, translators, testers and users joined the project.<br />
<br />
Several years have passed since the first Bluefish release. Since that time, the fish has gained a reputation as an excellent editor, with qualities like stability, usability and numerous features. Also, Bluefish is small, fast and efficient, making it usable even on slow machines.<br />
<br />
{| class="wikitable" style="margin:auto"<br />
!Year<br />
!Version<br />
!Major New features<br />
|-<br />
|2011<br />
|align="center"|2.2.0<br />
|GTK3-support, Search & Replace, block selection and more<br />
|-<br />
|2011<br />
|align="center"|2.2.1<br />
|Zen-Coding support (requires Python)<br />
|-<br />
|2012<br />
|align="center"|2.2.2<br />
|many bugfixes and minor improvements<br />
|-<br />
|2012<br />
|align="center"|2.2.3<br />
|lorem ipsum generator, HTML5 code creation dialogs, bugfixes<br />
|-<br />
|2013<br />
|align="center"|2.2.4<br />
|improved split view and language syntax detection; new: paste special; new: pylint, cssmin, jsmin, csstidy and php_beautifier integration<br />
|-<br />
|2014<br />
|align="center"|2.2.5<br />
|Improvements on projects, indenting and bookmarks; <br />
|-<br />
|2014<br />
|align="center"|2.2.6<br />
|many improvements and bugfixes<br />
|-<br />
|2015<br />
|align="center"|2.2.7<br />
|Added various HTML5 tags, better syntax support, improved autocompletion, charmap for OSX<br />
|-<br />
|2016<br />
|align="center"|2.2.8<br />
|Various improvements and bugfixes, SASS style language has been added<br />
|-<br />
|2016<br />
|align="center"|2.2.9<br />
|fix incompatability with GTK 3.2, some improvements<br />
|-<br />
|2017<br />
|align="center"|2.2.10<br />
|wayland support, import/export syntax color styles<br />
|-<br />
|2020<br />
|align="center"|2.2.11<br />
|python 3 compatibility, insert output from an external command in the current cursor position, CSS, Python and HTML updates, search within the filebrowser<br />
|-<br />
|2020<br />
|align="center"|2.2.12<br />
|Supports Enchant2 for spell checking, bugfixes and some improvements<br />
|}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Main_Page&diff=2894Main Page2022-12-28T06:16:16Z<p>DrMartinus: </p>
<hr />
<div>==Welcome to the Bluefish Wiki!==<br />
<br />
The official bluefish website is at http://bluefish.openoffice.nl<br />
<br />
If you want to see the manual, go here: * [[Manual_2_ToC|Bluefish 2 Manual]].<br />
<br />
See our [[Mailinglists]] to get in touch with the Bluefish community and developers. The honourable project leader is Olivier Sessink (olivier (at) bluefish.openoffice.nl). The wiki maintainer is Christian (bfwiki --a--tellefsen.net).<br />
<br />
=== Wiki user registration ===<br />
<br />
To register for an account, send me an email with your desired username to <tt>bfwiki--a--tellefsen.net</tt>.<br />
<br />
=== Help / documentation ===<br />
<br />
* [[Installing Bluefish]] / [[Compiling Bluefish from source]]<br />
* [[Hidden features]] <br />
* [[Keyboard shortcuts]]<br />
<br />
* [[Troubleshooting dll issues on windows]]<br />
* [[:Category:Manual 2|Bluefish 2 Manual project]]<br />
* [[Enabling Aspell Under MacOSX]]<br />
* [[Typing Japanese under MacOS X]]<br />
<br />
=== Development / contributing ===<br />
<br />
Recent activity:<br />
* [[Project Roadmap]]<br />
* [[Translations|Translation status]]<br />
* [[Providing information on crashes]]<br />
* [[Debugging Bluefish]]<br />
* [[Writing language definition files]]<br />
<br />
<br />
* [[CommunityTools]]<br />
* [[Getting Bluefish]]<br />
* [[Sending Patches]]<br />
* [[Setting up a Windows Build Environment]] [[Installation d'un environnement de compilation Windows|(français)]]<br />
* [[Using File Type Icons in Bluefish 2]]<br />
* [[Building a native (no X11) MacOSX binary]]<br />
<br />
Still useful:<br />
<br />
* [[Man 1 index|The Bluefish 1 Manual]]<br />
* [[Compiling Under MacOS X]]<br />
* [[Backtrace Under Mac OS X]]<br />
* [[Customization For MacOS X]]<br />
* [[Compiling Under Cygwin]]<br />
<br />
=== Old stuff, mostly outdated ===<br />
* [[Syntax Highlighting Colours]] - default colors for all languages<br />
* [[Scanner]] - Bluefish text widget with scanning features<br />
* [[Manual]] -- Just so people can work out whos doing what (Now being Maintained by Scott White)<br />
* [[Function Reference 2]] - new function reference for Bluefish (or should we call it Information Center ?)<br />
* Search and Replace dialog<br />
* [[Reproducable Bugs]]<br />
* [[Preferences Refactor]] - Changes and removals on the Prefs Dialog<br />
* [[Feature Requests]]<br />
* [[ToDo List]]<br />
* [[Plugins]]<br />
* [[Current Plans]] from all developers<br />
* [[Gnome HIG]] compliance<br />
* [[Cvs Activity]]<br />
* [[Function Reference]] - implemented already, but we need more references for python, perl etc.<br />
* [[Old stuff, Bookmarks]]<br />
* [[Downloading From CVS]]<br />
* [[Compiling Manual]]<br />
This Wiki is maintained by the Bluefish community. If you want to help to contribute in any way, please contact us on the [[Mailinglists|bluefish mailinglist]]. If you want to help translate Bluefish, have a look at [[Translations]].</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Manual_2_ToC&diff=2893Manual 2 ToC2022-12-24T14:54:03Z<p>DrMartinus: Moved "Editing area" to the updated part of the ToC</p>
<hr />
<div>{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| <center>'''Bluefish: The Definitive Guide'''</center><br />
|}<br />
<div style="text-align:center"><br />
'''Table of Contents <small>(part 1)</small>'''<br />
</div><br />
{{toc}} <br />
{|<br />
|see also: <br />
|[[Notes for Bluefish 2 Manual]]<br />
|-<br />
|<br />
|[[Guidelines for Writing this Manual]]<br />
|}<br />
<br />
{{Note|text=Note that the manual is currently being reworked. Many pages are outdated, others not yet available. They will be made available in the near future.}}<br />
<br />
Here an overview of what has been done so far:<br />
{|class="wikitable" style="margin:auto"<br />
!As per<br />
!What has been done<br />
|-<br />
|2022-12-21<br />
|All unnumbered sections under ''Preface'' and ''Getting and Installing Bluefish'' have been updated<br />
|-<br />
|2022-12-22<br />
|Finished reviewing all sections under ''Preface'' and ''Getting and Installing Bluefish'', reviewed and updated ''Starting Bluefish''<br />
|}<br />
<br />
'''Bluefish 2.2 Manual''' <br />
<br />
== [[Preface|Preface]] ==<br />
*[[About this Manual]]<br />
*[[What is Bluefish?]]<br />
*[[History of Bluefish]]<br />
*[[Main Features of Bluefish]]<br />
*[[How Stable is Bluefish?]]<br />
*[[Contact Us]]<br />
== [[Getting and Installing Bluefish|Getting and Installing Bluefish]] ==<br />
*[[Operating Systems Supported by Bluefish]]<br />
*[[Man 2 ch02#1. Requirements|Requirements]]<br />
*[[Choosing a Version]]<br />
*[[Latest Stable Version|Latest Stable Version]]<br />
*[[Getting Bluefish - Latest Snapshot|Latest Snapshot Version]]<br />
*[[Getting Bluefish - Latest Development Version|Latest Developmental Version]]<br />
*[[How and When Updates are Released]]<br />
*[[Installing Bluefish]]<br />
*[[Installing Bluefish - System Issues| System Specific Installation Issues]]<br />
*[[Installing Bluefish - Install from Source Code|Installing a Bluefish Source Distribution]]<br />
*[[Compiling Bluefish from source]] <br />
*[[Installing Bluefish - Install from Source Code Options|Configure Options]]<br />
*[[Installing Bluefish - Install from Binary Distribution|Installing a Binary Distribution]]<br />
*[[Installing Bluefish - Post-Installation Checklist|Post-installation Setup]]<br /><br />
<br />
<br />
== [[Using Bluefish|Using Bluefish]] ==<br />
*[[Launching Bluefish|Starting Bluefish]]<br />
*[[Editing Area#1. Editing Area|Editing Area]]<br />
<br />
=== [[Editing Area|The user interface]] ===<br />
[[Menus and Tool Bars|2. Menus and Tool Bars]] ¤ [[Side Panel|3. Side Panel]] ¤ [[Interface - Status Bar|4. Status Bar]] ¤ [[Interface - Help Menu|5. Help Menu]]<br />
=== [[Preferences|Preferences]] === <br />
=== [[Creating Files|Working with files and folders]] ===<br />
[[Creating Files#1. Creating files|1. Creating files]] ¤ [[Managing Directories|2. Managing directories]] ¤ [[Opening Files|3. Opening files]] ¤ [[Saving Files|4. Saving files]] ¤ [[Renaming Files|5. Renaming files]] ¤ [[Deleting files|6. Deleting files]] ¤ [[Closing Files|7. Closing files]] ¤ [[Inserting files|8. Inserting files]]<br /><br />
[[Editing|9. Editing]] ¤ Undo and Redo ¤ Cut, Copy, and Paste ¤ Input methods<br /><br />
[[Basic Find and Replace|10. Basic Find and Replace]] ¤ Searching for a word within a whole document ¤ Setting limits to the search scope ¤ Case sensitive search ¤ Overlapping searches ¤ Retrieving previous search strings ¤ More on find ¤ Replacing features ¤ Retrieving previous replace strings ¤ Changing letter case when replacing ¤ Choosing strings to replace ¤ More on replace<br /><br />
[[File Types (1/2)|11. File types]] ¤ Syntax highlighting<br /><br />
[[File Types (2/2)|12. More on files]] ¤ Remote files ¤ Character encoding ¤ Open advanced<br />
=== [[Navigating through a document|Navigation and Managing documents]] === <br />
Navigating through a document<br /><br />
[[Go Menu and Document Navigation|2. Navigating through many documents]] ¤ [[Projects|3. Projects]]<br /><br />
[[Bookmarks|4. Bookmarks]] ¤ Generating several bookmarks at once]]<br /><br />
[[Find and Replace|5. Find and Replace]] ¤ Find Again ¤ Find from Selection ¤ Find and Replace Using Regular Expressions<br /><br />
[[Templates| Templates]]<br />
=== [[Indenting|More than a Text Editor]] === <br />
[[Indenting#1. Indenting|1. Indenting]] ¤ [[Autocompletion|2. Autocompletion]] ¤ [[Hidden features]] ¤ [[Spell checker|3. Spell checker]] ¤ [[Programming and Markup Languages Function Reference|4. Function reference]]<br /><br />
[[HTML Editing|5. HTML]] ¤ Special find and replace features ¤ Thumbnail generation<br /><br />
[[Quick Bar Customization|6. Customizing the Quick bar]]<br /><br />
[[Snippets plugin|7. Snippets plugin]] (was Custom menu in Bluefish 1) ¤ Adding a snippet dialog ¤ Adding a snippet replace dialog<br /><br />
[[External Programs and Filters|8. External programs, filters]] ¤ Customizing browsers ¤ Customizing Commands menu ¤ Customizing Ouputbox menu<br />
<br />
=== [[Modifying shortcut keys|Customising Bluefish]] === <br />
Modifying shortcut keys<br /><br />
[[Invisible Files and Folders|2. Showing hidden files and folders]] ¤ [[Showing backup files|3. Showing backup files]] ¤ [[Editor Appearance Customization|4. Editor appearance]] ¤ [[Bookmarks Path Customization|5. Customizing the bookmarks path]] ¤ [[HTML Tags Style Customization|6. Customizing the html tags style]] ¤ [[Author Meta Tag|7. Changing the author meta tag on the fly]]<br /><br />
[[File Handling and Browsing Customization|8. Customizing files handling and browsing]] ¤ Setting the encoding meta tag on save ¤ Setting the default base directory ¤ Merging file browser views ¤ 8.4. Backup files ¤ 8.5. Using multiple instances of a file<br /><br />
[[User Interface Customization|9. Customizing the user interface]] ¤ [[File Types Handling|10. Modifying file types]] ¤ [[File Filters|11. Modifying the files filters]] ¤ [[Highlight Patterns Modification|12. Modifying the highlighting patterns]]<br />
*[[General Shortcuts|IX. Shortcuts available within Bluefish]] ¤ [[General Shortcuts#1. General Shortcuts|1. General Shortcuts]] ¤ [[HTML Shortcuts|2. HTML Shortcuts]]<br />
<br />
== [[Developing Bluefish|Developing Bluefish]] ==<br />
=== [[Bugs - Using the Debugger|Debugging Bluefish]] ===<br />
[[Bugs - Using the Debugger#1. Using the Debugger|1. Using the Debugger]] ¤ [[Bugs - Filing a Report|2. Filling a bug report]]<br />
=== [[Editor Tab Options|Reference]] === <br />
[[Editor Tab Options#1. Options in the Editor Tab|1. Options in the Editor Tab]] ¤ [[HTML Tab Options|2. Options in the HTML Tab]] ¤ [[Files Tab Options|3. Options in the Files Tab]] ¤ [[User Interface Tab Options|4. Options in the User interface Tab]] ¤ [[Images Tab Options|5. Options in the Images Tab]]<br />
=== [[Development - Indenting and Formatting|Development guidelines]] ===<br />
Indenting and formating style<br /><br />
[[Development - Naming|2. Naming]] ¤ [[Development - Declaring Procedures|3. Declaring procedures]] ¤ [[Development - Header Files|4. Header files]] ¤ [[Development - New Files|5. New files]] ¤ [[Development - File Reference|6. File reference]] ¤ [[Development - Patches|7. Patches]]<br /><br />
[[Development - Translations|8. Translations]] ¤ Introduction ¤ PO files basics ¤ <br />
Shortcut keys ¤ How to contribute<br /><br />
[[Development - Some tips|9. Some tips]] ¤ [[Development - Making Releases|10. Making releases]] ¤ [[Development - Useful Stuff|11. Useful stuff]]<br />
<br />
== [[Table of Contents (2/3)|'''Table of Contents (2/3)''']] ==<br />
<br />
{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| &nbsp;<br />
| <center>[[Man 2 index|Home]]</center><br />
| <div align="right">&nbsp;</div><br />
|}<br />
<br />
[[Category:Manual 2]]</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Editing_Area&diff=2892Editing Area2022-12-24T14:51:43Z<p>DrMartinus: removed for the time being the table of other pages relating to the editor area</p>
<hr />
<div>{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=u<br />
|Title=Chapter&nbsp;IV.&nbsp;The user interface<br />
|prev=Man 2 ch03s02<br />
|Subtitle=Part&nbsp;2.&nbsp;Using Bluefish<br />
|next=Man 2 ch04s02<br />
}}<br />
{{toc}}<br />
Here are the main elements of the user interface.<br />
{{clear}}<br />
<!--<br />
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;"><br />
*[[#1. Editing Area|1. Editing Area]] <br />
*[[Man 2 ch04s02|2. Menus and Tool Bars]] <br />
*[[Man 2 ch04s03|3. Side Panel]] <br />
*[[Man 2 ch04s04|4. Status Bar]] <br />
*[[Man 2 ch04s05|5. Help Menu]] <br />
</div><br />
--><br />
== 1. Editing Area ==<br />
=== Notebook tab bar ===<br />
[[File:Man2_editor_array.png|700px|thumb|left|Bluefish Editor]]<br />
{{clear}}<br />
The biggest part of the user interface is the editor area. Because Bluefish has a so-called “Multiple Document Interface”, there are actually many editor areas in Bluefish, accessible via the document tabs, which are by default at the bottom of the window. <br/><small>see Preferences [[Preferences#User interface|User interface]]</small><br />
<br />
[[File:Man2_opendocument_list.png|600px|thumb|left|List of open Documents]]<br />
{{clear}}<br />
In the enlarged picture of the document tab bar you see that the current document's tab may be raised by the Gtk theme (here it has a blue line underneath), and if the document has been modified, its name on the tab is coloured by default in blue. The asterisk to the left of the document name shows that the changes haven't been saved yet. The changes are also noted with blue on the open document list, accessible by right-clicking on the tab. Error documents are colored in red, empty documents in light gray.<br /><br />
If there are more open documents than there is space for the corresponding tabs, you can navigate between documents by clicking on the left and right arrow of the tab bar. It may be easier to just right-click on one visible tab and then select the document you want to work with from the list which shows you all opened documents. <br/>You can also reorder the document tabs using drag n drop.<br />
<br />
=== Drag and drop ===<br />
In case you are not familiar with the term "drag and drop": you click with the left mouse button on a document, highlighted text or something else and drag the mouse cursor to another place, where you want to drop the document or highlighted text or whatever you have grabbed with the mouse cursor. By releasing the left mouse button, the document or whatever you have grabbed will be dropped at the place where the mouse cursor is pointing to, provided this is supported by the OS and for the item you wanted to drag and drop.<br/><br />
Generally, within Bluefish<br/><br />
* You can drag n drop a selection in document.<br />
* You can import a document in Bluefish using drag and drop.<br />
** select some text in Firefox, drag and drop the selection in your document.<br />
** drag and drop a document, you import it's URI.<br />
* drag and drop a document in the Tab Bar, you open it in Bluefish. (For remote files you need to have a fully functionnal installation of gvfs)<br />
<br />
<br />
=== other features ===<br />
;todo<br />
: [[Document highlighting]] see [[Man 2 ch08s12]] and [[Man 2 ch05s11]]<br />
: [[Autocompletion]]<br />
: [[Indenting]] <br />
: [[Block folding]]<br />
: [[Bookmarks]]<br />
: Line numbers<br />
: whitespace Highlighting<br />
: [[Spell checker]]<br />
: [[Hidden features]]<br />
: ?<br />
<br />
{{top}}<br />
<br />
{{Man2bottom<br />
|prev=Man 2 ch03s02<br />
|up=Man 2 pt02<br />
|next=Man 2 ch04s02<br />
|prevname= 2.&nbsp;Command line options<br />
|nextname=2.&nbsp;Menus and Tool Bars<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Editing_Area&diff=2891Editing Area2022-12-24T14:50:23Z<p>DrMartinus: rewrote, put new screenshots in place, as the old ones had disappeared</p>
<hr />
<div>{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=u<br />
|Title=Chapter&nbsp;IV.&nbsp;The user interface<br />
|prev=Man 2 ch03s02<br />
|Subtitle=Part&nbsp;2.&nbsp;Using Bluefish<br />
|next=Man 2 ch04s02<br />
}}<br />
{{toc}}<br />
Here are the main elements of the user interface.<br />
{{clear}}<br />
<br />
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;"><br />
*[[#1. Editing Area|1. Editing Area]] <br />
*[[Man 2 ch04s02|2. Menus and Tool Bars]] <br />
*[[Man 2 ch04s03|3. Side Panel]] <br />
*[[Man 2 ch04s04|4. Status Bar]] <br />
*[[Man 2 ch04s05|5. Help Menu]] <br />
</div><br />
<br />
== 1. Editing Area ==<br />
=== Notebook tab bar ===<br />
[[File:Man2_editor_array.png|700px|thumb|left|Bluefish Editor]]<br />
{{clear}}<br />
The biggest part of the user interface is the editor area. Because Bluefish has a so-called “Multiple Document Interface”, there are actually many editor areas in Bluefish, accessible via the document tabs, which are by default at the bottom of the window. <br/><small>see Preferences [[Preferences#User interface|User interface]]</small><br />
<br />
[[File:Man2_opendocument_list.png|600px|thumb|left|List of open Documents]]<br />
{{clear}}<br />
In the enlarged picture of the document tab bar you see that the current document's tab may be raised by the Gtk theme (here it has a blue line underneath), and if the document has been modified, its name on the tab is coloured by default in blue. The asterisk to the left of the document name shows that the changes haven't been saved yet. The changes are also noted with blue on the open document list, accessible by right-clicking on the tab. Error documents are colored in red, empty documents in light gray.<br /><br />
If there are more open documents than there is space for the corresponding tabs, you can navigate between documents by clicking on the left and right arrow of the tab bar. It may be easier to just right-click on one visible tab and then select the document you want to work with from the list which shows you all opened documents. <br/>You can also reorder the document tabs using drag n drop.<br />
<br />
=== Drag and drop ===<br />
In case you are not familiar with the term "drag and drop": you click with the left mouse button on a document, highlighted text or something else and drag the mouse cursor to another place, where you want to drop the document or highlighted text or whatever you have grabbed with the mouse cursor. By releasing the left mouse button, the document or whatever you have grabbed will be dropped at the place where the mouse cursor is pointing to, provided this is supported by the OS and for the item you wanted to drag and drop.<br/><br />
Generally, within Bluefish<br/><br />
* You can drag n drop a selection in document.<br />
* You can import a document in Bluefish using drag and drop.<br />
** select some text in Firefox, drag and drop the selection in your document.<br />
** drag and drop a document, you import it's URI.<br />
* drag and drop a document in the Tab Bar, you open it in Bluefish. (For remote files you need to have a fully functionnal installation of gvfs)<br />
<br />
<br />
=== other features ===<br />
;todo<br />
: [[Document highlighting]] see [[Man 2 ch08s12]] and [[Man 2 ch05s11]]<br />
: [[Autocompletion]]<br />
: [[Indenting]] <br />
: [[Block folding]]<br />
: [[Bookmarks]]<br />
: Line numbers<br />
: whitespace Highlighting<br />
: [[Spell checker]]<br />
: [[Hidden features]]<br />
: ?<br />
<br />
{{top}}<br />
<br />
{{Man2bottom<br />
|prev=Man 2 ch03s02<br />
|up=Man 2 pt02<br />
|next=Man 2 ch04s02<br />
|prevname= 2.&nbsp;Command line options<br />
|nextname=2.&nbsp;Menus and Tool Bars<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=File:Man2_opendocument_list.png&diff=2890File:Man2 opendocument list.png2022-12-24T14:28:09Z<p>DrMartinus: DrMartinus uploaded a new version of File:Man2 opendocument list.png</p>
<hr />
<div></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=File:Man2_editor_array.png&diff=2889File:Man2 editor array.png2022-12-24T14:19:18Z<p>DrMartinus: DrMartinus uploaded a new version of File:Man2 editor array.png</p>
<hr />
<div></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Manual_2_ToC&diff=2888Manual 2 ToC2022-12-22T16:44:52Z<p>DrMartinus: Moved "Starting Bluefish" to the updated part and updated the list of what has been done</p>
<hr />
<div>{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| <center>'''Bluefish: The Definitive Guide'''</center><br />
|}<br />
<div style="text-align:center"><br />
'''Table of Contents <small>(part 1)</small>'''<br />
</div><br />
{{toc}} <br />
{|<br />
|see also: <br />
|[[Notes for Bluefish 2 Manual]]<br />
|-<br />
|<br />
|[[Guidelines for Writing this Manual]]<br />
|}<br />
<br />
{{Note|text=Note that the manual is currently being reworked. Many pages are outdated, others not yet available. They will be made available in the near future.}}<br />
<br />
Here an overview of what has been done so far:<br />
{|class="wikitable" style="margin:auto"<br />
!As per<br />
!What has been done<br />
|-<br />
|2022-12-21<br />
|All unnumbered sections under ''Preface'' and ''Getting and Installing Bluefish'' have been updated<br />
|-<br />
|2022-12-22<br />
|Finished reviewing all sections under ''Preface'' and ''Getting and Installing Bluefish'', reviewed and updated ''Starting Bluefish''<br />
|}<br />
<br />
'''Bluefish 2.2 Manual''' <br />
<br />
== [[Preface|Preface]] ==<br />
*[[About this Manual]]<br />
*[[What is Bluefish?]]<br />
*[[History of Bluefish]]<br />
*[[Main Features of Bluefish]]<br />
*[[How Stable is Bluefish?]]<br />
*[[Contact Us]]<br />
== [[Getting and Installing Bluefish|Getting and Installing Bluefish]] ==<br />
*[[Operating Systems Supported by Bluefish]]<br />
*[[Man 2 ch02#1. Requirements|Requirements]]<br />
*[[Choosing a Version]]<br />
*[[Latest Stable Version|Latest Stable Version]]<br />
*[[Getting Bluefish - Latest Snapshot|Latest Snapshot Version]]<br />
*[[Getting Bluefish - Latest Development Version|Latest Developmental Version]]<br />
*[[How and When Updates are Released]]<br />
*[[Installing Bluefish]]<br />
*[[Installing Bluefish - System Issues| System Specific Installation Issues]]<br />
*[[Installing Bluefish - Install from Source Code|Installing a Bluefish Source Distribution]]<br />
*[[Compiling Bluefish from source]] <br />
*[[Installing Bluefish - Install from Source Code Options|Configure Options]]<br />
*[[Installing Bluefish - Install from Binary Distribution|Installing a Binary Distribution]]<br />
*[[Installing Bluefish - Post-Installation Checklist|Post-installation Setup]]<br /><br />
<br />
<br />
== [[Using Bluefish|Using Bluefish]] ==<br />
*[[Launching Bluefish|Starting Bluefish]]<br />
<br />
=== [[Editing Area|The user interface]] ===<br />
[[Editing Area#1. Editing Area|1. Editing Area]] ¤ [[Menus and Tool Bars|2. Menus and Tool Bars]] ¤ [[Side Panel|3. Side Panel]] ¤ [[Interface - Status Bar|4. Status Bar]] ¤ [[Interface - Help Menu|5. Help Menu]]<br />
=== [[Preferences|Preferences]] === <br />
=== [[Creating Files|Working with files and folders]] ===<br />
[[Creating Files#1. Creating files|1. Creating files]] ¤ [[Managing Directories|2. Managing directories]] ¤ [[Opening Files|3. Opening files]] ¤ [[Saving Files|4. Saving files]] ¤ [[Renaming Files|5. Renaming files]] ¤ [[Deleting files|6. Deleting files]] ¤ [[Closing Files|7. Closing files]] ¤ [[Inserting files|8. Inserting files]]<br /><br />
[[Editing|9. Editing]] ¤ Undo and Redo ¤ Cut, Copy, and Paste ¤ Input methods<br /><br />
[[Basic Find and Replace|10. Basic Find and Replace]] ¤ Searching for a word within a whole document ¤ Setting limits to the search scope ¤ Case sensitive search ¤ Overlapping searches ¤ Retrieving previous search strings ¤ More on find ¤ Replacing features ¤ Retrieving previous replace strings ¤ Changing letter case when replacing ¤ Choosing strings to replace ¤ More on replace<br /><br />
[[File Types (1/2)|11. File types]] ¤ Syntax highlighting<br /><br />
[[File Types (2/2)|12. More on files]] ¤ Remote files ¤ Character encoding ¤ Open advanced<br />
=== [[Navigating through a document|Navigation and Managing documents]] === <br />
Navigating through a document<br /><br />
[[Go Menu and Document Navigation|2. Navigating through many documents]] ¤ [[Projects|3. Projects]]<br /><br />
[[Bookmarks|4. Bookmarks]] ¤ Generating several bookmarks at once]]<br /><br />
[[Find and Replace|5. Find and Replace]] ¤ Find Again ¤ Find from Selection ¤ Find and Replace Using Regular Expressions<br /><br />
[[Templates| Templates]]<br />
=== [[Indenting|More than a Text Editor]] === <br />
[[Indenting#1. Indenting|1. Indenting]] ¤ [[Autocompletion|2. Autocompletion]] ¤ [[Hidden features]] ¤ [[Spell checker|3. Spell checker]] ¤ [[Programming and Markup Languages Function Reference|4. Function reference]]<br /><br />
[[HTML Editing|5. HTML]] ¤ Special find and replace features ¤ Thumbnail generation<br /><br />
[[Quick Bar Customization|6. Customizing the Quick bar]]<br /><br />
[[Snippets plugin|7. Snippets plugin]] (was Custom menu in Bluefish 1) ¤ Adding a snippet dialog ¤ Adding a snippet replace dialog<br /><br />
[[External Programs and Filters|8. External programs, filters]] ¤ Customizing browsers ¤ Customizing Commands menu ¤ Customizing Ouputbox menu<br />
<br />
=== [[Modifying shortcut keys|Customising Bluefish]] === <br />
Modifying shortcut keys<br /><br />
[[Invisible Files and Folders|2. Showing hidden files and folders]] ¤ [[Showing backup files|3. Showing backup files]] ¤ [[Editor Appearance Customization|4. Editor appearance]] ¤ [[Bookmarks Path Customization|5. Customizing the bookmarks path]] ¤ [[HTML Tags Style Customization|6. Customizing the html tags style]] ¤ [[Author Meta Tag|7. Changing the author meta tag on the fly]]<br /><br />
[[File Handling and Browsing Customization|8. Customizing files handling and browsing]] ¤ Setting the encoding meta tag on save ¤ Setting the default base directory ¤ Merging file browser views ¤ 8.4. Backup files ¤ 8.5. Using multiple instances of a file<br /><br />
[[User Interface Customization|9. Customizing the user interface]] ¤ [[File Types Handling|10. Modifying file types]] ¤ [[File Filters|11. Modifying the files filters]] ¤ [[Highlight Patterns Modification|12. Modifying the highlighting patterns]]<br />
*[[General Shortcuts|IX. Shortcuts available within Bluefish]] ¤ [[General Shortcuts#1. General Shortcuts|1. General Shortcuts]] ¤ [[HTML Shortcuts|2. HTML Shortcuts]]<br />
<br />
== [[Developing Bluefish|Developing Bluefish]] ==<br />
=== [[Bugs - Using the Debugger|Debugging Bluefish]] ===<br />
[[Bugs - Using the Debugger#1. Using the Debugger|1. Using the Debugger]] ¤ [[Bugs - Filing a Report|2. Filling a bug report]]<br />
=== [[Editor Tab Options|Reference]] === <br />
[[Editor Tab Options#1. Options in the Editor Tab|1. Options in the Editor Tab]] ¤ [[HTML Tab Options|2. Options in the HTML Tab]] ¤ [[Files Tab Options|3. Options in the Files Tab]] ¤ [[User Interface Tab Options|4. Options in the User interface Tab]] ¤ [[Images Tab Options|5. Options in the Images Tab]]<br />
=== [[Development - Indenting and Formatting|Development guidelines]] ===<br />
Indenting and formating style<br /><br />
[[Development - Naming|2. Naming]] ¤ [[Development - Declaring Procedures|3. Declaring procedures]] ¤ [[Development - Header Files|4. Header files]] ¤ [[Development - New Files|5. New files]] ¤ [[Development - File Reference|6. File reference]] ¤ [[Development - Patches|7. Patches]]<br /><br />
[[Development - Translations|8. Translations]] ¤ Introduction ¤ PO files basics ¤ <br />
Shortcut keys ¤ How to contribute<br /><br />
[[Development - Some tips|9. Some tips]] ¤ [[Development - Making Releases|10. Making releases]] ¤ [[Development - Useful Stuff|11. Useful stuff]]<br />
<br />
== [[Table of Contents (2/3)|'''Table of Contents (2/3)''']] ==<br />
<br />
{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| &nbsp;<br />
| <center>[[Man 2 index|Home]]</center><br />
| <div align="right">&nbsp;</div><br />
|}<br />
<br />
[[Category:Manual 2]]</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Launching_Bluefish&diff=2887Launching Bluefish2022-12-22T16:38:01Z<p>DrMartinus: Improved the first section and added the Command Line Options section, so there is no need for another page.</p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=d<br />
|Title=Chapter&nbsp;III.&nbsp;Starting Bluefish<br />
|prev=Man 2 pt02<br />
|Subtitle=Part&nbsp;2.&nbsp;Using Bluefish<br />
|next=Man 2 ch03s02<br />
}}<br />
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;"><br />
*[[#1. Launching Bluefish|1. Launching Bluefish]] <br />
*[[Man 2 ch03s02|2. Command line options]] <br />
</div><br />
<br />
== 1. Launching Bluefish ==<br />
In GNOME, Bluefish can be started from the Applications/Programming menu. From a terminal, simply launch bluefish using the command <tt>'''bluefish'''</tt>.<br />
<br />
{{note|text=In GNOME, bluefish is launched conforming to the system language. If you want to launch it with another language, first rename the directory $HOME/.bluefish to $HOME/.bluefish-xx, where xx is the previous language. This way you will retrieve your previous settings easily. Then use this command in a terminal: <br/><tt>'''export LANGUAGE=fr_FR; export LANG=fr_FR; export LC_ALL=fr_FR; bluefish &'''</tt><br/> if you use a bash-like shell.}}<br />
<br />
Then use this command in a terminal: <tt>'''export LANGUAGE=fr_FR; export LANG=fr_FR; export LC_ALL=fr_FR; bluefish &'''</tt> if you use a bash-like shell.<br />
<br />
== 2. Command Line Options ==<br />
There are several useful command line options:<br /><br />
<tt>'''$''' man bluefish</tt> show a list of possible commands.<br />
<br />
;-c, --curwindow<br />
:Open a file in an existing window. This can be used to overwrite the chosen default.<br />
<br />
;-n, --newwindow<br />
:Open a file in a new window. This can be used to overwrite the chosen default.<br />
<br />
;-?, --help, --help-*, --help-all<br />
:Print all or just a group of help options. Some of these options may be documented in gtk-options(7) and gnome-options(7).<br />
<br />
:;--help-gtk<br />
:GTK+ Options<br />
:: --class=CLASS Program class as used by the window manager<br />
:: --name=NAME Program name as used by the window manager<br />
:: --display=DISPLAY X display to use<br />
:: --screen=SCREEN X screen to use<br />
:: --sync Make X calls synchronous<br />
:: --gtk-module=MODULES Load additional GTK+ modules<br />
:: --g-fatal-warnings Make all warnings fatal<br />
<br />
:;--help-gnome<br />
:: todo<br />
<br />
<br />
;-v, --Version<br />
:Print version information.<br />
<br />
<br />
Many programs like browsers, email clients and file managers can be configured to open files in Bluefish. For example, '''bluefish '%s'''' will open a file in the current window, '''bluefish -n '%s'''' will open a file in a new window.<br />
<br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 pt02<br />
|up=Man 2 pt02<br />
|next=Man 2 ch03s02<br />
|prevname= Part&nbsp;2.&nbsp;Using Bluefish<br />
|nextname=2.&nbsp;Command line options<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Manual_2_ToC&diff=2886Manual 2 ToC2022-12-22T16:28:01Z<p>DrMartinus: Removed the "7." before the last entry in the second chapter</p>
<hr />
<div>{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| <center>'''Bluefish: The Definitive Guide'''</center><br />
|}<br />
<div style="text-align:center"><br />
'''Table of Contents <small>(part 1)</small>'''<br />
</div><br />
{{toc}} <br />
{|<br />
|see also: <br />
|[[Notes for Bluefish 2 Manual]]<br />
|-<br />
|<br />
|[[Guidelines for Writing this Manual]]<br />
|}<br />
<br />
{{Note|text=Note that the manual is currently being reworked. Many pages are outdated, others not yet available. They will be made available in the near future.}}<br />
<br />
Here an overview of what has been done so far:<br />
{|class="wikitable" style="margin:auto"<br />
!As per<br />
!What has been done<br />
|-<br />
|2022-12-21<br />
|All unnumbered sections under ''Preface'' and ''Getting and Installing Bluefish'' have been updated<br />
|}<br />
<br />
'''Bluefish 2.2 Manual''' <br />
<br />
== [[Preface|Preface]] ==<br />
*[[About this Manual]]<br />
*[[What is Bluefish?]]<br />
*[[History of Bluefish]]<br />
*[[Main Features of Bluefish]]<br />
*[[How Stable is Bluefish?]]<br />
*[[Contact Us]]<br />
== [[Getting and Installing Bluefish|Getting and Installing Bluefish]] ==<br />
*[[Operating Systems Supported by Bluefish]]<br />
*[[Man 2 ch02#1. Requirements|Requirements]]<br />
*[[Choosing a Version]]<br />
*[[Latest Stable Version|Latest Stable Version]]<br />
*[[Getting Bluefish - Latest Snapshot|Latest Snapshot Version]]<br />
*[[Getting Bluefish - Latest Development Version|Latest Developmental Version]]<br />
*[[How and When Updates are Released]]<br />
*[[Installing Bluefish]]<br />
*[[Installing Bluefish - System Issues| System Specific Installation Issues]]<br />
*[[Installing Bluefish - Install from Source Code|Installing a Bluefish Source Distribution]]<br />
*[[Compiling Bluefish from source]] <br />
*[[Installing Bluefish - Install from Source Code Options|Configure Options]]<br />
*[[Installing Bluefish - Install from Binary Distribution|Installing a Binary Distribution]]<br />
*[[Installing Bluefish - Post-Installation Checklist|Post-installation Setup]]<br /><br />
<br />
<br />
== [[Using Bluefish|Using Bluefish]] ==<br />
=== [[Launching Bluefish|Starting Bluefish]] ===<br />
[[Launching Bluefish#1. Launching Bluefish|1. Launching Bluefish]] ¤ [[Command line options|2. Command line options]]<br />
=== [[Editing Area|The user interface]] ===<br />
[[Editing Area#1. Editing Area|1. Editing Area]] ¤ [[Menus and Tool Bars|2. Menus and Tool Bars]] ¤ [[Side Panel|3. Side Panel]] ¤ [[Interface - Status Bar|4. Status Bar]] ¤ [[Interface - Help Menu|5. Help Menu]]<br />
=== [[Preferences|Preferences]] === <br />
=== [[Creating Files|Working with files and folders]] ===<br />
[[Creating Files#1. Creating files|1. Creating files]] ¤ [[Managing Directories|2. Managing directories]] ¤ [[Opening Files|3. Opening files]] ¤ [[Saving Files|4. Saving files]] ¤ [[Renaming Files|5. Renaming files]] ¤ [[Deleting files|6. Deleting files]] ¤ [[Closing Files|7. Closing files]] ¤ [[Inserting files|8. Inserting files]]<br /><br />
[[Editing|9. Editing]] ¤ Undo and Redo ¤ Cut, Copy, and Paste ¤ Input methods<br /><br />
[[Basic Find and Replace|10. Basic Find and Replace]] ¤ Searching for a word within a whole document ¤ Setting limits to the search scope ¤ Case sensitive search ¤ Overlapping searches ¤ Retrieving previous search strings ¤ More on find ¤ Replacing features ¤ Retrieving previous replace strings ¤ Changing letter case when replacing ¤ Choosing strings to replace ¤ More on replace<br /><br />
[[File Types (1/2)|11. File types]] ¤ Syntax highlighting<br /><br />
[[File Types (2/2)|12. More on files]] ¤ Remote files ¤ Character encoding ¤ Open advanced<br />
=== [[Navigating through a document|Navigation and Managing documents]] === <br />
Navigating through a document<br /><br />
[[Go Menu and Document Navigation|2. Navigating through many documents]] ¤ [[Projects|3. Projects]]<br /><br />
[[Bookmarks|4. Bookmarks]] ¤ Generating several bookmarks at once]]<br /><br />
[[Find and Replace|5. Find and Replace]] ¤ Find Again ¤ Find from Selection ¤ Find and Replace Using Regular Expressions<br /><br />
[[Templates| Templates]]<br />
=== [[Indenting|More than a Text Editor]] === <br />
[[Indenting#1. Indenting|1. Indenting]] ¤ [[Autocompletion|2. Autocompletion]] ¤ [[Hidden features]] ¤ [[Spell checker|3. Spell checker]] ¤ [[Programming and Markup Languages Function Reference|4. Function reference]]<br /><br />
[[HTML Editing|5. HTML]] ¤ Special find and replace features ¤ Thumbnail generation<br /><br />
[[Quick Bar Customization|6. Customizing the Quick bar]]<br /><br />
[[Snippets plugin|7. Snippets plugin]] (was Custom menu in Bluefish 1) ¤ Adding a snippet dialog ¤ Adding a snippet replace dialog<br /><br />
[[External Programs and Filters|8. External programs, filters]] ¤ Customizing browsers ¤ Customizing Commands menu ¤ Customizing Ouputbox menu<br />
<br />
=== [[Modifying shortcut keys|Customising Bluefish]] === <br />
Modifying shortcut keys<br /><br />
[[Invisible Files and Folders|2. Showing hidden files and folders]] ¤ [[Showing backup files|3. Showing backup files]] ¤ [[Editor Appearance Customization|4. Editor appearance]] ¤ [[Bookmarks Path Customization|5. Customizing the bookmarks path]] ¤ [[HTML Tags Style Customization|6. Customizing the html tags style]] ¤ [[Author Meta Tag|7. Changing the author meta tag on the fly]]<br /><br />
[[File Handling and Browsing Customization|8. Customizing files handling and browsing]] ¤ Setting the encoding meta tag on save ¤ Setting the default base directory ¤ Merging file browser views ¤ 8.4. Backup files ¤ 8.5. Using multiple instances of a file<br /><br />
[[User Interface Customization|9. Customizing the user interface]] ¤ [[File Types Handling|10. Modifying file types]] ¤ [[File Filters|11. Modifying the files filters]] ¤ [[Highlight Patterns Modification|12. Modifying the highlighting patterns]]<br />
*[[General Shortcuts|IX. Shortcuts available within Bluefish]] ¤ [[General Shortcuts#1. General Shortcuts|1. General Shortcuts]] ¤ [[HTML Shortcuts|2. HTML Shortcuts]]<br />
<br />
== [[Developing Bluefish|Developing Bluefish]] ==<br />
=== [[Bugs - Using the Debugger|Debugging Bluefish]] ===<br />
[[Bugs - Using the Debugger#1. Using the Debugger|1. Using the Debugger]] ¤ [[Bugs - Filing a Report|2. Filling a bug report]]<br />
=== [[Editor Tab Options|Reference]] === <br />
[[Editor Tab Options#1. Options in the Editor Tab|1. Options in the Editor Tab]] ¤ [[HTML Tab Options|2. Options in the HTML Tab]] ¤ [[Files Tab Options|3. Options in the Files Tab]] ¤ [[User Interface Tab Options|4. Options in the User interface Tab]] ¤ [[Images Tab Options|5. Options in the Images Tab]]<br />
=== [[Development - Indenting and Formatting|Development guidelines]] ===<br />
Indenting and formating style<br /><br />
[[Development - Naming|2. Naming]] ¤ [[Development - Declaring Procedures|3. Declaring procedures]] ¤ [[Development - Header Files|4. Header files]] ¤ [[Development - New Files|5. New files]] ¤ [[Development - File Reference|6. File reference]] ¤ [[Development - Patches|7. Patches]]<br /><br />
[[Development - Translations|8. Translations]] ¤ Introduction ¤ PO files basics ¤ <br />
Shortcut keys ¤ How to contribute<br /><br />
[[Development - Some tips|9. Some tips]] ¤ [[Development - Making Releases|10. Making releases]] ¤ [[Development - Useful Stuff|11. Useful stuff]]<br />
<br />
== [[Table of Contents (2/3)|'''Table of Contents (2/3)''']] ==<br />
<br />
{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| &nbsp;<br />
| <center>[[Man 2 index|Home]]</center><br />
| <div align="right">&nbsp;</div><br />
|}<br />
<br />
[[Category:Manual 2]]</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Manual_2_ToC&diff=2885Manual 2 ToC2022-12-22T16:27:12Z<p>DrMartinus: Moved the last sections within "Getting and Installing Bluefish" to the list of updated sections</p>
<hr />
<div>{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| <center>'''Bluefish: The Definitive Guide'''</center><br />
|}<br />
<div style="text-align:center"><br />
'''Table of Contents <small>(part 1)</small>'''<br />
</div><br />
{{toc}} <br />
{|<br />
|see also: <br />
|[[Notes for Bluefish 2 Manual]]<br />
|-<br />
|<br />
|[[Guidelines for Writing this Manual]]<br />
|}<br />
<br />
{{Note|text=Note that the manual is currently being reworked. Many pages are outdated, others not yet available. They will be made available in the near future.}}<br />
<br />
Here an overview of what has been done so far:<br />
{|class="wikitable" style="margin:auto"<br />
!As per<br />
!What has been done<br />
|-<br />
|2022-12-21<br />
|All unnumbered sections under ''Preface'' and ''Getting and Installing Bluefish'' have been updated<br />
|}<br />
<br />
'''Bluefish 2.2 Manual''' <br />
<br />
== [[Preface|Preface]] ==<br />
*[[About this Manual]]<br />
*[[What is Bluefish?]]<br />
*[[History of Bluefish]]<br />
*[[Main Features of Bluefish]]<br />
*[[How Stable is Bluefish?]]<br />
*[[Contact Us]]<br />
== [[Getting and Installing Bluefish|Getting and Installing Bluefish]] ==<br />
*[[Operating Systems Supported by Bluefish]]<br />
*[[Man 2 ch02#1. Requirements|Requirements]]<br />
*[[Choosing a Version]]<br />
*[[Latest Stable Version|Latest Stable Version]]<br />
*[[Getting Bluefish - Latest Snapshot|Latest Snapshot Version]]<br />
*[[Getting Bluefish - Latest Development Version|Latest Developmental Version]]<br />
*[[How and When Updates are Released]]<br />
*[[Installing Bluefish]]<br />
*[[Installing Bluefish - System Issues| System Specific Installation Issues]]<br />
*[[Installing Bluefish - Install from Source Code|Installing a Bluefish Source Distribution]]<br />
*[[Compiling Bluefish from source]] <br />
*[[Installing Bluefish - Install from Source Code Options|Configure Options]]<br />
*[[Installing Bluefish - Install from Binary Distribution|Installing a Binary Distribution]]<br />
*[[Installing Bluefish - Post-Installation Checklist|7. Post-installation Setup]]<br /><br />
<br />
<br />
== [[Using Bluefish|Using Bluefish]] ==<br />
=== [[Launching Bluefish|Starting Bluefish]] ===<br />
[[Launching Bluefish#1. Launching Bluefish|1. Launching Bluefish]] ¤ [[Command line options|2. Command line options]]<br />
=== [[Editing Area|The user interface]] ===<br />
[[Editing Area#1. Editing Area|1. Editing Area]] ¤ [[Menus and Tool Bars|2. Menus and Tool Bars]] ¤ [[Side Panel|3. Side Panel]] ¤ [[Interface - Status Bar|4. Status Bar]] ¤ [[Interface - Help Menu|5. Help Menu]]<br />
=== [[Preferences|Preferences]] === <br />
=== [[Creating Files|Working with files and folders]] ===<br />
[[Creating Files#1. Creating files|1. Creating files]] ¤ [[Managing Directories|2. Managing directories]] ¤ [[Opening Files|3. Opening files]] ¤ [[Saving Files|4. Saving files]] ¤ [[Renaming Files|5. Renaming files]] ¤ [[Deleting files|6. Deleting files]] ¤ [[Closing Files|7. Closing files]] ¤ [[Inserting files|8. Inserting files]]<br /><br />
[[Editing|9. Editing]] ¤ Undo and Redo ¤ Cut, Copy, and Paste ¤ Input methods<br /><br />
[[Basic Find and Replace|10. Basic Find and Replace]] ¤ Searching for a word within a whole document ¤ Setting limits to the search scope ¤ Case sensitive search ¤ Overlapping searches ¤ Retrieving previous search strings ¤ More on find ¤ Replacing features ¤ Retrieving previous replace strings ¤ Changing letter case when replacing ¤ Choosing strings to replace ¤ More on replace<br /><br />
[[File Types (1/2)|11. File types]] ¤ Syntax highlighting<br /><br />
[[File Types (2/2)|12. More on files]] ¤ Remote files ¤ Character encoding ¤ Open advanced<br />
=== [[Navigating through a document|Navigation and Managing documents]] === <br />
Navigating through a document<br /><br />
[[Go Menu and Document Navigation|2. Navigating through many documents]] ¤ [[Projects|3. Projects]]<br /><br />
[[Bookmarks|4. Bookmarks]] ¤ Generating several bookmarks at once]]<br /><br />
[[Find and Replace|5. Find and Replace]] ¤ Find Again ¤ Find from Selection ¤ Find and Replace Using Regular Expressions<br /><br />
[[Templates| Templates]]<br />
=== [[Indenting|More than a Text Editor]] === <br />
[[Indenting#1. Indenting|1. Indenting]] ¤ [[Autocompletion|2. Autocompletion]] ¤ [[Hidden features]] ¤ [[Spell checker|3. Spell checker]] ¤ [[Programming and Markup Languages Function Reference|4. Function reference]]<br /><br />
[[HTML Editing|5. HTML]] ¤ Special find and replace features ¤ Thumbnail generation<br /><br />
[[Quick Bar Customization|6. Customizing the Quick bar]]<br /><br />
[[Snippets plugin|7. Snippets plugin]] (was Custom menu in Bluefish 1) ¤ Adding a snippet dialog ¤ Adding a snippet replace dialog<br /><br />
[[External Programs and Filters|8. External programs, filters]] ¤ Customizing browsers ¤ Customizing Commands menu ¤ Customizing Ouputbox menu<br />
<br />
=== [[Modifying shortcut keys|Customising Bluefish]] === <br />
Modifying shortcut keys<br /><br />
[[Invisible Files and Folders|2. Showing hidden files and folders]] ¤ [[Showing backup files|3. Showing backup files]] ¤ [[Editor Appearance Customization|4. Editor appearance]] ¤ [[Bookmarks Path Customization|5. Customizing the bookmarks path]] ¤ [[HTML Tags Style Customization|6. Customizing the html tags style]] ¤ [[Author Meta Tag|7. Changing the author meta tag on the fly]]<br /><br />
[[File Handling and Browsing Customization|8. Customizing files handling and browsing]] ¤ Setting the encoding meta tag on save ¤ Setting the default base directory ¤ Merging file browser views ¤ 8.4. Backup files ¤ 8.5. Using multiple instances of a file<br /><br />
[[User Interface Customization|9. Customizing the user interface]] ¤ [[File Types Handling|10. Modifying file types]] ¤ [[File Filters|11. Modifying the files filters]] ¤ [[Highlight Patterns Modification|12. Modifying the highlighting patterns]]<br />
*[[General Shortcuts|IX. Shortcuts available within Bluefish]] ¤ [[General Shortcuts#1. General Shortcuts|1. General Shortcuts]] ¤ [[HTML Shortcuts|2. HTML Shortcuts]]<br />
<br />
== [[Developing Bluefish|Developing Bluefish]] ==<br />
=== [[Bugs - Using the Debugger|Debugging Bluefish]] ===<br />
[[Bugs - Using the Debugger#1. Using the Debugger|1. Using the Debugger]] ¤ [[Bugs - Filing a Report|2. Filling a bug report]]<br />
=== [[Editor Tab Options|Reference]] === <br />
[[Editor Tab Options#1. Options in the Editor Tab|1. Options in the Editor Tab]] ¤ [[HTML Tab Options|2. Options in the HTML Tab]] ¤ [[Files Tab Options|3. Options in the Files Tab]] ¤ [[User Interface Tab Options|4. Options in the User interface Tab]] ¤ [[Images Tab Options|5. Options in the Images Tab]]<br />
=== [[Development - Indenting and Formatting|Development guidelines]] ===<br />
Indenting and formating style<br /><br />
[[Development - Naming|2. Naming]] ¤ [[Development - Declaring Procedures|3. Declaring procedures]] ¤ [[Development - Header Files|4. Header files]] ¤ [[Development - New Files|5. New files]] ¤ [[Development - File Reference|6. File reference]] ¤ [[Development - Patches|7. Patches]]<br /><br />
[[Development - Translations|8. Translations]] ¤ Introduction ¤ PO files basics ¤ <br />
Shortcut keys ¤ How to contribute<br /><br />
[[Development - Some tips|9. Some tips]] ¤ [[Development - Making Releases|10. Making releases]] ¤ [[Development - Useful Stuff|11. Useful stuff]]<br />
<br />
== [[Table of Contents (2/3)|'''Table of Contents (2/3)''']] ==<br />
<br />
{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| &nbsp;<br />
| <center>[[Man 2 index|Home]]</center><br />
| <div align="right">&nbsp;</div><br />
|}<br />
<br />
[[Category:Manual 2]]</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Installing_Bluefish_-_Post-Installation_Checklist&diff=2884Installing Bluefish - Post-Installation Checklist2022-12-22T16:25:04Z<p>DrMartinus: Removed outdated information and edited some wording</p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=d<br />
|Title=7.&nbsp;Post-installation Setup<br />
|prev=Man 2 ch02s06<br />
|Subtitle=Chapter&nbsp;II.&nbsp;Installing Bluefish<br />
|next=Man 2 pt02<br />
}}<br />
<br />
The first time you run Bluefish it will create a directory ~/.bluefish where all Bluefish's configuration options are stored. This includes all preferences, customized menus, highlighting-patterns, file history, etc.<br />
<br />
Bluefish will work right out of the box, but you can and should take advantage of the many customizations available. Change the font in the main text view if you do not like the one which is offered by default, remove unused tool bars, add or edit snippets and edit the list of browsers and external programs.<br />
<br />
If you are upgrading from a previous version, perhaps using the SVN, you should note that certain features may have changed. Please let us know if you encounter any difficulties.<br />
<br />
If your settings become corrupted, unusable, or you simply want to revert to the defaults, you may safely delete the ~/.bluefish directory.<br />
<br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 ch02s06<br />
|up=Man 2 ch02<br />
|next=Man 2 pt02<br />
|prevname= 6.&nbsp;Installing a Binary Distribution<br />
|nextname=Part&nbsp;2.&nbsp;Using Bluefish<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Installing_Bluefish_-_Install_from_Binary_Distribution&diff=2883Installing Bluefish - Install from Binary Distribution2022-12-22T16:19:52Z<p>DrMartinus: removed outdated information and linked to the relevant sources.</p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=d<br />
|Title=6.&nbsp;Installing a Binary Distribution<br />
|prev=Man 2 ch02s05<br />
|Subtitle=Chapter&nbsp;II.&nbsp;Installing Bluefish<br />
|next=Man 2 ch02s07<br />
}}<br />
<br />
Different packages -- different installation.<br />
<br />
Actually, Bluefish {{Version}} has been integrated into many repositories of various Linux distributions, as it has proven to be a reliable programming editor. Besides, there are installation packages available for Windows and MacOS as well. If you have problems, you find info on the [https://bluefish.openoffice.nl/index.html project page] as well as in this [[Installing Bluefish|wiki]]. <br />
<br />
If all that doesn't help, then please [[Contact Us|contact us]]!<br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 ch02s05<br />
|up=Man 2 ch02<br />
|next=Man 2 ch02s07<br />
|prevname= 5.&nbsp;Configure Options<br />
|nextname=7.&nbsp;Post-installation Setup<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=What_is_Bluefish%3F&diff=2882What is Bluefish?2022-12-22T16:12:09Z<p>DrMartinus: Removed the parts which were outdated and moved that to individual pages</p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=d<br />
|Title=2.&nbsp;What is Bluefish?<br />
|prev=Man 2 pr01<br />
|Subtitle=Preface<br />
|next=Man 2 pt01<br />
}}<br />
<br />
Bluefish is a powerful editor for experienced web designers and programmers based on the GTK2 GUI interface. Bluefish supports many programming and markup languages, but focuses on editing dynamic and interactive websites.<br />
<br />
Bluefish is not a WYSIWYG<ref>What You See Is What You Get</ref> text editor. This is deliberate, allowing the programmer to stay in full control. To facilitate the editing process, a large number of features are at your disposal. For inserting markup and code, there are tool bars, dialogs, and predefined/user-customized menus. Syntax highlighting, advanced search/replace functionality, scalability and language function references make Bluefish a powerful tool for development.<br />
<br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 pr01<br />
|up=Man 2 pr01<br />
|next=Man 2 pt01<br />
|prevname= Preface<br />
|nextname=Part&nbsp;1.&nbsp;Getting and Installing Bluefish<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Contact_Us&diff=2881Contact Us2022-12-22T16:08:39Z<p>DrMartinus: updated links to contacts, mailing lists etc.</p>
<hr />
<div>== 2.4. Contact Us ==<br />
We, the Bluefish development team, welcome all comments, user requests, constructive criticisms, and contributions. Are you curious or seeking information regarding Bluefish? Would you like to contribute by translating Bluefish or its manual? Here are your options:<br />
<br />
* [http://bluefish.openoffice.nl/ http://bluefish.openoffice.nl/] - The main website where you will find news, updates, manual and more information.<br />
* [http://bfwiki.tellefsen.net/ http://bfwiki.tellefsen.net/] - The Bluefish WiKi is the notebook for the developers, containing a lot of information. This includes, but is not limited to: updated project road maps, status of translations. It also contains the manual for this software.<br />
* For bug reports and feature requests, related to bluefish, its web site, and its manual, please fill the appropriate bug type at [https://sourceforge.net/p/bluefish/tickets/ https://sourceforge.net/p/bluefish/tickets/], the bluefish bugzilla page - for instructions, see [[ch10s02|Section 2, “Filling a bug report”]].<br />
* You can subscribe to the users' Bluefish mailing list by visiting [https://sourceforge.net/projects/bluefish/lists/bluefish-community this web page]. The mailing list is hosted by sourceforge.<br />
* You can subscribe to the developers' Bluefish mailing list by [https://sourceforge.net/projects/bluefish/lists/bluefish-svn visiting this web page]. The mailing list is hosted by sourceforge.<br />
* Do you want to help translate Bluefish? Please let us know by dropping an email to <del>Walter Echarri [mailto:wecharri(at)arnet.com.ar wecharri(at)arnet.com.ar]</del>, our friendly translation maintainer.<br />
* If you want to help improve the manual or write new sections, please send an email to the Bluefish manual maintainer, Martin S. [mailto:linux (at) drmartinus (dot) de linux (at) drmartinus (dot) de]. Make sure you replace the words in parentheses with the appropriate signs and remove all spaces. Guidelines for this manual can be found in [[Man 2 apc|Appendix C, Guidelines for Writing this Manual]]<br />
* If you have a general question, drop an email to [mailto:bluefish(at)bluefish.openoffice.nl bluefish(at)bluefish.openoffice.nl].</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Installing_Bluefish_-_Install_from_Source_Code_Options&diff=2880Installing Bluefish - Install from Source Code Options2022-12-22T16:02:50Z<p>DrMartinus: </p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=d<br />
|Title=5.&nbsp;Configure Options<br />
|prev=Man 2 ch02s04<br />
|Subtitle=Chapter&nbsp;II.&nbsp;Installing Bluefish<br />
|next=Man 2 ch02s06<br />
}}<br />
{{toc}}<br />
This section describes all the configure options available for bluefish.<br />
{{note|text=This page has not been checked if it's uptodate. It is likely that all options are still being used. To test all, would take a lot of time. In case you encounter any problem with the options listed here, please contact us on the developers mailing list or via the [https://sourceforge.net/p/bluefish/tickets/ ticket system].}}<br />
<br />
== 5.1. Standard configuration flags ==<br />
'''Configuration:'''<br />
*<tt>-h--help</tt> <br />
display this help and exit<br />
*<tt>--help=short</tt> <br />
display options specific to this package<br />
*<tt>--help=recursive</tt> <br />
display the short help of all the included packages<br />
*<tt>-V--version</tt> <br />
display version information and exit<br />
*<tt>-q--quiet--silent</tt> <br />
do not print "checking..." messages<br />
*<tt>--cache-file=FILE</tt> <br />
<nowiki>cache test results in FILE [disabled by default]</nowiki><br />
*<tt>-C--config-cache</tt> <br />
alias for <tt>--cache-file=config.cache</tt><br />
*<tt>-n--no-create</tt> <br />
do not create output files<br />
*<tt>--srcdir=DIR</tt> <br />
<nowiki>find the sources in DIR [configure dir or </nowiki>.. by default]<br />
<br />
'''Installation directories:'''<br />
<br />
{{tip|text=By default, '''make install''' will install all the files in /usr/local/bin, /usr/local/lib, etc. You can specify an installation prefix other than /usr/local using <tt>--prefix</tt>, for instance <tt>--prefix=$HOME</tt>}}.<br />
*<tt>--prefix=PREFIX</tt> <br />
<nowiki>install architecture-independent files in PREFIX [</nowiki>/usr/local by default]<br />
*<tt>--exec-prefix=EPREFIX</tt> <br />
<nowiki>install architecture-dependent files in EPREFIX [</nowiki>PREFIX by default]<br />
<br />
'''Fine tuning of the installation directories:'''<br />
<br />
{{tip|text=For better control, use the options below. Defaults are shown within brackets.}}<br />
<br />
*<tt>--bindir=DIR</tt> <br />
<nowiki>user executables [</nowiki>EPREFIX/bin]<br />
*<tt>--sbindir=DIR</tt> <br />
<nowiki>system admin executables [</nowiki>EPREFIX/sbin]<br />
*<tt>--libexecdir=DIR</tt> <br />
<nowiki>program executables [[Man 2 </nowiki>EPREFIX/libexec]]<br />
*<tt>--datadir=DIR</tt> <br />
<nowiki>read-only architecture-independent data [</nowiki>PREFIX/share]<br />
*<tt>--sysconfdir=DIR</tt> <br />
<nowiki>read-only single-machine data [</nowiki>PREFIX/etc]<br />
*<tt>--sharedstatedir=DIR</tt> <br />
<nowiki>modifiable architecture-independent data [</nowiki>PREFIX/com]<br />
*<tt>--localstatedir=DIR</tt> <br />
<nowiki>modifiable single-machine data [</nowiki>PREFIX/var]<br />
*<tt>--libdir=DIR</tt> <br />
<nowiki>object code libraries [[Man 2 </nowiki>EPREFIX/lib]]<br />
*<tt>--includedir=DIR</tt> <br />
<nowiki>C header files [[Man 2 </nowiki>PREFIX/include]]<br />
*<tt>--oldincludedir=DIR</tt> <br />
<nowiki>C header files for non-gcc [</nowiki>/usr/include]<br />
*<tt>--infodir=DIR</tt> <br />
<nowiki>info documentation [</nowiki>PREFIX/info]<br />
*<tt>--mandir=DIR</tt> <br />
<nowiki>man documentation [</nowiki>PREFIX/man]<br />
<br />
'''Program names:'''<br />
*<tt>--program-prefix=PREFIX</tt> <br />
prepend PREFIX to installed program names<br />
*<tt>--program-suffix=SUFFIX</tt> <br />
append SUFFIX to installed program names<br />
*<tt>--program-transform-name=PROGRAM</tt> <br />
run sed PROGRAM on installed program names<br />
<br />
'''System types:'''<br />
*<tt>--build=BUILD</tt> <br />
<nowiki>configure for building on BUILD [guessed]</nowiki><br />
*<tt>--host=HOST</tt> <br />
<nowiki>cross-compile to build programs to run on HOST [BUILD]</nowiki><br />
<br />
'''Some influential environment variables:'''<br />
<br />
<br />
[[File:Man2_tip.png]] Use these variables to override the choices made by '''configure''' or to help it to find libraries and programs with nonstandard names/locations.<br />
<br />
*<tt>CC</tt> <br />
C compiler command<br />
*<tt>CFLAGS</tt> <br />
C compiler flags<br />
*<tt>LDFLAGS</tt> <br />
<nowiki>linker flags, e.g. -L<lib dir> if you have libraries in a nonstandard directory <lib dir></nowiki><br />
*<tt>CPPFLAGS</tt> <br />
<nowiki>C/C++ preprocessor flags, e.g. -I<include dir> if you have headers in a nonstandard directory <include dir></nowiki><br />
*<tt>CPP</tt> <br />
C preprocessor<br />
<br />
== 5.2. Flags personal to bluefish ==<br />
'''Optional Features:'''<br />
<br />
<br />
{{note|text=These work like this: <tt>--enable-feature</tt> enables the feature, <tt>--disable-feature</tt> or <tt>--enable-feature=no</tt> disables the feature.}}<br />
<br />
By default, the <tt>--enable-feature</tt> option is not enabled, you should pass it if you want to get it, the <tt>--disable-xxx</tt> option is not disabled, you should pass it if you want to disable it.<br />
<br />
*<tt>--enable-auto-optimization</tt> <br />
Optimizes the build process for a given architecture if possible. It works only on a selected set of x86 platforms.<br />
<br />
How: rely on the result of:<br />
<br />
# '''uname -p''' or '''grep "model name" /proc/cpuinfo | cut -d: -f2''' to detect the architecture<br />
# the version of gcc to pass the arguments<br />
<br />
Tested gcc versions: 3.2.*, 3.0.*, 2.95.*<br />
<br />
Machines: Intel(R) Pentium(R) 4CPU, Pentium III, AMD-K6 (tm) 3D, Pentium 75 - 200, Pentium II, AMD Athlon(TM) XP<br />
<br />
Other machines are ignored<br />
<br />
*<tt>--enable-gcc3-optimization=type</tt> <br />
optimizes the build process for a given architecture if possible<br />
<br />
Machines: i386, i486, pentium, pentium-mmx, pentiumpro, pentium2, pentium3, pentium4, k6, k6-2, k6-3, athlon, athlon-tbird, athlon-4, athlon-xp, athlon-mp, winchip-c6, winchip2, c3<br />
<br />
Other machines are ignored<br />
<br />
*<tt>--enable-gcc2-optimization=type</tt> <br />
optimizes the build process for a given architecture if possible<br />
<br />
Machines: i386, i486, pentium, pentiumpro, k6<br />
<br />
Other machines are ignored<br />
<br />
*<tt>--enable-debugging-output</tt> <br />
turns debugging output on (this option impacts performance)<br />
*<tt>--disable-splash-screen</tt> <br />
suppresses the display of the splash screen at launch time (Bluefish launches faster)<br />
*<tt>--enable-highlight-profiling</tt> <br />
outputs statistics on where the program spends most of its time when highlighting patterns<br />
<br />
Usage: for debugging highlight patterns or trying to optimize the program<br />
*<tt>--enable-development</tt> <br />
enables development checks (slows down the program)<br />
*<tt>--enable-gprof-profiling</tt> <br />
outputs statistics on where the program spends most of its time by generating extra code to write profile information suitable for the analysis (slows down the program)<br />
*<tt>--enable-gcoc-coverage</tt> <br />
Purpose: to be able to collect statistics on how many times each branch is executed and how long it has lasted. Creates data files for the gcov code-coverage utility (slows down the program)<br />
*<tt>--disable-update-databases</tt> <br />
do not run the update-desktop-database or update-mime-database utilities after installation (mostly useful for package maintainers)<br />
*<tt>--disable-nls</tt> <br />
disables the Native Language Support (might speed up the program)<br />
<br />
'''Optional Packages:'''<br />
<br />
<br />
{{note|text=These work like this: <tt>--with-xxx=foo</tt> enables the flag, <tt>--without-xxx</tt> disables it. When not enabled, the default is used.}}<br />
*<tt>--without-libgnomeui</tt> <br />
disable libgnomeui detection<br />
*<tt>--with-gnome1-menu</tt> <br />
customized path for the gnome1 menu (disabled by default)<br />
<br />
Usage: <tt>--with-gnome1-menu=customizedpath</tt> or <tt>--without-gnome1-menu</tt> <br />
disabled by default<br />
*<tt>--with-freedesktop_org-menu</tt> <br />
customized path for the freedesktop.org (gnome and kde) menu<br />
<br />
Usage: <tt>--with-freedesktop_org-menu=customizedpath</tt> or <tt>--without-freedesktop_org-menu</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/applications<br />
* PREFIX/share/applications<br />
* /usr/X11R6/share/gnome/applications<br />
* PREFIX/share/gnome/applications<br />
<br />
*<tt>--with-freedesktop_org-mime</tt> <br />
customized path for the freedesktop.org (gnome and kde) mime<br />
<br />
Usage: <tt>--with-freedesktop_org-mime=customizedpath</tt> or <tt>--without-freedesktop_org-mime</tt> <br />
<br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/mime<br />
* PREFIX/share/mime<br />
* /usr/X11R6/share/gnome/mime<br />
* PREFIX/share/gnome/mime<br />
<br />
*<tt>--with-gnome2_4-mime</tt> <br />
customized path for the gnome 2.4 mime<br />
<br />
Usage: <tt>--with-gnome2_4-mime=customizedpath</tt> or <tt>--without-gnome2_4-mime</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/mime-info<br />
* PREFIX/share/mime-info<br />
* /usr/X11R6/share/gnome/mime-info<br />
* PREFIX/share/gnome/mime-info<br />
<br />
*<tt>--with-gnome2_4-appreg</tt> <br />
customized path for the gnome 2.4 application registry<br />
<br />
Usage: <tt>--with-gnome2_4-appreg=customizedpath</tt> or <tt>--without-gnome2_4-appreg</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/application-registry<br />
* PREFIX/share/application-registry<br />
* /usr/X11R6/share/gnome/application-registry<br />
* PREFIX/share/gnome/application-registry<br />
<br />
*<tt>--with-icon-path</tt> <br />
customized path for the icon.<br />
<br />
Usage: <tt>--with-icon-path=customizedpath</tt> or <tt>--without-icon-path</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/pixmaps<br />
* PREFIX/share/pixmaps<br />
* /usr/X11R6/share/gnome/pixmaps<br />
* PREFIX/share/gnome/pixmaps<br />
<br />
*<tt>--with-libiconv-prefix</tt> <br />
customized path for libiconv top level installation.<br />
<br />
Usage: <tt>--with-libiconv-prefix=customizeddir</tt><br />
<br />
Effect: searches for libiconv in customizeddir/include and customizeddir/lib<br />
*<tt>--with-included-gettext</tt> <br />
<br />
use the GNU gettext library included in the package<br />
<br />
'''Features specific to the CVS version:'''<br />
*<tt>--enable-unstable-install</tt> <br />
enable the installation of a bluefish development version with independent directories and files. Use this for CVS snapshots<br />
*<tt>--enable-scanner</tt> <br />
use the BfTextView scanner for editor widget<br />
*<tt>--disable-python</tt> <br />
do not build the python plugin<br />
*<tt>--with-theme-path</tt> <br />
customized path for the theme icons.<br />
<br />
Usage: <tt>--with-theme-path=customizedpath</tt> or <tt>--without-theme-path</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/icons/hicolor<br />
* PREFIX/share/icons/hicolor<br />
* /usr/X11R6/share/gnome/icons/hicolor<br />
* PREFIX/share/gnome/icons/hicolor<br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 ch02s04<br />
|up=Man 2 ch02<br />
|next=Man 2 ch02s06<br />
|prevname= 4.&nbsp;Installing a Bluefish Source Distribution<br />
|nextname=6.&nbsp;Installing a Binary Distribution<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=File:Man2_warning.png&diff=2879File:Man2 warning.png2022-12-22T15:52:08Z<p>DrMartinus: DrMartinus uploaded a new version of File:Man2 warning.png</p>
<hr />
<div></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=File:Man2_warning.png&diff=2878File:Man2 warning.png2022-12-22T15:48:09Z<p>DrMartinus: DrMartinus uploaded a new version of File:Man2 warning.png</p>
<hr />
<div></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=File:Man2_important.png&diff=2877File:Man2 important.png2022-12-22T15:47:22Z<p>DrMartinus: DrMartinus reverted File:Man2 important.png to an old version</p>
<hr />
<div></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=File:Man2_important.png&diff=2876File:Man2 important.png2022-12-22T15:46:42Z<p>DrMartinus: DrMartinus uploaded a new version of File:Man2 important.png</p>
<hr />
<div></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Guidelines_for_Writing_this_Manual&diff=2875Guidelines for Writing this Manual2022-12-22T10:51:08Z<p>DrMartinus: /* Tips and Notes Templates */ Added the "Important" example</p>
<hr />
<div>{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=v<br />
|Title=Appendix&nbsp;C.&nbsp;Guidelines for Writing this Manual<br />
|prev=Man 2 apb<br />
|Subtitle=&nbsp;<br />
|next=Man 2 apd<br />
}}<br />
{{toc}}<br />
<br />
== create an account ==<br />
{{note|text=<br />
You are a bluefish user? You can help write the Bluefish 2 Manual!<br />
* first step: [[Special:UserLogin|create an account]],<br />
* second step: feel free to edit the manual,<br />
* third step: thanks for your help! :)}}<br />
<br style="clear:both"/><br />
<br />
== Using Bluefish 2 to edit Bluefish 2 Manual ==<br />
See: [[Bluefish mediawiki editor]]. [[Mediawiki snippets]] have snippets for Bluefish Manual: note, tip, important, warning, clear, framed image.<br />
<br />
== Templates ==<br />
=== Top and bottom menus ===<br />
Bluefish Wiki Manual use 2 templates for navigation: '''Man2top''' and '''Man2bottom'''.<br /><br />
'''They do not usually need to be edited'''. However, since their output was scrambled up, they are, for now, disabled.<br />
<br />
[[File:Man2 template editing.png|left|frame|Template:Man2top Template:Man2bottom]]<br />
Man2top and Man2bottom templates do not usually need to be edited.<br />
'''Exceptions''':<br />
{{note|text=When you read a page, and make any necessary corrections so that this page conforms to Bluefish version 2.2.12, <br />thank you for changing the status, from '''d''' (draft) to '''u''' (update).<br /> <br />
ie: <tt><nowiki>|</nowiki>st=d</tt> by <tt><nowiki>|</nowiki>st=u</tt>.}}<br />
{{tip|text=After a Bluefish version update, you have to modify the rev parameter.}}<br />
{{clear}}<br />
<br />
=== Tips and Notes Templates ===<br />
Bluefish Wiki Manual uses templates for:<br />
{|<br />
|align="center"|'''note''':<br />
|align="center"|'''tip''':<br />
|align="center"|'''important''':<br />
|align="center"|'''warning''':<br />
|-<br />
|align="bottom" width="150"|{{note|text=this is a note.}}<br />
|align="bottom" width="150"|{{tip|text=this is a tip.}}<br />
|align="bottom" width="170"|{{important|text=this is important!}}<br />
|align="bottom" width="150"|{{warning|text=this is a warning!}}<br />
|}<br />
<br />
==== examples ====<br />
{|border=1 cellpadding=5<br />
|<nowiki>{{note|</nowiki>text=mytext here, use <nowiki><br /></nowiki> to break lines.<nowiki>}}</nowiki><br />
|{{note|text=mytext here, use <nowiki><br /></nowiki><br />to break lines.}}<br />
|-<br />
|<nowiki>{{warning|</nowiki>text=mytext here, use <nowiki><br /></nowiki> to break lines.<nowiki>}}</nowiki><br />
|{{warning|text=mytext here, use <nowiki><br /></nowiki><br />to break lines.}}<br />
|-<br />
|<nowiki>{{Tip|</nowiki>text=mytext here, use <nowiki><br /></nowiki> to break lines.<nowiki>}}</nowiki><br />
|{{Tip|text=mytext here, use <nowiki><br /></nowiki><br />to break lines.}}<br />
|-<br />
|<nowiki>{{Important|</nowiki>text=mytext here, use <nowiki><br /></nowiki> to break lines.<nowiki>}}</nowiki><br />
|{{Important|text=mytext here, use <nowiki><br /></nowiki><br />to break lines.}}<br />
|}<br />
<br />
<br />
{{Tip|text=use [[Bluefish mediawiki snippets]] to edit this manual...<br />the task will be easier!}}<br />
<br />
=== Clear Template ===<br />
You can write <nowiki>{{clear}}</nowiki> as a shortcut of <nowiki><br style="clear:both" /></nowiki><br /><br />
The next element will be moved below all floating boxes of earlier elements.<br />
=== Top Template ===<br />
You can write <nowiki>{{top}}</nowiki> to create a link to the top of the page: {{top}}<br />
=== Toc Template ===<br />
You can write <nowiki>{{toc}}</nowiki> to create a floating right ToC<br />
<br />
=== Images ===<br />
see mediawiki manual: [http://www.mediawiki.org/wiki/Help:Images#Syntax Images Syntax]<br /><br />
<small>note: to add in snippets and bflang2</small><br />
<br />
In the manual images are framed with a title:<br /><br />
<br />
==== One image ====<br />
For one large image, with text on top and/or bottom:<br /><br />
<pre>[[File:Man2_snippet_insert_dialog.png|none|frame|snippet insert dialog]]</pre><br />
<br />
For a small image floating left with text on the right:<br />
<pre>[[File:Man2 create snippet4.png|left|frame|lorem ipsum]]<br />
lorem ipsum<br />
{{clear}}</pre><br />
<br />
==== More images ====<br />
In this case we use a table:<br />
<pre>{|<br />
|valign="bottom" align="center"|[[File:Man2 create snippet.png|none|frame|lorem ipsum]]<br />
|valign="bottom" align="center"|[[File:Man2 create snippet2.png|none|frame|lorem ipsum]]<br />
|valign="bottom" align="center"|[[File:Man2 create snippet3.png|none|frame|lorem ipsum]]<br />
|}</pre><br />
<br />
{{top}}<br />
{|<br />
{{Man2bottom<br />
|prev=Man 2 apb<br />
|up=<br />
|next=Man 2 apd<br />
|prevname= Appendix&nbsp;B.&nbsp;Bluefish change history<br />
|nextname= Appendix&nbsp;D.&nbsp;GNU GENERAL PUBLIC LICENSE<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Template:Warning&diff=2874Template:Warning2022-12-22T10:50:12Z<p>DrMartinus: changed text color to white, as black on red is hard to read</p>
<hr />
<div><table style="background-color:#F70000;color:white;border:1px solid #aaa;-moz-border-radius:0.9em;padding:2px"><tr><td><br />
{|<br />
|valign="middle" align="center" width="40"|[[File:Man2 warning.png]] <br />
|{{{text}}}<br />
|}<br />
</td></tr></table></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Template:Important&diff=2873Template:Important2022-12-22T10:43:07Z<p>DrMartinus: Replaced the icon</p>
<hr />
<div><table style="background-color:#FF0;border:1px solid #aaa;-moz-border-radius:0.9em;padding:0.5em3px"><tr><td><br />
{|<br />
|valign="middle" align="center" width="40"| [[File:Man2 important.png]] <br />
|{{{text}}}<br />
|}<br />
</td></tr></table></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=File:Man2_important.png&diff=2872File:Man2 important.png2022-12-22T10:42:24Z<p>DrMartinus: DrMartinus uploaded a new version of File:Man2 important.png</p>
<hr />
<div></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Guidelines_for_Writing_this_Manual&diff=2871Guidelines for Writing this Manual2022-12-22T10:22:04Z<p>DrMartinus: /* examples */ Added a row with the Tip template</p>
<hr />
<div>{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=v<br />
|Title=Appendix&nbsp;C.&nbsp;Guidelines for Writing this Manual<br />
|prev=Man 2 apb<br />
|Subtitle=&nbsp;<br />
|next=Man 2 apd<br />
}}<br />
{{toc}}<br />
<br />
== create an account ==<br />
{{note|text=<br />
You are a bluefish user? You can help write the Bluefish 2 Manual!<br />
* first step: [[Special:UserLogin|create an account]],<br />
* second step: feel free to edit the manual,<br />
* third step: thanks for your help! :)}}<br />
<br style="clear:both"/><br />
<br />
== Using Bluefish 2 to edit Bluefish 2 Manual ==<br />
See: [[Bluefish mediawiki editor]]. [[Mediawiki snippets]] have snippets for Bluefish Manual: note, tip, important, warning, clear, framed image.<br />
<br />
== Templates ==<br />
=== Top and bottom menus ===<br />
Bluefish Wiki Manual use 2 templates for navigation: '''Man2top''' and '''Man2bottom'''.<br /><br />
'''They do not usually need to be edited'''. However, since their output was scrambled up, they are, for now, disabled.<br />
<br />
[[File:Man2 template editing.png|left|frame|Template:Man2top Template:Man2bottom]]<br />
Man2top and Man2bottom templates do not usually need to be edited.<br />
'''Exceptions''':<br />
{{note|text=When you read a page, and make any necessary corrections so that this page conforms to Bluefish version 2.2.12, <br />thank you for changing the status, from '''d''' (draft) to '''u''' (update).<br /> <br />
ie: <tt><nowiki>|</nowiki>st=d</tt> by <tt><nowiki>|</nowiki>st=u</tt>.}}<br />
{{tip|text=After a Bluefish version update, you have to modify the rev parameter.}}<br />
{{clear}}<br />
<br />
=== Tips and Notes Templates ===<br />
Bluefish Wiki Manual use templates for:<br />
{|<br />
|align="center"|'''note''':<br />
|align="center"|'''tip''':<br />
|align="center"|'''important''':<br />
|align="center"|'''warning''':<br />
|-<br />
|align="bottom" width="150"|{{note|text=this is a note.}}<br />
|align="bottom" width="150"|{{tip|text=this is a tip.}}<br />
|align="bottom" width="170"|{{important|text=this is important!}}<br />
|align="bottom" width="150"|{{warning|text=this is a warning!}}<br />
|}<br />
<br />
==== examples ====<br />
{|border=1 cellpadding=5<br />
|<nowiki>{{note|</nowiki>text=mytext here, use <nowiki><br /></nowiki> to break lines.<nowiki>}}</nowiki><br />
|{{note|text=mytext here, use <nowiki><br /></nowiki><br />to break lines.}}<br />
|-<br />
|<nowiki>{{warning|</nowiki>text=mytext here, use <nowiki><br /></nowiki> to break lines.<nowiki>}}</nowiki><br />
|{{warning|text=mytext here, use <nowiki><br /></nowiki><br />to break lines.}}<br />
|-<br />
|<nowiki>{{Tip|</nowiki>text=mytext here, use <nowiki><br /></nowiki> to break lines.<nowiki>}}</nowiki><br />
|{{Tip|text=mytext here, use <nowiki><br /></nowiki><br />to break lines.}}<br />
|}<br />
{{Tip|text=use [[Bluefish mediawiki snippets]] to edit this manual...<br />the task will be easier!}}<br />
<br />
=== Clear Template ===<br />
You can write <nowiki>{{clear}}</nowiki> as a shortcut of <nowiki><br style="clear:both" /></nowiki><br /><br />
The next element will be moved below all floating boxes of earlier elements.<br />
=== Top Template ===<br />
You can write <nowiki>{{top}}</nowiki> to create a link to the top of the page: {{top}}<br />
=== Toc Template ===<br />
You can write <nowiki>{{toc}}</nowiki> to create a floating right ToC<br />
<br />
=== Images ===<br />
see mediawiki manual: [http://www.mediawiki.org/wiki/Help:Images#Syntax Images Syntax]<br /><br />
<small>note: to add in snippets and bflang2</small><br />
<br />
In the manual images are framed with a title:<br /><br />
<br />
==== One image ====<br />
For one large image, with text on top and/or bottom:<br /><br />
<pre>[[File:Man2_snippet_insert_dialog.png|none|frame|snippet insert dialog]]</pre><br />
<br />
For a small image floating left with text on the right:<br />
<pre>[[File:Man2 create snippet4.png|left|frame|lorem ipsum]]<br />
lorem ipsum<br />
{{clear}}</pre><br />
<br />
==== More images ====<br />
In this case we use a table:<br />
<pre>{|<br />
|valign="bottom" align="center"|[[File:Man2 create snippet.png|none|frame|lorem ipsum]]<br />
|valign="bottom" align="center"|[[File:Man2 create snippet2.png|none|frame|lorem ipsum]]<br />
|valign="bottom" align="center"|[[File:Man2 create snippet3.png|none|frame|lorem ipsum]]<br />
|}</pre><br />
<br />
{{top}}<br />
{|<br />
{{Man2bottom<br />
|prev=Man 2 apb<br />
|up=<br />
|next=Man 2 apd<br />
|prevname= Appendix&nbsp;B.&nbsp;Bluefish change history<br />
|nextname= Appendix&nbsp;D.&nbsp;GNU GENERAL PUBLIC LICENSE<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=File_talk:Man2_warning.png&diff=2870File talk:Man2 warning.png2022-12-22T10:18:31Z<p>DrMartinus: Created this page</p>
<hr />
<div>I'm not the man for making images, but I had to do one that matches the others I had chosen after I found out that none of those small icons aren't available on this server any longer. This one seems ok to me, but if anyone wants to make a better one, be my guest... <br />
[[User:DrMartinus|Dr. Martinus]] ([[User talk:DrMartinus|talk]]) 11:18, 22 December 2022 (CET)</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=File:Man2_warning.png&diff=2869File:Man2 warning.png2022-12-22T10:16:11Z<p>DrMartinus: DrMartinus uploaded a new version of File:Man2 warning.png</p>
<hr />
<div></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Contact_Us&diff=2868Contact Us2022-12-22T09:16:53Z<p>DrMartinus: created this page, updated some info, as far as possible, checked links for functionality and replaced them if necessary</p>
<hr />
<div>== 2.4. Contact Us ==<br />
We, the Bluefish development team, welcome all comments, user requests, constructive criticisms, and contributions. Are you curious or seeking information regarding Bluefish? Would you like to contribute by translating Bluefish or its manual? Here are your options:<br />
<br />
* [http://bluefish.openoffice.nl/ http://bluefish.openoffice.nl/] - The main website where you will find news, updates, manual and more information.<br />
* [http://bfwiki.tellefsen.net/ http://bfwiki.tellefsen.net/] - The Bluefish WiKi is the notebook for the developers, containing a lot of information. This includes, but is not limited to: updated project road maps, status of translations. It also contains the manual for this software.<br />
* For bug reports and feature requests, related to bluefish, its web site, and its manual, please fill the appropriate bug type at [https://sourceforge.net/p/bluefish/tickets/ https://sourceforge.net/p/bluefish/tickets/], the bluefish bugzilla page - for instructions, see [[ch10s02|Section 2, “Filling a bug report”]].<br />
* You can subscribe to the users' Bluefish mailing list by sending an email containing “subscribe bluefish-users” to [mailto:bluefish-users-request@lists.ems.ru bluefish-users-request@lists.ems.ru].<br />
* You can subscribe to the developers' Bluefish mailing list by sending an email containing “subscribe bluefish-dev” to [mailto:bluefish-dev-request@lists.ems.ru bluefish-dev-request@lists.ems.ru].<br />
* Do you want to help translate Bluefish? Please let us know by dropping an email to <del>Walter Echarri [mailto:wecharri(at)arnet.com.ar wecharri(at)arnet.com.ar]</del>, our friendly translation maintainer.<br />
* If you want to help improve the manual or write new sections, please send an email to the Bluefish manual maintainer, Martin S. [mailto:linux(at)drmartinus(dot)de linux(at)drmartinus(dot)de]. Make sure you replace the words in parentheses with the appropriate signs. Guidelines for this manual can be found in [[Man 2 apc|Appendix C, Guidelines for Writing this Manual]]<br />
* If you have a general question, drop an email to [mailto:bluefish(at)bluefish.openoffice.nl bluefish(at)bluefish.openoffice.nl].</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=What_is_Bluefish%3F&diff=2867What is Bluefish?2022-12-22T08:53:25Z<p>DrMartinus: Removed the Contact Us section in order to create a new page with these details</p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=d<br />
|Title=2.&nbsp;What is Bluefish?<br />
|prev=Man 2 pr01<br />
|Subtitle=Preface<br />
|next=Man 2 pt01<br />
}}<br />
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;"><br />
*[[#2.1. History of Bluefish| 2.1. History of Bluefish]] <br />
*[[#2.2. Main Features of Bluefish| 2.2. Main Features of Bluefish]] <br />
*[[#2.3. How Stable is Bluefish?| 2.3. How Stable is Bluefish?]] <br />
*[[#2.4. Contact Us| 2.4. Contact Us]] <br />
</div><br />
Bluefish is a powerful editor for experienced web designers and programmers based on the GTK2 GUI interface. Bluefish supports many programming and markup languages, but focuses on editing dynamic and interactive websites.<br />
<br />
Bluefish is not a WYSIWYG<ref>What You See Is What You Get</ref> text editor. This is deliberate, allowing the programmer to stay in full control. To facilitate the editing process, a large number of features are at your disposal. For inserting markup and code, there are tool bars, dialogs, and predefined/user-customized menus. Syntax highlighting, advanced search/replace functionality, scalability and language function references make Bluefish a powerful tool for development.<br />
<br />
== 2.2. Main Features of Bluefish ==<br />
This list will give you an overview of the most important or outstanding features found in Bluefish:<br />
<br />
* A What You Write Is What You Get interface<br />
* Multiple document interface, will easily open 500+ documents (tested 3500 with documents simultaneously).<br />
* Customizable syntax highlighting based on Perl compatible regular expressions, with subpattern support. Default patterns are included for:<br />
** C<br />
** cfml<br />
** ChangeLog<br />
** CSS stylesheet<br />
** Gettext po<br />
** HTML<br />
** Java<br />
** JScript<br />
** JavaScript<br />
** Octave<br />
** Pascal<br />
** Perl<br />
** PHP<br />
** Python<br />
** R<br />
** Shell<br />
** SQL<br />
** Tcl<br />
** Ruby<br />
** XML<br />
* Anti-aliased text window<br />
* Multiple encodings support, can convert between different character sets, supports multibyte characters, Unicode, UTF8, etc.<br />
* Nice wizards for startup, tables, frames, and others<br />
* Dialogs for many HTML tags, with all their attributes<br />
* HTML tool bar and tear-off menus<br />
* User-customizable tool bar for quick access to often used functions<br />
* Open files based on filename patterns and/or content, from selection or URIs<br />
* Fully featured image insert dialog<br />
* Thumbnail creation and automatically linking of the thumbnail with the original image<br />
* Multi-thumbnail generation for easy creation of photo albums or screen shot pages<br />
* Line numbers along the document<br />
* Bookmarks for lines across multiple documents, with bookmark browser<br />
* A custom menu, specify your own tags or sets of code, and define your own dialogs<br />
* Custom search and replace pattern support for the Custom menu<br />
* Very powerful search and replace, allowing POSIX and Perl Compatible regular expressions and sub-pattern replacing<br />
* Excellent undo/redo functionality<br />
* Configurable recent documents and recent directories functionality<br />
* Spell checking<br />
* Translations in ''twenty languages''<br />
* User customizable integration with many programs, including weblint, tidy, make, javac, etc.<br />
* XML based function reference. Currently, references are included for Apache, DHTML, DocBook, HTML, PHP, and SQL. A GTK reference is available, and support for Perl and Python will be added. You may also create your own function reference. The XML format is described later in the manual.<br />
* XML based reference library for CSS2, HTML, PHP, and Python.<br />
* Projects management.<br />
<br />
As Bluefish is a part of a larger desktop environment, we have focused on making the GUI consistent with the Gnome HIG<ref>GNOME Human Interface Guidelines, accessible at [http://developer.gnome.org/projects/gup/hig/ http://developer.gnome.org/projects/gup/hig/]</ref>. However, we prefer not following it in every detail, as some parts are intended ''for the end user'', while Bluefish is ''for the programmer''.<br />
<br />
== 2.3. How Stable is Bluefish? ==<br />
Quite stable! The Bluefish developers aim to produce code that neither crashes nor leaks memory. Of course, that is not always easy to do. Leaks and crashes are often fixed in CVS as soon as they are discovered and hunted down. In addition to Bluefish's large user base, the developers use Bluefish for their daily work. So, fixing bugs and preventing crashes is always a major priority. However, some nags still exist. One example being the issue of slightly sluggish copy/paste functions.<br />
<br />
For an updated list of open bugs, please go to the [http://bugzilla.gnome.org/browse.cgi?product=bluefish bluefish] page on bugzilla gnome.<br />
<br />
We appreciate any and all contributions! Please tell us if Bluefish crashes on you :-).<br />
<br />
<br />
<br />
<br />
<br />
<references /><br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 pr01<br />
|up=Man 2 pr01<br />
|next=Man 2 pt01<br />
|prevname= Preface<br />
|nextname=Part&nbsp;1.&nbsp;Getting and Installing Bluefish<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Talk:History_of_Bluefish&diff=2866Talk:History of Bluefish2022-12-22T08:49:29Z<p>DrMartinus: added a signature</p>
<hr />
<div>I'm entirely unsure if the years are correct. On the project page, only months and days are mentioned, not years. From that, the list should cover a range of 8 to 10 years (this can be deducted from the fact that the next release has been issued on an earlier date in the year than the previous release). Yet I believe that 2.2.12 was released in 2020, but, as already said, I'm not sure...<br />
[[User:DrMartinus|Dr. Martinus]] ([[User talk:DrMartinus|talk]]) 09:49, 22 December 2022 (CET)</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Talk:History_of_Bluefish&diff=2865Talk:History of Bluefish2022-12-22T08:48:47Z<p>DrMartinus: Created this page</p>
<hr />
<div>I'm entirely unsure if the years are correct. On the project page, only months and days are mentioned, not years. From that, the list should cover a range of 8 to 10 years (this can be deducted from the fact that the next release has been issued on an earlier date in the year than the previous release). Yet I believe that 2.2.12 was released in 2020, but, as already said, I'm not sure...</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=History_of_Bluefish&diff=2864History of Bluefish2022-12-22T08:46:14Z<p>DrMartinus: Created this page, added a table which lists the various releases and gives a very short note of improvements</p>
<hr />
<div>== History of Bluefish ==<br />
Bluefish development started under a different name. A good and free text editor targeted towards web development was not available. Olivier Sessink started the project ProSite. Chris Mazuc also started an HTML editor. On a GTK development mailing list, Olivier Sessink and Chris Mazuc saw each others postings, and decided to team up. Olivier had a basic editor, Chris had many HTML dialogs ready. After merging the code this was for a while known as the Thtml editor.<br />
<br />
After a while Neil Millar joined the project to add weblint integration and a color dialog. Because the project became larger and more mature, a logo was wanted. After many discussions about boring logos, Neil Millar came up with a cute blue fish. Because this logo was appreciated by all, the name changed into the final name Bluefish.<br />
<br />
After this initial stage, many developers, translators, testers and users joined the project.<br />
<br />
Several years have passed since the first Bluefish release. Since that time, the fish has gained a reputation as an excellent editor, with qualities like stability, usability and numerous features. Also, Bluefish is small, fast and efficient, making it usable even on slow machines.<br />
<br />
{| class="wikitable" style="margin:auto"<br />
!Year<br />
!Version<br />
!Major New features<br />
|-<br />
|2011<br />
|align="center"|2.2.0<br />
|GTK3-support, Search & Replace, block selection and more<br />
|-<br />
|2012<br />
|align="center"|2.2.1<br />
|Zen-Coding support (requires Python)<br />
|-<br />
|2013<br />
|align="center"|2.2.2<br />
|many bugfixes and minor improvements<br />
|-<br />
|2015<br />
|align="center"|2.2.3<br />
|lorem ipsum generator, HTML5 code creation dialogs, bugfixes<br />
|-<br />
|2016<br />
|align="center"|2.2.4<br />
|improved split view and language syntax detection; new: paste special; new: pylint, cssmin, jsmin, csstidy and php_beautifier integration<br />
|-<br />
|2017<br />
|align="center"|2.2.5<br />
|Improvements on projects, indenting and bookmarks; <br />
|-<br />
|2017<br />
|align="center"|2.2.6<br />
|many improvements and bugfixes<br />
|-<br />
|2018<br />
|align="center"|2.2.7<br />
|Added various HTML5 tags, better syntax support, improved autocompletion, charmap for OSX<br />
|-<br />
|2019<br />
|align="center"|2.2.8<br />
|Various improvements and bugfixes, SASS style language has been added<br />
|-<br />
|2019<br />
|align="center"|2.2.9<br />
|fix incompatability with GTK 3.2, some improvements<br />
|-<br />
|2020<br />
|align="center"|2.2.10<br />
|wayland support, import/export syntax color styles<br />
|-<br />
|2021<br />
|align="center"|2.2.11<br />
|python 3 compatibility, insert output from an external command in the current cursor position, CSS, Python and HTML updates, search within the filebrowser<br />
|-<br />
|2021<br />
|align="center"|2.2.12<br />
|Supports Enchant2 for spell checking, bugfixes and some improvements<br />
|}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=What_is_Bluefish%3F&diff=2863What is Bluefish?2022-12-22T07:34:16Z<p>DrMartinus: </p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=d<br />
|Title=2.&nbsp;What is Bluefish?<br />
|prev=Man 2 pr01<br />
|Subtitle=Preface<br />
|next=Man 2 pt01<br />
}}<br />
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;"><br />
*[[#2.1. History of Bluefish| 2.1. History of Bluefish]] <br />
*[[#2.2. Main Features of Bluefish| 2.2. Main Features of Bluefish]] <br />
*[[#2.3. How Stable is Bluefish?| 2.3. How Stable is Bluefish?]] <br />
*[[#2.4. Contact Us| 2.4. Contact Us]] <br />
</div><br />
Bluefish is a powerful editor for experienced web designers and programmers based on the GTK2 GUI interface. Bluefish supports many programming and markup languages, but focuses on editing dynamic and interactive websites.<br />
<br />
Bluefish is not a WYSIWYG<ref>What You See Is What You Get</ref> text editor. This is deliberate, allowing the programmer to stay in full control. To facilitate the editing process, a large number of features are at your disposal. For inserting markup and code, there are tool bars, dialogs, and predefined/user-customized menus. Syntax highlighting, advanced search/replace functionality, scalability and language function references make Bluefish a powerful tool for development.<br />
<br />
== 2.2. Main Features of Bluefish ==<br />
This list will give you an overview of the most important or outstanding features found in Bluefish:<br />
<br />
* A What You Write Is What You Get interface<br />
* Multiple document interface, will easily open 500+ documents (tested 3500 with documents simultaneously).<br />
* Customizable syntax highlighting based on Perl compatible regular expressions, with subpattern support. Default patterns are included for:<br />
** C<br />
** cfml<br />
** ChangeLog<br />
** CSS stylesheet<br />
** Gettext po<br />
** HTML<br />
** Java<br />
** JScript<br />
** JavaScript<br />
** Octave<br />
** Pascal<br />
** Perl<br />
** PHP<br />
** Python<br />
** R<br />
** Shell<br />
** SQL<br />
** Tcl<br />
** Ruby<br />
** XML<br />
* Anti-aliased text window<br />
* Multiple encodings support, can convert between different character sets, supports multibyte characters, Unicode, UTF8, etc.<br />
* Nice wizards for startup, tables, frames, and others<br />
* Dialogs for many HTML tags, with all their attributes<br />
* HTML tool bar and tear-off menus<br />
* User-customizable tool bar for quick access to often used functions<br />
* Open files based on filename patterns and/or content, from selection or URIs<br />
* Fully featured image insert dialog<br />
* Thumbnail creation and automatically linking of the thumbnail with the original image<br />
* Multi-thumbnail generation for easy creation of photo albums or screen shot pages<br />
* Line numbers along the document<br />
* Bookmarks for lines across multiple documents, with bookmark browser<br />
* A custom menu, specify your own tags or sets of code, and define your own dialogs<br />
* Custom search and replace pattern support for the Custom menu<br />
* Very powerful search and replace, allowing POSIX and Perl Compatible regular expressions and sub-pattern replacing<br />
* Excellent undo/redo functionality<br />
* Configurable recent documents and recent directories functionality<br />
* Spell checking<br />
* Translations in ''twenty languages''<br />
* User customizable integration with many programs, including weblint, tidy, make, javac, etc.<br />
* XML based function reference. Currently, references are included for Apache, DHTML, DocBook, HTML, PHP, and SQL. A GTK reference is available, and support for Perl and Python will be added. You may also create your own function reference. The XML format is described later in the manual.<br />
* XML based reference library for CSS2, HTML, PHP, and Python.<br />
* Projects management.<br />
<br />
As Bluefish is a part of a larger desktop environment, we have focused on making the GUI consistent with the Gnome HIG<ref>GNOME Human Interface Guidelines, accessible at [http://developer.gnome.org/projects/gup/hig/ http://developer.gnome.org/projects/gup/hig/]</ref>. However, we prefer not following it in every detail, as some parts are intended ''for the end user'', while Bluefish is ''for the programmer''.<br />
<br />
== 2.3. How Stable is Bluefish? ==<br />
Quite stable! The Bluefish developers aim to produce code that neither crashes nor leaks memory. Of course, that is not always easy to do. Leaks and crashes are often fixed in CVS as soon as they are discovered and hunted down. In addition to Bluefish's large user base, the developers use Bluefish for their daily work. So, fixing bugs and preventing crashes is always a major priority. However, some nags still exist. One example being the issue of slightly sluggish copy/paste functions.<br />
<br />
For an updated list of open bugs, please go to the [http://bugzilla.gnome.org/browse.cgi?product=bluefish bluefish] page on bugzilla gnome.<br />
<br />
We appreciate any and all contributions! Please tell us if Bluefish crashes on you :-).<br />
<br />
== 2.4. Contact Us ==<br />
We, the Bluefish development team, welcome all comments, user requests, constructive criticisms, and contributions. Are you curious or seeking information regarding Bluefish? Would you like to contribute by translating Bluefish or its manual? Here are your options:<br />
<br />
* [http://bluefish.openoffice.nl/ http://bluefish.openoffice.nl/] - The main website where you will find news, updates, manual and more information.<br />
* [http://bfwiki.tellefsen.net/ http://bfwiki.tellefsen.net/] - The Bluefish WiKi is the notebook for the developers, containing a lot of information. This includes, but is not limited to: updated project road maps, status of translations.<br />
* For bug reports and features requests, related to bluefish, its web site, and its manual, please fill the appropriate bug type at [https://sourceforge.net/p/bluefish/tickets/ https://sourceforge.net/p/bluefish/tickets/], the bluefish bugzilla page - for instructions, see [ch10s02|Section 2, “Filling a bug report”].<br />
* You can subscribe to the users' Bluefish mailing list by sending an email containing “subscribe bluefish-users” to [mailto:bluefish-users-request@lists.ems.ru bluefish-users-request@lists.ems.ru].<br />
* You can subscribe to the developers' Bluefish mailing list by sending an email containing “subscribe bluefish-dev” to [mailto:bluefish-dev-request@lists.ems.ru bluefish-dev-request@lists.ems.ru].<br />
* Do you want to help translate Bluefish? Please let us know by dropping an email to <del>Walter Echarri [mailto:wecharri(at)arnet.com.ar wecharri(at)arnet.com.ar]</del>, our friendly translation maintainer.<br />
* If you want to help improve the manual or write new sections, please send an email to the Bluefish manual maintainer, <del>Michèle Garoche [mailto:michele.garoche(at)easyconnect.fr michele.garoche(at)easyconnect.fr]</del>. Guidelines for this manual can be found in [[Man 2 apc|Appendix C, Guidelines for Writing this Manual]]<br />
* If you have a general question, drop an email to [mailto:bluefish(at)bluefish.openoffice.nl bluefish(at)bluefish.openoffice.nl].<br />
<br />
<br />
<br />
<references/><br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 pr01<br />
|up=Man 2 pr01<br />
|next=Man 2 pt01<br />
|prevname= Preface<br />
|nextname=Part&nbsp;1.&nbsp;Getting and Installing Bluefish<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Manual_2_ToC&diff=2862Manual 2 ToC2022-12-22T07:32:58Z<p>DrMartinus: Reordered the pages in the first two chapters</p>
<hr />
<div>{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| <center>'''Bluefish: The Definitive Guide'''</center><br />
|}<br />
<div style="text-align:center"><br />
'''Table of Contents <small>(part 1)</small>'''<br />
</div><br />
{{toc}} <br />
{|<br />
|see also: <br />
|[[Notes for Bluefish 2 Manual]]<br />
|-<br />
|<br />
|[[Guidelines for Writing this Manual]]<br />
|}<br />
<br />
{{Note|text=Note that the manual is currently being reworked. Many pages are outdated, others not yet available. They will be made available in the near future.}}<br />
<br />
Here an overview of what has been done so far:<br />
{|class="wikitable" style="margin:auto"<br />
!As per<br />
!What has been done<br />
|-<br />
|2022-12-21<br />
|All unnumbered sections under ''Preface'' and ''Getting and Installing Bluefish'' have been updated<br />
|}<br />
<br />
'''Bluefish 2.2 Manual''' <br />
<br />
== [[Preface|Preface]] ==<br />
*[[About this Manual]]<br />
*[[What is Bluefish?]]<br />
*[[History of Bluefish]]<br />
*[[Main Features of Bluefish]]<br />
*[[How Stable is Bluefish?]]<br />
*[[Contact Us]]<br />
== [[Getting and Installing Bluefish|Getting and Installing Bluefish]] ==<br />
*[[Operating Systems Supported by Bluefish]]<br />
*[[Man 2 ch02#1. Requirements|Requirements]]<br />
*[[Choosing a Version]]<br />
*[[Latest Stable Version|Latest Stable Version]]<br />
*[[Getting Bluefish - Latest Snapshot|Latest Snapshot Version]]<br />
*[[Getting Bluefish - Latest Development Version|Latest Developmental Version]]<br />
*[[How and When Updates are Released]]<br />
*[[Installing Bluefish]]<br />
*[[Installing Bluefish - System Issues| System Specific Installation Issues]]<br />
*[[Installing Bluefish - Install from Source Code|Installing a Bluefish Source Distribution]]<br />
*[[Compiling Bluefish from source]] <br />
*[[Installing Bluefish - Install from Source Code Options|Configure Options]]<br /><br />
<br />
<br />
<br />
<br />
[[Installing Bluefish - Install from Binary Distribution|6. Installing a Binary Distribution]] ¤ [[Installing Bluefish - Post-Installation Checklist|7. Post-installation Setup]]<br />
<br />
== [[Using Bluefish|Using Bluefish]] ==<br />
=== [[Launching Bluefish|Starting Bluefish]] ===<br />
[[Launching Bluefish#1. Launching Bluefish|1. Launching Bluefish]] ¤ [[Command line options|2. Command line options]]<br />
=== [[Editing Area|The user interface]] ===<br />
[[Editing Area#1. Editing Area|1. Editing Area]] ¤ [[Menus and Tool Bars|2. Menus and Tool Bars]] ¤ [[Side Panel|3. Side Panel]] ¤ [[Interface - Status Bar|4. Status Bar]] ¤ [[Interface - Help Menu|5. Help Menu]]<br />
=== [[Preferences|Preferences]] === <br />
=== [[Creating Files|Working with files and folders]] ===<br />
[[Creating Files#1. Creating files|1. Creating files]] ¤ [[Managing Directories|2. Managing directories]] ¤ [[Opening Files|3. Opening files]] ¤ [[Saving Files|4. Saving files]] ¤ [[Renaming Files|5. Renaming files]] ¤ [[Deleting files|6. Deleting files]] ¤ [[Closing Files|7. Closing files]] ¤ [[Inserting files|8. Inserting files]]<br /><br />
[[Editing|9. Editing]] ¤ Undo and Redo ¤ Cut, Copy, and Paste ¤ Input methods<br /><br />
[[Basic Find and Replace|10. Basic Find and Replace]] ¤ Searching for a word within a whole document ¤ Setting limits to the search scope ¤ Case sensitive search ¤ Overlapping searches ¤ Retrieving previous search strings ¤ More on find ¤ Replacing features ¤ Retrieving previous replace strings ¤ Changing letter case when replacing ¤ Choosing strings to replace ¤ More on replace<br /><br />
[[File Types (1/2)|11. File types]] ¤ Syntax highlighting<br /><br />
[[File Types (2/2)|12. More on files]] ¤ Remote files ¤ Character encoding ¤ Open advanced<br />
=== [[Navigating through a document|Navigation and Managing documents]] === <br />
Navigating through a document<br /><br />
[[Go Menu and Document Navigation|2. Navigating through many documents]] ¤ [[Projects|3. Projects]]<br /><br />
[[Bookmarks|4. Bookmarks]] ¤ Generating several bookmarks at once]]<br /><br />
[[Find and Replace|5. Find and Replace]] ¤ Find Again ¤ Find from Selection ¤ Find and Replace Using Regular Expressions<br /><br />
[[Templates| Templates]]<br />
=== [[Indenting|More than a Text Editor]] === <br />
[[Indenting#1. Indenting|1. Indenting]] ¤ [[Autocompletion|2. Autocompletion]] ¤ [[Hidden features]] ¤ [[Spell checker|3. Spell checker]] ¤ [[Programming and Markup Languages Function Reference|4. Function reference]]<br /><br />
[[HTML Editing|5. HTML]] ¤ Special find and replace features ¤ Thumbnail generation<br /><br />
[[Quick Bar Customization|6. Customizing the Quick bar]]<br /><br />
[[Snippets plugin|7. Snippets plugin]] (was Custom menu in Bluefish 1) ¤ Adding a snippet dialog ¤ Adding a snippet replace dialog<br /><br />
[[External Programs and Filters|8. External programs, filters]] ¤ Customizing browsers ¤ Customizing Commands menu ¤ Customizing Ouputbox menu<br />
<br />
=== [[Modifying shortcut keys|Customising Bluefish]] === <br />
Modifying shortcut keys<br /><br />
[[Invisible Files and Folders|2. Showing hidden files and folders]] ¤ [[Showing backup files|3. Showing backup files]] ¤ [[Editor Appearance Customization|4. Editor appearance]] ¤ [[Bookmarks Path Customization|5. Customizing the bookmarks path]] ¤ [[HTML Tags Style Customization|6. Customizing the html tags style]] ¤ [[Author Meta Tag|7. Changing the author meta tag on the fly]]<br /><br />
[[File Handling and Browsing Customization|8. Customizing files handling and browsing]] ¤ Setting the encoding meta tag on save ¤ Setting the default base directory ¤ Merging file browser views ¤ 8.4. Backup files ¤ 8.5. Using multiple instances of a file<br /><br />
[[User Interface Customization|9. Customizing the user interface]] ¤ [[File Types Handling|10. Modifying file types]] ¤ [[File Filters|11. Modifying the files filters]] ¤ [[Highlight Patterns Modification|12. Modifying the highlighting patterns]]<br />
*[[General Shortcuts|IX. Shortcuts available within Bluefish]] ¤ [[General Shortcuts#1. General Shortcuts|1. General Shortcuts]] ¤ [[HTML Shortcuts|2. HTML Shortcuts]]<br />
<br />
== [[Developing Bluefish|Developing Bluefish]] ==<br />
=== [[Bugs - Using the Debugger|Debugging Bluefish]] ===<br />
[[Bugs - Using the Debugger#1. Using the Debugger|1. Using the Debugger]] ¤ [[Bugs - Filing a Report|2. Filling a bug report]]<br />
=== [[Editor Tab Options|Reference]] === <br />
[[Editor Tab Options#1. Options in the Editor Tab|1. Options in the Editor Tab]] ¤ [[HTML Tab Options|2. Options in the HTML Tab]] ¤ [[Files Tab Options|3. Options in the Files Tab]] ¤ [[User Interface Tab Options|4. Options in the User interface Tab]] ¤ [[Images Tab Options|5. Options in the Images Tab]]<br />
=== [[Development - Indenting and Formatting|Development guidelines]] ===<br />
Indenting and formating style<br /><br />
[[Development - Naming|2. Naming]] ¤ [[Development - Declaring Procedures|3. Declaring procedures]] ¤ [[Development - Header Files|4. Header files]] ¤ [[Development - New Files|5. New files]] ¤ [[Development - File Reference|6. File reference]] ¤ [[Development - Patches|7. Patches]]<br /><br />
[[Development - Translations|8. Translations]] ¤ Introduction ¤ PO files basics ¤ <br />
Shortcut keys ¤ How to contribute<br /><br />
[[Development - Some tips|9. Some tips]] ¤ [[Development - Making Releases|10. Making releases]] ¤ [[Development - Useful Stuff|11. Useful stuff]]<br />
<br />
== [[Table of Contents (2/3)|'''Table of Contents (2/3)''']] ==<br />
<br />
{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| &nbsp;<br />
| <center>[[Man 2 index|Home]]</center><br />
| <div align="right">&nbsp;</div><br />
|}<br />
<br />
[[Category:Manual 2]]</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=How_and_When_Updates_are_Released&diff=2861How and When Updates are Released2022-12-22T07:26:31Z<p>DrMartinus: added hint towards little development</p>
<hr />
<div>There is no schedule as to when updates are being released. The work on the project goes on, though slowly, because the software is fully functional and provides a lot of valuable features. Depending on the amount of changes and maybe bugfixes, there will be a new stable version released. In the meantime, there may be snapshot releases. New releases will be announced on the [https://bluefish.openoffice.nl/index.html official project page].</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Manual_2_ToC&diff=2860Manual 2 ToC2022-12-22T06:29:32Z<p>DrMartinus: Moved "Configure Option" up</p>
<hr />
<div>{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| <center>'''Bluefish: The Definitive Guide'''</center><br />
|}<br />
<div style="text-align:center"><br />
'''Table of Contents <small>(part 1)</small>'''<br />
</div><br />
{{toc}} <br />
{|<br />
|see also: <br />
|[[Notes for Bluefish 2 Manual]]<br />
|-<br />
|<br />
|[[Guidelines for Writing this Manual]]<br />
|}<br />
<br />
{{Note|text=Note that the manual is currently being reworked. Many pages are outdated, others not yet available. They will be made available in the near future.}}<br />
<br />
Here an overview of what has been done so far:<br />
{|class="wikitable" style="margin:auto"<br />
!As per<br />
!What has been done<br />
|-<br />
|2022-12-21<br />
|All unnumbered sections under ''Preface'' and ''Getting and Installing Bluefish'' have been updated<br />
|}<br />
<br />
'''Bluefish 2.2 Manual''' <br />
<br />
== [[Preface|Preface]] ==<br />
[[About this Manual]] ¤ [[What is Bluefish?]] ¤ [[History of Bluefish]] ¤ [[Main Features of Bluefish]] ¤ [[How Stable is Bluefish?]] ¤ [[Contact Us]]<br />
== [[Getting and Installing Bluefish|Getting and Installing Bluefish]] ==<br />
[[Installing Bluefish]] ¤ [[Compiling Bluefish from source]] ¤ <br />
[[Choosing a Version]] ¤ [[Latest Stable Version|Latest Stable Version]] ¤ [[Getting Bluefish - Latest Snapshot|Latest Snapshot Version]] ¤ [[Getting Bluefish - Latest Development Version|Latest Developmental Version]] ¤ [[How and When Updates are Released]] ¤ [[Operating Systems Supported by Bluefish]] ¤ [[Man 2 ch02#1. Requirements|Requirements]] ¤ [[Installing Bluefish - System Issues| System Specific Installation Issues]] ¤ [[Installing Bluefish - Install from Source Code|Installing a Bluefish Source Distribution]] ¤ [[Installing Bluefish - Install from Source Code Options|Configure Options]]<br /><br />
<br />
<br />
<br />
<br />
[[Installing Bluefish - Install from Binary Distribution|6. Installing a Binary Distribution]] ¤ [[Installing Bluefish - Post-Installation Checklist|7. Post-installation Setup]]<br />
<br />
== [[Using Bluefish|Using Bluefish]] ==<br />
=== [[Launching Bluefish|Starting Bluefish]] ===<br />
[[Launching Bluefish#1. Launching Bluefish|1. Launching Bluefish]] ¤ [[Command line options|2. Command line options]]<br />
=== [[Editing Area|The user interface]] ===<br />
[[Editing Area#1. Editing Area|1. Editing Area]] ¤ [[Menus and Tool Bars|2. Menus and Tool Bars]] ¤ [[Side Panel|3. Side Panel]] ¤ [[Interface - Status Bar|4. Status Bar]] ¤ [[Interface - Help Menu|5. Help Menu]]<br />
=== [[Preferences|Preferences]] === <br />
=== [[Creating Files|Working with files and folders]] ===<br />
[[Creating Files#1. Creating files|1. Creating files]] ¤ [[Managing Directories|2. Managing directories]] ¤ [[Opening Files|3. Opening files]] ¤ [[Saving Files|4. Saving files]] ¤ [[Renaming Files|5. Renaming files]] ¤ [[Deleting files|6. Deleting files]] ¤ [[Closing Files|7. Closing files]] ¤ [[Inserting files|8. Inserting files]]<br /><br />
[[Editing|9. Editing]] ¤ Undo and Redo ¤ Cut, Copy, and Paste ¤ Input methods<br /><br />
[[Basic Find and Replace|10. Basic Find and Replace]] ¤ Searching for a word within a whole document ¤ Setting limits to the search scope ¤ Case sensitive search ¤ Overlapping searches ¤ Retrieving previous search strings ¤ More on find ¤ Replacing features ¤ Retrieving previous replace strings ¤ Changing letter case when replacing ¤ Choosing strings to replace ¤ More on replace<br /><br />
[[File Types (1/2)|11. File types]] ¤ Syntax highlighting<br /><br />
[[File Types (2/2)|12. More on files]] ¤ Remote files ¤ Character encoding ¤ Open advanced<br />
=== [[Navigating through a document|Navigation and Managing documents]] === <br />
Navigating through a document<br /><br />
[[Go Menu and Document Navigation|2. Navigating through many documents]] ¤ [[Projects|3. Projects]]<br /><br />
[[Bookmarks|4. Bookmarks]] ¤ Generating several bookmarks at once]]<br /><br />
[[Find and Replace|5. Find and Replace]] ¤ Find Again ¤ Find from Selection ¤ Find and Replace Using Regular Expressions<br /><br />
[[Templates| Templates]]<br />
=== [[Indenting|More than a Text Editor]] === <br />
[[Indenting#1. Indenting|1. Indenting]] ¤ [[Autocompletion|2. Autocompletion]] ¤ [[Hidden features]] ¤ [[Spell checker|3. Spell checker]] ¤ [[Programming and Markup Languages Function Reference|4. Function reference]]<br /><br />
[[HTML Editing|5. HTML]] ¤ Special find and replace features ¤ Thumbnail generation<br /><br />
[[Quick Bar Customization|6. Customizing the Quick bar]]<br /><br />
[[Snippets plugin|7. Snippets plugin]] (was Custom menu in Bluefish 1) ¤ Adding a snippet dialog ¤ Adding a snippet replace dialog<br /><br />
[[External Programs and Filters|8. External programs, filters]] ¤ Customizing browsers ¤ Customizing Commands menu ¤ Customizing Ouputbox menu<br />
<br />
=== [[Modifying shortcut keys|Customising Bluefish]] === <br />
Modifying shortcut keys<br /><br />
[[Invisible Files and Folders|2. Showing hidden files and folders]] ¤ [[Showing backup files|3. Showing backup files]] ¤ [[Editor Appearance Customization|4. Editor appearance]] ¤ [[Bookmarks Path Customization|5. Customizing the bookmarks path]] ¤ [[HTML Tags Style Customization|6. Customizing the html tags style]] ¤ [[Author Meta Tag|7. Changing the author meta tag on the fly]]<br /><br />
[[File Handling and Browsing Customization|8. Customizing files handling and browsing]] ¤ Setting the encoding meta tag on save ¤ Setting the default base directory ¤ Merging file browser views ¤ 8.4. Backup files ¤ 8.5. Using multiple instances of a file<br /><br />
[[User Interface Customization|9. Customizing the user interface]] ¤ [[File Types Handling|10. Modifying file types]] ¤ [[File Filters|11. Modifying the files filters]] ¤ [[Highlight Patterns Modification|12. Modifying the highlighting patterns]]<br />
*[[General Shortcuts|IX. Shortcuts available within Bluefish]] ¤ [[General Shortcuts#1. General Shortcuts|1. General Shortcuts]] ¤ [[HTML Shortcuts|2. HTML Shortcuts]]<br />
<br />
== [[Developing Bluefish|Developing Bluefish]] ==<br />
=== [[Bugs - Using the Debugger|Debugging Bluefish]] ===<br />
[[Bugs - Using the Debugger#1. Using the Debugger|1. Using the Debugger]] ¤ [[Bugs - Filing a Report|2. Filling a bug report]]<br />
=== [[Editor Tab Options|Reference]] === <br />
[[Editor Tab Options#1. Options in the Editor Tab|1. Options in the Editor Tab]] ¤ [[HTML Tab Options|2. Options in the HTML Tab]] ¤ [[Files Tab Options|3. Options in the Files Tab]] ¤ [[User Interface Tab Options|4. Options in the User interface Tab]] ¤ [[Images Tab Options|5. Options in the Images Tab]]<br />
=== [[Development - Indenting and Formatting|Development guidelines]] ===<br />
Indenting and formating style<br /><br />
[[Development - Naming|2. Naming]] ¤ [[Development - Declaring Procedures|3. Declaring procedures]] ¤ [[Development - Header Files|4. Header files]] ¤ [[Development - New Files|5. New files]] ¤ [[Development - File Reference|6. File reference]] ¤ [[Development - Patches|7. Patches]]<br /><br />
[[Development - Translations|8. Translations]] ¤ Introduction ¤ PO files basics ¤ <br />
Shortcut keys ¤ How to contribute<br /><br />
[[Development - Some tips|9. Some tips]] ¤ [[Development - Making Releases|10. Making releases]] ¤ [[Development - Useful Stuff|11. Useful stuff]]<br />
<br />
== [[Table of Contents (2/3)|'''Table of Contents (2/3)''']] ==<br />
<br />
{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| &nbsp;<br />
| <center>[[Man 2 index|Home]]</center><br />
| <div align="right">&nbsp;</div><br />
|}<br />
<br />
[[Category:Manual 2]]</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Installing_Bluefish_-_Install_from_Source_Code_Options&diff=2859Installing Bluefish - Install from Source Code Options2022-12-22T06:27:52Z<p>DrMartinus: Added note that the page may not be up to date.</p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=d<br />
|Title=5.&nbsp;Configure Options<br />
|prev=Man 2 ch02s04<br />
|Subtitle=Chapter&nbsp;II.&nbsp;Installing Bluefish<br />
|next=Man 2 ch02s06<br />
}}<br />
{{toc}}<br />
This section describes all the configure options available for bluefish.<br />
{{note|text=This page has not been checked if it's uptodate. It is likely that all options are still being useable. To test all, would take a lot of time. In case you encounter any problem with the options listed here, please contact us on the developers mailing list or via the [https://sourceforge.net/p/bluefish/tickets/ ticket system].}}<br />
<br />
== 5.1. Standard configuration flags ==<br />
'''Configuration:'''<br />
*<tt>-h--help</tt> <br />
display this help and exit<br />
*<tt>--help=short</tt> <br />
display options specific to this package<br />
*<tt>--help=recursive</tt> <br />
display the short help of all the included packages<br />
*<tt>-V--version</tt> <br />
display version information and exit<br />
*<tt>-q--quiet--silent</tt> <br />
do not print "checking..." messages<br />
*<tt>--cache-file=FILE</tt> <br />
<nowiki>cache test results in FILE [disabled by default]</nowiki><br />
*<tt>-C--config-cache</tt> <br />
alias for <tt>--cache-file=config.cache</tt><br />
*<tt>-n--no-create</tt> <br />
do not create output files<br />
*<tt>--srcdir=DIR</tt> <br />
<nowiki>find the sources in DIR [configure dir or </nowiki>.. by default]<br />
<br />
'''Installation directories:'''<br />
<br />
{{tip|text=By default, '''make install''' will install all the files in /usr/local/bin, /usr/local/lib, etc. You can specify an installation prefix other than /usr/local using <tt>--prefix</tt>, for instance <tt>--prefix=$HOME</tt>}}.<br />
*<tt>--prefix=PREFIX</tt> <br />
<nowiki>install architecture-independent files in PREFIX [</nowiki>/usr/local by default]<br />
*<tt>--exec-prefix=EPREFIX</tt> <br />
<nowiki>install architecture-dependent files in EPREFIX [</nowiki>PREFIX by default]<br />
<br />
'''Fine tuning of the installation directories:'''<br />
<br />
{{tip|text=For better control, use the options below. Defaults are shown within brackets.}}<br />
<br />
*<tt>--bindir=DIR</tt> <br />
<nowiki>user executables [</nowiki>EPREFIX/bin]<br />
*<tt>--sbindir=DIR</tt> <br />
<nowiki>system admin executables [</nowiki>EPREFIX/sbin]<br />
*<tt>--libexecdir=DIR</tt> <br />
<nowiki>program executables [[Man 2 </nowiki>EPREFIX/libexec]]<br />
*<tt>--datadir=DIR</tt> <br />
<nowiki>read-only architecture-independent data [</nowiki>PREFIX/share]<br />
*<tt>--sysconfdir=DIR</tt> <br />
<nowiki>read-only single-machine data [</nowiki>PREFIX/etc]<br />
*<tt>--sharedstatedir=DIR</tt> <br />
<nowiki>modifiable architecture-independent data [</nowiki>PREFIX/com]<br />
*<tt>--localstatedir=DIR</tt> <br />
<nowiki>modifiable single-machine data [</nowiki>PREFIX/var]<br />
*<tt>--libdir=DIR</tt> <br />
<nowiki>object code libraries [[Man 2 </nowiki>EPREFIX/lib]]<br />
*<tt>--includedir=DIR</tt> <br />
<nowiki>C header files [[Man 2 </nowiki>PREFIX/include]]<br />
*<tt>--oldincludedir=DIR</tt> <br />
<nowiki>C header files for non-gcc [</nowiki>/usr/include]<br />
*<tt>--infodir=DIR</tt> <br />
<nowiki>info documentation [</nowiki>PREFIX/info]<br />
*<tt>--mandir=DIR</tt> <br />
<nowiki>man documentation [</nowiki>PREFIX/man]<br />
<br />
'''Program names:'''<br />
*<tt>--program-prefix=PREFIX</tt> <br />
prepend PREFIX to installed program names<br />
*<tt>--program-suffix=SUFFIX</tt> <br />
append SUFFIX to installed program names<br />
*<tt>--program-transform-name=PROGRAM</tt> <br />
run sed PROGRAM on installed program names<br />
<br />
'''System types:'''<br />
*<tt>--build=BUILD</tt> <br />
<nowiki>configure for building on BUILD [guessed]</nowiki><br />
*<tt>--host=HOST</tt> <br />
<nowiki>cross-compile to build programs to run on HOST [BUILD]</nowiki><br />
<br />
'''Some influential environment variables:'''<br />
<br />
<br />
[[File:Man2_tip.png]] Use these variables to override the choices made by '''configure''' or to help it to find libraries and programs with nonstandard names/locations.<br />
<br />
*<tt>CC</tt> <br />
C compiler command<br />
*<tt>CFLAGS</tt> <br />
C compiler flags<br />
*<tt>LDFLAGS</tt> <br />
<nowiki>linker flags, e.g. -L<lib dir> if you have libraries in a nonstandard directory <lib dir></nowiki><br />
*<tt>CPPFLAGS</tt> <br />
<nowiki>C/C++ preprocessor flags, e.g. -I<include dir> if you have headers in a nonstandard directory <include dir></nowiki><br />
*<tt>CPP</tt> <br />
C preprocessor<br />
<br />
== 5.2. Flags personal to bluefish ==<br />
'''Optional Features:'''<br />
<br />
<br />
{{note|text=These work like this: <tt>--enable-feature</tt> enables the feature, <tt>--disable-feature</tt> or <tt>--enable-feature=no</tt> disables the feature.}}<br />
<br />
By default, the <tt>--enable-feature</tt> option is not enabled, you should pass it if you want to get it, the <tt>--disable-xxx</tt> option is not disabled, you should pass it if you want to disable it.<br />
<br />
*<tt>--enable-auto-optimization</tt> <br />
Optimizes the build process for a given architecture if possible. It works only on a selected set of x86 platforms.<br />
<br />
How: rely on the result of:<br />
<br />
# '''uname -p''' or '''grep "model name" /proc/cpuinfo | cut -d: -f2''' to detect the architecture<br />
# the version of gcc to pass the arguments<br />
<br />
Tested gcc versions: 3.2.*, 3.0.*, 2.95.*<br />
<br />
Machines: Intel(R) Pentium(R) 4CPU, Pentium III, AMD-K6 (tm) 3D, Pentium 75 - 200, Pentium II, AMD Athlon(TM) XP<br />
<br />
Other machines are ignored<br />
<br />
*<tt>--enable-gcc3-optimization=type</tt> <br />
optimizes the build process for a given architecture if possible<br />
<br />
Machines: i386, i486, pentium, pentium-mmx, pentiumpro, pentium2, pentium3, pentium4, k6, k6-2, k6-3, athlon, athlon-tbird, athlon-4, athlon-xp, athlon-mp, winchip-c6, winchip2, c3<br />
<br />
Other machines are ignored<br />
<br />
*<tt>--enable-gcc2-optimization=type</tt> <br />
optimizes the build process for a given architecture if possible<br />
<br />
Machines: i386, i486, pentium, pentiumpro, k6<br />
<br />
Other machines are ignored<br />
<br />
*<tt>--enable-debugging-output</tt> <br />
turns debugging output on (this option impacts performance)<br />
*<tt>--disable-splash-screen</tt> <br />
suppresses the display of the splash screen at launch time (Bluefish launches faster)<br />
*<tt>--enable-highlight-profiling</tt> <br />
outputs statistics on where the program spends most of its time when highlighting patterns<br />
<br />
Usage: for debugging highlight patterns or trying to optimize the program<br />
*<tt>--enable-development</tt> <br />
enables development checks (slows down the program)<br />
*<tt>--enable-gprof-profiling</tt> <br />
outputs statistics on where the program spends most of its time by generating extra code to write profile information suitable for the analysis (slows down the program)<br />
*<tt>--enable-gcoc-coverage</tt> <br />
Purpose: to be able to collect statistics on how many times each branch is executed and how long it has lasted. Creates data files for the gcov code-coverage utility (slows down the program)<br />
*<tt>--disable-update-databases</tt> <br />
do not run the update-desktop-database or update-mime-database utilities after installation (mostly useful for package maintainers)<br />
*<tt>--disable-nls</tt> <br />
disables the Native Language Support (might speed up the program)<br />
<br />
'''Optional Packages:'''<br />
<br />
<br />
{{note|text=These work like this: <tt>--with-xxx=foo</tt> enables the flag, <tt>--without-xxx</tt> disables it. When not enabled, the default is used.}}<br />
*<tt>--without-libgnomeui</tt> <br />
disable libgnomeui detection<br />
*<tt>--with-gnome1-menu</tt> <br />
customized path for the gnome1 menu (disabled by default)<br />
<br />
Usage: <tt>--with-gnome1-menu=customizedpath</tt> or <tt>--without-gnome1-menu</tt> <br />
disabled by default<br />
*<tt>--with-freedesktop_org-menu</tt> <br />
customized path for the freedesktop.org (gnome and kde) menu<br />
<br />
Usage: <tt>--with-freedesktop_org-menu=customizedpath</tt> or <tt>--without-freedesktop_org-menu</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/applications<br />
* PREFIX/share/applications<br />
* /usr/X11R6/share/gnome/applications<br />
* PREFIX/share/gnome/applications<br />
<br />
*<tt>--with-freedesktop_org-mime</tt> <br />
customized path for the freedesktop.org (gnome and kde) mime<br />
<br />
Usage: <tt>--with-freedesktop_org-mime=customizedpath</tt> or <tt>--without-freedesktop_org-mime</tt> <br />
<br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/mime<br />
* PREFIX/share/mime<br />
* /usr/X11R6/share/gnome/mime<br />
* PREFIX/share/gnome/mime<br />
<br />
*<tt>--with-gnome2_4-mime</tt> <br />
customized path for the gnome 2.4 mime<br />
<br />
Usage: <tt>--with-gnome2_4-mime=customizedpath</tt> or <tt>--without-gnome2_4-mime</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/mime-info<br />
* PREFIX/share/mime-info<br />
* /usr/X11R6/share/gnome/mime-info<br />
* PREFIX/share/gnome/mime-info<br />
<br />
*<tt>--with-gnome2_4-appreg</tt> <br />
customized path for the gnome 2.4 application registry<br />
<br />
Usage: <tt>--with-gnome2_4-appreg=customizedpath</tt> or <tt>--without-gnome2_4-appreg</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/application-registry<br />
* PREFIX/share/application-registry<br />
* /usr/X11R6/share/gnome/application-registry<br />
* PREFIX/share/gnome/application-registry<br />
<br />
*<tt>--with-icon-path</tt> <br />
customized path for the icon.<br />
<br />
Usage: <tt>--with-icon-path=customizedpath</tt> or <tt>--without-icon-path</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/pixmaps<br />
* PREFIX/share/pixmaps<br />
* /usr/X11R6/share/gnome/pixmaps<br />
* PREFIX/share/gnome/pixmaps<br />
<br />
*<tt>--with-libiconv-prefix</tt> <br />
customized path for libiconv top level installation.<br />
<br />
Usage: <tt>--with-libiconv-prefix=customizeddir</tt><br />
<br />
Effect: searches for libiconv in customizeddir/include and customizeddir/lib<br />
*<tt>--with-included-gettext</tt> <br />
<br />
use the GNU gettext library included in the package<br />
<br />
'''Features specific to the CVS version:'''<br />
*<tt>--enable-unstable-install</tt> <br />
enable the installation of a bluefish development version with independent directories and files. Use this for CVS snapshots<br />
*<tt>--enable-scanner</tt> <br />
use the BfTextView scanner for editor widget<br />
*<tt>--disable-python</tt> <br />
do not build the python plugin<br />
*<tt>--with-theme-path</tt> <br />
customized path for the theme icons.<br />
<br />
Usage: <tt>--with-theme-path=customizedpath</tt> or <tt>--without-theme-path</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/icons/hicolor<br />
* PREFIX/share/icons/hicolor<br />
* /usr/X11R6/share/gnome/icons/hicolor<br />
* PREFIX/share/gnome/icons/hicolor<br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 ch02s04<br />
|up=Man 2 ch02<br />
|next=Man 2 ch02s06<br />
|prevname= 4.&nbsp;Installing a Bluefish Source Distribution<br />
|nextname=6.&nbsp;Installing a Binary Distribution<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=File:Man2_tip.gif&diff=2858File:Man2 tip.gif2022-12-22T06:23:01Z<p>DrMartinus: </p>
<hr />
<div></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Template:Tip&diff=2857Template:Tip2022-12-22T06:22:17Z<p>DrMartinus: Since the file Man2 tip.png was no longer available, a new image has been placed there</p>
<hr />
<div><table style="background-color:#FFFFCF;border:1px solid #aaa;-moz-border-radius:0.9em;padding:3px"><tr><td><br />
{|<br />
|valign="middle" align="center" width="40"|[[File:Man2_tip.gif]] <br />
|{{{text}}}<br />
|}<br />
</td></tr></table></div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Manual_2_ToC&diff=2856Manual 2 ToC2022-12-22T06:13:28Z<p>DrMartinus: Moved "Installing a Bluefish Source Distribution" to the updated section in "Getting and Installing Bluefish"</p>
<hr />
<div>{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| <center>'''Bluefish: The Definitive Guide'''</center><br />
|}<br />
<div style="text-align:center"><br />
'''Table of Contents <small>(part 1)</small>'''<br />
</div><br />
{{toc}} <br />
{|<br />
|see also: <br />
|[[Notes for Bluefish 2 Manual]]<br />
|-<br />
|<br />
|[[Guidelines for Writing this Manual]]<br />
|}<br />
<br />
{{Note|text=Note that the manual is currently being reworked. Many pages are outdated, others not yet available. They will be made available in the near future.}}<br />
<br />
Here an overview of what has been done so far:<br />
{|class="wikitable" style="margin:auto"<br />
!As per<br />
!What has been done<br />
|-<br />
|2022-12-21<br />
|All unnumbered sections under ''Preface'' and ''Getting and Installing Bluefish'' have been updated<br />
|}<br />
<br />
'''Bluefish 2.2 Manual''' <br />
<br />
== [[Preface|Preface]] ==<br />
[[About this Manual]] ¤ [[What is Bluefish?]] ¤ [[History of Bluefish]] ¤ [[Main Features of Bluefish]] ¤ [[How Stable is Bluefish?]] ¤ [[Contact Us]]<br />
== [[Getting and Installing Bluefish|Getting and Installing Bluefish]] ==<br />
[[Installing Bluefish]] ¤ [[Compiling Bluefish from source]] ¤ <br />
[[Choosing a Version]] ¤ [[Latest Stable Version|Latest Stable Version]] ¤ [[Getting Bluefish - Latest Snapshot|Latest Snapshot Version]] ¤ [[Getting Bluefish - Latest Development Version|Latest Developmental Version]] ¤ [[How and When Updates are Released]] ¤ [[Operating Systems Supported by Bluefish]] ¤ [[Man 2 ch02#1. Requirements|Requirements]] ¤ [[Installing Bluefish - System Issues| System Specific Installation Issues]] ¤ [[Installing Bluefish - Install from Source Code|Installing a Bluefish Source Distribution]]<br /><br />
<br />
<br />
[[Installing Bluefish - Install from Source Code|4. Installing a Bluefish Source Distribution]] ¤ Quick Installation Overview ¤ Installing from Development Source Tree|4.2. Installing from Development Source Tree ¤ Problems Compiling?<br /><br />
[[Installing Bluefish - Install from Source Code Options|5. Configure Options]] ¤ Standard configuration flags ¤ Flags personal to bluefish<br /><br />
[[Installing Bluefish - Install from Binary Distribution|6. Installing a Binary Distribution]] ¤ [[Installing Bluefish - Post-Installation Checklist|7. Post-installation Setup]]<br />
<br />
== [[Using Bluefish|Using Bluefish]] ==<br />
=== [[Launching Bluefish|Starting Bluefish]] ===<br />
[[Launching Bluefish#1. Launching Bluefish|1. Launching Bluefish]] ¤ [[Command line options|2. Command line options]]<br />
=== [[Editing Area|The user interface]] ===<br />
[[Editing Area#1. Editing Area|1. Editing Area]] ¤ [[Menus and Tool Bars|2. Menus and Tool Bars]] ¤ [[Side Panel|3. Side Panel]] ¤ [[Interface - Status Bar|4. Status Bar]] ¤ [[Interface - Help Menu|5. Help Menu]]<br />
=== [[Preferences|Preferences]] === <br />
=== [[Creating Files|Working with files and folders]] ===<br />
[[Creating Files#1. Creating files|1. Creating files]] ¤ [[Managing Directories|2. Managing directories]] ¤ [[Opening Files|3. Opening files]] ¤ [[Saving Files|4. Saving files]] ¤ [[Renaming Files|5. Renaming files]] ¤ [[Deleting files|6. Deleting files]] ¤ [[Closing Files|7. Closing files]] ¤ [[Inserting files|8. Inserting files]]<br /><br />
[[Editing|9. Editing]] ¤ Undo and Redo ¤ Cut, Copy, and Paste ¤ Input methods<br /><br />
[[Basic Find and Replace|10. Basic Find and Replace]] ¤ Searching for a word within a whole document ¤ Setting limits to the search scope ¤ Case sensitive search ¤ Overlapping searches ¤ Retrieving previous search strings ¤ More on find ¤ Replacing features ¤ Retrieving previous replace strings ¤ Changing letter case when replacing ¤ Choosing strings to replace ¤ More on replace<br /><br />
[[File Types (1/2)|11. File types]] ¤ Syntax highlighting<br /><br />
[[File Types (2/2)|12. More on files]] ¤ Remote files ¤ Character encoding ¤ Open advanced<br />
=== [[Navigating through a document|Navigation and Managing documents]] === <br />
Navigating through a document<br /><br />
[[Go Menu and Document Navigation|2. Navigating through many documents]] ¤ [[Projects|3. Projects]]<br /><br />
[[Bookmarks|4. Bookmarks]] ¤ Generating several bookmarks at once]]<br /><br />
[[Find and Replace|5. Find and Replace]] ¤ Find Again ¤ Find from Selection ¤ Find and Replace Using Regular Expressions<br /><br />
[[Templates| Templates]]<br />
=== [[Indenting|More than a Text Editor]] === <br />
[[Indenting#1. Indenting|1. Indenting]] ¤ [[Autocompletion|2. Autocompletion]] ¤ [[Hidden features]] ¤ [[Spell checker|3. Spell checker]] ¤ [[Programming and Markup Languages Function Reference|4. Function reference]]<br /><br />
[[HTML Editing|5. HTML]] ¤ Special find and replace features ¤ Thumbnail generation<br /><br />
[[Quick Bar Customization|6. Customizing the Quick bar]]<br /><br />
[[Snippets plugin|7. Snippets plugin]] (was Custom menu in Bluefish 1) ¤ Adding a snippet dialog ¤ Adding a snippet replace dialog<br /><br />
[[External Programs and Filters|8. External programs, filters]] ¤ Customizing browsers ¤ Customizing Commands menu ¤ Customizing Ouputbox menu<br />
<br />
=== [[Modifying shortcut keys|Customising Bluefish]] === <br />
Modifying shortcut keys<br /><br />
[[Invisible Files and Folders|2. Showing hidden files and folders]] ¤ [[Showing backup files|3. Showing backup files]] ¤ [[Editor Appearance Customization|4. Editor appearance]] ¤ [[Bookmarks Path Customization|5. Customizing the bookmarks path]] ¤ [[HTML Tags Style Customization|6. Customizing the html tags style]] ¤ [[Author Meta Tag|7. Changing the author meta tag on the fly]]<br /><br />
[[File Handling and Browsing Customization|8. Customizing files handling and browsing]] ¤ Setting the encoding meta tag on save ¤ Setting the default base directory ¤ Merging file browser views ¤ 8.4. Backup files ¤ 8.5. Using multiple instances of a file<br /><br />
[[User Interface Customization|9. Customizing the user interface]] ¤ [[File Types Handling|10. Modifying file types]] ¤ [[File Filters|11. Modifying the files filters]] ¤ [[Highlight Patterns Modification|12. Modifying the highlighting patterns]]<br />
*[[General Shortcuts|IX. Shortcuts available within Bluefish]] ¤ [[General Shortcuts#1. General Shortcuts|1. General Shortcuts]] ¤ [[HTML Shortcuts|2. HTML Shortcuts]]<br />
<br />
== [[Developing Bluefish|Developing Bluefish]] ==<br />
=== [[Bugs - Using the Debugger|Debugging Bluefish]] ===<br />
[[Bugs - Using the Debugger#1. Using the Debugger|1. Using the Debugger]] ¤ [[Bugs - Filing a Report|2. Filling a bug report]]<br />
=== [[Editor Tab Options|Reference]] === <br />
[[Editor Tab Options#1. Options in the Editor Tab|1. Options in the Editor Tab]] ¤ [[HTML Tab Options|2. Options in the HTML Tab]] ¤ [[Files Tab Options|3. Options in the Files Tab]] ¤ [[User Interface Tab Options|4. Options in the User interface Tab]] ¤ [[Images Tab Options|5. Options in the Images Tab]]<br />
=== [[Development - Indenting and Formatting|Development guidelines]] ===<br />
Indenting and formating style<br /><br />
[[Development - Naming|2. Naming]] ¤ [[Development - Declaring Procedures|3. Declaring procedures]] ¤ [[Development - Header Files|4. Header files]] ¤ [[Development - New Files|5. New files]] ¤ [[Development - File Reference|6. File reference]] ¤ [[Development - Patches|7. Patches]]<br /><br />
[[Development - Translations|8. Translations]] ¤ Introduction ¤ PO files basics ¤ <br />
Shortcut keys ¤ How to contribute<br /><br />
[[Development - Some tips|9. Some tips]] ¤ [[Development - Making Releases|10. Making releases]] ¤ [[Development - Useful Stuff|11. Useful stuff]]<br />
<br />
== [[Table of Contents (2/3)|'''Table of Contents (2/3)''']] ==<br />
<br />
{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| &nbsp;<br />
| <center>[[Man 2 index|Home]]</center><br />
| <div align="right">&nbsp;</div><br />
|}<br />
<br />
[[Category:Manual 2]]</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Installing_Bluefish_-_Install_from_Source_Code&diff=2855Installing Bluefish - Install from Source Code2022-12-22T06:11:31Z<p>DrMartinus: updated links to other pages</p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.2.12<br />
|st=d<br />
|Title=4.&nbsp;Installing a Bluefish Source Distribution<br />
|prev=Man 2 ch02s03<br />
|Subtitle=Chapter&nbsp;II.&nbsp;Installing Bluefish<br />
|next=Man 2 ch02s05<br />
}}<br />
<br />
{{toc}}<br />
<br />
By installing Bluefish from source, you may be able to get a newer version (from SVN) than those distributed as binaries. You may also need to compile from source if no binary is available for your system.<br />
<br />
== 4.1. Quick Installation Overview ==<br />
This is the short installation description. Consult the other chapters, e.g. [[Bluefish Wiki:Installing Bluefish from Source | Installing Bluefish from Source]] if you are in doubt.<br />
<br />
Bluefish is installed using the standard 'configure, make, make install' steps. Assuming you have downloaded a bluefish source package, for instance bluefish-ver.tar.gz (naturally, change the filename to what's appropriate), you complete the installation with the following steps:<br />
<br />
# '''tar -zxvf bluefish-ver.tar.gz'''<br />
# '''cd bluefish-ver'''<br />
# '''./configure''' (see [[Installing Bluefish - Install from Source Code Options|“Configure Options”]])<br />
# '''make'''<br />
# '''su -c 'make install''''<br />
# Now, type '''bluefish''' to run. You may delete the bluefish-ver directory.<br />
<br />
The '''configure''' script is used to automatically find the appropriate settings for your system. Because of differences between systems, this compile-time configuration is necessary, and configure solves this challenge easily -- with an added bonus of telling whether you have everything needed to compile.<br />
<br />
The configure-script can be configured. This is something you most likely will not need to do, but it is easy to do if necessary. For a complete list of configure options, see [[Installing Bluefish - Install from Source Code Options|“Configure Options”]]<br />
<br />
== 4.2. Installing from Development Source Tree ==<br />
You can get the latest Bluefish version via SVN using the instructions in [[Man 2 ch01s04|Section 4, “Latest Developmental Version”]]:<br />
cd TheChosenDirectory<br />
{{SVN}}<br />
<br />
Next, install it with the following steps:<br />
<br />
# Enter the directory containing the bluefish source files: <br/>'''cd TheChosenDirectory/bluefish-code'''<br />
# Next, generate the configure script by running <br/>'''./autogen.sh'''<br />
# Then, you run <br/>'''./configure''' with whatever options you might want (see [[Installing Bluefish - Install from Source Code Options|“Configure Options”]]). <br/> This example will cause ''make install'' to install Bluefish with the specified directory as prefix (i.e. the binary is installed in /usr/bin/bluefish-unstable):'''./configure --prefix=/usr'''<br/>By default, `make install' will install all the files in `/usr/local/bin', `/usr/local/lib' etc.<br/>Run `./configure -h' to list available options.<br/>If configure fails, it will probably give a hint telling you what is missing or wrong.<br />
# Assuming it completed successfully, your next step is to compile Bluefish. To do this, run '''make'''.<br />
# When ''make'' has completed, you can install Bluefish: (''su'' to root first, unless you specified a user writable prefix to configure), then issue: '''<nowiki># make install</nowiki>'''.<br />
#Now, type '''bluefish-unstable''' to run.<br />
To update the sources at a later time:<br />
# Enter the directory containing the bluefish source files: '''cd TheChosenDirectory/bluefish-code'''<br />
# '''svn update'''<br />
# and then run '''./configure''', '''make''' and '''<nowiki>#</nowiki> make install'''.<br />
<br />
== 4.3. Problems Compiling? ==<br />
If compilation fails, first make sure you have the necessary utilities and libraries. See [[Man 2 ch02#Section 1, “Requirements”| Section 1, “Requirements”]].<br />
<br />
Next, see if your system is mentioned in [[Man 2 ch02s03|Section 3, “System Specific Installation Issues”]].<br />
<br />
Below is a list of well known problems that have been mentioned on the bluefish-dev list:<br />
<br />
* make: *** No targets specified and no makefile found. Stop.<br/> This will happen if ''configure'' fails and you try to run '''make'''. It also happens if you're running '''make''' from the wrong directory.<br />
* ... more trouble to come ;-)<br />
<br />
If you're unable to find a solution (or if you think you have a solution others might want), feel free to contact us on the ''bluefish-dev'' list (See [[Man 2 pr01s02#2.4. Contact Us| Section 2.4, “Contact Us”]]). You may want to contact the bluefish package maintainer for your distribution first when appropriate.<br />
<br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 ch02s03<br />
|up=Man 2 ch02<br />
|next=Man 2 ch02s05<br />
|prevname= 3.&nbsp;System Specific Installation Issues<br />
|nextname=5.&nbsp;Configure Options<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=What_is_Bluefish%3F&diff=2854What is Bluefish?2022-12-22T06:10:14Z<p>DrMartinus: Changed link to bug tracker</p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.0.0<br />
|st=d<br />
|Title=2.&nbsp;What is Bluefish?<br />
|prev=Man 2 pr01<br />
|Subtitle=Preface<br />
|next=Man 2 pt01<br />
}}<br />
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;"><br />
*[[#2.1. History of Bluefish| 2.1. History of Bluefish]] <br />
*[[#2.2. Main Features of Bluefish| 2.2. Main Features of Bluefish]] <br />
*[[#2.3. How Stable is Bluefish?| 2.3. How Stable is Bluefish?]] <br />
*[[#2.4. Contact Us| 2.4. Contact Us]] <br />
</div><br />
Bluefish is a powerful editor for experienced web designers and programmers based on the GTK2 GUI interface. Bluefish supports many programming and markup languages, but focuses on editing dynamic and interactive websites.<br />
<br />
Bluefish is not a WYSIWYG<ref>What You See Is What You Get</ref> text editor. This is deliberate, allowing the programmer to stay in full control. To facilitate the editing process, a large number of features are at your disposal. For inserting markup and code, there are tool bars, dialogs, and predefined/user-customized menus. Syntax highlighting, advanced search/replace functionality, scalability and language function references make Bluefish a powerful tool for development.<br />
<br />
== 2.1. History of Bluefish ==<br />
Bluefish development started under a different name. A good and free text editor targeted towards web development was not available. Olivier Sessink started the project ProSite. Chris Mazuc also started an HTML editor. On a GTK development mailing list, Olivier Sessink and Chris Mazuc saw each others postings, and decided to team up. Olivier had a basic editor, Chris had many HTML dialogs ready. After merging the code this was for a while known as the Thtml editor.<br />
<br />
After a while Neil Millar joined the project to add weblint integration and a color dialog. Because the project became larger and more mature, a logo was wanted. After many discussions about boring logos, Neil Millar came up with a cute blue fish. Because this logo was appreciated by all, the name changed into the final name Bluefish.<br />
<br />
After this initial stage, many developers, translators, testers and users joined the project.<br />
<br />
Several years have passed since the first Bluefish release. Since that time, the fish has gained a reputation as an excellent editor, with qualities like stability, usability and numerous features. Also, Bluefish is small, fast and efficient, making it usable even on slow machines.<br />
<br />
== 2.2. Main Features of Bluefish ==<br />
This list will give you an overview of the most important or outstanding features found in Bluefish:<br />
<br />
* A What You Write Is What You Get interface<br />
* Multiple document interface, will easily open 500+ documents (tested 3500 with documents simultaneously).<br />
* Customizable syntax highlighting based on Perl compatible regular expressions, with subpattern support. Default patterns are included for:<br />
** C<br />
** cfml<br />
** ChangeLog<br />
** CSS stylesheet<br />
** Gettext po<br />
** HTML<br />
** Java<br />
** JScript<br />
** JavaScript<br />
** Octave<br />
** Pascal<br />
** Perl<br />
** PHP<br />
** Python<br />
** R<br />
** Shell<br />
** SQL<br />
** Tcl<br />
** Ruby<br />
** XML<br />
* Anti-aliased text window<br />
* Multiple encodings support, can convert between different character sets, supports multibyte characters, Unicode, UTF8, etc.<br />
* Nice wizards for startup, tables, frames, and others<br />
* Dialogs for many HTML tags, with all their attributes<br />
* HTML tool bar and tear-off menus<br />
* User-customizable tool bar for quick access to often used functions<br />
* Open files based on filename patterns and/or content, from selection or URIs<br />
* Fully featured image insert dialog<br />
* Thumbnail creation and automatically linking of the thumbnail with the original image<br />
* Multi-thumbnail generation for easy creation of photo albums or screen shot pages<br />
* Line numbers along the document<br />
* Bookmarks for lines across multiple documents, with bookmark browser<br />
* A custom menu, specify your own tags or sets of code, and define your own dialogs<br />
* Custom search and replace pattern support for the Custom menu<br />
* Very powerful search and replace, allowing POSIX and Perl Compatible regular expressions and sub-pattern replacing<br />
* Excellent undo/redo functionality<br />
* Configurable recent documents and recent directories functionality<br />
* Spell checking<br />
* Translations in ''twenty languages''<br />
* User customizable integration with many programs, including weblint, tidy, make, javac, etc.<br />
* XML based function reference. Currently, references are included for Apache, DHTML, DocBook, HTML, PHP, and SQL. A GTK reference is available, and support for Perl and Python will be added. You may also create your own function reference. The XML format is described later in the manual.<br />
* XML based reference library for CSS2, HTML, PHP, and Python.<br />
* Projects management.<br />
<br />
As Bluefish is a part of a larger desktop environment, we have focused on making the GUI consistent with the Gnome HIG<ref>GNOME Human Interface Guidelines, accessible at [http://developer.gnome.org/projects/gup/hig/ http://developer.gnome.org/projects/gup/hig/]</ref>. However, we prefer not following it in every detail, as some parts are intended ''for the end user'', while Bluefish is ''for the programmer''.<br />
<br />
== 2.3. How Stable is Bluefish? ==<br />
Quite stable! The Bluefish developers aim to produce code that neither crashes nor leaks memory. Of course, that is not always easy to do. Leaks and crashes are often fixed in CVS as soon as they are discovered and hunted down. In addition to Bluefish's large user base, the developers use Bluefish for their daily work. So, fixing bugs and preventing crashes is always a major priority. However, some nags still exist. One example being the issue of slightly sluggish copy/paste functions.<br />
<br />
For an updated list of open bugs, please go to the [http://bugzilla.gnome.org/browse.cgi?product=bluefish bluefish] page on bugzilla gnome.<br />
<br />
We appreciate any and all contributions! Please tell us if Bluefish crashes on you :-).<br />
<br />
== 2.4. Contact Us ==<br />
We, the Bluefish development team, welcome all comments, user requests, constructive criticisms, and contributions. Are you curious or seeking information regarding Bluefish? Would you like to contribute by translating Bluefish or its manual? Here are your options:<br />
<br />
* [http://bluefish.openoffice.nl/ http://bluefish.openoffice.nl/] - The main website where you will find news, updates, manual and more information.<br />
* [http://bfwiki.tellefsen.net/ http://bfwiki.tellefsen.net/] - The Bluefish WiKi is the notebook for the developers, containing a lot of information. This includes, but is not limited to: updated project road maps, status of translations.<br />
* For bug reports and features requests, related to bluefish, its web site, and its manual, please fill the appropriate bug type at [https://sourceforge.net/p/bluefish/tickets/ https://sourceforge.net/p/bluefish/tickets/], the bluefish bugzilla page - for instructions, see [ch10s02|Section 2, “Filling a bug report”].<br />
* You can subscribe to the users' Bluefish mailing list by sending an email containing “subscribe bluefish-users” to [mailto:bluefish-users-request@lists.ems.ru bluefish-users-request@lists.ems.ru].<br />
* You can subscribe to the developers' Bluefish mailing list by sending an email containing “subscribe bluefish-dev” to [mailto:bluefish-dev-request@lists.ems.ru bluefish-dev-request@lists.ems.ru].<br />
* Do you want to help translate Bluefish? Please let us know by dropping an email to <del>Walter Echarri [mailto:wecharri(at)arnet.com.ar wecharri(at)arnet.com.ar]</del>, our friendly translation maintainer.<br />
* If you want to help improve the manual or write new sections, please send an email to the Bluefish manual maintainer, <del>Michèle Garoche [mailto:michele.garoche(at)easyconnect.fr michele.garoche(at)easyconnect.fr]</del>. Guidelines for this manual can be found in [[Man 2 apc|Appendix C, Guidelines for Writing this Manual]]<br />
* If you have a general question, drop an email to [mailto:bluefish(at)bluefish.openoffice.nl bluefish(at)bluefish.openoffice.nl].<br />
<br />
<br />
<br />
<references/><br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 pr01<br />
|up=Man 2 pr01<br />
|next=Man 2 pt01<br />
|prevname= Preface<br />
|nextname=Part&nbsp;1.&nbsp;Getting and Installing Bluefish<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Installing_Bluefish_-_Install_from_Source_Code&diff=2853Installing Bluefish - Install from Source Code2022-12-21T16:51:14Z<p>DrMartinus: minor adjustments, changed links to match new page names</p>
<hr />
<div>__NOTOC__<br />
{{Man2top<br />
|lang=en<br />
|rev=2.2.12<br />
|st=d<br />
|Title=4.&nbsp;Installing a Bluefish Source Distribution<br />
|prev=Man 2 ch02s03<br />
|Subtitle=Chapter&nbsp;II.&nbsp;Installing Bluefish<br />
|next=Man 2 ch02s05<br />
}}<br />
<br />
{{toc}}<br />
<br />
By installing Bluefish from source, you may be able to get a newer version (from SVN) than those distributed as binaries. You may also need to compile from source if no binary is available for your system.<br />
<br />
== 4.1. Quick Installation Overview ==<br />
This is the short installation description. Consult the other chapters, e.g. [[Bluefish Wiki:Installing Bluefish from Source | Installing Bluefish from Source]] if you are in doubt.<br />
<br />
Bluefish is installed using the standard 'configure, make, make install' steps. Assuming you have downloaded a bluefish source package, for instance bluefish-ver.tar.gz (naturally, change the filename to what's appropriate), you complete the installation with the following steps:<br />
<br />
# '''tar -zxvf bluefish-ver.tar.gz'''<br />
# '''cd bluefish-ver'''<br />
# '''./configure''' (see [[Installing Bluefish - Install from Source Code Options|“Configure Options”]])<br />
# '''make'''<br />
# '''su -c 'make install''''<br />
# Now, type '''bluefish''' to run. You may delete the bluefish-ver directory.<br />
<br />
The '''configure''' script is used to automatically find the appropriate settings for your system. Because of differences between systems, this compile-time configuration is necessary, and configure solves this challenge easily -- with an added bonus of telling whether you have everything needed to compile.<br />
<br />
The configure-script can be configured. This is something you most likely will not need to do, but it is easy to do if necessary. For a complete list of configure options, see [[Man 2 ch02s05|Section 5, “Configure Options”]]<br />
<br />
== 4.2. Installing from Development Source Tree ==<br />
You can get the latest Bluefish version via SVN using the instructions in [[Man 2 ch01s04|Section 4, “Latest Developmental Version”]]:<br />
cd TheChosenDirectory<br />
{{SVN}}<br />
<br />
Next, install it with the following steps:<br />
<br />
# Enter the directory containing the bluefish source files: <br/>'''cd TheChosenDirectory/bluefish-code'''<br />
# Next, generate the configure script by running <br/>'''./autogen.sh'''<br />
# Then, you run <br/>'''./configure''' with whatever options you might want (see [[Man 2 ch02s05|Section 5, “Configure Options”]]). <br/> This example will cause ''make install'' to install Bluefish with the specified directory as prefix (i.e. the binary is installed in /usr/bin/bluefish-unstable):'''./configure --prefix=/usr'''<br/>By default, `make install' will install all the files in `/usr/local/bin', `/usr/local/lib' etc.<br/>Run `./configure -h' to list available options.<br/>If configure fails, it will probably give a hint telling you what is missing or wrong.<br />
# Assuming it completed successfully, your next step is to compile Bluefish. To do this, run '''make'''.<br />
# When ''make'' has completed, you can install Bluefish: (''su'' to root first, unless you specified a user writable prefix to configure), then issue: '''<nowiki># make install</nowiki>'''.<br />
#Now, type '''bluefish-unstable''' to run.<br />
To update the sources at a later time:<br />
# Enter the directory containing the bluefish source files: '''cd TheChosenDirectory/bluefish-code'''<br />
# '''svn update'''<br />
# and then run '''./configure''', '''make''' and '''<nowiki>#</nowiki> make install'''.<br />
<br />
== 4.3. Problems Compiling? ==<br />
If compilation fails, first make sure you have the necessary utilities and libraries. See [[Man 2 ch02#Section 1, “Requirements”| Section 1, “Requirements”]].<br />
<br />
Next, see if your system is mentioned in [[Man 2 ch02s03|Section 3, “System Specific Installation Issues”]].<br />
<br />
Below is a list of well known problems that have been mentioned on the bluefish-dev list:<br />
<br />
* make: *** No targets specified and no makefile found. Stop.<br/> This will happen if ''configure'' fails and you try to run '''make'''. It also happens if you're running '''make''' from the wrong directory.<br />
* ... more trouble to come ;-)<br />
<br />
If you're unable to find a solution (or if you think you have a solution others might want), feel free to contact us on the ''bluefish-dev'' list (See [[Man 2 pr01s02#2.4. Contact Us| Section 2.4, “Contact Us”]]). You may want to contact the bluefish package maintainer for your distribution first when appropriate.<br />
<br />
<br />
<br />
{{Man2bottom<br />
|prev=Man 2 ch02s03<br />
|up=Man 2 ch02<br />
|next=Man 2 ch02s05<br />
|prevname= 3.&nbsp;System Specific Installation Issues<br />
|nextname=5.&nbsp;Configure Options<br />
}}</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=How_Stable_is_Bluefish%3F&diff=2852How Stable is Bluefish?2022-12-21T08:56:42Z<p>DrMartinus: Created this page</p>
<hr />
<div>The current stable release {{Version}} is extremely stable. In case you encounter an issue, please report it at [https://sourceforge.net/p/bluefish/tickets/ the ticket system]. <br />
<br />
The sourcecode available via SVN ({{SVN}}) has some bugs fixed and maybe a few new features, which haven't been tested extensively. Hence it is possible that there are issues. Please report issues at [https://sourceforge.net/p/bluefish/tickets/ the ticket system].</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Main_Features_of_Bluefish&diff=2851Main Features of Bluefish2022-12-21T08:52:08Z<p>DrMartinus: Created this page, using the info from the project page</p>
<hr />
<div>Bluefish is an extremely powerful editor. Some of its features are listed below:<br />
<br />
Bluefish has many features, this list will give you an overview of the most important or outstanding features in Bluefish 2.2. Not all features are (yet) available on Windows or Mac OSX.<br />
<br />
* Lightweight - Bluefish tries to be lean and clean, as far as possible given it is a GUI editor.<br />
* Fast - Bluefish starts really quick (even on a netbook) and loads hundreds of files within seconds.<br />
* Multiple document interface, easily opens 500+ documents (tested >10000 documents simultaneously)<br />
* Project support, enables you to work efficiently on multiple projects, and automatically restores settings for each project.<br />
* Multi-threaded support for remote files using gvfs, supporting FTP, SFTP, HTTP, HTTPS, WebDAV, CIFS and more (not yet fully functional)<br />
* Very powerful search and replace, with support for Perl Compatible regular expressions, sub-pattern replacing, and search and replace in files on disk.<br />
* Open files recursively based on filename patterns and/or content patterns<br />
* Snippets sidebar - specify custom dialogs, search and replace patterns or insert patterns and bind them to a shortkut key combination of your liking to speed up your development process<br />
* Integrate external programs such as make, lint, weblint, xmllint, tidy, javac, or your own program or script to handle advanced text processing or error detection<br />
* Integrate external filters of your liking, pipe your document (or just the current selected text) through sort, sed, awk or any custom script<br />
* Unlimited undo/redo functionality<br />
* In-line spell checker which is programing language aware (spell check comments and strings, but not code), requires libenchant during compilation (requires libenchant)<br />
* Auto-recovery of changes in modified documents after a crash, kill or shutdown<br />
* Character map of all unicode characters (requires libgucharmap during compilation)(requires libgucharmap)<br />
* Site upload / download (not fully operational yet)<br />
* Full screen editing<br />
* Many tools such as tabs to spaces, join lines, lines to columns, strip whitespace, etc. etc.<br />
* Customizable programming language support:<br />
** In-line reference information (move your mouse over a function name or tag name) for various programming languages<br />
** Code block folding<br />
** Highlighting matching block start and end markers (both brackets and tags)<br />
** Auto-completion and auto-tag-closing for many programming languages, with reference information, and even for nested languages (e.g. css and javascript inside html code that is inside a php document)<br />
* with included language definition files for:<br />
** Ada<br />
** ASP .NET and VBS<br />
** C/C++<br />
** CSS<br />
** CFML<br />
** Clojure<br />
** D<br />
** gettext PO<br />
** Google Go<br />
** HTML, XHTML and HTML5<br />
** Java and JSP<br />
** JavaScript and jQuery<br />
** Lua<br />
** Octave/MATLAB<br />
** MediaWiki<br />
** NSIS<br />
** Pascal<br />
** Perl<br />
** PHP<br />
** Python<br />
** R<br />
** Ruby<br />
** SASS<br />
** Shell<br />
** Scheme<br />
** SQL<br />
** SVG<br />
** Vala<br />
** Wordpress<br />
** XML<br />
* Multiple encodings support. Bluefish works internally with UTF8, but can save your documents in any desired encoding.<br />
* Bookmarks functionality<br />
* HTML toolbar and tearable menu's<br />
** Dialogs and wizards for many HTML tags, with all their attributes<br />
** Fully featured image insert dialog<br />
** Thumbnail creation and automatically linking of the thumbnail with the original image, and multi-thumbnail creation<br />
** User-customizable toolbar for quick access to often used functions<br />
* ZenCoding support (optional, requires Python)<br />
* Compliance with the Gnome and KDE user interface guidelines where possible<br />
* Translations into 17 languages - and more are coming for the next releases .</div>DrMartinushttps://bfwiki.tellefsen.net//index.php?title=Manual_2_ToC&diff=2850Manual 2 ToC2022-12-21T08:42:14Z<p>DrMartinus: Moved "System Specific Installation Issues", as this page has been updated to match version 2.2</p>
<hr />
<div>{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| <center>'''Bluefish: The Definitive Guide'''</center><br />
|}<br />
<div style="text-align:center"><br />
'''Table of Contents <small>(part 1)</small>'''<br />
</div><br />
{{toc}} <br />
{|<br />
|see also: <br />
|[[Notes for Bluefish 2 Manual]]<br />
|-<br />
|<br />
|[[Guidelines for Writing this Manual]]<br />
|}<br />
<br />
<br />
'''Bluefish 2.2 Manual''' <br />
<br />
== [[Preface|Preface]] ==<br />
[[About this Manual]] ¤ [[What is Bluefish?]] ¤ [[History of Bluefish]] ¤ [[Main Features of Bluefish]] ¤ [[How Stable is Bluefish?]] ¤ [[Contact Us]]<br />
== [[Getting and Installing Bluefish|Getting and Installing Bluefish]] ==<br />
[[Installing Bluefish]] ¤ [[Compiling Bluefish from source]] ¤ <br />
[[Choosing a Version]] ¤ [[Latest Stable Version|Latest Stable Version]] ¤ [[Getting Bluefish - Latest Snapshot|Latest Snapshot Version]] ¤ [[Getting Bluefish - Latest Development Version|Latest Developmental Version]] ¤ [[How and When Updates are Released]] ¤ [[Operating Systems Supported by Bluefish]] ¤ [[Man 2 ch02#1. Requirements|Requirements]] ¤ [[Installing Bluefish - System Issues| System Specific Installation Issues]]<br /><br />
<br />
<br />
[[Installing Bluefish - Install from Source Code|4. Installing a Bluefish Source Distribution]] ¤ Quick Installation Overview ¤ Installing from Development Source Tree|4.2. Installing from Development Source Tree ¤ Problems Compiling?<br /><br />
[[Installing Bluefish - Install from Source Code Options|5. Configure Options]] ¤ Standard configuration flags ¤ Flags personal to bluefish<br /><br />
[[Installing Bluefish - Install from Binary Distribution|6. Installing a Binary Distribution]] ¤ [[Installing Bluefish - Post-Installation Checklist|7. Post-installation Setup]]<br />
<br />
== [[Using Bluefish|Using Bluefish]] ==<br />
=== [[Launching Bluefish|Starting Bluefish]] ===<br />
[[Launching Bluefish#1. Launching Bluefish|1. Launching Bluefish]] ¤ [[Command line options|2. Command line options]]<br />
=== [[Editing Area|The user interface]] ===<br />
[[Editing Area#1. Editing Area|1. Editing Area]] ¤ [[Menus and Tool Bars|2. Menus and Tool Bars]] ¤ [[Side Panel|3. Side Panel]] ¤ [[Interface - Status Bar|4. Status Bar]] ¤ [[Interface - Help Menu|5. Help Menu]]<br />
=== [[Preferences|Preferences]] === <br />
=== [[Creating Files|Working with files and folders]] ===<br />
[[Creating Files#1. Creating files|1. Creating files]] ¤ [[Managing Directories|2. Managing directories]] ¤ [[Opening Files|3. Opening files]] ¤ [[Saving Files|4. Saving files]] ¤ [[Renaming Files|5. Renaming files]] ¤ [[Deleting files|6. Deleting files]] ¤ [[Closing Files|7. Closing files]] ¤ [[Inserting files|8. Inserting files]]<br /><br />
[[Editing|9. Editing]] ¤ Undo and Redo ¤ Cut, Copy, and Paste ¤ Input methods<br /><br />
[[Basic Find and Replace|10. Basic Find and Replace]] ¤ Searching for a word within a whole document ¤ Setting limits to the search scope ¤ Case sensitive search ¤ Overlapping searches ¤ Retrieving previous search strings ¤ More on find ¤ Replacing features ¤ Retrieving previous replace strings ¤ Changing letter case when replacing ¤ Choosing strings to replace ¤ More on replace<br /><br />
[[File Types (1/2)|11. File types]] ¤ Syntax highlighting<br /><br />
[[File Types (2/2)|12. More on files]] ¤ Remote files ¤ Character encoding ¤ Open advanced<br />
=== [[Navigating through a document|Navigation and Managing documents]] === <br />
Navigating through a document<br /><br />
[[Go Menu and Document Navigation|2. Navigating through many documents]] ¤ [[Projects|3. Projects]]<br /><br />
[[Bookmarks|4. Bookmarks]] ¤ Generating several bookmarks at once]]<br /><br />
[[Find and Replace|5. Find and Replace]] ¤ Find Again ¤ Find from Selection ¤ Find and Replace Using Regular Expressions<br /><br />
[[Templates| Templates]]<br />
=== [[Indenting|More than a Text Editor]] === <br />
[[Indenting#1. Indenting|1. Indenting]] ¤ [[Autocompletion|2. Autocompletion]] ¤ [[Hidden features]] ¤ [[Spell checker|3. Spell checker]] ¤ [[Programming and Markup Languages Function Reference|4. Function reference]]<br /><br />
[[HTML Editing|5. HTML]] ¤ Special find and replace features ¤ Thumbnail generation<br /><br />
[[Quick Bar Customization|6. Customizing the Quick bar]]<br /><br />
[[Snippets plugin|7. Snippets plugin]] (was Custom menu in Bluefish 1) ¤ Adding a snippet dialog ¤ Adding a snippet replace dialog<br /><br />
[[External Programs and Filters|8. External programs, filters]] ¤ Customizing browsers ¤ Customizing Commands menu ¤ Customizing Ouputbox menu<br />
<br />
=== [[Modifying shortcut keys|Customising Bluefish]] === <br />
Modifying shortcut keys<br /><br />
[[Invisible Files and Folders|2. Showing hidden files and folders]] ¤ [[Showing backup files|3. Showing backup files]] ¤ [[Editor Appearance Customization|4. Editor appearance]] ¤ [[Bookmarks Path Customization|5. Customizing the bookmarks path]] ¤ [[HTML Tags Style Customization|6. Customizing the html tags style]] ¤ [[Author Meta Tag|7. Changing the author meta tag on the fly]]<br /><br />
[[File Handling and Browsing Customization|8. Customizing files handling and browsing]] ¤ Setting the encoding meta tag on save ¤ Setting the default base directory ¤ Merging file browser views ¤ 8.4. Backup files ¤ 8.5. Using multiple instances of a file<br /><br />
[[User Interface Customization|9. Customizing the user interface]] ¤ [[File Types Handling|10. Modifying file types]] ¤ [[File Filters|11. Modifying the files filters]] ¤ [[Highlight Patterns Modification|12. Modifying the highlighting patterns]]<br />
*[[General Shortcuts|IX. Shortcuts available within Bluefish]] ¤ [[General Shortcuts#1. General Shortcuts|1. General Shortcuts]] ¤ [[HTML Shortcuts|2. HTML Shortcuts]]<br />
<br />
== [[Developing Bluefish|Developing Bluefish]] ==<br />
=== [[Bugs - Using the Debugger|Debugging Bluefish]] ===<br />
[[Bugs - Using the Debugger#1. Using the Debugger|1. Using the Debugger]] ¤ [[Bugs - Filing a Report|2. Filling a bug report]]<br />
=== [[Editor Tab Options|Reference]] === <br />
[[Editor Tab Options#1. Options in the Editor Tab|1. Options in the Editor Tab]] ¤ [[HTML Tab Options|2. Options in the HTML Tab]] ¤ [[Files Tab Options|3. Options in the Files Tab]] ¤ [[User Interface Tab Options|4. Options in the User interface Tab]] ¤ [[Images Tab Options|5. Options in the Images Tab]]<br />
=== [[Development - Indenting and Formatting|Development guidelines]] ===<br />
Indenting and formating style<br /><br />
[[Development - Naming|2. Naming]] ¤ [[Development - Declaring Procedures|3. Declaring procedures]] ¤ [[Development - Header Files|4. Header files]] ¤ [[Development - New Files|5. New files]] ¤ [[Development - File Reference|6. File reference]] ¤ [[Development - Patches|7. Patches]]<br /><br />
[[Development - Translations|8. Translations]] ¤ Introduction ¤ PO files basics ¤ <br />
Shortcut keys ¤ How to contribute<br /><br />
[[Development - Some tips|9. Some tips]] ¤ [[Development - Making Releases|10. Making releases]] ¤ [[Development - Useful Stuff|11. Useful stuff]]<br />
<br />
== [[Table of Contents (2/3)|'''Table of Contents (2/3)''']] ==<br />
<br />
{| style="width:100%;background-color:#D4D4D4;border:1px solid #E1E1E1;color:#4D4D4D"<br />
| &nbsp;<br />
| <center>[[Man 2 index|Home]]</center><br />
| <div align="right">&nbsp;</div><br />
|}<br />
<br />
[[Category:Manual 2]]</div>DrMartinus