Bluefish Wiki - User contributions [en]

Providing information on crashes

2022-07-11T23:22:08Z

David tangye: /* OSX */ minor grammar

= How to report information =

Please create a bug report on:
https://sourceforge.net/p/bluefish/tickets/

Or subscribe to the bluefish community mailinglist.

If this is all too complicated you can send an email to bluefish@bluefish.openoffice.nl

= What to send =

In general: It is always a good idea to tell us your version of Bluefish and your version of GTK/Glib installed on your system, both can be found in the About menu. Please copy/paste the information in ''Help->Build info''

Also don't forget to mention the platform (Linux, OSX, Windows, FreeBSD, etc.) and it's version (and for Linux the distribution). If you have the possibility to test it on multiple computers with different platforms or versions this will really help to track down the problem. If you can reproduce a crash on some specific file, please send us the file too. The smaller the file, the easier for us to debug the issue.

= Linux =
Linux has a wealth of tools to track down problems in software. Please have a look at
https://bfwiki.tellefsen.net/index.php/Debugging_Bluefish
for a detailed description on what is possible.

= OSX =

If Bluefish crashes on OSX there should be a report generated in a separate window. Please copy/paste this information (the backtrace) for thread 0 (on the top of the report) into a text file, and send it to the bluefish developers. Preferably create a bug report on https://sourceforge.net/p/bluefish/tickets/ and attach it as a text file.

On OSX you can run Bluefish via terminal, that provides some debug output that might help to identify issue. Open terminal and type: /Applications/Bluefish.app/Contents/MacOS/bluefish (assuming that Bluefish is installed in the Applications folder). Please copy/paste the terminal output to a text file and attach it as well.

= Windows =
If you get a dialog "bluefish.exe has stopped working" you can click "view problems" which gives some rudimentary information. Since it is better than nothing, please provide it.

In order to provide more information on Windows you can use the msys debugger, a good tutorial can be found here:
https://github.com/mypaint/mypaint/wiki/Debugging-crashes-on-Windows

Guidelines for Writing this Manual

2022-07-11T23:02:46Z

David tangye: /* create an account */ Sp.

{{Man2top
|lang=en
|rev=2.0.0
|st=v
|Title=Appendix C. Guidelines for Writing this Manual
|prev=Man 2 apb
|Subtitle= 
|next=Man 2 apd
}}
{{toc}}

== create an account ==
{{note|text=
You are a bluefish user? You can help write the Bluefish 2 Manual!
* first step: [[Special:UserLogin|create an account]],
* second step: feel free to edit the manual,
* third step: thanks for your help! :)}}
 

== Using Bluefish 2 to edit Bluefish 2 Manual ==
See: [[Bluefish mediawiki editor]]. [[Mediawiki snippets]] have snippets for Bluefish Manual: note, tip, important, warning, clear, framed image.

== Templates ==
=== Top and bottom menus ===
Bluefish Wiki Manual use 2 templates for navigation: '''Man2top''' and '''Man2bottom'''. 
'''They do not usually need to be edited'''.
[[File:Man2 template editing.png|left|frame|Template:Man2top Template:Man2bottom]]
Man2top and Man2bottom templates do not usually need to be edited.
'''Exceptions''':
{{note|text=When you read a page, and make any necessary corrections so that this page conforms to Bluefish version 2.0.0, thank you for changing the status, from '''d''' (draft) to '''u''' (update). 
ie: <tt><nowiki>|</nowiki>st=d</tt> by <tt><nowiki>|</nowiki>st=u</tt>.}}
{{tip|text=After a Bluefish version update, you have to modify the rev parameter.}}
{{clear}}

=== Tips and Notes Templates ===
Bluefish Wiki Manual use templates for:
{|
|align="center"|'''note''':
|align="center"|'''tip''':
|align="center"|'''important''':
|align="center"|'''warning''':
|-
|align="bottom" width="150"|{{note|text=this is a note.}}
|align="bottom" width="150"|{{tip|text=this is a tip.}}
|align="bottom" width="170"|{{important|text=this is important!}}
|align="bottom" width="150"|{{warning|text=this is a warning!}}
|}

