| 本文档是Template:营养值的文档子页面（见模板页自身）。 本页包含用法信息、分类和其他非原模板页面的内容。 |
用法
| 本文档是Template:营养值的文档子页面（见模板页自身）。 本页包含用法信息、分类和其他非原模板页面的内容。 |
这里是{{营养值}}消息栏模板的使用文档，用于显示营养标签资料。
用法
{{营养值
| name =
| kJ =
| carbs =
| fat =
| protein =
| note =
}}
- 必填区域 - |name=, |kJ=, |carbs=, |fat=, |protein=。这里必须指明使用的单位，除了kJ指代千焦耳。例如|fat= 3 g, 这里的单位通常标识为克(g)。
- 注意 - 1 kJ = 0.239 卡路里(千卡).
- 可选区域 - |sugars=, |lactose=, |satfat=, |transfat=, |monofat=, |polyfat=, |omega3fat=, |omega6fat=, |fiber=, |starch=, |water=, |alcohol= 和 |caffeine=。 必须清楚指定你所使用的单位。
- Contributor defined fields - 附加自定义域可最佳到模板尾部的|opt1n=和|opt1v=区域，这里 n用于名称，v用于值。最多支持4个自定域, |opt1n= & |opt1v= 到 |opt4n= & |opt4v=。
- 下面列出的可选变量可以跟随RDA信息 (USDA 2000推荐20-50岁的成年男女平均摄入量)
- 矿物质 (单位mg) - |calcium_mg=, |iron_mg=, |phosphorus_mg=, |magnesium_mg=, |manganese_mg=, |sodium_mg=, |potassium_mg=, |zinc_mg=
- 维生素 (单位为mg, μg或国际单位IU) - |vitA_ug=, |betacarotene_ug= (维生素A子类), |thiamin_mg= (维生素B1), |riboflavin_mg= (维生素B2), |niacin_mg= (维生素B3), |pantothenic_mg= (泛酸), |vitB6_mg=, |folate_ug=, |vitB12_ug=, |vitC_mg=, |vitD_ug=, |vitD_iu= (单位是IU), |vitE_mg=, |vitK_ug=。
- 其它可选变量和标记
- 脚注 - |note= 方便指出实物或者可食用部分的重量，例如 1 根香蕉重100-150 g 或者其它信息。
- 数据来源 - |source= 设定模板中的信息来源。
- USDA - |source_usda= 设定为 "yes"，模板自动设定为USDA的数据库。
- 隐藏RDA解释 - |noRDA = 如设定为"yes" ，那么将不显示USDA每日摄入推荐值。
- 位置 - |right = - 设定为 "yes"，本模板产生的表格自动显示在页面右面。
- 附加注释
- 根据约定，在数字和单位之间应当有一个空格，也就是说： "14 g"，而不是"14g".
- 不要提供过多的小数位。食物数据经常发生变化；USDA数据表格提供标准误差来确保数字的精确。假设1.2345 g 的标准误差是0.08 g, 那么1.2 g就是最精确的描述。
- 将组合内容进行分割，这样对计量数值更容易让人理解(例如1.5 g 脂肪，其中0.5 g不饱和）。
- 本模板作者建议对于被看作主要营养来源的食物应用此模板只包括维生素和微量元素，以避免产生一个超长的表格，作为指引建议如下：
- 主食: 提供超过10,000 kJ 热量的量会超过RDI 100%的推荐值。
- 肉类: 同上，但是热量上限为4,000 千焦。
- 蔬菜，其它低热量固体食物，水果: 相同，但是是400 g。
- 其它产品： 使用日常基础上可以容易接受的摄入量。
营养值数据可以在下列网址查看：USDA美国国家营养数据库。注意，热量根据糖类（碳水化合物）计算得出。
举例
| 每100 g（3.5 oz）食物营养值 | |
|---|---|
|
2,451 kJ（586 kcal） | |
|
22 g | |
| 淀粉 | 8 g |
| 糖 |
5 g 1 g |
| 膳食纤维 | 9 g |
|
50 g | |
| 饱和脂肪 | 7 g |
| 反式脂肪 | 3 g |
| 单元不饱和脂肪 | 25 g |
| 多元不饱和脂肪 |
16 g 1 g 2 g |
|
24 g | |
| 维生素 | |
| 维生素A equiv. |
(2%) 12 μg(1%) 120 μg |
| 硫胺（维生素B1） |
(87%) 1 mg |
| 核黄素（维生素B2） |
(167%) 2 mg |
| 烟碱酸（维生素B3） |
(3%) 0.5 mg |
line-height:1.1em |
(2%) 0.1 mg |
| 吡哆醇（维生素B6） |
(77%) 1 mg |
| 叶酸（维生素B9） |
(0%) 1.5 μg |
| 维生素B12 |
(21%) 0.5 μg |
| 维生素C |
(24%) 20 mg |
| 维生素D |
(67%) 10 μg |
| 维生素E |
(33%) 5 mg |
| 维生素K |
(10%) 10 μg |
| 膳食矿物质 | |
| 钙 |
(20%) 200 mg |
| 铁 |
(38%) 5 mg |
| 镁 |
(3%) 10 mg |
| 锰 |
(57%) 1.2 mg |
| 磷 |
(7%) 50 mg |
| 钾 |
(2%) 80 mg |
| 钠 |
(3%) 40 mg |
| 锌 |
(4%) 0.4 mg |
| 其他成分 | |
| 水 | 5 g |
line-height:1.0em | 1 g |
| 咖啡因 | 20 mg |
|
芙蓉蛋脚注 参照美国标准的相对百分比 成人每日的膳食营养素参考摄取量（RDI） 来源：（英文）美国农业部营养数据库 | |
{{营养值
| name = 芙蓉蛋
| kJ=2451
| kcal = （與kJ參數，二選一）
| carbs = 22 g
| starch=8 g
| sugars=5 g
| lactose=1 g
| fiber = 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
| water=5 g
| 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
| vitC_mg=20
| vitD_ug=10
| vitE_mg=5
| vitK_ug=10
| vitB6_mg=1
| folate_ug=1.5
| vitB12_ug=0.5
| calcium_mg=200
| iron_mg=5
| magnesium_mg=10
| manganese_mg=1.2
| phosphorus_mg=50
| potassium_mg = 80
| sodium_mg=40
| zinc_mg=0.4
| source_usda = 1
| note = 芙蓉蛋脚注
| right = yes
}}
效果看右面==>>>>
模板编辑
本模板在英文维基截至2008年10钥被超过150个条目所引用。损坏这个模板将会影响大量的相关条目。所以请使用沙盒进行广泛测试{{营养值/沙盒}}。
在HTML版本：不要在模板中插入断行例如{{#if:...}}等解析函数，因为这将导致表格输出问题。
翻译
如果你翻译本模板到其它语言的维基中，最好保留英文变量名，这样就可以从英文维基直接拷贝/粘贴内容到你的语言版本。或者你制作2个版本，其中一个使用候选语言变量名，另一个使用英语。