Guidelines for Writing this Manual: Difference between revisions

From Bluefish Wiki
Jump to navigation Jump to search
DrMartinus (talk | contribs)
Added a hint towards ignoring the templates.
DrMartinus (talk | contribs)
→‎examples: Added a row with the Tip template
Line 55: Line 55:
|<nowiki>{{warning|</nowiki>text=mytext here, use <nowiki><br /></nowiki> to break lines.<nowiki>}}</nowiki>
|<nowiki>{{warning|</nowiki>text=mytext here, use <nowiki><br /></nowiki> to break lines.<nowiki>}}</nowiki>
|{{warning|text=mytext here, use <nowiki><br /></nowiki><br />to break lines.}}
|{{warning|text=mytext here, use <nowiki><br /></nowiki><br />to break lines.}}
|-
|<nowiki>{{Tip|</nowiki>text=mytext here, use <nowiki><br /></nowiki> to break lines.<nowiki>}}</nowiki>
|{{Tip|text=mytext here, use <nowiki><br /></nowiki><br />to break lines.}}
|}
|}
{{tip|text=use [[Bluefish mediawiki snippets]] to edit this manual...<br />the task will be easier!}}
{{Tip|text=use [[Bluefish mediawiki snippets]] to edit this manual...<br />the task will be easier!}}


=== Clear Template ===
=== Clear Template ===

Revision as of 11:22, 22 December 2022

 

create an account

You are a bluefish user? You can help write the Bluefish 2 Manual!
  • first step: create an account,
  • second step: feel free to edit the manual,
  • third step: thanks for your help! :)


Using Bluefish 2 to edit Bluefish 2 Manual

See: Bluefish mediawiki editor. Mediawiki snippets have snippets for Bluefish Manual: note, tip, important, warning, clear, framed image.

Templates

Top and bottom menus

Bluefish Wiki Manual use 2 templates for navigation: Man2top and Man2bottom.
They do not usually need to be edited. However, since their output was scrambled up, they are, for now, disabled.

Template:Man2top Template:Man2bottom

Man2top and Man2bottom templates do not usually need to be edited. Exceptions:

When you read a page, and make any necessary corrections so that this page conforms to Bluefish version 2.2.12,
thank you for changing the status, from d (draft) to u (update).

ie: |st=d by |st=u.

After a Bluefish version update, you have to modify the rev parameter.


Tips and Notes Templates

Bluefish Wiki Manual use templates for:

note: tip: important: warning:
this is a note.
this is a tip.
this is important!
this is a warning!

examples

{{note|text=mytext here, use <br /> to break lines.}}
mytext here, use <br />
to break lines.
{{warning|text=mytext here, use <br /> to break lines.}}
mytext here, use <br />
to break lines.
{{Tip|text=mytext here, use <br /> to break lines.}}
mytext here, use <br />
to break lines.
use Bluefish mediawiki snippets to edit this manual...
the task will be easier!

Clear Template

You can write {{clear}} as a shortcut of <br style="clear:both" />
The next element will be moved below all floating boxes of earlier elements.

Top Template

You can write {{top}} to create a link to the top of the page:

Toc Template

You can write {{toc}} to create a floating right ToC

Images

see mediawiki manual: 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:

[[File:Man2_snippet_insert_dialog.png|none|frame|snippet insert dialog]]

For a small image floating left with text on the right:

[[File:Man2 create snippet4.png|left|frame|lorem ipsum]]
lorem ipsum
{{clear}}

More images

In this case we use a table:

{|
|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]]
|}