==== examples ====
{|border=1 cellpadding=5
|<nowiki>{{note|</nowiki>text=mytext here, use <nowiki> </nowiki> to break lines.<nowiki>}}</nowiki>
|{{note|text=mytext here, use <nowiki> </nowiki> to break lines.}}
|-
|<nowiki>{{warning|</nowiki>text=mytext here, use <nowiki> </nowiki> to break lines.<nowiki>}}</nowiki>
|{{warning|text=mytext here, use <nowiki> </nowiki> to break lines.}}
|}
{{tip|text=use [[Bluefish mediawiki snippets]] to edit this manual... the task will be easier!}}

=== Clear Template ===
You can write <nowiki>{{clear}}</nowiki> as a shortcut of <nowiki> </nowiki> 
The next element will be moved below all floating boxes of earlier elements.
=== Top Template ===
You can write <nowiki>{{top}}</nowiki> to create a link to the top of the page: {{top}}
=== Toc Template ===
You can write <nowiki>{{toc}}</nowiki> to create a floating right ToC

=== Images ===
see mediawiki manual: [http://www.mediawiki.org/wiki/Help:Images#Syntax Images Syntax] 
note: to add in snippets and bflang2

In the manual images are framed with a title: 

==== One image ====
For one large image, with text on top and/or bottom: 
<pre>[[File:Man2_snippet_insert_dialog.png|none|frame|snippet insert dialog]]</pre>

For a small image floating left with text on the right:
<pre>[[File:Man2 create snippet4.png|left|frame|lorem ipsum]]
lorem ipsum
{{clear}}</pre>

==== More images ====
In this case we use a table:
<pre>{|
|valign="bottom" align="center"|[[File:Man2 create snippet.png|none|frame|lorem ipsum]]
|valign="bottom" align="center"|[[File:Man2 create snippet2.png|none|frame|lorem ipsum]]
|valign="bottom" align="center"|[[File:Man2 create snippet3.png|none|frame|lorem ipsum]]
|}</pre>

{{top}}
{|
{{Man2bottom
|prev=Man 2 apb
|up=
|next=Man 2 apd
|prevname= Appendix B. Bluefish change history
|nextname= Appendix D. GNU GENERAL PUBLIC LICENSE
}}

CommunityTools

2022-07-11T03:04:21Z

David tangye: Sp. I didn't read this page closely, but it looks like an outdated 'Ramdom Thoughts' page of someone. Might be out of place as a wiki page.

This is a page where we can discuss the tools that we have and that we need.

== Communication ==

* a forum that is linked to the mailing list. Every posting on the list is posted to the forum, and every post on the forum to the list.
** This FudForum Mailing List Manager looks interesting: http://cvs.prohost.org/index.php/Mailing_List_Manager
** where forum-users can subscribe to certain topics to get an email when answers have been posted
* a poll on the website so we can ask users what they want
* RSS feed with the news
* integration with gnome bugzilla for feature requests? how can we do that?

== File upload/download ==
* a place to collect files such as 'made with' icons, language files, snippets files

Here are some Bluefish 2 syntax highlighting definitions for HAML & SASS (http://haml-lang.com/)

http://trustycoder.com/bluefish_haml_sass_highlighting.tar.gz

Put them in /usr/share/bluefish/bflang/ or wherever your distro puts Bluefish lang files.

Also included is a Ubuntu mime type definition for .sass and .haml files. Put it in /usr/share/mime/packages/ then run sudo update-mime /usr/share/mime

== Style & navigation ==

* all sites (wiki, main site and forums) should use the same navigation on the left and the same colors
* administration of all sites must be made by CORE developers, in a manner so no one can take his toys and leave.
We would not like to lose the wiki for example. - or better we host the sites on general servers (e.g. sourceforge.net) and multiple people have the admin account. Core developers have more things to do ;-)

== Community Goals and Objectives ==
* The purpose of the user community is not to give more work for developers. They already have enough to occupy them.
* The purpose of the community is to enable users to help each other ... And help as much as possible the Bluefish's development team.
* The purpose of the community is to offer a place for the users to share snippets and other stuff that can be easily added/imported, without the need for a developer to put to svn or to the main site. Let's say unofficial addons.

== Notes and comments ==
* we use only free tools (b.t.w. Joomla is free!)
* it is possible to embed a free forum in mediawiki.
** FudForum, reported by Anita, can be used with Mediawiki.
* also if a bigger CMS is to be used, we can use Drupal.
* Smaller cms, with a lot of addons, and that can be designed light and nice - textpattern. http://www.textpattern.com/
* a forum could be nice but for us probably lists are faster and nicer - that's why we need both and integrated

== List of forums that can be embedded in Mediawiki and linked to the mailinglist ==
(see also: [http://www.mediawiki.org/wiki/Category:Discussion_and_forum_extensions Mediawiki Discussion and forum extensions])
* FudForum

Getting Bluefish

2022-07-11T02:59:25Z

David tangye: /* Downloading the source */ sp

__TOC__

== Installing binaries from packages ==

We provide pre-compiled binaries for several operating systems. In alphabetical order:

=== [http://www.debian.org Debian] and [http://www.ubuntu.com Ubuntu] ===

Packages for the bluefish stable tree can usually be installed from the [http://packages.debian.org/bluefish Debian] or [http://packages.ubuntu.com/bluefish Ubuntu] package pool via apt-get, aptitude, synaptic, ...

apt-get install bluefish

For users of [http://packages.debian.org/bluefish Debian stable] (currently Debian Wheezy) packages are provided via [https://packages.debian.org/wheezy-backports/bluefish backports.debian.org]. Just add this repository, follow the instructions given at [http://backports.debian.org/Instructions/] and install bluefish like this:

apt-get install -t wheezy-backports bluefish

The old repository [http://debian.wgdd.de debian.wgdd.de] won't provide any bluefish binary packages any longer. After installing the bluefish backport you can also safely remove any reference to this repository including entries to ''sources.list'' and also the repository keyring (package) '''wgdd-archive-keyring'''.

=== [http://www.gentoo.org Gentoo] ===

Gentoo users run

emerge bluefish

to install the stable version of Bluefish.

=== [http://www.apple.com/macosx/ MacOSX] and [http://www.opensource.apple.com/ Darwin] ===

Fink users might install the [http://pdb.finkproject.org/pdb/package.php/bluefish stable version] via

fink install bluefish

and the [http://pdb.finkproject.org/pdb/package.php/bluefish-unstable development version] via

fink install bluefish-unstable

=== Windows ===

For Windows an installer is available. Check out the projects [https://sourceforge.net/projects/bluefish/files/ sourceforge.net download page].

== Downloading the source ==

There are several ways to retrieve the source of Bluefish.

=== Downloading a source tarball ===

The source tarballs for Bluefish can be downloaded from the [http://www.bennewitz.com/bluefish/ project master server] (or one of its [http://bluefish.openoffice.nl/download.html mirrors]) or [https://sourceforge.net/projects/bluefish/files sourceforge.net].

For the stable tree, check out [http://www.bennewitz.com/bluefish/stable/source/] on the master server. For the development version use [http://www.bennewitz.com/bluefish/devel/source/]. The [https://sourceforge.net/projects/bluefish/files sourceforge.net] server has both versions on the same site.

After downloading compare the SHA hashsum of the tarball with the values provided at our [http://bluefish.openoffice.nl homepage].

=== Downloading the source via Subversion ===

We have two main branches in our [https://bluefish.svn.sourceforge.net Subversion] tree:
* the [http://bluefish.svn.sourceforge.net/viewvc/bluefish/branches/bluefish_1_0/ stable 1.0 branch] (gets mainly bugfixes; no major rewrites)
* the [http://bluefish.svn.sourceforge.net/viewvc/bluefish/trunk/bluefish/ development branch] (major rewrites, new features, possibly unstable).

Make a checkout of the branch you want to work on. Sometimes we also have some branches, when we work on new major features or rewrites. But you usually want one of the above. For the current stable tree (1.0) use:
svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/branches/bluefish_1_0/
For the current development tree use:
svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/trunk/bluefish/
If you need a special release, it can be retreived via (replace ''X'',''Y'',''Z'' with the version numbers, e.g. ''1'', ''3'' and ''7''):
svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/tags/bluefish_X_Y_Z

=== Downloading the latest source snapshot ===

The latest snapshot (for the stable or the development tree) can be retreived via subversion as shown above. You can also download the source snapshot as tarball for the [http://bluefish.svn.sourceforge.net/viewvc/bluefish/branches/bluefish_1_0.tar.gz?view=tar stable] or [http://bluefish.svn.sourceforge.net/viewvc/bluefish/trunk/bluefish.tar.gz?view=tar development] tree.

Getting Bluefish

2022-07-11T02:58:03Z

David tangye: /* installing binaries from packages */

__TOC__

== Installing binaries from packages ==

We provide pre-compiled binaries for several operating systems. In alphabetical order:

=== [http://www.debian.org Debian] and [http://www.ubuntu.com Ubuntu] ===

Packages for the bluefish stable tree can usually be installed from the [http://packages.debian.org/bluefish Debian] or [http://packages.ubuntu.com/bluefish Ubuntu] package pool via apt-get, aptitude, synaptic, ...

apt-get install bluefish

For users of [http://packages.debian.org/bluefish Debian stable] (currently Debian Wheezy) packages are provided via [https://packages.debian.org/wheezy-backports/bluefish backports.debian.org]. Just add this repository, follow the instructions given at [http://backports.debian.org/Instructions/] and install bluefish like this:

apt-get install -t wheezy-backports bluefish

The old repository [http://debian.wgdd.de debian.wgdd.de] won't provide any bluefish binary packages any longer. After installing the bluefish backport you can also safely remove any reference to this repository including entries to ''sources.list'' and also the repository keyring (package) '''wgdd-archive-keyring'''.

=== [http://www.gentoo.org Gentoo] ===

Gentoo users run

emerge bluefish

to install the stable version of Bluefish.

=== [http://www.apple.com/macosx/ MacOSX] and [http://www.opensource.apple.com/ Darwin] ===

Fink users might install the [http://pdb.finkproject.org/pdb/package.php/bluefish stable version] via

fink install bluefish

and the [http://pdb.finkproject.org/pdb/package.php/bluefish-unstable development version] via

fink install bluefish-unstable

=== Windows ===

For Windows an installer is available. Check out the projects [https://sourceforge.net/projects/bluefish/files/ sourceforge.net download page].

== Downloading the source ==

There are several ways to retreive the source of Bluefish.

=== Downloading a source tarball ===

The source tarballs for Bluefish can be downloaded from the [http://www.bennewitz.com/bluefish/ project master server] (or one of its [http://bluefish.openoffice.nl/download.html mirrors]) or [https://sourceforge.net/projects/bluefish/files sourceforge.net].

For the stable tree, check out [http://www.bennewitz.com/bluefish/stable/source/] on the master server. For the development version use [http://www.bennewitz.com/bluefish/devel/source/]. The [https://sourceforge.net/projects/bluefish/files sourceforge.net] server has both versions on the same site.

After downloading compare the SHA hashsum of the tarball with the values provided at our [http://bluefish.openoffice.nl homepage].

=== Downloading the source via Subversion ===

We have two main branches in our [https://bluefish.svn.sourceforge.net Subversion] tree:
* the [http://bluefish.svn.sourceforge.net/viewvc/bluefish/branches/bluefish_1_0/ stable 1.0 branch] (gets mainly bugfixes; no major rewrites)
* the [http://bluefish.svn.sourceforge.net/viewvc/bluefish/trunk/bluefish/ development branch] (major rewrites, new features, possibly unstable).

Make a checkout of the branch you want to work on. Sometimes we also have some branches, when we work on new major features or rewrites. But you usually want one of the above. For the current stable tree (1.0) use:
svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/branches/bluefish_1_0/
For the current development tree use:
svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/trunk/bluefish/
If you need a special release, it can be retreived via (replace ''X'',''Y'',''Z'' with the version numbers, e.g. ''1'', ''3'' and ''7''):
svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/tags/bluefish_X_Y_Z

=== Downloading the latest source snapshot ===

The latest snapshot (for the stable or the development tree) can be retreived via subversion as shown above. You can also download the source snapshot as tarball for the [http://bluefish.svn.sourceforge.net/viewvc/bluefish/branches/bluefish_1_0.tar.gz?view=tar stable] or [http://bluefish.svn.sourceforge.net/viewvc/bluefish/trunk/bluefish.tar.gz?view=tar development] tree.

Getting Bluefish

2022-07-11T02:57:29Z

David tangye: Change the section name to better reflect the content

__TOC__

== installing binaries from packages ==

We provide pre-compiled binaries for several operating systems. In alphabetical order:

=== [http://www.debian.org Debian] and [http://www.ubuntu.com Ubuntu] ===

Packages for the bluefish stable tree can usually be installed from the [http://packages.debian.org/bluefish Debian] or [http://packages.ubuntu.com/bluefish Ubuntu] package pool via apt-get, aptitude, synaptic, ...

apt-get install bluefish

For users of [http://packages.debian.org/bluefish Debian stable] (currently Debian Wheezy) packages are provided via [https://packages.debian.org/wheezy-backports/bluefish backports.debian.org]. Just add this repository, follow the instructions given at [http://backports.debian.org/Instructions/] and install bluefish like this:

apt-get install -t wheezy-backports bluefish

The old repository [http://debian.wgdd.de debian.wgdd.de] won't provide any bluefish binary packages any longer. After installing the bluefish backport you can also safely remove any reference to this repository including entries to ''sources.list'' and also the repository keyring (package) '''wgdd-archive-keyring'''.

=== [http://www.gentoo.org Gentoo] ===

Gentoo users run

emerge bluefish

to install the stable version of Bluefish.

=== [http://www.apple.com/macosx/ MacOSX] and [http://www.opensource.apple.com/ Darwin] ===

Fink users might install the [http://pdb.finkproject.org/pdb/package.php/bluefish stable version] via

fink install bluefish

and the [http://pdb.finkproject.org/pdb/package.php/bluefish-unstable development version] via

fink install bluefish-unstable

=== Windows ===

For Windows an installer is available. Check out the projects [https://sourceforge.net/projects/bluefish/files/ sourceforge.net download page].

== Downloading the source ==

There are several ways to retreive the source of Bluefish.

=== Downloading a source tarball ===

The source tarballs for Bluefish can be downloaded from the [http://www.bennewitz.com/bluefish/ project master server] (or one of its [http://bluefish.openoffice.nl/download.html mirrors]) or [https://sourceforge.net/projects/bluefish/files sourceforge.net].

For the stable tree, check out [http://www.bennewitz.com/bluefish/stable/source/] on the master server. For the development version use [http://www.bennewitz.com/bluefish/devel/source/]. The [https://sourceforge.net/projects/bluefish/files sourceforge.net] server has both versions on the same site.

After downloading compare the SHA hashsum of the tarball with the values provided at our [http://bluefish.openoffice.nl homepage].

=== Downloading the source via Subversion ===

We have two main branches in our [https://bluefish.svn.sourceforge.net Subversion] tree:
* the [http://bluefish.svn.sourceforge.net/viewvc/bluefish/branches/bluefish_1_0/ stable 1.0 branch] (gets mainly bugfixes; no major rewrites)
* the [http://bluefish.svn.sourceforge.net/viewvc/bluefish/trunk/bluefish/ development branch] (major rewrites, new features, possibly unstable).

Make a checkout of the branch you want to work on. Sometimes we also have some branches, when we work on new major features or rewrites. But you usually want one of the above. For the current stable tree (1.0) use:
svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/branches/bluefish_1_0/
For the current development tree use:
svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/trunk/bluefish/
If you need a special release, it can be retreived via (replace ''X'',''Y'',''Z'' with the version numbers, e.g. ''1'', ''3'' and ''7''):
svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/tags/bluefish_X_Y_Z

=== Downloading the latest source snapshot ===

The latest snapshot (for the stable or the development tree) can be retreived via subversion as shown above. You can also download the source snapshot as tarball for the [http://bluefish.svn.sourceforge.net/viewvc/bluefish/branches/bluefish_1_0.tar.gz?view=tar stable] or [http://bluefish.svn.sourceforge.net/viewvc/bluefish/trunk/bluefish.tar.gz?view=tar development] tree.

Notes for Bluefish 2 Manual

2022-07-11T02:03:48Z

David tangye: /* scanner */ minor spelling and grammar fixes

== Bluefish 1.3 features ==
from: http://bluefish.openoffice.nl/features.html 
Bluefish 1.3 (the development version) mostly has the same features with some notable exceptions or additions:

* In-line spell checker which is programing language aware (spell check comments and strings, but not code), requires libenchant during compilation.
* Code block folding
* Highlighting matching block start and end markers (both brackets and tags)
* Auto-completion for many programming languages, and even for nested languages (e.g. css inside html)
* Auto-recovery of changes in modified documents after a crash, kill or shutdown
* Character map of all unicode characters (requires libgucharmap during compilation)
* Upload / download synchronisation
* Full screen editing
* In-line reference information (move your mouse over a function name or tag name) for various programming languages
* Many new tools (tabs to spaces, join lines, etc. etc.)

=== Bluefish 2.0 new features ===
* Right margin
* [[Templates]] function (XHTML 1.0, HTML 5, C Header, C Header GPL and PHP
* Tab key indent a block, tab / shift tab for indent/unindent
* toggle bookmark on doubleclick (to add to [[Man 2 ch06s04]])

== scanner ==
Bluefish can Highlight the syntax of more than 20 languages, eg: 
Ada, ASP-VBScript, ASP, C, C++, CSS, D, HTML, Java, JavaScript, JSP, NSIS, Perl, PHP, gettext PO, Python, Ruby, Shell, Smarty, VBScript, XHTML, XML.
=== Enable/disable scanner ===
Use Document > Highlight Syntax.

=== Edit preferences ===

[[File:Man2 Generic HTML Textstyle.png|500px|thumb|left|Edit preferences Generic HTML Textstyle]]
 

=== Contributing ===
A lot of information is available in these two files in bluefish/data/bflang/ : 
[https://bluefish.svn.sourceforge.net/svnroot/bluefish/trunk/bluefish/data/bflang/bflang2.bflang2 bflang2.bflang2] [https://bluefish.svn.sourceforge.net/svnroot/bluefish/trunk/bluefish/data/bflang/sample.bflang2 sample.bflang2]

In Bluefish 2, Custom menu is replaced by Snippets in the left panel. 
Bluefish_2 comes without any snippets. You have to [[:Category:Snippets repository|import]] or create them.
{{note|text= To import your Bluefish_1 Custom menu in snippets you can use Olivier's python script [[convert_custom_menu_to_snippets.py]].
*put convert_custom_menu_to_snippets.py in ~/.bluefish/ directory
*make the script executable: chmod a+x convert_custom_menu_to_snippets.py and run the script.}}

== Editing Snippets ==

[[Category:Manual 2]]