Şablon:Kod noktası

Vikipedi, özgür ansiklopedi
Şuraya atla: kullan, ara
Şablon belgelemesi[gör] [değiştir] [geçmiş] [temizle]

Bu şablon satır içinde Unicode karakterlerinin düzenli bir açıklamasını göstermek amacıyla kullanılır.

  • {{kod noktası|a9|Copyright sign (Telif hakkı imi)}} karakteri fikri mülkiyet hakkını belirtmek için kullanılır → U+00A9 © copyright sign (telif hakkı imi) karakteri fikri mülkiyet hakkını belirtmek için kullanılır

Kullanım[kaynağı değiştir]

Bu şablon Unicode karakterlerinin düzenli açıklamasını üretir ve satır içinde, düz metinler beraber kullanılır. Girdi olarak karakterin Unicode standardında belirtilen on altı tabanındaki kod noktasını ve resmi adını kullanır. Karakterin adı standartlarda resmi olarak İngilizce olarak belirtilmiş olduğundan karakterin resmi adının Türkçe karşılığı parantez içinde yazılır. Örnek {{kod noktası|00A9|Copyright sign (Telif hakkı imi)}}U+00A9 © copyright sign (telif hakkı imi).

Karakter tanımlaması Unicode stadnartlarına uygun bir şekilde yapılmaktadır. Karakterin kod noktası başına "U+" getirilerek yazılır ve karakterin resmi adı tüm harfleri büyük olarak yazılır. Vikipedi'de tamamı büyük harfle yazılan yazılar istenmeyen bir görüntü oluşturduğundan ufaltılmış büyük harfler kullanılır. On altılık tabandaki kod noktasının girilmesi zorunludur (a9 veya 1f3 gibi). Diğer tüm seçenekler isteğe bağlıdır. Karakterin ekrandaki görüntüsü (glif) yazı türü tarafından belirlenen bir unsurdur. Dolayısıyla karakter gösterilirken Unicode standardını en iyi kapsayan yazı türünde gösterilmeye çalışılır ancak eğer istenirse kullanıcı özel olarak karakterin ait olduğu dili, veya IPA karakteri olduğunu belirtebilir. Glif gösterilirken, yazı karakteri olarak göstermek yerine resim kullanılabilir. Bu seçenek standarda yeni eklenen ve çoğu yazı tipi tarafından desteklenmeyen bir karakter söz konusu olduğunda faydalı olacaktır. Harfin yanına parantez içinde ek notlar, kod noktasının on tabanında karşılığı ve HTML gösterimi eklenebilir.

Kontrol karakterleri veya boşluk karakterleri gibi bazı özel karakterlerde şablon tarafından algılanmaktadır. kod noktası/gc şablonunda bu bilgiler kayıtlıdır.

Örnekler[kaynağı değiştir]

  • {{kod noktası|00A9|Copyright sign (Telif hakkı imi)}}U+00A9 © copyright sign (telif hakkı imi)
  • {{kod noktası|00A9|Copyright sign (Telif hakkı imi)|nbağlantısı=Telif hakkı}}U+00A9 © copyright sign (telif hakkı imi)
  • {{kod noktası|00A9|Copyright sign (Telif hakkı imi)|nbağlantısı=Telif hakkı|not=Ayrıca bakınız: [[Copyleft]]}}U+00A9 © copyright sign (telif hakkı imi) (Ayrıca bakınız: Copyleft)
  • {{kod noktası|00A9|Copyright sign (Telif hakkı imi)|nbağlantısı=Telif hakkı|onluk=|html=}}U+00A9 © copyright sign (telif hakkı imi) (HTML: &#; Şablon:Numcr2namecr)
  • {{kod noktası|00A0|No-break space (Kesilemeyen boşluk)|not=NBSP}}U+00A0   no-break space (NBSP)
  • {{kod noktası|0007|nbağlantısı=Bell character)}}U+0007 <control-0007>

Parametreler[kaynağı değiştir]

Tüm parametreleriyle birlikte şablon şu şekildedir:

{{kod noktası
| <!-- on altı tabanında kod noktası ("U+" eklemeyin)  -->
| <!-- Unicode resmi adı (türkçe karşılığı) -->
| ubağlantısı =
| resim =
| kgenişliği =
| boyut =
| kullan =
| kullan2 =
| nbağlantısı =
| onluk   =
| html  =
| not  =
}}

Satır içinde :

{{kod noktası| <!-- on altı tabanında kod noktası ("U+" eklemeyin) -->| <!-- Unicode resmi adı (türkçe karşılığı) -->|ubağlantısı= |resim= |kgenişliği= |boyut= |kullan= |kullan2= |nbağlantısı= |onluk= |html= |not= }}
  • First parameter, 1= Unnamed, required (prefix "1=" may be omitted). The hexadecimal value of the code point, e.g. ​00A9​.
