Ŝablono:•/dokumentado

El Kitakujo

< Ŝablono:•(Malsamoj inter versioj)
Iri al: navigado, serĉi
(kiu emas fintraduki la anglaĵon?)
E (15 versioj: Baza ŝablono kaj dokumentado)
 
(14 mezaj versioj ne montrata.)
Linio 1: Linio 1:
{{ŝablona navigado}}
{{ŝablona navigado}}
-
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
 
-
__NOTOC__
 
-
Tio estas '''bold middot''' ŝablono, aspektas kiel tio: " '''&middot;''' ".
 
-
Ĝi funkcias simile kiel html+wiki markup sekvo "<code>'''&amp;nbsp;<nowiki>'''&amp;middot;'''</nowiki>'''&nbsp;</code>". That is, [[non-breaking space]], a bolded middot and a normal space.  
+
Tio estas ŝablono '''grasa mezpunkto''', aspektas kiel tio: " '''&middot;''' ".  
-
<!--{{tl|dot}} a {{tl|middot}} sposrědkujetej sem a so móžetej wužiwać kaž alternatiwnej mjenje za tutu předłohu.-->
+
Ĝi funkcias simile kiel html+vikia markada sekvenco "<code>'''&amp;nbsp;<nowiki>'''&amp;middot;'''</nowiki>'''&nbsp;</code>". Alivorte, [[ne-liniavanca spaceto]], grasa mezpunkto, kaj normala spaceto.  
-
{{esperantigu artikolon}}
+
-
This template is usually used for dotted lists, such as for link lists in navigation boxes. (For lists that have a font-size 80% or less of normal font-size, the bold middot "'''&middot;'''" becomes too small. Then use the [[Template:•|bullet]] "&bull;" instead.)
+
-
This template is used when you want something smaller than a [[Template:•|bullet]] "&bull;", [[Template:Ndash|ndash]] "&ndash;" or [[Template:Mdash|mdash]] "&mdash;".  
+
Ĉi tiu ŝablono norme estas uzata por punktitaj listoj, kiel por ligilaj listoj en navigadaj kadroj. (Por listoj kiuj havas tipara grandeco 80% aŭ malpli ol norma tipargrandeco, la grasa mezpunkto "'''&middot;'''" estiĝas tro maldranda. Tiukaze, uzu la [[Ŝablono:|bulpunkto]] "&bull;" anstataŭe.)
-
=== Normala uzado ===
+
Ĉi tiu ŝablono estas uzata kiam vi volas ion pli malgranda ol [[Template:•|bulpunkto]] "&bull;", [[Ŝablono:Ndash|n-streko]] "&ndash;" aŭ [[Ŝablono:Mdash|m-streko]] "&mdash;".
-
The recommended usage is to use ''no'' space before the template and one space after the template, like this:
+
== Normala uzado ==
 +
La rekomendita uzado estas uzi ''neniu'' spaceto antaŭ la ŝablono kaj unu spaceto post la ŝablono, jen:
  <nowiki>[[salo]]{{&middot;}} [[pipro]]</nowiki>
  <nowiki>[[salo]]{{&middot;}} [[pipro]]</nowiki>
-
The template can also be used with no space after it, but then the code does not wrap in the edit window thus making editing harder. Like this:
+
La ŝablono povas ankaŭ esti uzata kun neniu spaceto post ĝi, sed tiukaze la kodo ne linifaldas en la redakto-fenestro, tiel farante pli malfacilan redaktadon. Jen:
  <nowiki>[[salo]]{{&middot;}}[[pipro]]</nowiki>
  <nowiki>[[salo]]{{&middot;}}[[pipro]]</nowiki>
