Témbongkeun sumber pikeun Citakan:Nowrap begin/doc

<includeonly>{{template doc page transcluded}}</includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
__NOTOC__
This template prevents word wraps (line breaks) in text and links with spaces in. It is designed to handle the really tricky wrapping cases where you need full control. For instance in very complex long link lists. It works similarly to {{tl|nowrap}} and {{tl|nowraplinks}}.

This template takes no parameters, instead it works in pair with {{tl|nowrap end}}.

=== Helper templates ===

This template has a number of helper templates which allows you to tell the web browser exactly where line breaks may occur:
* {{tl|wrap}} - Marks where a wrap may occur.
* {{tl|·wrap}} - Looks like this: " '''·''' ". For dotted lists. Renders a bold middot surrounded by spaces and then marks that a wrap may occur ''after'' the midddot.
* {{tl|•wrap}} - Looks like this: " • ". For dotted lists that use small font and thus need a bigger dot. Renders a bullet surrounded by spaces and then marks that a wrap may occur ''after'' the bullet.
* {{tl|–wrap}} - Looks like this: " &ndash; ". For dashed lists. Renders a ndash surrounded by spaces and then marks that a wrap may occur ''after'' the ndash.
* {{tl|!wrap}} - Looks like this: " &#124; ". For pipe separated lists. Renders a pipe surrounded by spaces and then marks that a wrap may occur ''after'' the pipe. The pipe used is not a real pipe but the code <code>&amp;#124;</code> so should work within wiki tables etc.

'''Note!''' The helper templates may only be used in sections surrounded by {{tl|nowrap begin}} and {{tl|nowrap end}} or they may cause weird behaviour of your page.

=== Usage ===

<pre><nowiki>
{{nowrap begin}}

[[Salt]] and{{wrap}} [[Pepper]] and{{wrap}} [[Curry]] 
and{{wrap}} [[Saffron]].{{wrap}} 
[[Salt]] and{{wrap}} [[Pepper]] and{{wrap}} [[Curry]] 
and{{wrap}} [[Saffron]]. 

{{nowrap end}}
</nowiki></pre>

It will render something like this:

:[[Salt]] and [[Pepper]] and [[Curry]] and 
:[[Saffron]]. [[Salt]] and [[Pepper]] and 
:[[Curry]] and [[Saffron]]. 

But it will ''not'' render like this:

:[[Salt]] and [[Pepper]] and [[Curry]] 
:and [[Saffron]]. [[Salt]] and [[Pepper]] 
:and [[Curry]] and [[Saffron]]. 

To make your code readable and easy to edit, you can put each wrappable "line" on its own line. And let's use some dots too. Like this:

<pre><nowiki>
{{nowrap begin}}

[[Salt]] and [[Pepper]]{{·wrap}} 
[[Pepper]] and [[Curry]]{{·wrap}} 
[[Curry]] and [[Saffron]]{{·wrap}} 
[[Saffron]] and [[Salt]]

{{nowrap end}}
</nowiki></pre>

It will render something like this:

:[[Salt]] and [[Pepper]] '''·''' [[Pepper]] and [[Curry]] '''·''' 
:[[Curry]] and [[Saffron]] '''·''' [[Saffron]] and [[Salt]]

But it will ''not'' render like this:

:[[Salt]] and [[Pepper]] '''·''' [[Pepper]] 
:and [[Curry]] '''·''' [[Curry]] and [[Saffron]] 
:'''·''' [[Saffron]] and [[Salt]]

=== Examples ===

Here are the above examples in actual running code in a table. Try dragging the width of your web browser window so it becomes smaller and smaller and watch how the line wrapping behaves:

{| class="wikitable"
|-
|
{{nowrap begin}}
[[Salt]] and{{wrap}} [[Pepper]] and{{wrap}} [[Curry]] 
and{{wrap}} [[Saffron]].{{wrap}} 
[[Salt]] and{{wrap}} [[Pepper]] and{{wrap}} [[Curry]] 
and{{wrap}} [[Saffron]]. 
{{nowrap end}}
|
{{nowrap begin}}
[[Salt]] and [[Pepper]]{{·wrap}} 
[[Pepper]] and [[Curry]]{{·wrap}} 
[[Curry]] and [[Saffron]]{{·wrap}} 
[[Saffron]] and [[Salt]]
{{nowrap end}}
|}

An example demonstrating all the helper templates:

{| class="wikitable"
|-
|
{{nowrap begin}}
[[Salt]]{{wrap}} [[Pepper]]{{wrap}} [[Curry]]{{·wrap}} [[Saffron]]{{·wrap}} [[Salt]]{{•wrap}} [[Pepper]]{{•wrap}} [[Curry]]{{–wrap}} [[Saffron]]{{–wrap}} [[Salt]]{{!wrap}} [[Pepper]]{{!wrap}} [[Curry]]
{{nowrap end}}
|
{{nowrap begin}}
[[Salt]]{{wrap}} [[Pepper]]{{wrap}} [[Curry]]{{·wrap}} [[Saffron]]{{·wrap}} [[Salt]]{{•wrap}} [[Pepper]]{{•wrap}} [[Curry]]{{–wrap}} [[Saffron]]{{–wrap}} [[Salt]]{{!wrap}} [[Pepper]]{{!wrap}} [[Curry]]
{{nowrap end}}
|}

=== Technical details ===

The actual code that does the job is this HTML+CSS code:

:<code><nowiki><span style="white-space:nowrap;"> Text and links </span> <span style="white-space:nowrap;"> More text and links </span></nowiki></code>

It means that wraps may only happen in the unprotected space between the <code><nowiki></span></nowiki></code> and the <code><nowiki><span ...></nowiki></code>. That's what the {{tl|nowrap begin}} and its helper templates are packaging in an easy to use way.

The {{tl|·wrap}} and the {{tl|•wrap}} tolerates anything from no to several spaces and newlines on either side. They will always render only one space on each side of the dot, and if a wrap occurs then the wrap will come after the dot, not before.

The {{tl|·wrap}} causes problems if inside sections of bolded text. Do end the bold text before the {{tl|·wrap}} and continue the bold text after it to avoid the problems. {{tl|•wrap}} does not have this problem.

=== See also ===

* {{tl|nowrap end}} - The other end of this template.
* {{tl|nowrap}} - A template with similar purpose.
* {{tl|nowraplinks}} - Prevents wraps inside links and only allows wraps between the links and in normal text. Very useful for link lists and usually easier to use than this template.
* {{tn|·}} and {{tn|•}} - If you need dots/bullets when not using {{tl|nowrap begin}} and {{tl|nowrap end}}.


<noinclude>
[[Category:Dokuméntasi citakan|{{PAGENAME}}]]
</noinclude><includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Citakan format|{{PAGENAME}}]]

<!-- ADD INTERWIKIS BELOW THIS LINE -->

</includeonly>