Set default theme

catبديل عصري لـ cat مع تمييز بناء الجملة، ودمج Git، والصفحات التلقائية.

منصة	أمر
Ubuntu/Debian	`sudo apt install bat` (binary may be named `batcat`)
Arch Linux	`sudo pacman -S bat`
Fedora/RHEL	`sudo dnf install bat`
macOS (Homebrew)	`brew install bat`
macOS (MacPorts)	`sudo port install bat`
Windows (Scoop)	`scoop install bat`
Windows (Chocolatey)	`choco install bat`
Windows (Winget)	`winget install sharkdp.bat`
Rust/Cargo	`cargo install --locked bat`
Docker	`docker pull danlynn/bat`
`alias bat='batcat'`[Placeholder for alias command]

أمر	وصف
`bat file.txt`	عرض الملف مع التمييز الصyntaxي وأرقام السطور
`bat file1.txt file2.py`	عرض ملفات متعددة مع رؤوس
`bat -n file.txt`	إظهار أرقام السطور بشكل صريح (ممكّن افتراضيًا)
`bat -p file.txt`	Plain mode (no decorations, like `cat`)
`bat -pp file.txt`	وضع سادة إضافي (مخرجات سادة تمامًا)
`bat -A file.txt`	اعرض جميع الأحرف غير القابلة للطباعة (علامات التبويب، المسافات، نهايات السطور)
`bat -r 10:20 file.txt`	عرض نطاق سطور محدد (الأسطر 10-20)
`bat -r :50 file.txt`	عرض أول 50 سطر
`bat -r 100: file.txt`	عرض من السطر 100 حتى النهاية
`echo “text” \	bat`
`bat --list-languages`	أظهر جميع لغات البرمجة المدعومة
`bat --list-themes`	عرض جميع مواضيع الألوان المتاحة
`bat -l python file.txt`	فرض تنسيق لغة/تركيب معين للتظليل
`bat --plain file.txt`	تعطيل التمييز اللغوي
`bat --paging=never file.txt`	تعطيل التمرير التلقائي

أمر	وصف
`bat --theme="Dracula" file.py`	استخدم مجموعة ألوان محددة
`bat --diff file.txt`	عرض تعديلات Git مع التمييز الصوري للصياغة
`bat --no-git file.txt`	تعطيل علامات تكامل Git
`bat --tabs=4 file.py`	تعيين عرض علامة التبويب المخصص
`bat --wrap=never file.txt`	تعطيل التفاف السطر
`bat --terminal-width=80 file.txt`	فرض عرض محدد للطرفية
`bat --style=numbers,changes file.txt`	اعرض أرقام السطور وتغييرات Git فقط
`bat --style=header,grid file.txt`	اعرض فقط رأس الجدول وفواصل الشبكة
`bat --style=plain file.txt`	إزالة جميع الزخارف
`bat --file-name="Custom" file.txt`	عرض الاسم المخصص في الرأسية
`bat --decorations=never file.txt`	قم بتعطيل جميع الزخارف (حتى عندما تكون مناسبة)
`bat --color=always file.txt`	فرض إخراج الألوان (حتى عند التوجيه)
`bat --paging=always file.txt`	فرض الصفحة حتى للملفات الصغيرة
`bat --pager="less -RF" file.txt`	استخدم pager مخصص مع خيارات
`bat --map-syntax='*.conf:INI' file.conf`	ربط امتداد الملف بصيغة محددة
`bat --generate-config-file`	إنشاء ملف التكوين الافتراضي
`bat cache --build`	إعادة بناء ذاكرة التخزين المؤقت للصياغة/السمة
`bat cache --clear`	مسح ذاكرة التخزين المؤقت للصياغة/السمة

منصة	مسار
Linux/macOS	`~/.config/bat/config`
Windows	`%APPDATA%\bat\config`
`~/.config/bat/config`أنشئ [ملف التكوين] مع تفضيلاتك:

# Set default theme
--theme="Dracula"

# Always show line numbers and changes
--style="numbers,changes,header,grid"

# Use 4-space tabs
--tabs=4

# Automatic paging
--paging=auto

# Show non-printable characters
--show-all

# Enable italic text (if terminal supports)
--italic-text=always

# Custom syntax mappings
--map-syntax="*.conf:INI"
--map-syntax=".ignore:Git Ignore"
--map-syntax="*.jenkinsfile:Groovy"
--map-syntax="*.log:Log"
--map-syntax=".env:Bash"
```[Placeholder for configuration details]
```bash
# Set default theme
export BAT_THEME="Dracula"

# Set default style components
export BAT_STYLE="numbers,changes,header"

# Set default pager
export BAT_PAGER="less -RF"

# Disable paging entirely
export BAT_PAGER=""

# Custom config directory
export BAT_CONFIG_PATH="/custom/path/to/config"
```[Placeholder for environment variables]
```bash
# Create themes directory
mkdir -p "$(bat --config-dir)/themes"

# Download theme file (.tmTheme format)
cd "$(bat --config-dir)/themes"
wget https://example.com/theme.tmTheme

# Rebuild cache to use new theme
bat cache --build
```[Placeholder for custom themes]

| مكوِّن | وصف |
|-----------|-------------|
| `full` | جميع المكونات (الافتراضي) |
| `auto` | تلقائي بناءً على المخرجات |
| `plain` | لا زخارف |
| `numbers` | أرقام السطور |
| `changes` | علامات تعديل Git |
| `header` | رأس اسم الملف |
| `grid` | فواصل الشبكة |
| `rule` | الخطوط الأفقية |
| `snip` | علامات القطع لنطاقات الأسطر |مكونات النمط المتاحة (مفصولة بفاصلة):
```bash
# View file with Git changes highlighted
bat --diff src/main.py