-
Both examples will render one space on each side of the dot, like this:
+
Ambaŭ ekzemploj farigos unu spaceton en ambaŭ flankoj de la punkto, jene:
:[[salo]] '''&middot;''' [[pipro]]
:[[salo]] '''&middot;''' [[pipro]]
-
If it line breaks then the line break will come ''after'' the dot, not before, like this:
+
Se ĝi liniavancas, tiel la liniavanco venos ''post'' la punkto, ne antaŭ, kiel jene:
:[[salo]] '''&middot;'''  
:[[salo]] '''&middot;'''  
:[[pipro]]
:[[pipro]]
-
For long dotted lists each list item can be put on its own line, with no spaces between each item and the template. Like this:
+
Por longa punktitaj listoj, ĉiu listano povas esti metita en ĝia propra linio, kun neniuj spacetoj inter ĉiu ano kaj la ŝablono, kiel jene:
  <pre><nowiki>
  <pre><nowiki>
  [[salo]]{{&middot;}}
  [[salo]]{{&middot;}}
  [[pipro]]{{&middot;}}
  [[pipro]]{{&middot;}}
-
  [[curry]]{{&middot;}}
+
  [[kareo]]{{&middot;}}
-
  [[safran]]</nowiki></pre>
+
  [[safrano]]</nowiki></pre>
