Mahan: ۱ نسخه واردشده

2017-12-23T23:02:00Z

۱ نسخه واردشده

→ نسخهٔ قدیمی‌تر		نسخهٔ ‏۲۴ دسامبر ۲۰۱۷، ساعت ۰۱:۰۲
(بدون تفاوت)

Mahan در ‏۱۶ نوامبر ۲۰۱۶، ساعت ۱۴:۱۹

2016-11-16T14:19:45Z

صفحهٔ تازه

{{زیرصفحه توضیحات}}

{{چپ‌چین}}
== Use ==
This is the {{الگو|key press}} template primarily designed to illustrate keys and keystrokes on a [[صفحه‌کلید]]. With additional parameters, a single template can even illustrate a combination of multiple ''simultaneous'' keystrokes. A sequence of keystrokes, on the other hand, need to be demonstrated with separate templates.

Example:
:{{الگوک|key press|A}} → {{فشردن کلید|A}}

=== Keystroke combinations ===

To illustrate keystroke combinations, just use extra parameters:
:{{الگوک|key press|Alt|P}} → {{فشردن کلید|Alt|P}}
:{{الگوک|key press|Ctrl|Alt|Del}} → {{فشردن کلید|Ctrl|Alt|Del}}

This template currently handles up to 10 key name parameters, which should be more than enough to accommodate for any possible combination of simultaneous keystrokes. If it gets too many key name parameters it reports the page into [[:Category:Iranpedia keypress template parameter needs fixing]]. This means we can easily find those pages and fix them, or we can discover if we need to make this template take more parameters.

