عرض مصدر قالب:مواصفات طائرات/doc

{{#ifeq:{{{noheader|}}}|yes||{{صفحة توثيق فرعية}}

== استعمال ==
}}
<!--{{استخدام عال}} -->

:[[ملف:Ambox warning pn.svg|يسار|16px|alt=|link=]] Please test any changes in the template's [[قالب:مواصفات طائرات/sandbox|/sandbox]] or [[قالب:مواصفات طائرات/testcases|/testcases]] subpages, or in a user subpage, and consider discussing changes on the appropriate pages before implementing them. '''Editors beware:''' formatting of code to make it "look nice" is very likely to inadvertently introduce leading and trailing blank lines into the template output.

{{قالب معقد}}

=== Aircraft specs === <!-- PLEASE DON'T CHANGE THE LEVEL OF THIS HEADING, AS IT IS NECESSARY FOR PROPER TRANSCLUSION. -->

This template displays aircraft specifications, automatically formatted and converted for either metric or imperial units.

:[[ملف:Ambox warning pn.svg|يسار|16px|alt=|link=]] Due to the use of the {{قا|حول}} template, entries must '''''not''''' include commas. For example '''<code>|empty weight=11280</code>''' not '''<code>|empty weight=11,280</code>'''!

:[[ملف:Ambox warning pn.svg|يسار|16px|alt=|link=]] A "note" parameter is available for every parameters for qualifying the entry. Its name is always the same as the parameter you are amending, without units, and "note" attached to the end. For example '''<code>|range miles=420</code>''' and '''<code>|range note=with max wing fuel, VTOL, & 10% reserves</code>'''. Some parameters (i.e. '''<code>|crew=</code>''') will display any text entered and do not require the use of notes.

== Syntax ==
{{مواصفات طائرات/doc/examples}}

This template was designed so that the data supported by it should be largely self-explanatory. A detailed description of the various fields, with examples, follows:

* '''<code>|ref=</code>''' allows for the data in this section to be specifically sourced.

* '''<code>|prime units?=</code>''' switches the template from displaying SI (metric) units first (by entering '''met''') or English (Imperial) units first (by entering '''imp''' for mph first or '''kts''' for kts or nautical miles first). There is a long-standing convention within WikiProject:Aircraft that specifications for US, Canadian and UK aircraft (for the UK periods differ - e.g. RAF aircraft until post war used mph, FAA aircraft operated in knots) should be given as English units first, and all others as SI units first.
:[[ملف:Ambox warning pn.svg|يسار|16px|alt=|link=]] you ''must'' include '''imp''', '''kts''', or '''met''' in this field or the template won't display at all!

* '''<code>|genhide=</code>''' allows the "General characteristics" heading to be manually turned off in the rare case that none of the data in this section is available. Enter <code>|genhide=Y</code> to do this. If using this parameter, please leave a hidden note so that other editors will know to remove this line to turn the heading back on again.
::Example
:::<nowiki>|genhide=Y <!-- please remove this line if data on general characteristics becomes available --></nowiki>

* '''<code>|crew=</code>''' the number of people typically required to operate the aircraft, and their positions (if known). For commercial aircraft, this may include cabin crew. If specific positions are not known, this field might just contain a number. If the number is "One", however, it's safe to assume that this person's job might be "pilot"! Drones and UAVs should have "None" in this field.

::Examples
:::Four
:::One pilot
:::None
:::Three: Pilot, co-pilot, and navigator/radio operator
:::Two: Pilot and tail-gunner
:::Five: Two pilots, flight engineer, two cabin crew

* '''<code>|capacity=</code>''' – the passenger and/or cargo carrying capacity of the aircraft. Typically, this may include some alternatives when a transport aircraft is typically configurable for a variety of cargo types. In these cases, the alternatives should be separated by ''or'' (in italics)

:: Examples
::: 32 passengers
::: 2,000 kg (4,400 lb) of cargo
::: 320 US gal (1,200 L) of chemicals
::: Eight 463L cargo pallets
::: Six passengers ''or'' two litters with attendants

* '''<code>|length=</code>''' – the overall length of the airframe. For rotary-wing aircraft, this is the fuselage length, not counting areas swept by turning rotors.

* '''<code>|span=</code>''' – the overall wingspan for fixed-wing aircraft. This does not count areas swept by turning propellers, but does include the width of tip-tanks, finlets, and non-removable wingtip weapons stations.

*For bi- and tri-planes, a separate measurement for each wing can be entered. For bi-planes use "upper" and "lower", for tri-planes use "upper" "mid" and "lower". If the spans are equal, use the previous parameter <code>|span=</code>.
'''<code>|upper span m=</code>'''
'''<code>|upper span ft=</code>'''
'''<code>|upper span in=</code>'''
'''<code>|mid span m=</code>'''
'''<code>|mid span ft=</code>'''
'''<code>|mid span in=</code>'''
'''<code>|lower span m=</code>'''
'''<code>|lower span ft=</code>'''
'''<code>|lower span in=</code>'''

* '''<code>|swept =</code>''' – the swept wingspan variable-geometry fixed-wing aircraft

* '''<code>|dia=</code>''' – the diameter of an aircraft where this is the best way to describe it. This will most often be used for describing airships and balloons, but will also make sense for disc-shaped (Example: [[VZ-1 Pawnee]], [[Avro Avrocar]]) or cylindrical (Example: [[SNECMA Coléoptère]]) heavier-than-air aircraft. Please do not use this to express a fuselage diameter of a conventional heavier-than-air aircraft – mention that in the article text if it's relevant.

* '''<code>|width=</code>''' – the width of an aircraft in the few very rare cases where this is the best way to describe it (example: [[Rolls-Royce Thrust Measuring Rig]], [[LLRV]])

* '''<code>|height=</code>''' – the overall height of an aircraft, landing gear extended

* '''<code>|wing area=</code>''' – the area of the mainplanes of a fixed-wing aircraft. This excludes the area of horizontal stabiliser or canards. For biplanes, triplanes, and multiplanes, this is the sum of all mainplane areas. For variable-geometry aircraft, this is the unswept area

* '''<code>|swept area=</code>''' – for variable-geometry aircraft where the mainplane area differs depending on whether the wings are swept or not.

* '''<code>|volume=</code>''' – the envelope volume of a lighter-than-air or hybrid aircraft. Please do not use this to express the volume of a cargo space – put that under "capacity" if it's relevant.

* '''<code>|aspect ratio=</code>''' – the ratio of the length of a wing to its chord. While measurable in any fixed-wing aircraft, please only provide this specification when describing sailplanes or for aircraft where this is an important parameter. This can also be used for ''root'', ''tip'', and ''mid'' point information.

* '''<code>|airfoil=</code>''' - For fixed wing aircraft, the type of airfoil the wing uses. E.g., see [[جناح NACA الحامل]] for information on airfoil types.

* '''<code>|empty weight=</code>''' - the unloaded, unfuelled, unoccupied weight of the aircraft. In most cases, this will be the Basic Aircraft Empty Weight. For lighter-than-air or hybrid aircraft, this will be the structural weight of the aircraft.

* '''<code>|gross weight=</code>''' - the fully-loaded weight of the aircraft. In most cases, this will be the Maximum Take Off Weight.

* '''<code>|max takeoff weight=</code>''' - the max takeoff weight of the aircraft, when different from the above gross weight.

* '''<code>|fuel capacity=</code>''' - description of fuel capacity.

* '''<code>|lift=</code>''' - the static lift of a lighter-than-air or hybrid aircraft. Please do not use this to describe dynamic lift.

* '''<code>|more general=</code>''' - A place to put anything relevant not included already under the general parameters e.g. "Fuel Capacity: 500 gallons"

=== Engines ===
At present, the template allows for up to three different types of engines on an aircraft. Typically, this will be used for mixed-power aircraft with piston-engines and jets, or jets and rockets, but occasionally an aircraft will be fitted with more than one type of piston engine. Please do not use this for APUs, or for alternative engine fits.

* '''<code>|eng number=</code>''' – the number of this type of engine, expressed with a digit

* '''<code>|eng name=</code>''' the manufacturer and model of the engine. You need to specify something here otherwise nothing will be shown. Please make sure to wikilink this to the engine article. Please do not simply link to the engine manufacturer to avoid a redlink here. Redlinks are good! They help us grow! Example: <code><nowiki>|eng1 name=[[برات آند ويتني آر-4360 واسب ميجر]]-53 "Wasp Major"</nowiki></code>.

* '''<code>|eng type=</code>''' Examples: <code><nowiki>|eng1 type=liquid-cooled [[محرك V12]]</nowiki></code>, <code><nowiki>|eng2 type=[[محرك مروحة عنفية]]</nowiki></code>, <code><nowiki>|eng3 type=[[محرك شعاعي]]</nowiki></code>.

* '''<code>|eng kw=</code>''', '''<code>|eng hp=</code>''' and '''<code>|eng shp=</code>'''– the rated power of a propeller engine (whether piston or turbine-driven)

* '''<code>|power original=</code>''' For some engines the power output may have been originally measured in an unconventional unit. For example, older German engines originally had their power measured in [[حصان (وحدة قدرة)]] (PS). Sample usage of this parameter: '''<code><nowiki>|power original=<ref>Originally measured as 15,000 [[حصان (وحدة قدرة)]].</nowiki></code>'''

* '''<code>|eng kn=</code>''' and '''<code>|eng lbf=</code>''' – the rated dry thrust of a jet or rocket engine

* '''<code>|thrust original=</code>''' Some jet or rocket engines had their original measurements taken in unconventional units. For example, many Russian and Soviet engines were originally rated using [[كيلو غرام ثقلي]].

* '''<code>|eng kn-ab=</code>''' and '''<code>|eng lbf-ab=</code>''' – the afterburning thrust of a jet engine so equipped.

* '''<code>|eng note=</code>''' - a note that appears after the thrust value. Use this for when data does not fit in the other parameters e.g. expressing a range of power value.

* '''<code>|prop blade number=</code>''' – the number of propellers on a propeller aircraft.

* '''<code>|prop name==</code>''' – description of the propellers.

* '''<code>|prop dia=</code>''' – the diameter of the propeller(s)

* '''<code>|rot number=</code>''' – the number of main (lifting) rotors on a rotary-wing aircraft. This will only be displayed if the number is greater than 1

* '''<code>|rot dia=</code>''' – the diameter of the main (lifting) rotor(s) on a rotary-wing aircraft

* '''<code>|rot area=</code>''' – the area of the main (lifting) rotor(s) of a rotary-wing aircraft. For multi-rotor aircraft, this is the sum of all rotor areas.

* '''<code>|more power=</code>''' - A place to put anything relevant not included already under the engine parameters

* '''<code>|perfhide=</code>''' allows the "Performance" heading to be manually turned off in the rare case that none of the data in this section is available. Enter <code>|perfhide=Y</code> to do this. If using this parameter, please leave a hidden note so that other editors will know to remove this line to turn the heading back on again.
::Example
:::<nowiki>|perfhide=Y <!-- please remove this line if performance data becomes available --></nowiki>

* '''<code>|max speed=</code>''' – the maximum speed of the aircraft

* '''<code>|cruise speed=</code>''' – the maximum cruising speed of the aircraft (usually only specified where the maximum speed is unknown)

* '''<code>|stall speed=</code>''' – the stall speed of the aircraft

* '''<code>|never exceed speed=</code>''' – never exceed speed ([[في سبييدس]]) of the aircraft

* '''<code>|minimum control speed kmh=</code>''' – minimum control speed ([[في سبييدس]]) of the aircraft

* '''<code>|range=</code>''' – the maximum unrefuelled range of the aircraft

* '''<code>|combat range=</code>''' – the maximum range of the aircraft loaded for combat

* '''<code>|ferry range=</code>''' – the maximum range of the aircraft with ferry fuel

* '''<code>|endurance=</code>''' – the maximum flight endurance of the aircraft, where the range is unknown (this is particularly common in specifications of early aircraft).

* '''<code>|ceiling=</code>''' – the service ceiling of the aircraft

* '''<code>|glide ratio=</code>''' – the maximum glide ratio of an aircraft. Please only include this specification when describing gliders and sailplanes.

* '''<code>|climb rate=</code>''' – the maximum rate of climb for a powered aircraft

* '''<code>|time to altitude=</code>''' - ''referenced'' time to climb to altitude, usually in "minutes to x thousand feet"

* '''<code>|sink rate=</code>''' – the minimum rate of sink for an aircraft. Please only include this specification when describing gliders and sailplanes.

* '''<code>|lift to drag=</code>''' – the [[نسبة الرفع إلى السحب]]. A unitless number.

* '''<code>|wing loading=</code>''' – the loaded weight of the aircraft divided by the area of the wing.

* '''<code>|disk loading=</code>''' – the loaded weight of the aircraft divided by the area of the rotor.

* '''<code>|fuel consumption=</code>''' – fuel burn (kg/km or lb/mi).

* '''<code>|avionics=</code>''' – a place to put any specific avionics used.

*'''<code>|power/mass=</code>''' - the power to weight ratio

*'''<code>|thrust/weight=</code>''' - the thrust to weight ratio - dimensionless

:Note: calculating these from other values is considered OR, these should therefore quoted from a source

* '''<code>|more performance=</code>''' – A place to put anything relevant not included already under the performance parameters

=== Armament ===

:[[ملف:Ambox warning pn.svg|يسار|16px|alt=|link=]] You can use '''<code>|armament=</code>''' followed by a bulletted list of the armaments, or omit that line entirely and use the following specific parameters. If you include the line <code>|armament=</code> at all—even with an empty value—then none of the following parameters will have any effect.

<code>|guns=</code><br/>
<code>|bombs=</code><br/>
<code>|rockets=</code><br/>
<code>|missiles=</code><br/>
<code>|hardpoints=</code> to specify the number of hardpoints<br/>
<code>|hardpoint capacity=</code> to specify the capacity of hardpoints e.g. as total payload<br/>
and<br/>
:<code>|hardpoint rockets=</code>
:<code>|hardpoint missiles=</code>
:<code>|hardpoint bombs=</code>
:<code>|hardpoint other=</code>
    
:to specify the types of hardpoint weapons

<code>|other armament=</code> for other armament

<includeonly>
{{#ifeq:{{{noheader|}}}|yes |
 | {{قالب معقد}}
   {{#ifeq:{{SUBPAGENAME}}|sandbox |
    | [[تصنيف:قوالب مواصفات طائرة| ]] [[تصنيف:قوالب طائرات]]
}} }}
</includeonly>