-
(It doesn't matter if there are no or some spaces at the end of the lines, after the templates.)
+
(Ne gravas se estas aŭ ne estas spacetoj ĉe la fino de linioj, post la ŝablonoj.)
-
As before it will render one space on each side of the dots, like this:
+
Kiel antaŭe ĝi farigos unu spaceton en ambaŭ flanko de la punktoj, kiel jene:
-
:[[salo]] '''&middot;''' [[pipro]] '''&middot;''' [[curry]] '''&middot;''' [[safran]]
+
:[[salo]] '''&middot;''' [[pipro]] '''&middot;''' [[kareo]] '''&middot;''' [[safrano]]
-
And if it line breaks then the line break will come ''after'' one of the dots, not before, like this:
+
Kaj se ĝi liniavancas, la liniavanco venos ''post'' unu de la punktoj, ne antaŭ, kiel jene:
:[[salo]] '''&middot;''' [[pipro]] '''&middot;'''  
:[[salo]] '''&middot;''' [[pipro]] '''&middot;'''  
-
:[[curry]] '''&middot;''' [[safran]]
+
:[[kareo]] '''&middot;''' [[safrano]]
-
When using the template to separate words in italics (typically lists of artworks in [[Template:navbox|navboxes]]), put it ''within the italics'' to display with proper spacing on both sides. Compare:
+
Kiam uzante la ŝablonon apartigi vortojn en kursiva teksto (ĝenerale listoj de artverkoj en [[Ŝablono:navbox|navboxes]]), ''kursivigi ĝin'' por montri ĝin kun ĝusta spacigado de ambaŭ flankoj. Komparu:
-
  <nowiki>''[[Salt]]''{{&middot;}} ''[[Pepper]]''</nowiki>
+
  <nowiki>''[[Salo]]''{{&middot;}} ''[[Pipro]]''</nowiki>
-
  <nowiki>''[[Salt]]{{&middot;}} [[Pepper]]''</nowiki>
+
  <nowiki>''[[Salo]]{{&middot;}} [[Pipro]]''</nowiki>
-
<!-- This smaller text size is necessary for the first example to "fail" as intended. -->
+
<!-- Ĉi tiu pli malgranda teksta grandeco bezonas por la unua ekzemplo "malsukcesi" kiel intenciita. -->
<div style="font-size:90%">
<div style="font-size:90%">
:''[[salo]]''{{·}} ''[[pipro]]''
:''[[salo]]''{{·}} ''[[pipro]]''
Linio 56: Linio 52:
</div>
</div>
-
(This also improves code brevity and clarity.)
+
(Ĉi tiel ankaŭ plibonigas mallongecon kaj klarecon de kodo.)
-
=== Problemoj ĉe uzado ===
+
== Problemoj ĉe uzado ==
-
 
+
Enmetante unu aŭ pliaj spacetoj antaŭ la ŝablono kaŭzos ĝin farigi malsame, kiel en ĉi tiuj ekzemploj:
-
Putting one or more spaces before the template will cause it to render differently, like these examples:
+
  <nowiki>[[salo]] {{&middot;}}[[pipro]]</nowiki>
  <nowiki>[[salo]] {{&middot;}}[[pipro]]</nowiki>
  <nowiki>[[salo]]  {{&middot;}}[[pipro]]</nowiki>
  <nowiki>[[salo]]  {{&middot;}}[[pipro]]</nowiki>
Linio 66: Linio 61:
  <nowiki>[[salo]]  {{&middot;}}  [[pipro]]</nowiki>
  <nowiki>[[salo]]  {{&middot;}}  [[pipro]]</nowiki>
-
Then it will render with ''two'' spaces before the dot, and one after, like this:
+
Tiel ĝi montrigi kun ''du'' spacetoj antaŭ la punkto, kaj unu poste, kiel jene:
:[[salo]] &nbsp;'''&middot;''' [[pipro]]
:[[salo]] &nbsp;'''&middot;''' [[pipro]]
-
And if it line breaks it might break ''before'' the dot, like this:
+
Kaj se ĝi liniavancas, ĝi eble avancos ''antaŭ'' la punkto, kiel jene:
:[[salo]]  
:[[salo]]  
:'''&middot;''' [[pipro]]
:'''&middot;''' [[pipro]]
-
Alternatively an <code>&amp;nbsp;</code> can be added before and after the template to create extra padding around the middot.
+
Alternative <code>&amp;nbsp;</code> povas esti aldonita antaŭ kaj post la ŝablono por krei plian ŝtopadon ĉirkaŭ la mezpunkto.
-
=== Teknikaj detaloj ===
+
== Teknikaj detaloj ==
-
The space before the dot is a [[non-breaking space]]. That means it will not line break and will not collapse together with normal spaces that come before the template.
+
La spaceto antaŭ la punkto estas [[ne-linavanca spaceto]]. Tial ĝi ne liniavancos kaj ne interkunigos kun normaj spacetoj venante antaŭ la ŝablono.
-
The space after the dot is a normal space. That means it wraps (allows line breaks) and it will collapse together with normal spaces that come after the template to form one single space.
+
La spaceto post la punkto estas norma spaceto. Tial ĝi permesas liniavancojn kaj interkunigos kun normaj spacetoj venante post la ŝablono por estiĝi unuopa spaceto.
-
Under some circumstances dotted link lists misbehave. They might get unexpected line wraps or they might expand outside the box they are enclosed in. The how-to guide [[Wikipedia:Line break handling]] explains when that happens and how to fix it.
+
Iufoje punktitaj listoj de ligiloj misfunkcias. Ili eble ricevos malatenditajn liniavancojn, aŭ ili eble vastigi ekster la kesto kiu enhavas ilin. La anglalingva "kiel-fari" gvidlibro [[:en:Wikipedia:Line break handling]] priskribas kiel ripari tian problemon.
-
=== Dot size reference list ===
+
== Referenco-listo pri punkta grandeco ==
{| style="text-align:center; background:transparent;"
{| style="text-align:center; background:transparent;"
| style="width:1.7em;" | <small>&middot;</small>
| style="width:1.7em;" | <small>&middot;</small>
-
| align="left" | &lt;small> middot
+
| align="left" | &lt;small> mezpunkto (eta)
|-
|-
| &middot;
| &middot;
-
| align="left" | middot
+
| align="left" | mezpunkto
|-
|-
| <small>'''&middot;'''</small>  
| <small>'''&middot;'''</small>  
-
| align="left" | &lt;small> bold middot
+
| align="left" | &lt;small> grasa mezpunkto (eta)
|-
|-
| '''&middot;'''
| '''&middot;'''
-
| align="left" | bold middot
+
| align="left" | grasa mezpunkto
|-
|-
| <small>&bull;</small>       
| <small>&bull;</small>       
-
| align="left" | &lt;small> bullet
+
| align="left" | &lt;small> bulpunkto (eta)
|-
|-
| &bull;
| &bull;
-
| align="left" | bullet
+
| align="left" | bulpunkto
|-
|-
| '''&bull;'''
| '''&bull;'''
-
| align="left" | bold bullet
+
| align="left" | grasa bulpunkto
|-
|-
| &ndash;
| &ndash;
-
| align="left" | ndash
+
| align="left" | n-streko
|-
|-
| &mdash;
| &mdash;
-
| align="left" | mdash
+
| align="left" | m-streko
|}
|}
-
=== See also ===
+
== Vidu ankaŭ ==
-
 
+
* [[Ŝablono:md]] ( — )
-
There are several other templates with similar functionality:
+
-
 
+
-
* {{tn|•}} – Bullet "&bull;" is mostly used for dotted lists that use small font sizes.
+
-
* {{tl|ndash}} – Ndash "&ndash;" is a short dash.
+
-
* {{tl|mdash}} – Mdash "&mdash;" is a long dash.
+
-
* {{tn|\}} – For the occasional slash "/" in lists.
+
-
 
+
-
When making dotted lists you might need to handle proper word wrapping (line breaking):
+
-
 
+
-
* {{tl|nowraplinks}} – Prevents wraps inside links and only allows wraps between the links and in normal text, very useful for link lists and easy to use.
+
-
* {{tl|nowrap begin}} – Prevents wraps in both text and links. For the really tricky wrapping cases when you need full control, for instance in very complex link lists.
+
-
* [[Wikipedia:Line break handling]] – The how-to guide detailing how to handle line wrapping on Wikipedia.
+
-
 
+
<includeonly>
<includeonly>
-
<!-- ADD CATEGORIES BELOW THIS LINE -->
+
[[Kategorio:Ŝablono:Formatigo|{{PAGENAME}}]]  
-
[[Category:Wikipedia formatting and function templates|·]]  
+
-
<!-- ADD INTERWIKIS BELOW THIS LINE -->
+
[[ar:قالب:•]]
[[ca:Plantilla:·]]
[[ca:Plantilla:·]]
[[cy:Nodyn:·]]
[[cy:Nodyn:·]]
Linio 140: Linio 121:
[[es:Plantilla:·]]
[[es:Plantilla:·]]
[[fr:Modèle:·]]
[[fr:Modèle:·]]
 +
[[he:תבנית:·]]
[[hi:साँचा:·]]
[[hi:साँचा:·]]
[[hsb:Předłoha:·]]
[[hsb:Předłoha:·]]
[[hu:Sablon:·]]
[[hu:Sablon:·]]
 +
[[ia:Patrono:*]]
[[id:Templat:·]]
[[id:Templat:·]]
[[it:Template:·]]
[[it:Template:·]]
[[ja:Template:·]]
[[ja:Template:·]]
 +
[[ko:틀:·]]
[[ku:Şablon:·]]
[[ku:Şablon:·]]
-
<!-- [[lt:Šablonas:·]] doesn't include the &nbsp; -->
 
[[lv:Veidne:·]]
[[lv:Veidne:·]]
[[ms:Templat:·]]
[[ms:Templat:·]]
[[nl:Sjabloon:·]]
[[nl:Sjabloon:·]]
[[nn:Mal:·]]
[[nn:Mal:·]]
-
<!-- [[no:Mal:·]] doesn't include the &nbsp; -->
 
[[pt:Predefinição:·]]
[[pt:Predefinição:·]]
[[ro:Format:·]]
[[ro:Format:·]]
Linio 159: Linio 141:
[[sq:Stampa:·]]
[[sq:Stampa:·]]
[[su:Citakan:·]]
[[su:Citakan:·]]
 +
[[sv:Mall:·]]
[[tr:Şablon:·]]
[[tr:Şablon:·]]
[[uk:Шаблон:·]]
[[uk:Шаблон:·]]
-
 
+
[[vi:Bản mẫu:•]]
</includeonly>
</includeonly>

Nuna versio ekde 12:16, 24. Aŭg 2010

Tio estas helpdokumentado por la ŝablono {{•}}.
Ĝi enhavas informojn pri la uzado de ŝablono, ĝiaj kategorioj kaj interlingvaj ligiloj, kiu ne estas enhavo de la ĝusta ŝablona paĝo.

Tio estas ŝablono grasa mezpunkto, aspektas kiel tio: " · ".

Ĝi funkcias simile kiel html+vikia markada sekvenco "&nbsp;'''&middot;''' ". Alivorte, ne-liniavanca spaceto, grasa mezpunkto, kaj normala spaceto.

Ĉi tiu ŝablono norme estas uzata por punktitaj listoj, kiel por ligilaj listoj en navigadaj kadroj. (Por listoj kiuj havas tipara grandeco 80% aŭ malpli ol norma tipargrandeco, la grasa mezpunkto "·" estiĝas tro maldranda. Tiukaze, uzu la bulpunkto "•" anstataŭe.)

Ĉi tiu ŝablono estas uzata kiam vi volas ion pli malgranda ol bulpunkto "•", n-streko "–" aŭ m-streko "—".

Enhavo

Normala uzado

La rekomendita uzado estas uzi neniu spaceto antaŭ la ŝablono kaj unu spaceto post la ŝablono, jen:

[[salo]]{{·}} [[pipro]]

La ŝablono povas ankaŭ esti uzata kun neniu spaceto post ĝi, sed tiukaze la kodo ne linifaldas en la redakto-fenestro, tiel farante pli malfacilan redaktadon. Jen:

[[salo]]{{·}}[[pipro]]

Ambaŭ ekzemploj farigos unu spaceton en ambaŭ flankoj de la punkto, jene:

salo · pipro

Se ĝi liniavancas, tiel la liniavanco venos post la punkto, ne antaŭ, kiel jene:

salo ·
pipro

Por longa punktitaj listoj, ĉiu listano povas esti metita en ĝia propra linio, kun neniuj spacetoj inter ĉiu ano kaj la ŝablono, kiel jene:

 [[salo]]{{·}}
 [[pipro]]{{·}}
 [[kareo]]{{·}}
 [[safrano]]

(Ne gravas se estas aŭ ne estas spacetoj ĉe la fino de linioj, post la ŝablonoj.)

Kiel antaŭe ĝi farigos unu spaceton en ambaŭ flanko de la punktoj, kiel jene:

salo · pipro · kareo · safrano

Kaj se ĝi liniavancas, la liniavanco venos post unu de la punktoj, ne antaŭ, kiel jene:

salo · pipro ·
kareo · safrano

Kiam uzante la ŝablonon apartigi vortojn en kursiva teksto (ĝenerale listoj de artverkoj en navboxes), kursivigi ĝin por montri ĝin kun ĝusta spacigado de ambaŭ flankoj. Komparu:

''[[Salo]]''{{·}} ''[[Pipro]]''
''[[Salo]]{{·}} [[Pipro]]''
salo· pipro
salo· pipro

(Ĉi tiel ankaŭ plibonigas mallongecon kaj klarecon de kodo.)

Problemoj ĉe uzado

Enmetante unu aŭ pliaj spacetoj antaŭ la ŝablono kaŭzos ĝin farigi malsame, kiel en ĉi tiuj ekzemploj:

[[salo]] {{·}}[[pipro]]
[[salo]]   {{·}}[[pipro]]
[[salo]] {{·}} [[pipro]]
[[salo]]   {{·}}   [[pipro]]

Tiel ĝi montrigi kun du spacetoj antaŭ la punkto, kaj unu poste, kiel jene:

salo  · pipro

Kaj se ĝi liniavancas, ĝi eble avancos antaŭ la punkto, kiel jene:

salo
· pipro

Alternative &nbsp; povas esti aldonita antaŭ kaj post la ŝablono por krei plian ŝtopadon ĉirkaŭ la mezpunkto.

Teknikaj detaloj

La spaceto antaŭ la punkto estas ne-linavanca spaceto. Tial ĝi ne liniavancos kaj ne interkunigos kun normaj spacetoj venante antaŭ la ŝablono.

La spaceto post la punkto estas norma spaceto. Tial ĝi permesas liniavancojn kaj interkunigos kun normaj spacetoj venante post la ŝablono por estiĝi unuopa spaceto.

Iufoje punktitaj listoj de ligiloj misfunkcias. Ili eble ricevos malatenditajn liniavancojn, aŭ ili eble vastigi ekster la kesto kiu enhavas ilin. La anglalingva "kiel-fari" gvidlibro en:Wikipedia:Line break handling priskribas kiel ripari tian problemon.

Referenco-listo pri punkta grandeco

· <small> mezpunkto (eta)
· mezpunkto
· <small> grasa mezpunkto (eta)
· grasa mezpunkto
<small> bulpunkto (eta)
bulpunkto
grasa bulpunkto
n-streko
m-streko

Vidu ankaŭ

Personaj iloj