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

From Bluefish Wiki
(Difference between pages)
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
 +
}}

Latest revision as of 16:07, 5 September 2015

Man2 warning.png This page is a copy from Manual 1. It needs to be modified to match Bluefish version 2.0.0!
Once you have verified this page (and corrected if necessary),

please modify the status to u (updated), i.e. st=u (see Guidelines for Writing this Manual)


Man2 icon 48.png
Chapter VII. More than a Text Editor
Prev 
8. External programs, filters
 Next
 

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:

  1. 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.
  2. external filters: In contrast to external commands, external filters give a return value.
  3. output box: Programmes in that category opens also the output box at the bottom of Bluefish.

By default, for all three are already defined commands.

Man2 note.png 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.

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.

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.

There are four columns for editing external commands:

  • 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.

These are the options for external commands:


Input options
| start with a | to send the input to the standard input
 %f local file name (available for local files)
 %i temporary file name for input, equals %f if the document is not modified and local
Other options
 %a additional arguments that will be asked when this filter is activated
 %c local directory of file (available for local files)
 %n file name without path (available for all titled files)
 %u URL (available for all titled files)
 %p preview URL if basedir and preview dir are set in project settings, else identical to %u

Predefined external commands

Name Command Description
chmod a+x chmod a+x %f File f will be executable for all users on Unix-like system.
Firefox firefox -remote 'openURL(%p)'|| firefox '%p'&
Chromium chromium-browser '%p'& The open source base for the Chrome browser.
Opera opera -remote 'openURL(%p)' || opera '%p'&
Konqueror konqueror '%p'& Browser for the KDE desktop environment
Links2 links2 -g '%p'& A text based browser
Epiphany epiphany-browser -n '%p'& Browser created by the GNOME project


External filters

The external commands can be reached through Tools → Filters.

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.

There are three columns for editing external filters:

  • 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.

These are the options for external filters:


Input options
| start with a | to send the input to the standard input
 %f local file name (requires local file, cannot operate on selection)
 %i temporary file name for input
Output options
| end with a | to read the output from the standard output
 %o temporary file name
 %t temporary file name for both input and output (for in-place-editing filters, cannot operate on selection)
Other options
 %a additional arguments that will be asked when this filter is activated
 %c local directory of file (requires local file)
 %n file name without path (available for all titled files)
 %u URL (available for all titled files)
 %p preview URL if basedir and preview dir are set in project settings, else identical to %u

Predefined external filters

Name Command Description
Sort |sort| sort is a sorting program for Unix-like systems.
Sort/Uniq |sort|uniq| uniq removes duplicates after the input is sorted by sort. It is also a program for Unix-like systems included in mysys.
Reverse lines |tac|
Dos2unix |dos2unix| Converts DOS line breaks to Unix line breaks. It is also a program for Unix-like systems included in mysys.
Tidy HTML |tidy -utf8| Improves the HTML with tidy program.
Tidy convert in XHTML |tidy -utf8 -i -w 80 -c -q -asxhtml| Converts HTML to XHTML with tidy.
Tidy HTML (perltidy) |perltidy -b| (strawberry)
Strip empty lines |egrep -v '^[ ]*$'| Deleting empty lines using regular expressions with egrep.
Render HTML in Text lynx -force_html -dump %i |
PHP Beautifier |php_beautifier -t| Improves PHP code with indentation of one tab.
Javascript Minify with jsmin |/usr/share/bluefish/jsmin.py| Minifies Javascript code with a Python script, which is provided by bluefish.
CSS Minify with cssmin |/usr/share/bluefish/cssmin.py| Minifies CSS code with a Python script, which is provided by bluefish.
CSS tidy |csstidy --preserve_css=true -| Optimises CSS code.


Output box

The external commands can be reached through Tools → Outputbox.

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.

There are seven columns for editing external filters:

  • Enabled: If this is checked, you are able to reach that command through Tools → Filters.
  • 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.

These are the options for the output box:


Input options
| start with a | to send the input to the standard input
 %f local file name (requires local file, cannot operate on selection)
 %i temporary file name for input
Output options
| end with a | to read the output from the standard output
 %o temporary file name
 %t temporary file name for both input and output (for in-place-editing "filters, cannot operate on selection)
Other options
 %a additional arguments that will be asked when this filter is activated
 %c local directory of file (requires local file)
 %n file name without path (available for all titled files)
 %u URL (available for all titled files)
 %p preview URL if basedir and preview dir are set in project settings, else identical to %u

Predefined output parsers

Name Command Description
make |cd %c && make| Runs the make build tool.
weblint HTML-Check |weblint '%f'|
tidy HTML-Check |tidy -qe '%i'|
javac |javac '%f'| Compiles Java code. A JDK has to be installed.
xmllint XML-Check |xmllint --noout --valid '%f'|
PHP |php '%f'| Runs a PHP script.
PHP syntax check |php -l -q -f '%f'| Cecks syntax and runs the PHP script.
Perl syntax check |perl -c '%f'| Checks only the syntax of the Perl script.
PHP Codesniffer |phpcs --report=emacs '%f'|
pylint |pylint '%f'|


Prev 
Up
 Next
7. Snippets plugin
Home | ToC
 Chapter VIII. Customising Bluefish