Template:Infobox firearm cartridge/doc

{{#ifeq:{{{noheader|}}}|yes || {{Documentation subpage}}

Usage
}}

Firearm cartridge infobox
A firearm cartridge infobox may be used to summarize information about a particular cartridge or artillery shell. The infobox should be added using the template, as shown below:

Parameters
Note: When using parameters, avoid the ambiguous abbreviation "N/A", and instead use "unknown" or "none". All subjective or qualitative judgements and numerical quantities or statistics must be cited to a reliable source (see WP:MILMOS). References for numerically converted parameters (e.g., bullet) can be appended using the corresponding  parameter (e.g., bullet_ref). Sources for the ballistic performance table, and more general sources, can be included using the balsrc parameter.

General parameters:
 * name – the formal name of the cartridge.
 * image – optional – an image of the cartridge, should be given in the form.
 * image_size – optional – width of image, should be given in the form.
 * alt – optional – alternative text describing the image for visually impaired users, see WP:ALT.
 * caption – optional – the text to be placed below the image.
 * type – the type of cartridge or its designed use (e.g. "Pistol", "Rifle", "Hunting", etc.).
 * origin – the country or place where the cartridgeoriginated or was first manufactured.

Service history parameters:
 * service – optional – the period (usually given in years) when the cartridge was in service.
 * used_by – optional – the countries, armed forces, or other groups using the cartridge; this may be omitted for cartridges employed only in their country of origin.
 * wars – optional – any wars during which the cartridge saw service.

Production history parameters:
 * designer – optional – the person or group responsible for designing the cartridge.
 * design_date – optional – the date (usually given as a year) when the cartridge was designed.
 * manufacturer – optional – the manufacturer of the cartridge.
 * production_date – optional – the period (usually given in years) when the cartridge was produced.
 * number – optional – the number of cartridge of this type that were manufactured.
 * variants – optional – any variant models of the cartridge.

Specification parameters:
 * is_SI_specs – optional – "yes" if the specifications are entered in SI units; any other value causes it to be interpreted as English units.
 * parent – optional – the cartridge that the cartridge was based on, if any.
 * case_type – optional – the type of case used for the cartridge (e.g. rimmed, rimless, straight, bottlenecked, etc.).
 * bullet – optional – the diameter of the bullet used in the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
 * land – optional – the land diameter of the rifling in the barrel, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
 * neck – optional – the neck diameter of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
 * shoulder – optional – the shoulder diameter of the cartridge, if any, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
 * base – optional – the base diameter of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
 * rim_dia – optional – the rim diamter of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
 * rim_thick – optional – the rim thickness of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
 * case_length – optional – the case length of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
 * length – optional – the overall length of the cartridge, expressed in mm or in; only include the number, and not the units of measurement, and omit any commas.
 * case_capacity – optional – the volume of the casing, expressed in cm3 or grains of water; only include the number, and not the units of measurement, and omit any commas.
 * rifling – optional – typical rifling to stabilize the bullet fired from the cartridge.
 * primer – optional – the type of primer used in the cartridge (e.g. large pistol, small rifle, rimfire, etc.).
 * max_pressure – optional – the maximum chamber pressure of the round, expressed in MPa or psi; only include the number, and not the units of measurement, and omit any commas.
 * pressure_method – optional – the methodology used to measure pressure, such as SAAMI, CIP, EPVAT, SCATP.
 * max_pressure2 – optional as above, second pressure with method
 * pressure_method2 – optional as above, second pressure's method
 * max_pressure3 – optional as above, third pressure with method
 * pressure_method2 – optional as above, third pressure's method
 * max_cup – optional – the maximum chamber pressure of the round, expressed in CUP; only include the number, and not the units of measurement, and omit any commas. Note that this parameter is not affected by the is_SI_specs parameter.
 * filling – optional – the explosive filling material of the shell, if any.
 * filling_weight – optional – the weight of the explosive material of the shell, if any.
 * detonation – optional – for explosive shells, the detonation trigger type (e.g. "timer", "pressure", "motion sensor").
 * yield – optional – for explosive shells, the yield (in tons of TNT) of the device.

Ballistic performance parameters:

Ballistic data for up to five different weight bullets can be specified; it may be provided in either SI or English units, but this choice must be consistent for all five sets. The x in the field name should be replaced with 1–5 as displayed in the template format shown above (e.g. bw1, bw2, btype1, btype2, vel1, vel2, en1, en2, etc.): {{#ifeq:{{{noheader|}}}|yes ||
 * is_SI_ballistics – optional – "yes" if the energy and velocity ballistics data is entered in SI units; any other value causes it to be interpreted as English units.
 * bwunit – optional – "gram" if the weights are given in grams; any other value causes them to be interpreted as grains.
 * bwround – optional – specify the number of digits after the decimal point in the converted weight (the default is 0 if not specified; if specified but empty, defaults to the same default as convert).
 * bwx – optional – the weight of the bullet for given data, expressed in grams or grains; only include the number, and not the units of measurement.
 * btypex – optional – the type of bullet (e.g. JHP, FMJ, BHP, etc.).
 * velx – required if bw field is specified – velocity of the bullet at the muzzle, expressed in m/s or ft/s; only include the number, and not the units of measurement, and omit any commas.
 * enx – required if bw field is specified – energy of the bullet at the muzzle, expressed in J or ft·lbf; only include the number, and not the units of measurement, and omit any commas.
 * test_barrel_length – optional – the length of the barrel used when generating the ballistics data.
 * balsrc – optional – the source from which the ballistics data was obtained.

Microformat
}}