From 39e2ccbd8d219b08e46a32351c111fb1878aee1f Mon Sep 17 00:00:00 2001
From: ccbikai <ccbikai@gmail.com>
Date: Thu, 8 Aug 2024 12:23:41 +0800
Subject: [PATCH] feat: clarify Telegram channel setup in docs

Improved documentation clarity on configuring Telegram channel usernames, added troubleshooting section for common deployment issues, and emphasized the necessity of public channels and correct username format to ensure successful deployment.
---
 README.md       | 11 ++++++++++-
 README.zh-cn.md | 11 ++++++++++-
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 6587ec6..e371160 100644
--- a/README.md
+++ b/README.md
@@ -61,7 +61,7 @@ For detailed tutorials, see [Deploy your Astro site](https://docs.astro.build/en
 ## ⚒️ Configuration
 
 ```env
-## Telegram channel name, required
+## Telegram Channel Username, must be configured. The string of characters following t.me/
 CHANNEL=miantiao_me
 
 ## Language and timezone settings, language options see [dayjs](https://github.com/iamkun/dayjs/tree/dev/src/locale)
@@ -97,6 +97,15 @@ HOST=telegram.dog
 STATIC_PROXY=
 ```
 
+## Frequently Asked Questions
+
+1. Why is the content empty after deployment?
+   - Check if the channel is public, it must be public
+   - The channel username is a string, not a number
+   - Turn off the "Restricting Saving Content" setting in the channel
+   - Redeploy after modifying environment variables
+   - Telegram blocks public display of some sensitive channels, you can verify by visiting `https://t.me/s/channelusername`.
+
 ## ☕ Sponsor
 
 1. [Follow me on Telegram](https://t.me/miantiao_me)
diff --git a/README.zh-cn.md b/README.zh-cn.md
index 510916e..ea06fab 100644
--- a/README.zh-cn.md
+++ b/README.zh-cn.md
@@ -61,7 +61,7 @@
 ## ⚒️ 配置
 
 ```env
-## Telegram 频道名称，必须配置
+## Telegram 频道用户名，必须配置。 t.me/ 后面那串字符
 CHANNEL=miantiao_me
 
 ## 语言和时区设置，语言选项见[dayjs](https://github.com/iamkun/dayjs/tree/dev/src/locale)
@@ -95,6 +95,15 @@ HOST=telegram.dog
 STATIC_PROXY=
 ```
 
+## 常问问题
+
+1. 为什么部署后内容为空？
+   - 检查频道是否是公开的，必须是公开的
+   - 频道用户名是字符串，不是数字
+   - 关闭频道 Restricting Saving Content 设置项
+   - 修改完环境变量后需要重新部署
+   - Telegram 会屏蔽一些敏感频道的公开展示， 可以通过访问 `https://t.me/s/频道用户名` 确认
+
 ## ☕ 赞助
 
 1. [在 Telegram 关注我](https://t.me/miantiao_me)