Skip to content

Commit 2efad5b

Browse files
committed
feat: Refactor documentation localization, dynamically display translations based on browser language
1 parent 1cab1e1 commit 2efad5b

18 files changed

Lines changed: 777 additions & 261 deletions

.github/workflows/build.yml

Lines changed: 42 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -709,11 +709,23 @@ jobs:
709709
}
710710
shell: pwsh
711711

712+
- name: 生成 exe 校验和文件
713+
run: |
714+
cd make
715+
$hash = (Get-FileHash "awstats-8.1.exe" -Algorithm SHA256).Hash.ToLower()
716+
"$hash awstats-8.1.exe" | Out-File -FilePath SHA256SUMS.txt -Encoding ascii
717+
Write-Host "✅ 已生成 SHA256SUMS.txt"
718+
shell: pwsh
719+
712720
- name: 上传安装包
713721
uses: actions/upload-artifact@v7
714722
with:
715-
name: awstats-windows-installer
716-
path: make/awstats-8.1.exe
723+
name: windows-packages
724+
path: |
725+
make/*.exe
726+
make/SHA256SUMS.txt
727+
if-no-files-found: warn
728+
retention-days: 1
717729

718730
release:
719731
name: 发布所有包
@@ -725,6 +737,34 @@ jobs:
725737
uses: actions/download-artifact@v8
726738
with:
727739
path: releases
740+
- name: 合并校验和
741+
run: |
742+
echo "=== 合并校验和文件 ==="
743+
# 复制 Linux 的校验和(4个包)
744+
if [ -f "releases/unix-packages/SHA256SUMS.txt" ]; then
745+
cp releases/unix-packages/SHA256SUMS.txt SHA256SUMS.txt
746+
echo "✅ 已添加 Linux 包校验和"
747+
else
748+
echo "⚠️ Linux 校验和文件不存在"
749+
> SHA256SUMS.txt
750+
fi
751+
752+
# 追加 Windows 的校验和(exe)
753+
if [ -f "releases/windows-packages/SHA256SUMS.txt" ]; then
754+
cat releases/windows-packages/SHA256SUMS.txt >> SHA256SUMS.txt
755+
echo "✅ 已添加 Windows 包校验和"
756+
else
757+
echo "⚠️ Windows 校验和文件不存在"
758+
fi
759+
760+
# 排序去重
761+
sort -u SHA256SUMS.txt -o SHA256SUMS.txt
762+
763+
echo ""
764+
echo "=== 最终校验和 ==="
765+
cat SHA256SUMS.txt
766+
echo ""
767+
echo "✅ 校验和行数: $(wc -l < SHA256SUMS.txt)"
728768
729769
- name: 检查下载的文件
730770
run: |
@@ -742,7 +782,6 @@ jobs:
742782
find releases -type f -name "*.rpm" -exec cp -v {} final/ \;
743783
find releases -type f -name "*.deb" -exec cp -v {} final/ \;
744784
find releases -type f -name "*.exe" -exec cp -v {} final/ \;
745-
find releases -type f -name "*.txt" -exec cp -v {} final/ \;
746785
747786
echo ""
748787
echo "✅ 最终文件列表:"

.github/workflows/update-year.yml

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
name: Update Copyright Year
2+
3+
on:
4+
schedule:
5+
- cron: '0 0 1 1 *'
6+
workflow_dispatch:
7+
8+
jobs:
9+
update:
10+
runs-on: ubuntu-latest
11+
steps:
12+
- uses: actions/checkout@v6
13+
14+
- name: Update copyright year in README
15+
id: update
16+
run: |
17+
YEAR=$(date +%Y)
18+
echo "YEAR=$YEAR" >> $GITHUB_OUTPUT
19+
sed -i "s/2026-{{YEAR}}/2026-$YEAR/" README*.md
20+
21+
- name: Commit changes
22+
uses: stefanzweifel/git-auto-commit-action@v7
23+
with:
24+
commit_message: "chore: update copyright year to ${{ steps.update.outputs.YEAR }}"
25+
branch: release

README-zh_CN.md

Lines changed: 21 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -180,16 +180,26 @@ perl /usr/share/awstats/tools/awstats_convert-zh.pl --help
180180

181181
#### HestiaCP 用户(推荐)
182182

183-
HestiaCP 已自带 AWStats,只需更新安装 deb 包
183+
> **注意**:本脚本仅适配 HestiaCP 面板。如果您使用其他控制面板或没有面板管理,请参考脚本中的 `build_awstats()` 函数,根据实际环境自行调整
184184
185-
支持官方 [Debian](https://github.com/hestiacp/hestiacp) 和爱好者 [RHEL](https://github.com/bayrepo/hestiacp-rpm)
185+
HestiaCP 已自带 AWStats,更新安装打包好的 `deb``rpm` 程序即可体验全新社区版本。
186186

187-
**您需要调整的文件**
188-
- 模板文件:`/usr/local/hestia/data/templates/web/awstats/awstats.tpl`
189-
- 域名配置:`/etc/awstats/` 目录下
190-
- 更新脚本:`/usr/local/hestia/bin/v-update-web-domain-stat`
191-
- 参考脚本模板:[v-update-web-domain-stat](/make//make/test/awstats/conf/v-update-web-domain-stat)
192-
- 参考配置模板:[awstats.tpl](/make//make/test/awstats/conf/awstats.tpl)
187+
**支持发行版**
188+
- 官方支持:[Debian/Ubuntu](https://github.com/hestiacp/hestiacp)
189+
- 社区支持:[RHEL/CentOS/Alma/Rocky](https://github.com/bayrepo/hestiacp-rpm)
190+
191+
**需要手动调整的文件**
192+
193+
| 文件类型 | 路径 | 参考示例 |
194+
|:---:|:---:|:---:|
195+
| 模板文件 | `/usr/local/hestia/data/templates/web/awstats/awstats.tpl` | [awstats.tpl](/test/awstats/conf/awstats.tpl) |
196+
| 域名配置目录 | `/etc/awstats/` | - |
197+
| 更新脚本 (Debian/Ubuntu 及其衍生版) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.debian](/test/awstats/conf/v-update-web-domain-stat.debian) |
198+
| 更新脚本 (RHEL/CentOS/Rocky/Alma/Fedora) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.rhel](/test/awstats/conf/v-update-web-domain-stat.rhel) |
199+
200+
> 📌 **说明**:Debian 和 RHEL 系列的脚本相关程序代码不同,请根据您的操作系统选择对应的参考示例进行修改。
201+
202+
> 💡 **提示**:修改脚本后,如遇到权限问题,请执行 `chmod +x /usr/local/hestia/bin/v-update-web-domain-stat`
193203
194204
#### 下载并安装
195205

@@ -357,5 +367,7 @@ awstats -h
357367
- DB-IP 数据库:[https://db-ip.com](https://db-ip.com)
358368

359369
---
360-
370+
<!--
371+
## © 1997-2025 Laurent Destailleur | 2026-{{YEAR}} 社区版持续维护中
372+
-->
361373
## © 1997-2026 AWStats 团队 | 社区版持续维护中

README-zh_TW.md

Lines changed: 19 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -178,18 +178,28 @@ perl /usr/share/awstats/tools/awstats_convert-zh.pl --help
178178

179179
### 1. 安裝
180180

181-
#### HestiaCP 使用者(建議
181+
#### HestiaCP 使用者(推薦
182182

183-
HestiaCP 已自帶 AWStats,只需更新安裝 deb 套件
183+
> **注意**:本腳本僅適用於 HestiaCP 控制面板。如果您使用其他控制面板或未使用面板管理,請參考腳本中的 `build_awstats()` 函式,依據實際環境自行調整
184184
185-
支援官方 [Debian](https://github.com/hestiacp/hestiacp) 和愛好者 [RHEL](https://github.com/bayrepo/hestiacp-rpm)
185+
HestiaCP 已內建 AWStats,更新安裝打包好的 `deb``rpm` 套件即可體驗全新社群版本。
186186

187-
**您需要調整的檔案**
188-
- 模板檔案:`/usr/local/hestia/data/templates/web/awstats/awstats.tpl`
189-
- 網域設定:`/etc/awstats/` 目錄下
190-
- 更新腳本:`/usr/local/hestia/bin/v-update-web-domain-stat`
191-
- 參考腳本模板:[v-update-web-domain-stat](/make/test/awstats/conf/v-update-web-domain-stat)
192-
- 參考設定模板:[awstats.tpl](/make/test/awstats/conf/awstats.tpl)
187+
**支援發行版**
188+
- 官方支援:[Debian/Ubuntu](https://github.com/hestiacp/hestiacp)
189+
- 社群支援:[RHEL/CentOS/Alma/Rocky](https://github.com/bayrepo/hestiacp-rpm)
190+
191+
**需要手動調整的檔案**
192+
193+
| 檔案類型 | 路徑 | 參考範例 |
194+
|:---:|:---:|:---:|
195+
| 模板檔案 | `/usr/local/hestia/data/templates/web/awstats/awstats.tpl` | [awstats.tpl](/test/awstats/conf/awstats.tpl) |
196+
| 網域名稱設定目錄 | `/etc/awstats/` | - |
197+
| 更新腳本 (Debian/Ubuntu 及其衍生版) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.debian](/test/awstats/conf/v-update-web-domain-stat.debian) |
198+
| 更新腳本 (RHEL/CentOS/Rocky/Alma/Fedora) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.rhel](/test/awstats/conf/v-update-web-domain-stat.rhel) |
199+
200+
> 📌 **說明**:Debian 和 RHEL 系列的腳本相關程式碼不同,請根據您的作業系統選擇對應的參考範例進行修改。
201+
202+
> 💡 **提示**:修改腳本後,如遇到權限問題,請執行 `chmod +x /usr/local/hestia/bin/v-update-web-domain-stat`
193203
194204
#### 下載並安裝
195205

README.ar.md

Lines changed: 20 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -175,22 +175,32 @@ perl /usr/share/awstats/tools/awstats_convert-en.pl --help
175175

176176
---
177177

178-
## 🚀 البدء السريع
178+
## 🚀 بداية سريعة
179179

180180
### 1. التثبيت
181181

182-
#### مستخدمو HestiaCP (موصى به)
182+
#### لمستخدمي HestiaCP (موصى به)
183183

184-
HestiaCP يأتي بالفعل مع AWStats، ما عليك سوى تحديث حزمة deb وتثبيتها.
184+
> **ملاحظة**: هذا السكربت مخصص فقط للوحة تحكم HestiaCP. إذا كنت تستخدم لوحة تحكم أخرى أو لا تستخدم لوحة تحكم، يرجى الرجوع إلى دالة `build_awstats()` في السكربت والتعديل وفقًا لبيئتك الفعلية.
185185
186-
يدعم [Debian](https://github.com/hestiacp/hestiacp) الرسمي وإصدار [RHEL](https://github.com/bayrepo/hestiacp-rpm) للهواة
186+
HestiaCP يأتي مدمجًا مع AWStats، ما عليك سوى تحديث وتثبيت حزم `deb` و `rpm` المعدة مسبقًا لتجربة الإصدار المجتمعي الجديد.
187187

188-
**الملفات التي تحتاج إلى تعديل**:
189-
- ملف القالب: `/usr/local/hestia/data/templates/web/awstats/awstats.tpl`
190-
- تكوين النطاق: دليل `/etc/awstats/`
191-
- برنامج التحديث النصي: `/usr/local/hestia/bin/v-update-web-domain-stat`
192-
- قالب البرنامج النصي المرجعي: [v-update-web-domain-stat](/make/test/awstats/conf/v-update-web-domain-stat)
193-
- قالب التكوين المرجعي: [awstats.tpl](/make/test/awstats/conf/awstats.tpl)
188+
**التوزيعات المدعومة**:
189+
- دعم رسمي: [Debian/Ubuntu](https://github.com/hestiacp/hestiacp)
190+
- دعم مجتمعي: [RHEL/CentOS/Alma/Rocky](https://github.com/bayrepo/hestiacp-rpm)
191+
192+
**الملفات التي تحتاج إلى تعديل يدوي**:
193+
194+
| نوع الملف | المسار | مثال مرجعي |
195+
|:---:|:---:|:---:|
196+
| ملف القالب | `/usr/local/hestia/data/templates/web/awstats/awstats.tpl` | [awstats.tpl](/test/awstats/conf/awstats.tpl) |
197+
| دليل إعدادات النطاق | `/etc/awstats/` | - |
198+
| سكربت التحديث (Debian/Ubuntu ومشتقاتهما) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.debian](/test/awstats/conf/v-update-web-domain-stat.debian) |
199+
| سكربت التحديث (RHEL/CentOS/Rocky/Alma/Fedora) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.rhel](/test/awstats/conf/v-update-web-domain-stat.rhel) |
200+
201+
> 📌 **توضيح**: أكواد سكربتات Debian و RHEL مختلفة، يرجى اختيار المثال المرجعي المناسب وفقًا لنظام التشغيل الخاص بك.
202+
203+
> 💡 **تلميح**: بعد تعديل السكربت، إذا واجهت مشكلة في الصلاحيات، قم بتنفيذ الأمر `chmod +x /usr/local/hestia/bin/v-update-web-domain-stat`
194204
195205
#### التحميل والتثبيت
196206

README.fr.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -181,16 +181,26 @@ perl /usr/share/awstats/tools/awstats_convert-en.pl --help
181181

182182
#### Utilisateurs de HestiaCP (recommandé)
183183

184-
HestiaCP inclut déjà AWStats, il suffit de mettre à jour et d'installer le paquet deb.
184+
> **Remarque** : Ce script est uniquement adapté au panneau de contrôle HestiaCP. Si vous utilisez un autre panneau de contrôle ou aucun panneau, veuillez vous référer à la fonction `build_awstats()` dans le script et ajuster en fonction de votre environnement réel.
185185
186-
Support des [Debian](https://github.com/hestiacp/hestiacp) officiels et [RHEL](https://github.com/bayrepo/hestiacp-rpm) pour les passionnés.
186+
HestiaCP intègre déjà AWStats, il suffit de mettre à jour et d'installer les paquets `deb` et `rpm` pré-compilés pour découvrir la nouvelle version communautaire.
187187

188-
**Fichiers à ajuster** :
189-
- Fichier template : `/usr/local/hestia/data/templates/web/awstats/awstats.tpl`
190-
- Configuration domaine : répertoire `/etc/awstats/`
191-
- Script de mise à jour : `/usr/local/hestia/bin/v-update-web-domain-stat`
192-
- Template de script de référence : [v-update-web-domain-stat](/make/test/awstats/conf/v-update-web-domain-stat)
193-
- Template de configuration de référence : [awstats.tpl](/make/test/awstats/conf/awstats.tpl)
188+
**Distributions supportées** :
189+
- Support officiel : [Debian/Ubuntu](https://github.com/hestiacp/hestiacp)
190+
- Support communautaire : [RHEL/CentOS/Alma/Rocky](https://github.com/bayrepo/hestiacp-rpm)
191+
192+
**Fichiers à ajuster manuellement** :
193+
194+
| Type de fichier | Chemin | Exemple de référence |
195+
|:---:|:---:|:---:|
196+
| Fichier template | `/usr/local/hestia/data/templates/web/awstats/awstats.tpl` | [awstats.tpl](/test/awstats/conf/awstats.tpl) |
197+
| Répertoire de configuration des domaines | `/etc/awstats/` | - |
198+
| Script de mise à jour (Debian/Ubuntu et dérivés) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.debian](/test/awstats/conf/v-update-web-domain-stat.debian) |
199+
| Script de mise à jour (RHEL/CentOS/Rocky/Alma/Fedora) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.rhel](/test/awstats/conf/v-update-web-domain-stat.rhel) |
200+
201+
> 📌 **Explication** : Les codes des scripts pour Debian et RHEL sont différents, veuillez choisir l'exemple de référence correspondant à votre système d'exploitation.
202+
203+
> 💡 **Astuce** : Après avoir modifié le script, si vous rencontrez un problème de permission, exécutez `chmod +x /usr/local/hestia/bin/v-update-web-domain-stat`
194204
195205
#### Téléchargement et installation
196206

README.ja.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -181,16 +181,26 @@ perl /usr/share/awstats/tools/awstats_convert-en.pl --help
181181

182182
#### HestiaCP ユーザー(推奨)
183183

184-
HestiaCP には AWStats が元から含まれています。debパッケージを更新してインストールするだけです
184+
> **注意**:このスクリプトは HestiaCP パネル専用に調整されています。他のコントロールパネルを使用している場合、またはパネルを使用していない場合は、スクリプト内の `build_awstats()` 関数を参照し、実際の環境に合わせて調整してください
185185
186-
公式 [Debian](https://github.com/hestiacp/hestiacp) および愛好家向け [RHEL](https://github.com/bayrepo/hestiacp-rpm) をサポートしています
186+
HestiaCP には AWStats が既に含まれています。ビルド済みの `deb` および `rpm` パッケージを更新・インストールするだけで、新しいコミュニティバージョンを体験できます
187187

188-
**調整が必要なファイル**
189-
- テンプレートファイル:`/usr/local/hestia/data/templates/web/awstats/awstats.tpl`
190-
- ドメイン設定:`/etc/awstats/` ディレクトリ内
191-
- 更新スクリプト:`/usr/local/hestia/bin/v-update-web-domain-stat`
192-
- 参考スクリプトテンプレート:[v-update-web-domain-stat](/make/test/awstats/conf/v-update-web-domain-stat)
193-
- 参考設定テンプレート:[awstats.tpl](/make/test/awstats/conf/awstats.tpl)
188+
**対応ディストリビューション**
189+
- 公式サポート:[Debian/Ubuntu](https://github.com/hestiacp/hestiacp)
190+
- コミュニティサポート:[RHEL/CentOS/Alma/Rocky](https://github.com/bayrepo/hestiacp-rpm)
191+
192+
**手動で調整が必要なファイル**
193+
194+
| ファイルタイプ | パス | 参考例 |
195+
|:---:|:---:|:---:|
196+
| テンプレートファイル | `/usr/local/hestia/data/templates/web/awstats/awstats.tpl` | [awstats.tpl](/test/awstats/conf/awstats.tpl) |
197+
| ドメイン設定ディレクトリ | `/etc/awstats/` | - |
198+
| 更新スクリプト (Debian/Ubuntu および派生版) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.debian](/test/awstats/conf/v-update-web-domain-stat.debian) |
199+
| 更新スクリプト (RHEL/CentOS/Rocky/Alma/Fedora) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.rhel](/test/awstats/conf/v-update-web-domain-stat.rhel) |
200+
201+
> 📌 **説明**:Debian 系と RHEL 系ではスクリプトのコードが異なります。お使いのオペレーティングシステムに応じて、適切な参考例を選択してください。
202+
203+
> 💡 **ヒント**:スクリプトを変更した後、権限の問題が発生した場合は `chmod +x /usr/local/hestia/bin/v-update-web-domain-stat` を実行してください。
194204
195205
#### ダウンロードしてインストール
196206

README.ko.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -181,16 +181,26 @@ perl /usr/share/awstats/tools/awstats_convert-en.pl --help
181181

182182
#### HestiaCP 사용자 (권장)
183183

184-
HestiaCP에는 이미 AWStats가 포함되어 있습니다. deb 패키지를 업데이트하여 설치하기만 하면 됩니다.
184+
> **참고**: 이 스크립트는 HestiaCP 패널 전용으로 조정되었습니다. 다른 제어판을 사용하거나 패널 없이 관리하는 경우 스크립트의 `build_awstats()` 함수를 참조하여 실제 환경에 맞게 조정하세요.
185185
186-
공식 [Debian](https://github.com/hestiacp/hestiacp) 및 애호가용 [RHEL](https://github.com/bayrepo/hestiacp-rpm)을 지원합니다.
186+
HestiaCP에는 AWStats가 이미 포함되어 있습니다. 빌드된 `deb``rpm` 패키지를 업데이트하고 설치하기만 하면 새로운 커뮤니티 버전을 경험할 수 있습니다.
187187

188-
**조정해야 할 파일**:
189-
- 템플릿 파일: `/usr/local/hestia/data/templates/web/awstats/awstats.tpl`
190-
- 도메인 설정: `/etc/awstats/` 디렉토리
191-
- 업데이트 스크립트: `/usr/local/hestia/bin/v-update-web-domain-stat`
192-
- 참조 스크립트 템플릿: [v-update-web-domain-stat](/make/test/awstats/conf/v-update-web-domain-stat)
193-
- 참조 설정 템플릿: [awstats.tpl](/make/test/awstats/conf/awstats.tpl)
188+
**지원 배포판**:
189+
- 공식 지원: [Debian/Ubuntu](https://github.com/hestiacp/hestiacp)
190+
- 커뮤니티 지원: [RHEL/CentOS/Alma/Rocky](https://github.com/bayrepo/hestiacp-rpm)
191+
192+
**수동으로 조정해야 하는 파일**:
193+
194+
| 파일 유형 | 경로 | 참고 예제 |
195+
|:---:|:---:|:---:|
196+
| 템플릿 파일 | `/usr/local/hestia/data/templates/web/awstats/awstats.tpl` | [awstats.tpl](/test/awstats/conf/awstats.tpl) |
197+
| 도메인 설정 디렉토리 | `/etc/awstats/` | - |
198+
| 업데이트 스크립트 (Debian/Ubuntu 및 파생판) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.debian](/test/awstats/conf/v-update-web-domain-stat.debian) |
199+
| 업데이트 스크립트 (RHEL/CentOS/Rocky/Alma/Fedora) | `/usr/local/hestia/bin/v-update-web-domain-stat` | [v-update-web-domain-stat.rhel](/test/awstats/conf/v-update-web-domain-stat.rhel) |
200+
201+
> 📌 **설명**: Debian 계열과 RHEL 계열의 스크립트 코드가 다릅니다. 사용 중인 운영체제에 따라 적절한 참고 예제를 선택하세요.
202+
203+
> 💡 **힌트**: 스크립트 수정 후 권한 문제가 발생하면 `chmod +x /usr/local/hestia/bin/v-update-web-domain-stat`을 실행하세요.
194204
195205
#### 다운로드 및 설치
196206

0 commit comments

Comments
 (0)