{{tag>plugin link}}

====== button Plugin ======

===== Examples/Usage =====

아래는 기본 결과 버튼의 스크린샷입니다.

{{http://rpeyron.github.io/plugin-button/dokuwiki_button_main.png}}

===== Syntax =====

The full syntax is :
<code>
[[{namespace:image|extra css}wiki page|**Title** of the link]]
</code>
Where :
  * ''namespace:image'': 미디어 관리자에서 사용할 이미지의 위치입니다.
  * ''extra css'' is some css code to add to the button, or the name of a style defined with ''conf.styles'' (see below)
  * ''wiki page'' is the targetted id page ; targets with %%://%% or %%mailto:%% are treated as external URI ; you may also use ''!'' prefix to force an external URI (for instance : %%!apt:package%% ) ; protocol has to be allowed in dokuwiki, check [[:urlschemes]]
  * ''**Title** of the link'' is the name that will be displayed on the button, with formatting support ('\\' will break the line in the button, '**' for bold, etc.)

All fields are optional, so the minimal syntax is :
<code>
[[{}Simple button without image]]
</code>

You may configure some styles to use in your buttons without repeating all the css :
<code>
[[{conf.styles}style|css]]
</code>

Where :
  * ''conf.styles'' is the keyword to set the styles
  * ''style'' is the name of the style you want to set ; if ‘default’, it will be added to all buttons
  * ''css'' is the css code you will assign to that style

You may then use the ''style'' in your button, example :

<code>
Style declaration :
[[{conf.styles}default|font-family: "Times New Roman", Times, serif;]]
[[{conf.styles}mystyle|color:green; width:15em;]]

Style use :
[[{|mystyle}Button in times new roman]]
[[{}Button in green and in times new roman]]
</code>

You may also add styles that will be available for all pages in the plugin section of the configuration page. You will have to add one line per style :
<code>
default|font-family: "Times New Roman", Times, serif;
mystyle|color:green; width:15em;
</code>

Note that the CSS part is a bit tricky due to the selectors used in the template CSS and the layout needed for the button. By default, the style of the links is not repeated (just external links icon). See comments in style.css file for more information.

You may also configure the target of the link with the use of conf.target :
<code>
[[{conf.target}style|target]]
</code>

Example:
<code>
[[{conf.target}default|_blank]]
</code>

A button is added to the toolbar to add the template button. 
Compatible with move plugin.