Admin: 1 revision imported

2022-12-14T04:22:06Z

1 revision imported

← Older revision	Revision as of 09:52, 14 December 2022
(No difference)

wikipedia>Shkuru Afshar at 07:06, 5 January 2022

2022-01-05T07:06:50Z

New page

{{Documentation subpage}}


<includeonly>{{intricate template}}</includeonly>

This is the {{tl|infobox nutritional value}} template.

=== Basic usage ===
<pre style="overflow: auto">
{{Infobox nutritional value
| name =
| kJ =
| carbs =
| fat =
| protein =
| note =
}}
</pre>

=== Parameters ===

* '''Required fields''': ''name'', ''kJ'', ''carbs'', ''fat'', ''protein''. You must state the units of measurement that are being used, except for kJ, which is in [[kilojoule]]s (1 Calorie = 1 kcal = 4.2 kJ). The units are usually expressed in [[gram]]s (g), for example: {{para|fat|<var>3 g</var>}}.
** '''Note''': To specify energy in [[calorie|kcal]] rather than kJ, use ''kcal'' instead.
* '''Optional fields''': ''image'', ''caption'', ''serving_size'', ''sugars'', ''lactose'', ''satfat'', ''transfat'', ''monofat'', ''polyfat'', ''omega3fat'', ''omega6fat'', ''fibre'', ''starch'', ''water'', ''cholesterol'', ''alcohol'' and ''caffeine''. Again, you must state the units that are being used.
* '''Contributor defined fields''': Additional fields can be added using the ''opt1n'' and ''opt1v'' fields, where ''n'' is for name and ''v'' is for value. Up to four optional fields are supported, ''opt1n'' & ''opt1v'' up to ''opt4n'' & ''opt4v''.

;The following optional variables are converted into percentages of RDA (taken as averages for males and females aged 25–50 years from the USDA 2000 recommendation):
* '''Minerals''' (in mg) - ''calcium_mg'', ''copper_mg'', ''iron_mg'', ''phosphorus_mg'', ''magnesium_mg'', ''manganese_mg'', ''selenium_ug'', ''sodium_mg'', ''potassium_mg'', ''zinc_mg''. Write the number without the unit.
* '''Vitamins''' (in mg, μg, or international units) - ''vitA_ug'', ''vitA_iu'' (in IU), ''vitA_asbeta_iu'' (in IU), ''betacarotene_ug'' (subcategory of vitamin A!), ''thiamin_mg'' (vit. B1), ''riboflavin_mg'' (vit. B2), ''niacin_mg'' (vit. B3), ''pantothenic_mg'' (pantothenic acid), ''vitB6_mg'', ''folate_ug'', ''vitB12_ug'', ''choline_mg'', ''vitC_mg'', ''vitD_ug'', ''vitD_iu'' (in IU), ''vitE_mg'', ''vitE_iu'', ''vitK_ug''. Write the number without the unit.

; Other optional variables and flags:
* '''note''' - a convenient way to indicate serving sizes or edible parts, e.g., ''1 banana is 100 to 150'' g or other information.
* '''source''' - sets the data source of the information used in the template.
** '''source_usda''' - a ''1'' in this field will automatically set the source as the USDA database.
* '''noRDA''' - optional suppression of RDA message: noRDA=1
* '''float''' - {{para|float|left}} will cause the table to appear on the left side of the article, {{para|float|center}} for centered, and {{para|float|none}} to place it on the left, but without wrapping text around it. The default is {{para|float|right}}.

