Quelltext der Seite Vorlage:Infobox nutritional value/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->

<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. B<sub>1</sub>), ''riboflavin_mg'' (vit. B<sub>2</sub>), ''niacin_mg'' (vit. B<sub>3</sub>), ''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&amp;nbsp;g" (which displays as "14&nbsp;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           = <!-- Filename is enough -->
| image_size      = <!-- Defaults to 235px -->
| image_alt       = 
| caption         = 
| serving_size    = 
| kJ              = 
| carbs           = 
| starch          = 
| sugars          = 
| lactose         = 
| fibre           = <!-- or |fiber= -->
| 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||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Food infobox templates|Nutritional value]]
}}</includeonly>