Difference between pages "Installing Bluefish" and "External Programs and Filters"

From Bluefish Wiki
Jump to: navigation, search
(Use one paragraph for instructions how to clean the system.)
 
 
Line 1: Line 1:
= Installing Bluefish on Debian GNU/Linux =
+
{{Man2top
 +
|lang=en
 +
|rev=2.0.0
 +
|st=d
 +
|Title=8. External programs, filters
 +
|prev=Snippets plugin
 +
|Subtitle=Chapter VII. More than a Text Editor
 +
|next=Modifying shortcut keys
 +
}}
  
== Installing the release that is part of Debian / Ubuntu / Mint / etc. ==
+
{{toc}}
  
Use
+
External programmes can be called from within Bluefish. The currently opened file can be given as a parameter. External programmes are divided into three parts:
  
sudo apt-get install bluefish
+
# '''external commands: '''With an external command you can just open a file in an other programme, e.g. a browser. If that programme changed the file, Bluefish will warn you some moments later.
sudo aptitude install bluefish
+
# '''external filters:''' In contrast to external commands, external filters give a return value.
 +
# '''output box:''' Programmes in that category opens also the output box at the bottom of Bluefish.
  
or any other frontend for the package manager such as synaptic or simply "add / remove programs".
+
By default, for all three are already defined commands.
  
== Installing the very latest release on Debian ==
+
{{note|text='''Note''': The external programmes are not necessarily installed on your computer, so you may have to install them at first. Bluefish will give you a warning if that programme is not installed.}}
  
=== Installing the very latest release on Debian 7.0 (Wheezy/Stable) ===
+
= External commands =
 +
External commands are mostly browsers. The external commands can be reached through ''Tools → Commands''. With the ''Preview in Browser ''button on the toolbar you can open the default browser, which is also an external programme.
  