; Additional notes:
* According to SI rules, there should be a non-breaking space between the number and the unit: "14&nbsp;g" (which displays as "14 g") and not "14g".
* Don't specify numbers in too many decimals.
* Splitting up components that are present in trace amounts is not very meaningful (e.g. 1.5 g fats of which 0.5 g unsaturated).
* Only vitamins and minerals for which this product is considered to be a good source should be included, in order to prevent clogging up the article with a huge table.
Nutritional values can be found in the [https://fdc.nal.usda.gov/index.html USDA's FoodData Central] (formerly National Nutrient Database). Note that fibres are counted as carbohydrates. Note also that the calculated energy value given in the USDA database sometimes includes 4 kcal per gram of fibre, which is not really correct, and it would be better for Wikipedia articles to exclude the fibre from the energy value. (The USDA [http://www.ars.usda.gov/sp2UserFiles/Place/12354500/Data/SR26/sr26_doc.pdf documentation] says, "For
multi-ingredient processed foods, kilocalorie values (source codes 8 or 9; ...) generally reflect industry practices (as
permitted by NLEA) of calculating kilocalories as 4, 4, or 9 kilocalories per gram of
protein, carbohydrate, and fat, respectively, or as 4, 4, or 9 kilocalories per gram of
protein, carbohydrate minus insoluble fiber, and fat. The latter method is often used for
high-fiber foods.")

=== Full syntax ===
<pre style="width: 40%; overflow: auto">
{{Infobox nutritional value
| name =
| image = 
| image_size = 
| image_alt =
| caption =
| serving_size =
| kJ =
| carbs =
| starch =
| sugars =
| lactose =
| fibre = 
| fat =
| satfat =
| transfat =
| monofat =
| polyfat =
| omega3fat =
| omega6fat =
| protein =
| tryptophan =
| threonine =
| isoleucine =
| leucine =
| lysine =
| methionine =
| cystine =
| phenylalanine =
| tyrosine =
| valine =
| arginine =
| histidine =
| alanine =
| aspartic acid =
| glutamic acid =
| glycine =
| proline =
| serine =
| hydroxyproline =
| water =
| cholesterol =
| alcohol =
| caffeine =
| vitA_ug =
| vitA_iu =
| betacarotene_ug =
| lutein_ug =
| thiamin_mg =
| riboflavin_mg =
| niacin_mg =
| pantothenic_mg =
| vitB6_mg =
| folate_ug =
| vitB12_ug =
| choline_mg =
| vitC_mg =
| vitD_ug =
| vitD_iu =
| vitE_mg =
| vitK_ug =
| calcium_mg =
| copper_mg =
| iron_mg =
| magnesium_mg =
| manganese_mg =
| phosphorus_mg =
| potassium_mg =
| selenium_ug =
| sodium_mg =
| zinc_mg =
| opt1n =
| opt1v =
| opt2n =
| opt2v =
| opt3n =
| opt3v =
| opt4n =
| opt4v =
| note =
| source =
| source_usda =
| noRDA =
| float =
}}
</pre>

=== Examples ===

{{Infobox nutritional value
| name = Foonuts
| kJ = 2450
| carbs = 22 g
| starch = 8 g
| sugars = 5 g
| lactose = 1 g
| fibre = 9 g
| fat = 50 g
| satfat = 7 g
| transfat = 3 g
| monofat = 25 g
| polyfat = 16 g
| omega3fat = 1 g
| omega6fat = 2 g
| protein = 24 g
| tryptophan = 70 mg
| threonine = 490 mg
| isoleucine = 570 mg
| leucine = 920 mg
| lysine = 690 mg
| methionine = 200 mg
| cystine = 230 mg
| phenylalanine = 610 mg
| tyrosine = 380 mg
| valine = 750 mg
| arginine = 890 mg
| histidine = 250 mg
| alanine = 640 mg
| aspartic acid = 2.850 g
| glutamic acid = 2.260 g
| glycine = 780 mg
| proline = 2.310 g
| serine = 610 mg
| hydroxyproline = 0 mg
| water = 5 g
| cholesterol = 2 mg
| alcohol = 1 g
| caffeine = 20 mg
| vitA_ug = 12
| betacarotene_ug = 120
| thiamin_mg = 1
| riboflavin_mg = 2
| niacin_mg = 0.5
| pantothenic_mg = 0.1
| vitB6_mg = 1
| folate_ug = 1.5
| vitB12_ug = 0.5
| vitC_mg = 20
| vitD_ug = 10
| vitE_mg = 5
| vitK_ug = 10
| calcium_mg = 200
| copper_mg = 0.9
| iron_mg = 5
| magnesium_mg = 1.2
| manganese_mg = 1.2
| phosphorus_mg = 50
| potassium_mg = 80
| sodium_mg = 40
| selenium_ug = 23
| zinc_mg = 0.4
| note = Footnote text here
| source_usda = 1
| float =
}}

<pre style="width:40%; overflow: auto">
{{Infobox nutritional value
| name = Foonuts
| kJ = 2450
| carbs = 22 g
| starch = 8 g
| sugars = 5 g
| lactose = 1 g
| fibre = 9 g
| fat = 50 g
| satfat = 7 g
| transfat = 3 g
| monofat = 25 g
| polyfat = 16 g
| omega3fat = 1 g
| omega6fat = 2 g
| protein = 24 g
| tryptophan = 70 mg
| threonine = 490 mg
| isoleucine = 570 mg
| leucine = 920 mg
| lysine = 690 mg
| methionine = 200 mg
| cystine = 230 mg
| phenylalanine = 610 mg
| tyrosine = 380 mg
| valine = 750 mg
| arginine = 890 mg
| histidine = 250 mg
| alanine = 640 mg
| aspartic acid = 2.850 g
| glutamic acid = 2.260 g
| glycine = 780 mg
| proline = 2.310 g
| serine = 610 mg
| hydroxyproline = 0 mg
| water = 5 g
| cholesterol = 2 mg
| alcohol = 1 g
| caffeine = 20 mg
| vitA_ug = 12
| betacarotene_ug = 120
| thiamin_mg = 1
| riboflavin_mg = 2
| niacin_mg = 0.5
| pantothenic_mg = 0.1
| vitB6_mg = 1
| folate_ug = 1.5
| vitB12_ug = 0.5
| vitC_mg = 20
| vitD_ug = 10
| vitE_mg = 5
| vitK_ug = 10
| calcium_mg = 200
| copper_mg = 0.9
| iron_mg = 5
| magnesium_mg = 1.2
| manganese_mg = 1.2
| phosphorus_mg = 50
| potassium_mg = 80
| sodium_mg = 40
| selenium_ug = 23
| zinc_mg = 0.4
| note = Footnote text here
| source_usda = 1
| float =
}}
</pre>

will generate →
{{Clear}}

=== Translations ===
If you translate this template for use in other language Wikipedias, you could consider keeping the English variable names, so that you can simply copy/paste existing tables from English to your language (and back). Or you could make two versions, one using native-language variable names, and the other using the English names.

==TemplateData==
{{TemplateData header}}
<templatedata>
{
"description": "A template for recording the nutritional value of foods",
"params": {
"name": {
"description": "The name of the food",
"required": true
},
"kJ": {
"suggested": true
},
"carbs": {
"description": "Total carbohydrates per 100 grams of food. State the unit being used (usually g for grams).",
"required": true
},
"fat": {
"description": "Total fat per 100 grams of food. State the unit being used (usually g for grams).",
"required": true
},
"protein": {
"description": "Total protein per 100 grams of food. State the unit being used (usually g for grams).",
"required": true
},
"note": {
"description": "Any explanatory notes, e.g., which parts of the vegetable are edible"
}
},
"format": "block"
}
</templatedata>

<includeonly>{{Sandbox other||

[[Category:Food infobox templates|Nutritional value]]
}}</includeonly>

Template:Infobox nutritional value/doc - Revision history

Admin: 1 revision imported

wikipedia>Shkuru Afshar at 07:06, 5 January 2022