View source for Template:Babel/doc

{{Documentation subpage}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
{{nosubst}}
{{Lua|Module:Babel}}
{{High-use}}

{{tl|Babel}} is for showing the languages that you know, as well as the operating system, keyboard layout, web browser, desktop environment, and text editor that you are most comfortable with.  Details of how to use it for its original purpose—showing the languages that you know—are at [[Wikipedia:Wikipedia:Babel]].

== Usage ==
{{tlx|Babel|{{var|&lt;box1>}}|{{var|&lt;box2>}}|{{var|&lt;box3>}}...}}

Parameters can be added using the <code><nowiki>{{!}}</nowiki></code> and {{tlx|{{=}}}} tricks:

{|
|-
|
<code><nowiki>{{Babel|</nowiki>[[Template:User 0RR|0RR]]<nowiki>{{!}}border-c{{=}}red}}</nowiki></code> {{large|➜}}
|
{{Babel|0RR{{!}}border-c{{=}}red}}
|}

The Babel box prefixes its arguments with "User ", so it will work with the User: namespace:

{|
|-
|
<code><nowiki>{{Babel|</nowiki>[[User:UBX/Userboxes/Thank Button|:UBX/Userboxes/Thank Button]]<nowiki>}}</nowiki></code> {{large|➜}}
|
{{Babel|:UBX/Userboxes/Thank Button}}
|}

== Custom styling ==
To customize the appearance you can add the optional parameters

; {{para|align|left}}: to display the babel box on the left side of the screen rather than the default right
; {{para|header|<var>header</var>}}: change header, default is [[Wikipedia:Babel]]
; {{para|footer|<var>footer</var>}}: change wiki markup for footer, default is <code><nowiki>[[:Category:Wikipedians by language|Search user languages]]</nowiki></code> (which appears as [[:Category:Wikipedians by language|Search user languages]])
; {{para|bordercolor|<var>color</var>}}: color of the border, default is #99B3FF
; {{para|color|<var>color</var>}}: background color, default is white
; {{para|textcolor|<var>color</var>}}: text color, default is black
; {{para|left|<var>pixels</var>}}: left margin in pixels, default is 1
; {{para|bottom|<var>pixels</var>}}: bottom margin in pixels, default is 0.5
; {{para|solid|<var>pixels</var>}}: solid border width, default is 1
; {{para|width|<var>pixels</var>}}: width of the box, default is 248
; {{para|extra-css|<var>css-code</var>}}: any other custom formatting

===Columns and separators===
* Use <code>!</code> to start a new column after that point
* Use [[Template:User -|<code>-</code>]] to insert a blank row
* Use [[Template:User head|<code>head</code>]] to insert a header; use [[Template:User head-m|<code>head-m</code>]] to insert a header without text
* Use [[Template:User line|<code>line</code>]] to insert a horizontal ruler separator

For example,
<syntaxhighlight lang="wikitext">
{{Babel
| align  = left
| header = Userboxes
| color  = yellow
| head           | en    | tl-1       | ru-2
| line           | pas   | :UBX/1337  | !
| head{{!}}Other | 1RR   | help desk  | -
| line           | happy | wikipedia/WikiFairy
}}
</syntaxhighlight>
Produces:

{{Babel
| align  = left
| header = Userboxes
| color  = yellow
| head           | en    | tl-1       | ru-2
| line           | pas   | :UBX/1337  | !
| head{{!}}Other | 1RR   | help desk  | -
| line           | happy | wikipedia/WikiFairy
| nocat=yes<!--Keep the nocat parameter even though not displayed to the user above. It keeps this documentation page from being categorized as a user.-->
}}
{{clear}}

== Copying template to other wikis ==
The page you are now reading is <noinclude>the '''/doc''' subpage for</noinclude> the actual Babel template. If you click "edit this page", you will see invocation of [[WP:Lua|Lua]] [[Module:Babel]] that makes the Babel boxes work. What you're now reading is just documentation for that code, transcluded inside "&lt;noinclude&gt;" tags so it doesn't interfere with the computer code.

In order to use Babel boxes in another Wikimedia project, you need both the template and the module. Click "view source" and copy all the contents, including the computer code. Create a page called "Template:Babel" on the other Wikimedia project and put the content into it. Do the same for the module.

You will also need to copy over a bunch of files with names like "Template:User en", "Template:User en-1", "Template:User fr", and so on. Once you've done that, users can put, for example, "{{Tlc|Babel|en-1|fr}}" on their user page, and the Babel boxes will be displayed.

==See also==
* [[mw:Extension:Babel]]

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Language user templates]]
[[Category:Userbox arrangement templates]]

}}</includeonly>