模板:營養值/doc檢視原始碼檢視歷史
| 本文件是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） 來源：（英文）美國農業部營養資料庫; zh-hk:數據庫 | |
{{营养值
| 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個版本，其中一個使用候選語言變量名，另一個使用英語。