Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ekm507/araste
آراسته: تبدیل متن فارسی به هنر اسکی
https://github.com/ekm507/araste
Last synced: 3 months ago
JSON representation
آراسته: تبدیل متن فارسی به هنر اسکی
- Host: GitHub
- URL: https://github.com/ekm507/araste
- Owner: ekm507
- License: agpl-3.0
- Created: 2022-07-05T20:53:27.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-03-19T10:52:03.000Z (8 months ago)
- Last Synced: 2024-07-22T14:46:28.112Z (4 months ago)
- Language: Python
- Size: 319 KB
- Stars: 86
- Watchers: 2
- Forks: 10
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[English Version](./README_EN.md)
آراسته
تبدیل نوشته‌های فارسی به هنر اسکی
مشابه ابزار figlet ولی برای نوشته‌های فارسی و عربی
در حال حاضر می‌توانید با دستور زیر، با استفاده از قلمی که تنظیم شده است یک واژه، جمله یا چند سطر نوشته را بنویسید.
```bash
araste نوشته
```
یا اگر قلمی مدنظر دارید :
```bash
araste 'نوشته‌ی شما' -f 'اسم یا مسیر قلم'
```
برای دیدن فهرستی از قلم‌های نصب شده:
```bash
araste --list
```
درحال‌حاضر چند قلم پیش فرض برای آراسته طراحی شده است که می‌توانید با اسم‌های زیر از آن‌ها استفاده کنید:
aipara
aipara_mini
zivar
nima
برای تعیین جهت چینش متن از سوییچ `-a` استفاده کنید.
به‌منظور تعیین پهنای متن چاپ شده از سوییچ `-w` استفاده کنید. آراسته به‌طور پیش‌فرض از پهنای پایانه استفاده می‌کند و درصورتی که امکان آن نباشد، پهنای پیش‌فرض ۸۰ نویسه را استفاده خواهد کرد.
برای راهنما :
```bash
araste -h
```
همچنین می‌توانید ورودی را از طریق stdin به برنامه بدهید. برای مثال:
```bash
echo 'آراسته' | araste
```
یک نمونه از خروجی برنامه با قلم پیش‌فرض آیپارا :
```
██████
████ ██ ██
████ ██ ██
████ ██ ██ ██ ██ ██ ██ ██
██████████████████████ ██ ██ ██
██
██
```
### فیلترها
می‌توانید در خروجی آراسته فیلترهای مختلفی اعمال کنید. برای استفاده از فیلترها از سوییچ `-F` استفاده کنید. سوییچ
برای مثال برای خروجی رنگی از فیلتر `rainbow` استفاده کنید.
```bash
$ araste 'این نوشته رنگی خواهد بود' -F rainbow
```
مثال دیگر: برای چاپ متن آینه‌شده از فیلترهای `hmirror` و `vmirror` استفاده کنید:
```bash
$ araste 'برعکس' -F hmirror
```
خروجی:
```
██
████ ██
██ ██ ██ ████ ██ ██ ██
██████ ██████████████████████ ██
██ ██ ██
██ ██ ████████
```
همچنین می‌توانید فیلترهای مختلف را باهم ترکیب کنید. برای این کار به‌سادگی آن‌ها را پشت سر هم بنویسید. مثال:
```bash
$ araste نوشته -F vrainbow box
```
همچنین سوییچ `--filter-list` فهرست فیلترهای موجود را چاپ می‌کند.
```bash
$ araste --filter-list
```
## نصب و استفاده
آراسته در [PyPI](https://pypi.org/project/araste/) قرار دارد. برای نصب برنامه از مدیر بستهٔ پایتون استفاده کنید.
````bash
pip install araste
````
توجه: اگر ارور error: externally-managed-environment رو دریافت میکنید، از pipx برای نصب آراسته استفاده کنید (مطمعن باشید بسته python-pipx روی سیستم شما نصب شده باشد):
````bash
pipx install araste
````
یا اگر می‌خواهید خودتان آراسته را بیلد کنید:
```bash
pip install setuptools wheel
git clone 'https://github.com/ekm507/araste/'
cd araste
rm -rf dist
python3 setup.py bdist_wheel
pip install ./dist/*.whl
```
## نصب قلم‌های بیشتر
برای نصب فونت‌ها می‌توانید از araste-get استفاده کنید.
````bash
araste-get install FontName
````
[قلم های قابل نصب](https://github.com/ekm507/araste-fonts/blob/main/Fonts.md)
## حذف برنامه
برای پاک کردن برنامه از روی سیستم، می‌توانید از pip استفاده کنید.
````bash
pip uninstall araste
````
یا با استفاده از pipx.
````bash
pipx uninstall araste
````
## ساخت قلم
برای دریافت قلم‌های بیشتر و همچنین ساخت قلم خودتان از مخزن [araste-fonts](https://github.com/ekm507/araste-fonts) استفاده کنید.
در آن مخزن قلم‌های ساخته شده و افزوده شده توسط کاربران، راهنماهایی برای ساخت طراحی و ساخت قلم و همچنین ابزارهای مختلفی برای این منظور وجود دارد.
## برای انجام
برای انجام کار جدید فایل [TODOS.md](https://github.com/ekm507/araste/blob/main/TODOS.md) را مشاهده کنید