Recent packages for bluefish are available from the [https://packages.debian.org/source/stable-backports/bluefish official Debian backports archive] and can be installed by following the instructions given [http://backports.debian.org/Instructions/ here]. The entry would look like this:
+
== Customising external commands ==
 +
For customising external commands you have to open the ''Preferences'' dialog either through ''Edit → Preferences'' or the ''Preferences'' button on the toolbar. Select ''External commands'' in the left panel.
  
deb http://YOURMIRROR.debian.org/debian wheezy-backports main
+
There are four columns for editing external commands:
  
or
+
* '''Enabled:''' If this is checked, you are able to reach that command through ''Tools → Commands''.
 +
* '''Label:''' The name of the command in menu.
 +
* '''Command:''' Here is the command.
 +
* '''Default browser:''' The checked programme can accessed through the ''Preview in Browser'' button at the toolbar.
  
deb http://YOURMIRROR.debian.org/debian stable-backports main
+
These are the options for external commands:
  
And install the package via:
 
  
  apt-get -t wheezy-backports install bluefish
+
{| style="border-spacing:0;width: 75%"
 +
| colspan="2" style="border:0.05pt solid #000000;padding:0.097cm;"| '''Input options'''
  
Report any bugs to the Debian bugtracker.
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| start with a | to send the input to the standard input
  
Please note, that the http://debian.wgdd.de repository has become obsolete. See below, how to clean your system.
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %f
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| local file name (available for local files)
  
=== Installing the very latest release on Debian 6.0 (Squeeze/Oldstable) ===
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %i
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| temporary file name for input, equals %f if the document is not modified and local
  
Recent packages for bluefish are available from the [https://packages.debian.org/source/stable-backports/bluefish official Debian backports archive] and can be installed by following the instructions given [http://backports.debian.org/Instructions/ here]. The entry would look like this:
+
|-
 +
| colspan="2"  style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| '''Other options'''
  
deb http://YOURMIRROR.debian.org/debian-backports squeeze-backports-sloppy main
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %a
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| additional arguments that will be asked when this filter is activated
  
or
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %c
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| local directory of file (available for local files)
  
deb http://YOURMIRROR.debian.org/debian-backports oldstable-backports-sloppy main
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %n
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| file name without path (available for all titled files)
  
And install the package via:
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %u
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| URL (available for all titled files)
  
apt-get -t squeeze-backports-sloppy install bluefish
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %p
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| preview URL if basedir and preview dir are set in project settings, else identical to %u
  
This version is built with the GTK+ 2 libraries. Report any bugs to the Debian bugtracker.
+
|}
  
Please note, that the http://debian.wgdd.de repository has become obsolete. See below, how to clean your system.
+
== Predefined external commands ==
  
== Installing the very latest on Ubuntu Linux ==
+
{| style="border-spacing:0;width: 75%"
 +
| style="border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| '''Name'''
 +
| style="border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| '''Command'''
 +
| style="border:0.05pt solid #000000;padding:0.097cm;"| '''Description'''
  
Users of Ubuntu releases, for which bluefish doesn't get any official update by the Ubuntu team in the past had the possibility to use the [http://debian.wgdd.de/debian http://debian.wgdd.de/ubuntu] repository. This has become obsolete. You'll now find recent packages of '''bluefish''' in this [https://launchpad.net/~klaus-vormweg/+archive/bluefish PPA]. Follow the instrcutions given there to add this repository. Then '''bluefish''' can be updated to its latest release:
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| chmod a+x
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| chmod a+x %f
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| File f will be executable for all users on Unix-like system.
  
sudo apt-get update
+
|-
sudo apt-get upgrade
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Firefox
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| firefox -remote 'openURL(%p)'<nowiki>||</nowiki> firefox '%p'&
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"|
  
Please note, that the http://debian.wgdd.de repository has become obsolete. See below, how to clean your system.
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Chromium
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| chromium-browser '%p'&
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| The open source base for the Chrome browser.
  
== Removing obsolete entries from sources.list ==
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Opera
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| opera -remote 'openURL(%p)' <nowiki>||</nowiki> opera '%p'&
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"|
  
The http://debian.wgdd.de/ repository no longer provides packages of bluefish. The above steps make the following entries to either ''/etc/apt/sources.list'' or ''/etc/apt/sources.list.d/debian.wgdd.de_*.list'' or any other file in ''/etc/apt/sources.list.d/'' obsolete. You can safely remove any references to the http://debian.wgdd.de repository, that may look like these:
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Konqueror
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| konqueror '%p'&
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Browser for the KDE desktop environment
  
deb    http://debian.wgdd.de/debian wheezy main contrib non-free
+
|-
deb-src http://debian.wgdd.de/debian wheezy main contrib non-free
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Links2
deb    http://debian.wgdd.de/debian stable main contrib non-free
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| links2 -g '%p'&
deb-src http://debian.wgdd.de/debian stable main contrib non-free
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| A text based browser
  
deb    http://debian.wgdd.de/debian squeeze main contrib non-free
+
|-
deb-src http://debian.wgdd.de/debian squeeze main contrib non-free
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Epiphany
deb    http://debian.wgdd.de/debian oldstable main contrib non-free
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| epiphany-browser -n '%p'&
deb-src http://debian.wgdd.de/debian oldstable main contrib non-free
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Browser created by the GNOME project
  
deb    http://debian.wgdd.de/ubuntu UBUNTU_VERSION_HERE main restricted universe multiverse
+
|}
deb-src http://debian.wgdd.de/ubuntu UBUNTU_VERSION_HERE main restricted universe multiverse
+
  
and update your system:
 
  
sudo apt-get update
+
= External filters =
sudo apt-get upgrade
+
The external commands can be reached through ''Tools → Filters''.
  
Also the '''wgdd-archive-keyring''' package then is obsolete together with the repository keyring. If you have the package installed, do:
+
== Customising external filters ==
 +
For customising external commands you have to open the ''Preferences'' dialog either through ''Edit → Preferences'' or the ''Preferences'' button on the toolbar. Select ''External filters'' in the left panel.
  
sudo apt-get autoremove --purge wgdd-archive-keyring
+
There are three columns for editing external filters:
  
... or if you only had the key:
+
* '''Enabled:''' If this is checked, you are able to reach that filter through ''Tools → Filters''.
 +
* '''Label:''' The name of the filter in menu.
 +
* '''Command''': Here is the filter itself.
  
sudo apt-key del E394D996
+
These are the options for external filters:
  
= Installing Bluefish on Fedora Linux =
 
  
=== Installing the version distributed by Fedora ===
+
{| style="border-spacing:0;width: 75%"
 +
| colspan="2"  style="border:0.05pt solid #000000;padding:0.097cm;"| '''Input options'''
  
yum install bluefish
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| start with a | to send the input to the standard input
  
=== Installing the very latest on Fedora with yum ===
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %f
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| local file name (requires local file, cannot operate on selection)
  
To enable a bluefish-release yum repository download the [http://bluefish.linuxexperience.net/downloads/fedora/bluefish-release.repo bluefish-release.repo] file.<br/>
+
|-
Place this repo file in /etc/yum.repos.d<br/>
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %i
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| temporary file name for input
  
Then you can install normally with...
+
|-
 +
| colspan="2"  style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| '''Output options'''
  
yum install bluefish
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| end with a | to read the output from the standard output
  
Packages are currently provided for Fedora 19 and Fedora 20. Packages are provided for both i386 and x86_64.<br/>
+
|-
All packages are built using mock. All packages are signed. You will be prompted to download the GPG key.<br/>
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %o
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| temporary file name
  
=== Installing development versions on Fedora with yum ===
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %t
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| temporary file name for both input and output (for in-place-editing filters, cannot operate on selection)
  
While care is taken to keep development versions very stable and usable, development versions may crash, contain data eating bugs and incomplete features.<br/>
+
|-
Please report any bugs you might find in [https://bugzilla.gnome.org/enter_bug.cgi?product=bluefish Bluefish bugzilla]<br/>
+
| colspan="2"  style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| '''Other options'''
  
If you wish to test the bleeding edge versions of Bluefish currently under development download the [http://bluefish.linuxexperience.net/downloads/fedora/bluefish-svn.repo bluefish-svn.repo] file.<br/>
+
|-
Place this repo file in /etc/yum.repos.d<br/>
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %a
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| additional arguments that will be asked when this filter is activated
  
Then you can install normally with...
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %c
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| local directory of file (requires local file)
  
yum install bluefish
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %n
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| file name without path (available for all titled files)
  
Packages are currently provided for Fedora 19 and Fedora 20. Packages are provided for both i386 and x86_64.<br/>
+
|-
All packages are built using mock. All packages are signed. You will be prompted to download the GPG key.
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %u
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| URL (available for all titled files)
  
=== Browsable Yum repo's for Fedora  ===
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %p
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| preview URL if basedir and preview dir are set in project settings, else identical to %u
  
These pages were created using repoview.
+
|}
  
Fedora 19 - Release
+
== Predefined external filters ==
* [http://bluefish.linuxexperience.net/downloads/fedora/release/19/i386/repoview/ i386]
+
* [http://bluefish.linuxexperience.net/downloads/fedora/release/19/x86_64/repoview/ x86_64]
+
  
Fedora 20 - Release
+
{| style="border-spacing:0;width: 75%"
* [http://bluefish.linuxexperience.net/downloads/fedora/release/20/i386/repoview/ i386]
+
| style="border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| '''Name'''
* [http://bluefish.linuxexperience.net/downloads/fedora/release/20/x86_64/repoview/ x86_64]
+
| style="border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| '''Command'''
 +
| style="border:0.05pt solid #000000;padding:0.097cm;"| '''Description'''
  
= Installing Bluefish on RHEL/CentOS 6.5 =
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Sort
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |sort|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| ''sort'' is a sorting program for Unix-like systems.
  
=== Installing the very latest on RHEL/CentOS 6.5 ===
+
|-
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Sort/Uniq
Bluefish packages for RHEL/CentOS 6.5 are available at the links below for i386 and x86_64.<br/>
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |sort|uniq|
These packages require version 6.5. Previous versions prior to 6.5 had GTK+ 2.18.x.<br/>
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| ''uniq'' removes duplicates after the input is sorted by ''sort''. It is also a program for Unix-like systems included in mysys.
RHEL/CentOS 6.5 has GTK+ 2.20.x which is the minimum version required to build current versions of Bluefish.
+
  
All packages are built using mock. All packages are signed with this gpg [http://bluefish.linuxexperience.net/downloads/fedora/RPM-GPG-KEY-bluefish-svn.asc key].
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Reverse lines
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |tac|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"|
  
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Dos2unix
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |dos2unix|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Converts DOS line breaks to Unix line breaks. It is also a program for Unix-like systems included in mysys.
  
Required for RHEL/CentOS 6.5..
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Tidy HTML
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |tidy -utf8|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Improves the HTML with tidy program.
  
i386
+
|-
* [http://bluefish.linuxexperience.net/downloads/epel6/release/i386/bluefish-2.2.6-1.el6.i686.rpm bluefish-2.2.6-1.el6.i686.rpm]
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Tidy convert in XHTML
* [http://bluefish.linuxexperience.net/downloads/epel6/release/i386/bluefish-shared-data-2.2.6-1.el6.noarch.rpm bluefish-shared-data-2.2.6-1.el6.noarch.rpm]
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |tidy -utf8 -i -w 80 -c -q -asxhtml|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Converts HTML to XHTML with tidy.
  
x86_64
+
|-
* [http://bluefish.linuxexperience.net/downloads/epel6/release/x86_64/bluefish-2.2.6-1.el6.x86_64.rpm bluefish-2.2.6-1.el6.x86_64.rpm]
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Tidy HTML (perltidy)
* [http://bluefish.linuxexperience.net/downloads/epel6/release/x86_64/bluefish-shared-data-2.2.6-1.el6.noarch.rpm bluefish-shared-data-2.2.6-1.el6.noarch.rpm]
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |perltidy -b|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| (strawberry)
  
Optional debug info RHEL/CentOS 6.5..
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Strip empty lines
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |egrep -v '^[ ]*$'|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Deleting empty lines using regular expressions with egrep.
  
i386
+
|-
* [http://bluefish.linuxexperience.net/downloads/epel6/release/debug/i386/bluefish-debuginfo-2.2.6-1.el6.i686.rpm bluefish-debuginfo-2.2.6-1.el6.i686.rpm]
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Render HTML in Text
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| lynx -force_html -dump %i |
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"|
  
x86_64
+
|-
* [http://bluefish.linuxexperience.net/downloads/epel6/release/debug/x86_64/bluefish-debuginfo-2.2.6-1.el6.x86_64.rpm bluefish-debuginfo-2.2.6-1.el6.x86_64.rpm]
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| PHP Beautifier
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |php_beautifier -t|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Improves PHP code with indentation of one tab.
  
= Installing Bluefish on openSUSE =
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Javascript Minify with jsmin
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |/usr/share/bluefish/jsmin.py|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Minifies Javascript code with a Python script, which is provided by bluefish.
  
Bluefish is available in the main repository. Launch YaST and search for "bluefish" to find and select the appropriate package to install.
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| CSS Minify with cssmin
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |/usr/share/bluefish/cssmin.py|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Minifies CSS code with a Python script, which is provided by bluefish.
  
This process is also automated through 1-Click-Install on the openSUSE Build Service: https://software.opensuse.org/package/bluefish
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| CSS tidy
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |csstidy --preserve_css=true -|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Optimises CSS code.
  
= Installing Bluefish on AltLinux =
+
|}
  
  
= Installing Bluefish on Slackware =
+
= Output box =
 +
The external commands can be reached through ''Tools → Outputbox''.
  
= Installing Bluefish on Mac OS X =
+
== Customising output box ==
 +
For customising external commands you have to open the ''Preferences'' dialog either through ''Edit → Preferences'' or the ''Preferences'' button on the toolbar. Select ''Output parsers'' in the left panel.
  
Download http://www.bennewitz.com/bluefish/stable/binaries/macosx/Bluefish-2.2.5-2.dmg from http://www.bennewitz.com/bluefish/stable/binaries/macosx/, open it and drag the bluefish icon onto Applications.
+
There are seven columns for editing external filters:
  
In Mavericks there is a system setting called ''Gatekeeper'' that only allows you to install packages from Apple-identified developers. Bluefish is not distributed through the Apple app store, so you will have to disable that setting. For more information see
+
* '''Enabled:''' If this is checked, you are able to reach that command through ''Tools → Filters''.
https://kb.wisc.edu/helpdesk/page.php?id=25443 or http://support.apple.com/kb/ht5290
+
* '''Name:''' The name of the command in menu.
 +
* '''Pattern''': Here is a regexp pattern send with the command.
 +
* '''File #'''
 +
* '''Line #'''
 +
* '''Output #'''
 +
* '''Command: '''Here is the command.
  
= Installing Bluefish on Windows XP or newer =
+
These are the options for the output box:
  
=== Installing 2.2.5 ===
 
Download the latest Bluefish installer from the main download server:
 
http://www.bennewitz.com/bluefish/stable/binaries/win32/
 
  
The installer will require internet access to download GTK+ and any spell check dictionaries. Please note that the internet-enabled setup may fail if the installer is run from a network share. See below for instructions for internet-less installation.
+
{| style="border-spacing:0;width: 75%"
 +
| colspan="2" style="border:0.05pt solid #000000;padding:0.097cm;"| '''Input options'''
  
==== Installing without Internet Access ====
+
|-
Download the latest Bluefish installer from the main download server:  
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |
http://www.bennewitz.com/bluefish/stable/binaries/win32/
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| start with a | to send the input to the standard input
  
Download the GTK+ 2.24.8 installer (from the gtk-win project):  
+
|-
http://downloads.sourceforge.net/gtk-win/gtk2-runtime-2.24.8-2011-12-03-ash.exe?download
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %f
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| local file name (requires local file, cannot operate on selection)
  
Download any language dictionaries you wish to be able to install:  
+
|-
http://www.muleslow.net/files/aspell/lang/
+
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %i
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| temporary file name for input
  
Place the files in a new directory named 'redist' in the same directory as the Bluefish installer.
+
|-
e.x.
+
| colspan="2" style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| '''Output options'''
Bluefish\
+
Bluefish\Bluefish-2.2.5-setup.exe
+
  Bluefish\redist\gtk2-runtime-2.24.8-2011-12-03-ash.exe
+
Bluefish\redist\aspell6-en-7.1-0.tbz2
+
  
The installer will fall back on downloading the files if they are not found in the redist folder, or if the checksum of the local copy is invalid.
+
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| end with a | to read the output from the standard output
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %o
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| temporary file name
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %t
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| temporary file name for both input and output (for in-place-editing "filters, cannot operate on selection)
 +
 
 +
|-
 +
| colspan="2"  style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| '''Other options'''
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %a
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| additional arguments that will be asked when this filter is activated
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %c
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| local directory of file (requires local file)
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %n
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| file name without path (available for all titled files)
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %u
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| URL (available for all titled files)
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| %p
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| preview URL if basedir and preview dir are set in project settings, else identical to %u
 +
 
 +
|}
 +
 
 +
== Predefined output parsers ==
 +
 
 +
{| style="border-spacing:0;width: 75%"
 +
| style="border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| '''Name'''
 +
| style="border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| '''Command'''
 +
| style="border:0.05pt solid #000000;padding:0.097cm;"| '''Description'''
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| make
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |cd %c && make|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Runs the make build tool.
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| weblint HTML-Check
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |weblint '%f'|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"|
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| tidy HTML-Check
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |tidy -qe '%i'|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"|
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| javac
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |javac '%f'|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Compiles Java code. A JDK has to be installed.
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| xmllint XML-Check
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |xmllint --noout --valid '%f'|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"|
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| PHP
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |php '%f'|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Runs a PHP script.
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| PHP syntax check
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |php -l -q -f '%f'|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Cecks syntax and runs the PHP script.
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| Perl syntax check
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |perl -c '%f'|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"| Checks only the syntax of the Perl script.
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| PHP Codesniffer
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |phpcs --report=emacs '%f'|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"|
 +
 
 +
|-
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| pylint
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0.097cm;"| |pylint '%f'|
 +
| style="border-top:none;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:0.05pt solid #000000;padding:0.097cm;"|
 +
 
 +
|}
 +
 
 +
 
 +
 
 +
{{Man2bottom
 +
|prev=Snippets plugin
 +
|up=Indenting
 +
|next=Modifying shortcut keys
 +
|prevname= 7.&nbsp;Snippets plugin
 +
|nextname= Chapter&nbsp;VIII.&nbsp;Customising Bluefish
 +
}}

Revision as of 16:07, 5 September 2015