1

.github/workflows/build-pdf.yml

@@ -0,0 +1,90 @@
+name: Build Pro Git PDF
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '3.1'
+        bundler-cache: true
+
+    - name: Install system dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y fonts-liberation fonts-dejavu fonts-arabeyes fonts-farsiweb
+
+    - name: Install Ruby dependencies
+      run: |
+        bundle install
+
+    - name: Build PDF
+      run: |
+        bundle exec rake book:build_pdf
+
+    - name: Build all formats (optional)
+      run: |
+        bundle exec rake book:build
+      continue-on-error: true
+
+    - name: Upload PDF as artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: progit-arabic-pdf
+        path: progit.pdf
+        if-no-files-found: error
+
+    - name: Upload all formats
+      uses: actions/upload-artifact@v4
+      with:
+        name: progit-arabic-all-formats
+        path: |
+          progit.pdf
+          progit.epub
+          progit.mobi
+          progit.html
+        if-no-files-found: ignore
+
+    - name: Get current date
+      id: date
+      run: echo "date=$(date +'%Y-%m-%d')" >> $GITHUB_OUTPUT
+
+    - name: Create Release
+      if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+      uses: softprops/action-gh-release@v2
+      with:
+        tag_name: build-${{ steps.date.outputs.date }}-${{ github.run_number }}
+        name: Pro Git العربية - ${{ steps.date.outputs.date }}
+        body: |
+          📚 **كتاب Pro Git - الإصدار الثاني (العربية)**
+
+          تم بناء الكتاب تلقائياً من الكود المصدري.
+
+          ### الملفات المتاحة:
+          - 📄 `progit.pdf` - نسخة PDF (موصى بها)
+          - 📱 `progit.epub` - نسخة EPUB للقراء الإلكترونية
+          - 📖 `progit.mobi` - نسخة Kindle
+          - 🌐 `progit.html` - نسخة HTML
+
+          **Build ID:** ${{ github.run_number }}
+          **Commit:** ${{ github.sha }}
+        files: |
+          progit.pdf
+          progit.epub
+          progit.mobi
+          progit.html
+        draft: false
+        prerelease: false
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      continue-on-error: true

A-git-in-other-environments.asc

@@ -1,11 +1,11 @@
 [[A-git-in-other-environments]]
 [appendix]
-== Git in Other Environments
+== Git in Other Environments (غيت في البيئات الأخرى)
 
-If you read through the whole book, you've learned a lot about how to use Git at the command line.
-You can work with local files, connect your repository to others over a network, and work effectively with others.
-But the story doesn't end there; Git is usually used as part of a larger ecosystem, and the terminal isn't always the best way to work with it.
-Now we'll take a look at some of the other kinds of environments where Git can be useful, and how other applications (including yours) work alongside Git.
+إذا قرأت الكتاب بأكمله، فقد تعلمت الكثير عن كيفية استخدام Git (غيت) من سطر الأوامر (command line).
+يمكنك العمل مع الملفات المحلية (local files)، وربط مستودعك (repository) بالآخرين عبر شبكة (network)، والعمل بفعالية مع الآخرين.
+لكن القصة لا تنتهي عند هذا الحد؛ يُستخدم Git (غيت) عادةً كجزء من نظام بيئي أكبر (larger ecosystem)، وليست المحطة الطرفية (terminal) دائماً أفضل طريقة للعمل معه.
+الآن سنلقي نظرة على بعض الأنواع الأخرى من البيئات (environments) حيث يمكن أن يكون Git (غيت) مفيداً، وكيف تعمل التطبيقات الأخرى (بما في ذلك تطبيقاتك) جنباً إلى جنب مع Git (غيت).
 
 include::book/A-git-in-other-environments/sections/guis.asc[]
 
@@ -23,6 +23,6 @@ include::book/A-git-in-other-environments/sections/zsh.asc[]
 
 include::book/A-git-in-other-environments/sections/powershell.asc[]
 
-=== Summary
+=== Summary (الملخص)
 
-You've learned how to harness Git's power from inside the tools that you use during your everyday work, and also how to access Git repositories from your own programs.
+لقد تعلمت كيفية تسخير قوة Git (غيت) من داخل الأدوات التي تستخدمها أثناء عملك اليومي، وأيضاً كيفية الوصول إلى مستودعات Git (Git repositories) من برامجك الخاصة.

B-embedding-git-in-your-applications.asc

@@ -1,12 +1,12 @@
 [[B-embedding-git-in-your-applications]]
 [appendix]
-== Embedding Git in your Applications
+== Embedding Git in your Applications (تضمين Git في تطبيقاتك)
 
-If your application is for developers, chances are good that it could benefit from integration with source control.
-Even non-developer applications, such as document editors, could potentially benefit from version-control features, and Git's model works very well for many different scenarios.
+إذا كان تطبيقك موجهاً للمطورين (developers)، فهناك احتمالات جيدة بأنه قد يستفيد من التكامل (integration) مع التحكم في كود المصدر (source control).
+حتى التطبيقات غير المخصصة للمطورين، مثل محرري المستندات (document editors)، يمكن أن تستفيد من ميزات التحكم في الإصدارات (version-control features)، ويعمل نموذج Git (غيت) بشكل جيد جداً في العديد من السيناريوهات المختلفة.
 
-If you need to integrate Git with your application, you have essentially two options: spawn a shell and call the `git` command-line program, or embed a Git library into your application.
-Here we'll cover command-line integration and several of the most popular embeddable Git libraries.
+إذا كنت بحاجة إلى دمج Git (غيت) مع تطبيقك، فلديك أساساً خياران: تفريخ غلاف (spawn a shell) واستدعاء برنامج سطر أوامر `git`، أو تضمين مكتبة Git (embed a Git library) في تطبيقك.
+سنغطي هنا تكامل سطر الأوامر (command-line integration) والعديد من مكتبات Git القابلة للتضمين (embeddable Git libraries) الأكثر شيوعاً.
 
 include::book/B-embedding-git/sections/command-line.asc[]