this page is updated for Manual 2. It needs to be verified! once you have verified this page (and corrected if necessary) please modify the status to v (verified), i.e. st=v (see Guidelines for Writing this Manual)
The snippets are stored in ~/.bluefish/snippets. It is an XML file, like import and export snippets files.
Bluefish has an excellent editor snippets. So it is useless to read this page unless you intend to create a large number of snippets from some documentation, eg: SVG, DOM, etc.
- The import file must have a valid XML syntax.
- The document must include the header: <?xml version="1.0"?>.
- The document must be included in the container: <snippets> <snippets>
- Any snippet must be contained in a branch: <branch title="example"> </branch>
- The branches may contain other branches.
- Each snippet is described in a container: <leaf> </leaf>
There are two types of snippets: insert and snr, aka Search N Replace.
- <?xml version="1.0"?>
- <branch title="Facebook">
- <leaf type="insert" title="bold"><before><b></before><after></b></after></leaf>
- <leaf type="insert" title="italic" tooltip="insert an italic tag"><before><i></before><after></i></after></leaf>
- <leaf type="insert" title="Hyperlink"><before><a href="%0"></before><after></a></after><param name="url"/></leaf>
- <leaf type="insert" title="em-dash"><before>&mdash;</before><after></after></leaf>
- First and important,
- if you want to insert any XML reserved characters ie: < > & you have to escape them (red highlighted in example).
- A leaf tag must have type and title attributes,
- it also may have a tooltip attribute (line 5 of example).
- Before tag is used for text to insert before, and after tag for text inserted after.
- You have to add one or more param tags (with name attibute) if you want tu use parameters (line 6 of example).
Search and replace snippets
SnR snippets are a little more complex:
<leaf type="snr" title="replace 1" tooltip="introduce events" region="b" matchtype="normal" casesens="0" escapechars="0">
<replacepat>jpg" alt="" onmouseout="out(this);" onmouseover="popup(this,'th/</replacepat>
- searchpat and replacepat tags,
- are replacing before and after.
- leaf tag have new attibutes,