arash/audio-voice-converter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update READMEs with CI/CD guide for teammates

Browse Source
This commit is contained in:
Arash_M
2026-06-09 15:39:43 +03:30
parent 02573f1643
commit b88ed1c2ce
2 changed files with 54 additions and 45 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+26 -29
View File
@@ -1,38 +1,35 @@
# Audio Voice Converter # audio-voice-converter
مبدل صوت به ویس — ابزاری برای تبدیل فایل‌های صوتی به فرمت‌های مختلف و پردازش صدا. ابزارها و extensionهای مرتبط با تبدیل صوت، caption، و transcript در Google Meet.
## هدف ## محتوا
تبدیل فایل‌های صوتی (mp3، wav، ogg و ...) به فرمت voice message قابل استفاده در پیام‌رسان‌ها. | پوشه | توضیح |
|------|-------|
| `google-meet-transcripts-extension/` | Chrome extension برای transcript و خلاصه‌سازی جلسات Google Meet (ID: `gjapjdfoanfgoeliolnigeieiibnefkp`) |
| `caption-extension/` | Chrome extension برای caption و ضبط گفتگو در Google Meet |
| `deploy/` | اسکریپت‌های CI/CD برای sync و push |
## ساختار پروژه ## شروع سریع
``` ```powershell
audio-voice-converter/ # ۱. کلون
├── README.md git clone https://git.darkreader.ir/arash/audio-voice-converter.git
├── src/ # کد اصلی cd audio-voice-converter
├── tests/ # تست‌ها
└── samples/ # نمونه فایل‌های صوتی # ۲. مسیر source را تنظیم کن
$env:AUDIO_SOURCE_ROOT = "مسیر پوشه‌ای که extensionها توشن"
# ۳. sync + push
.\deploy\scripts\sync.ps1
.\deploy\scripts\push.ps1
``` ```
## نصب و راه‌اندازی راهنمای کامل‌تر در [`deploy/README.md`](deploy/README.md).
```bash ## نصب extension در Chrome
# TODO
```
## استفاده 1. Chrome → `chrome://extensions` → Developer mode را روشن کن
2. **Load unpacked** → پوشه‌ی موردنظر را انتخاب کن:
```bash - برای transcripts: پوشه `google-meet-transcripts-extension/`
# TODO - برای caption: پوشه `caption-extension/`
```
## وابستگی‌ها
- TODO
## مشارکت
این پروژه روی Gitea در آدرس زیر هاست شده:
`http://194.180.11.201:3000/arash/audio-voice-converter`
deploy/README.md
+27 -15
View File
@@ -1,39 +1,51 @@
# Deploy — audio-voice-converter # Deploy — audio-voice-converter
اسکریپت‌های CI/CD پروژه `audio-voice-converter`. اسکریپت‌های CI/CD برای sync کردن extensionها از source و push به Gitea.
## ساختار ## ساختار
``` ```
deploy/ deploy/
├── README.md ← این فایل ├── README.md
└── scripts/ └── scripts/
├── sync.ps1 ← کپی فایل‌ها از source به repo ├── sync.ps1 ← کپی فایل‌ها از source dirs به repo
└── push.ps1 ← git commit + push به Gitea └── push.ps1 ← git commit + push به Gitea
``` ```
## پیش‌نیازها ## یک‌بار (اولین بار)
- متغیر محیطی `AUDIO_SOURCE_ROOT` تنظیم شده باشه (مسیر پوشه‌ی source)
- دسترسی git به remote (credential یا SSH key)
```powershell ```powershell
$env:AUDIO_SOURCE_ROOT = "D:\projects\google_meet_captions" git clone https://git.darkreader.ir/arash/audio-voice-converter.git
cd audio-voice-converter
``` ```
## استفاده ## هر بار که extension آپدیت شد
```powershell ```powershell
# فقط sync (کپی فایل‌ها بدون push) # مسیر پوشه‌ای که extensionهای source توشن
.\scripts\sync.ps1 $env:AUDIO_SOURCE_ROOT = "مسیر پوشه source"
# sync + commit + push # sync فایل‌ها از source
.\scripts\sync.ps1 | .\scripts\push.ps1 .\deploy\scripts\sync.ps1
# یا مستقیم push (اگر sync قبلاً انجام شده) # commit + push به Gitea
.\scripts\push.ps1 .\deploy\scripts\push.ps1
``` ```
## گزینه‌های push.ps1
```powershell
.\deploy\scripts\push.ps1 # پیام خودکار با timestamp
.\deploy\scripts\push.ps1 -Message "fix: ..." # پیام دلخواه
.\deploy\scripts\push.ps1 -DryRun # فقط نمایش، بدون push
```
## نکات
- `$env:AUDIO_SOURCE_ROOT` نباید توی هیچ فایلی ذخیره بشه — هر بار در terminal تنظیم کن
- `push.ps1` با `--force` پوش میکنه چون این repo snapshot هست نه تاریخچه
- آدرس Gitea: `https://git.darkreader.ir`
## جریان کلی ## جریان کلی
``` ```