# Compare with previous commit
git show HEAD~1:config.yaml | bat -l yaml --file-name="Previous Version"

# Review multiple changed files
git diff --name-only | xargs bat --diff
```[Placeholder for Git integration use case]
```bash
# View application logs with syntax highlighting
bat --language=log /var/log/application.log

# View specific error section
bat -r 1000:2000 /var/log/syslog | grep ERROR

# Monitor live logs (disable paging)
tail -f /var/log/app.log | bat --paging=never -l log

# Search logs with context
bat /var/log/nginx/error.log | grep -C 5 "ERROR"
```[Placeholder for log file analysis use case]
```bash
# Review system configurations
bat /etc/nginx/nginx.conf /etc/ssh/sshd_config

# Compare configurations side by side
diff <(bat -p config.prod.yml) <(bat -p config.dev.yml)

# Check for hidden characters in config
bat -A .env

# View Kubernetes resources
kubectl get deployment myapp -o yaml | bat -l yaml
```[Placeholder for configuration file management use case]
```bash
# View Dockerfile with syntax highlighting
bat Dockerfile

# Inspect docker-compose configurations
bat docker-compose.yml docker-compose.override.yml

# View container logs with syntax
docker logs container_name 2>&1 | bat --paging=never -l log

# Display formatted JSON from API
curl -s https://api.github.com/repos/sharkdp/bat | bat -l json
```[Placeholder for Docker and container workflows use case]
```bash
# View shell script with line numbers
bat -n deploy.sh

# Check specific function (lines 45-78)
bat -r 45:78 automation.sh

# Detect problematic characters
bat -A problematic-script.sh

# View multiple related scripts
bat scripts/*.sh
```[Placeholder for script development and debugging use case]
`-p`bat للبرمجة: عند استخدام الأنابيب أو البرمجة، استخدم
`bat -p`[Placeholder for additional scripting recommendation]

Would you like me to clarify or complete any specific sections?`bat --plain`لتجنب الزخارف التي قد تتداخل مع المعالجة
- **ضبط الإعدادات الافتراضية**: قم بإعداد`~/.config/bat/config`مع المظهر والنمط المفضل لديك لتجنب الأعلام المتكررة
- **اختصار لاستبدال cat**: أضف`alias cat='bat --paging=never --style=plain'`إلى تكوين shell الخاص بك للاستبدال السلس
- **الاستفادة من تكامل Git**: استخدم`--diff`عند مراجعة التغييرات في الكود لرؤية التعديلات مضمنة مع تمييز الصياغة
- **تعيين امتدادات مخصصة**: استخدم`--map-syntax`في ملف التكوين لأنواع الملفات الخاصة بالمشروع (مثل`.jenkinsfile`،`.conf`)
- **تعطيل الصفحات للأنابيب**: استخدم دائمًا`--paging=never`عند توجيه المخرجات إلى أوامر أخرى لمنع مشاكل الصفحة التفاعلية
- **استخدام تلميحات اللغة**: للملفات بدون امتدادات، حدد اللغة بشكل صريح باستخدام`-l`للحصول على تمييز صياغة صحيح
- **تناسق المظهر**: اختر مظهرًا يتناسب مع مخطط ألوان الطرفية الخاص بك لقراءة أفضل
- **إدارة الذاكرة المؤقتة**: بعد إضافة مظاهر أو صياغات مخصصة، قم بتشغيل`bat cache --build`لجعلها متاحة

## استكشاف الأخطاء وإصلاحها

| مشكلة | حل |
|-------|----------|
| Binary named `batcat` instead of `bat` | Create alias: `alias bat='batcat'` or symlink: `ln -s /usr/bin/batcat ~/.local/bin/bat` |
| No syntax highlighting | Check language support with `bat --list-languages` and use `-l` to force language |
| Pager interferes with pipes | Use `bat --paging=never` or set `export BAT_PAGER=""` |
| Theme not displaying correctly | Verify terminal supports 256 colors; try different theme with `bat --theme="GitHub"` |
| Custom theme not appearing | Ensure theme file is in `$(bat --config-dir)/themes/` and run `bat cache --build` |
| Line numbers misaligned | Check tab width setting; adjust with `--tabs=4` or in config file |
| Git integration not working | Ensure file is in Git repository; disable with `--no-git` if not needed |
| Config file changes ignored | Verify file location with `bat --config-file`; check for syntax errors in config |
| Performance issues with large files | Use `--paging=never` and pipe to `less`, or use line ranges with `-r` |
| Unicode characters display incorrectly | Ensure terminal uses UTF-8 encoding; check `locale` settings |
## مرجع سريع: الأعلام الشائعة

| قصير | طويل | الغرض |
|-------|------|---------|
| `-p` | `--plain` | وضع الإخراج العادي |
| `-n` | `--number` | إظهار أرقام السطور |
| `-A` | `--show-all` | إظهار الأحرف غير القابلة للطباعة |
| `-l` | `--language` | تعيين لغة بناء الجملة |
| `-r` | `--line-range` | عرض نطاق السطور |
| `-H` | `--highlight-line` | قواعد:
- قم بتمييز سطور محددة |
| `-d` | `--diff` | أظهر Git diff |
|  | `--theme` | تعيين مظهر اللون |
|  | `--style` | تعيين مكونات النمط |
|  | `--paging` | التحكم في سلوك صفحة التمرير |
|  | `--tabs` | تعيين عرض علامة التبويب ||  | `--wrap`| التحكم في التفاف السطر |