nots: The parameter accepts input like ​A9​, ​a9​ and ​00A9​ as hexadecimal value. Decimal values are not detected being decimal, and will give unexpected results (see Error messages, below).
  • Second parameter, 2= Unnamed (prefix "2=" may be omitted). The Unicode name of the character. The template uses this input as the name in small caps, forced into these small capitals whatever the input. This name may differ from the name of the corresponding Wikipedia article (see below: nbağlantısı=).
  • nbağlantısı= Optional.wikilink. Name of the Wikipedia page that will be linked to. If used, the Unicode name (second parameter) has a wikilink to the article. When the article name and the Unicode name are the same, using a straight "nbağlantısı=" without a name will do.
For control characters using the nbağlantısı parameter, the Unicode name parameter is not used: the nbağlantısı parameter is displayed instead, without small caps.
not: the name of the page is case sensitive as with all wikipages.
{{kod noktası|00A9|Copyright sign (Telif hakkı imi)|nbağlantısı=Copyright symbol}}U+00A9 © copyright sign (telif hakkı imi)
{{kod noktası|00A3|Pound sign|nbağlantısı=}}U+00A3 £ pound sign.
  • ubağlantısı Optional. Creates a wikilink in the "U+" prefix. When used without name (​{{{1}}}​), the default value, Unicode page, is used: U+.
  • dec= Optional. Adds the decimal value to the text, in the bracketed not.
  • html= Optional. Adds the HTML character reference to the text, like &#160; in the bracketed not. If a named character reference exists, like "&nbsp;", that is added too.
  • use= Optional. Sets the font-hinting template to get the glyph, since the character may not be present in a regular browser font. Default is {{unicode}}, other options are {{IPA}}, {{lang}} and {{script}}. When setting "use=lang" or "use=script", use2 should be used to set the language ("use2=fr") or the script ("use2=Cyrs"). A glyph may still not show as expected due to browser effects. For a detailed description, see the templates documentation.
{{kod noktası|0485|COMBINING CYRILLIC DASIA PNEUMATA|cwith=|use=script|use2=Cyrs}}U+0485 ҅ combining cyrillic dasia pneumata
  • resim= Optional. Allows for a file (graphic resim) to represent the glyph, overrules the font completely. The filename should include the extension like ".svg", but not the prefix "File:".
  • cwith= Optional. Useful when the Unicode character is combining. Using ​cwith=​ adds a space before the character, allowing the combining effect. So when used with a character like ​cwith=a​, the character will be combined with the letter "a". In Unicode, a general glyph used to place a combined character is U+25CC dotted circle (HTML: &#; Şablon:Numcr2namecr).
without cwith=:
{{kod noktası|0485|COMBINING CYRILLIC DASIA PNEUMATA}}U+0485 ҅ combining cyrillic dasia pneumata
cwith= without parameter:
{{kod noktası|0485|COMBINING CYRILLIC DASIA PNEUMATA|cwith=}}U+0485 ҅ combining cyrillic dasia pneumata
cwith= with dotted circle:
{{kod noktası|0485|COMBINING CYRILLIC DASIA PNEUMATA|cwith=&#9676;}}U+0485 ҅ combining cyrillic dasia pneumata
  • size= Optional. Can be used to set the size of the glyph. By default "size=125%". For the font, all font-size style inputs are accepted: "7px", "150%", "2em", "larger".
{{kod noktası|0041|LATIN CAPITAL LETTER A|size=2em}}U+0041 A latin capital letter a
When using an resim (file) instead of a font, this size can only accept sizes in px like "12px". Default for resims is "10px" .
{{kod noktası
| A9
| Copyright sign (Telif hakkı imi)
| ubağlantısı = Unicode character mapping
| resim = 
| size  = 150%
| nbağlantısı = Copyright symbol
| not  = Example
}}
Produces:
  • U+00A9 © copyright sign (telif hakkı imi) (Example)

Presentation effects[kaynağı değiştir]

Since this template is aimed at presenting a formatted, inline description, some effects are introduced to sustain this target.

  • Showing space characters: All space characters (those with General Category: Zs) are presented with a light-blue background, to show their actual presence and width: U+00A0   no-break space.
Incidentally, the regular space is replaced with &#00A0; (NBSP) to prevent wiki-markup deleting it as repeated spaces.
  • Removing formatting characters: Formatting characters (those with General Category: Cf, Zl and Zp) are removed from the output. By definition, formatting characters have no glyph. By removing them they cannot have a formatting effect.

Exception: five Arabic Cf/formatting number markings U+0600..U+0603 and U+60DD, are shown. While Cf formatting characters usually have no glyph, these five have. By internally adding "(visible)" to the category, these characters are shown.

  • Removing whitespace: The template removes formatting code and surrounding whitespace from the input. A <Return> in the Name-input (possibly unintended) would frustrate the in-line behaviour expectation.
  • Showing a label like <control-0007>: Unicode states, that an code point has no name when it is one of these: a control character, a private use character, a surrogate, a not assigned code point (reserved), or a non-character. These code points instead should be referred to by using a "Code Point Label", such as <private-use> or <private-use-E000>. In this situation, this template replaces the glyph with that label. This way, the correct presentation wins it over Unicode-usage to the letter of the law.
  • "Control" general category=Cc: <control> or <control-0007>
  • "Surrogate" general category=Cs: <surrogate> or <surrogate-D800>
  • "Private Use": general category=Co: <private-use> or <private-use-FFA0>
  • "Not a character" (minus the reserved code points, see below): general category=Cn: <not-a-character>, <non-character> or <not-a-character-FFA0>

The second parameter (Unicode name) is not presented, since it cannot exist. It is possible to create a link to an article.

not: A <reserved> (unassigned) code point cannot be detected yet, and so is not presented with this label. These code points too are given Cn category.
(Background on <>-labels: A Name can never have <>-brackets at all. These rules prevent mixing up a name with an actual control-character. So it will not happen that a bell rings when a page is opened that contains a Name of U+0007).

Possible errors[kaynağı değiştir]

  • The template produces an Error-message when parameter #1 (hex value) is missing.
  • A non-hexadecimal input like 00G9 produces an error (Because G/g is not hexadecimal).
  • Do not add the U+-prefix like U+00A9. It will not be recognised.
  • If the template only shows the code point number, like "2038", you're probably using the wrong template Şablon:Tlb, instead of Şablon:Tlb.
  • The glyph may be overruled and changed into a label like <control-0007>. These characters have no Unicode name. An nbağlantısı will be directly to the article (entered in "nbağlantısı=Bell signal"). A blank like this "nbağlantısı=", (which links fine for regular characters like Pound sign), cannot work for <labeled> characters (there is no character name at all to make into a link). This produces an error.
  • A decimal value input like 1=98 will be read as being hexadecimal value 0098. There is no way that the template can detect you intended to enter 9810=6216.No warning is issued, and the wrong character, U+009816, will be shown (not U+0062).

Technical nots[kaynağı değiştir]

The word "kod noktası" is used only in this English Wikipedia, as a name for this template. It has no meaning outside.

The template uses these subtemplates:

  • {{kod noktası/main}} Accepts all the input from {{kod noktası}}. Calls several subtemplates to produce the textstrings, and then strings them together. Also checks for the error non-hex input.
  • {{kod noktası/ubağlantısı}} creates a piped link for the "U+" prefix.
  • {{kod noktası/gc}} determines the Unicode general category, when this category is special (like, for control characters).
  • {{kod noktası/glyph}} for rendering the glyph by font. Accepts "resim=" that overrules the font. Uses also "use", "use2", "size", "cwith".
  • {{kod noktası/na}} Produces the formatted name of the character in smallcaps. Accepts the "nbağlantısı=" to create a piped wikilink to an article. When the general category (gc) is special, the name will change into a <label-hhhh>.
  • {{kod noktası/nots}} - Produces the three optional nots in brackets: decimal value, HTML-character reference (both decimal and by name like ​&amp;nbsp;​ if that exists using {{numcr2namecr}}) and the free text not as provided by the editor. Also does the brackets themselves.
  • Using the main template as an input-easy feature, there are few calculations done (actually only two hex2dec), and allows for adding default values not too deep in the templates.
  • The value "<#salted#>" is used internally to pass through a non-defined input parameter. This value is correct when about the Name, because a Unicode name cannot have the characters <##>, and so salted is the right word (meaning uninhibitable). For ease of code maintenance it is used in more places around.

Issues[kaynağı değiştir]

  • Unassigned code points, to be labelled <reserved>, cannot be detected.
  • When using use-script, use2 needs lowercase (e.g. 0485, Cyrs or cyrs)

See also[kaynağı değiştir]

  • {{unicode}} - Produces rare characters, using fonts that cover Unicode more widely.

Şablon:Unicode templates

External links[kaynağı değiştir]

Useful links for researching Unicode characters:

  • Unicode charts, gives the chart (in PDF) on which the U+value is located.
  • Fileformat.com search, to search by name (whole or partial), by U+ hex value or decimal value, by the font symbol (copy-past it). Extra information per character. One character only.
  • [1] a multi-character converter.