When you feed several key names to this template, it adds a "+" (or whatever the contents of the optional ''chain'' parameter) with no spaces around. This means it won't line wrap. But when you show key combinations for instance in a table then that might cause too wide items. Then instead manually build the key combination with spaces around the "+" so it can line wrap:
:{{الگوک|key press|Ctrl}} + {{الگوک|key press|Alt}} + {{الگوک|key press|Del}} → {{فشردن کلید|Ctrl}} + {{فشردن کلید|Alt}} + {{فشردن کلید|Del}}
:{{الگوک|key press|Ctrl|Alt|Del|5=chain=&#32;+&#32;}} → {{فشردن کلید|Ctrl|Alt|Del|chain= + }}

On the other hand, to illustrate Windows [[Alt code]]s you might want to use separate templates with no intervening punctuation or space. In most Windows systems in North America and Western Europe, for example, the [[علامت مثبت-منفی]] (±) can be entered by holding down the Alt key while typing <code>0177</code> (with the [[numeric keypad]]):
:{{الگوک|key press|Alt|0}}{{الگوک|key press|1}}{{الگوک|key press|7}}{{الگوک|key press|7}} → {{فشردن کلید|Alt|0}}{{فشردن کلید|1}}{{فشردن کلید|7}}{{فشردن کلید|7}}

An example of a use case where more than 5 might be used is explaining usage of a macro (keyboard shortcut) created by a third-party application:
:{{الگوک|Key press|Ctrl|Alt|Shift|Win|Menu|fn|L}} → {{فشردن کلید|Ctrl|Alt|Shift|Win|Menu|fn|L}}

=== Wikilinks ===

If there is an article about the key you can [[راهنما:فهرست/پیوند‌ها|wikilink]] the key's name like any other wiki text. Like this:
* {{الگوک|key press|<nowiki>[[کلید آلت|Alt]]</nowiki>}} → {{فشردن کلید|[[کلید آلت|Alt]]}}

If you are wikilinking the keys, please ensure that you are piping to the correct page (e.g. <code><nowiki>[[کلید کنترل (رایانه)|Ctrl]]</nowiki></code> instead of <code><nowiki>[[Ctrl]]</nowiki></code>, which leads to a [[ایران‌پدیا:ابهام‌زدایی|disambiguation page]]).

=== Wiki markup characters ===

Some wiki markup character, like the [[خط عمودی]], the [[نقطه ویرگول]] and the [[علامت مساوی]], need to be entered using the {{الگو|!}}, {{الگو|;}} and {{الگو|{{=}}}} templates or as an [[HTML entity]] &#124;, &#59;, &#61; respectively:
* {{الگوک|key press|{{الگوک|!}}}} → {{فشردن کلید|{{!}}}}
* {{الگوک|key press|&#124;}} → {{فشردن کلید||}}
* {{الگوک|key press|{{الگوک|;}}}} → {{فشردن کلید|{{;}}}}
* {{الگوک|key press|&#59;}} → {{فشردن کلید|;}}
* {{الگوک|key press|{{الگوک|=}}}} → {{فشردن کلید|{{=}}}}
* {{الگوک|key press|&#61;}} → {{فشردن کلید|=}}

However, if the characters are marked as wikilinks, they can be entered as such:
* {{الگوک|key press|<nowiki>[[|]]</nowiki>}} → {{فشردن کلید|[[|]]}}
* {{الگوک|key press|<nowiki>[[نقطه ویرگول]]</nowiki>}} → {{فشردن کلید|[[نقطه ویرگول]]}}
* {{الگوک|key press|<nowiki>[[علامت مساوی]]</nowiki>}} → {{فشردن کلید|[[علامت مساوی]]}}

Most markup characters also have aliases:
* {{الگوک|key press|pipe}} → {{فشردن کلید|pipe}}
* {{الگوک|key press|semicolon}} → {{فشردن کلید|semicolon}}
* {{الگوک|key press|equals}} → {{فشردن کلید|equals}}
* {{الگوک|key press|colon}} → {{فشردن کلید|colon}}
* {{الگوک|key press|asterisk}} → {{فشردن کلید|asterisk}}
* {{الگوک|key press|hash}} → {{فشردن کلید|hash}}

=== Key symbols ===

Some key names have a fitting [[یونی‌کد]] character. This template automatically adds such "icons" to the following key names among others (see also ''Arrows exception'' below).
* {{الگوک|key press|Shift}} → {{فشردن کلید|Shift}}
* {{الگوک|key press|Tab}} → {{فشردن کلید|Tab}}
* {{الگوک|key press|Enter}} → {{فشردن کلید|Enter}}
* {{الگوک|key press|Option}} → {{فشردن کلید|Option}}
* {{الگوک|key press|Opt}} → {{فشردن کلید|Opt}}
* {{الگوک|key press|Command}} → {{فشردن کلید|Command}}
* {{الگوک|key press|Cmd}} → {{فشردن کلید|Cmd}}
* {{الگوک|key press|Caps Lock}} → {{فشردن کلید|Caps Lock}}
* {{الگوک|key press|Scroll Lock}} → {{فشردن کلید|Scroll Lock}}
* {{الگوک|key press|Up}} → {{فشردن کلید|Up}}
* {{الگوک|key press|Down}} → {{فشردن کلید|Down}}
* {{الگوک|key press|Left}} → {{فشردن کلید|Left}}
* {{الگوک|key press|Right}} → {{فشردن کلید|Right}}
[[File:AltGr Win Menu Ctrl key.jpg|thumb|200px|Windows key and Menu key]]
[[File:Ctl wndws alt.jpg|thumb|200px|Old-style Windows key]]
There are no characters for the [[کلید ویندوز]] and [[Menu key]]. Besides, the Windows logo is [[نماد بازرگانی]]ed. So this template shows approximate characters for them in the following way:
* {{الگوک|key press|Win}} → {{فشردن کلید|Win}}
* {{الگوک|key press|Menu}} → {{فشردن کلید|Menu}}

==== Video games ====

Video game controllers often have specialized input labels that do not map easily. The following are mappings for various game consoles and input features.

===== Directional input =====

The following should only be used when the input sequence uses something other than the primary input or mixes input between directional devices.

* {{الگوک|key press|l-down}} → {{فشردن کلید|l-down}}
* {{الگوک|key press|c-left}} → {{فشردن کلید|c-left}}
* {{الگوک|key press|r-up}} → {{فشردن کلید|r-up}}

Stick specific diagonals are also supported:

* {{الگوک|key press|l-nw}} → {{فشردن کلید|l-nw}}
* {{الگوک|key press|c-se}} → {{فشردن کلید|c-se}}
* {{الگوک|key press|r-ne}} → {{فشردن کلید|r-ne}}

===== PlayStation =====

* {{الگوک|key press|ex}} → {{فشردن کلید|ex}}
* {{الگوک|key press|circle}} → {{فشردن کلید|circle}}
* {{الگوک|key press|triangle}} → {{فشردن کلید|triangle}}
* {{الگوک|key press|square}} → {{فشردن کلید|square}}

=== Technical details ===

This template calls {{الگو|key press/core}}, which holds the code that otherwise would be repeated several times in {{الگو|key press}}, thus simplifying the code.
{{پایان چپ‌چین}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|تمرین | |

[[رده:الگو:نرم‌افزارها]]
[[رده:دکمه‌های رایانه]]

}}</includeonly>

الگو:فشردن کلید/توضیحات - تاریخچهٔ نسخه‌ها

Mahan: ۱ نسخه واردشده

Mahan در ‏۱۶ نوامبر ۲۰۱۶، ساعت ۱۴:۱۹