饮料百科

一、项目简介

• 🍹 beverage.wiki 是一个开放的饮料百科项目，旨在记录全球饮料的历史、配方、包装与文化。
  • 从汽水到果汁，从功能饮料到地方特色，我们希望构建一个由社区共同维护的知识库，保存那些正在消失的饮料记忆。每一瓶饮料，都是一个时代的缩影。
• 📖 所有内容都以 Markdown 编写，托管在 GitHub 上，任何人都可以提交饮料条目。
  • 你可以分享你最爱的饮料、童年回忆中的汽水、或是某款已经绝版的奇妙饮品。我们欢迎所有人的贡献，无论是专业研究还是个人体验。
• 🧃 为什么要做这件事？因为饮料不仅是商品，它是文化、是记忆、是情感的载体。
  • 我们希望 beverage.wiki 成为一个数字饮料博物馆，让人们可以自由浏览、评论、分享，连接彼此的味觉记忆与生活故事。
• 🛠 项目完全开源，欢迎你 Fork、Star、提交 PR，也欢迎你提出建议或参与讨论。
  • 我们相信协作的力量，也相信饮料文化值得被认真记录。你的一次提交，可能就是未来某人寻找童年味道的线索。

二、贡献方式

🧃 如何贡献饮料条目（Pull Request 指南）

欢迎你为 beverage.wiki 添加或扩充饮料资料！我们鼓励所有人参与，共同记录饮料文化。

✅ 步骤一：先查查有没有

在提交新饮料之前，请先访问网站或浏览仓库中的 /drinks 文件夹，确认该饮料是否已经存在。你可以通过搜索饮料名称或浏览目录来查找。

📄 步骤二：准备你的条目

• 每个饮料资料请放在 /drinks 文件夹下，文件名建议使用英文名称（如 coca-cola.md）
• 内容格式参考 example.md 示例
• 示例中的字段如名称、产地、年份、描述等都可以缺省，欢迎自由发挥
• 你也可以修改或扩充已有饮料条目（如补充历史、添加图片链接等）

🔧 步骤三：提交 Pull Request

1. Fork 本仓库到你的 GitHub 账户
2. 在你的 Fork 仓库中创建新分支（如 add-pepsi-blue）
3. 添加或修改 /drinks 文件夹中的 Markdown 文件
4. 提交并推送更改到你的分支
5. 打开 Pull Request，填写标题与说明，等待审核与合并

我们欢迎所有形式的贡献，无论是新增饮料、修正错别字、补充资料，还是优化格式。你的每一次提交，都是饮料文化的一份延续。

🖼 如何添加饮料图片

饮料条目支持插入图片，帮助读者更直观地了解包装、颜色或品牌风格。你可以选择以下两种方式：

✅ 方式一：引用网络图片

你可以直接使用网络上的图片链接，例如：

https://example.com/images/coca-cola-can.jpg

请确保图片来源合法、稳定，并注明出处（如有必要）。

✅ 方式二：上传本地图片到仓库

你也可以将图片文件放入仓库的 /public/images 文件夹中，并在条目中使用相对路径引用：

/images/CocaCola_Can_330ml_pour.jpg

⚠️ 请确保文件名不与已有图片冲突，建议使用品牌名 + 规格 + 动作等组合命名方式，例如： Pepsi_Blue_Bottle_500ml_front.jpg Sprite_Can_330ml_open.jpg

三、其他语言

• 🇨🇳 中文说明
• 🇺🇸 English README

四、鸣谢