Bluefish Wiki - User contributions [en]

Main Page

2015-09-04T20:19:36Z

Poenikatu: respelt honor as honour

==Welcome to the Bluefish Wiki!==

The official bluefish website is at http://bluefish.openoffice.nl

See our [[Mailinglists]] to get in touch with the Bluefish community and developers. The honourable project leader is Olivier Sessink (olivier (at) bluefish.openoffice.nl). The wiki maintainer is Christian (bfwiki --a--tellefsen.net).

=== Wiki user registration ===

To register for an account, send me an email with your desired username to <tt>bfwiki--a--tellefsen.net</tt>.

=== Help / documentation ===

* [[Installing Bluefish]] / [[Compiling Bluefish from source]]
* [[Hidden features]]
* [[Keyboard shortcuts]]

* [[Troubleshooting dll issues on windows]]
* [[:Category:Manual 2|Bluefish 2 Manual project]]
* [[Enabling Aspell Under MacOSX]]
* [[Typing Japanese under MacOS X]]

=== Development / contributing ===

Recent activity:
* [[Project Roadmap]]
* [[Translations|Translation status]]
* [[Debugging Bluefish]]
* [[Writing language definition files]]

* [[CommunityTools]]
* [[Getting Bluefish]]
* [[Sending Patches]]
* [[Setting up a Windows Build Environment]] [[Installation d'un environnement de compilation Windows|(français)]]
* [[Using File Type Icons in Bluefish 2]]
* [[Building a native (no X11) MacOSX binary]]

Still useful:

* [[Man 1 index|The Bluefish 1 Manual]]
* [[Compiling Under MacOS X]]
* [[Backtrace Under Mac OS X]]
* [[Customization For MacOS X]]
* [[Compiling Under Cygwin]]

=== Old stuff, mostly outdated ===
* [[Syntax Highlighting Colours]] - default colors for all languages
* [[Scanner]] - Bluefish text widget with scanning features
* [[Manual]] -- Just so people can work out whos doing what (Now being Maintained by Scott White)
* [[Function Reference 2]] - new function reference for Bluefish (or should we call it Information Center ?)
* Search and Replace dialog
* [[Reproducable Bugs]]
* [[Preferences Refactor]] - Changes and removals on the Prefs Dialog
* [[Feature Requests]]
* [[ToDo List]]
* [[Plugins]]
* [[Current Plans]] from all developers
* [[Gnome HIG]] compliance
* [[Cvs Activity]]
* [[Project Management]] - Olivier
* [[Function Reference]] - implemented already, but we need more references for python, perl etc.
* [[Old stuff, Bookmarks]]
* [[Downloading From CVS]]
* [[Compiling Manual]]
This Wiki is maintained by the Bluefish community. If you want to help to contribute in any way, please contact us on the [[Mailinglists|bluefish mailinglist]]. If you want to help translate Bluefish, have a look at [[Translations]].

Guidelines for Writing this Manual

2015-09-04T19:43:11Z

Poenikatu: /* examples */

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

== create an account ==
{{note|text=
Your are a bluefish user? You can help to write the Bluefish 2 Manual!
* first step: [[Special:UserLogin|create an account]],
* second step: feel free to edit te manual,
* third step: thanks for your help! :)}}
 
== Using Bluefish 2 to edit Bluefish 2 Manual ==
See: [[Bluefish mediawiki editor]]. [[Mediawiki snippets]] have snippets for Bluefish Manual: note, tip, important, warning, clear, framed image.

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

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

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

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

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

In the manual images are framed with a title: 

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

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

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

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

Guidelines for Writing this Manual

2015-09-04T19:42:05Z

Poenikatu: /* Top and bottom menus */

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

== create an account ==
{{note|text=
Your are a bluefish user? You can help to write the Bluefish 2 Manual!
* first step: [[Special:UserLogin|create an account]],
* second step: feel free to edit te manual,
* third step: thanks for your help! :)}}
 
== Using Bluefish 2 to edit Bluefish 2 Manual ==
See: [[Bluefish mediawiki editor]]. [[Mediawiki snippets]] have snippets for Bluefish Manual: note, tip, important, warning, clear, framed image.

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

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

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

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

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

In the manual images are framed with a title: 

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

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

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

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