Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Bump release #115

Merged
merged 85 commits into from
Apr 14, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
85 commits
Select commit Hold shift + click to select a range
631b02b
ko-chapter1/1
Apr 1, 2022
e27454b
ko _toctree.yml created
Apr 1, 2022
ea10974
Fix the issue #80
Apr 2, 2022
2653c29
Single expression changed
Apr 2, 2022
f3073c2
ko/chapter1 finished
Apr 2, 2022
278753a
ko/chapter0 finished
Apr 2, 2022
1ec6d9c
ko/chapter0 finished
Apr 2, 2022
e5285b7
reviewed by @bzantium ko/chapter0
Apr 3, 2022
95bb455
reviewed by @bzantium chapter0 & fixed typo
Apr 3, 2022
3012092
reviewed by @rainmaker712
Apr 3, 2022
d84afe9
maximize Korean expressions
Apr 3, 2022
1193811
[Chapter 1] bangla traslation initial commit
Apr 4, 2022
33e0a04
Update 1.mdx
eNipu Apr 4, 2022
fa77e72
Fix formating and typos
Apr 4, 2022
d7c9f56
Merge branch 'huggingface:main' into main
eNipu Apr 4, 2022
ef201cb
translate _toctree.yml 0-1 chapter
Apr 4, 2022
211d8c0
Merge branch 'main' into kor
lewtun Apr 4, 2022
b664828
Add Korean to CI
lewtun Apr 4, 2022
b58e7e4
[tr] Translated chapter1/2.mdx
ftarlaci Apr 4, 2022
a775ef6
Merge branch 'huggingface:main' into main
eNipu Apr 5, 2022
e82e845
remove translation from sec titles not yet translated
Apr 5, 2022
045ca30
Add authors [th ru]
lewtun Apr 5, 2022
35c9fcd
Merge pull request #94 from huggingface/add_authors_1
lewtun Apr 5, 2022
0f068d5
[FIX] _toctree.yml
Apr 5, 2022
c548c2f
Merge branch 'huggingface:main' into main
eNipu Apr 5, 2022
fd8bef7
Update chapters/bn/chapter0/1.mdx
eNipu Apr 5, 2022
07766e6
tag typos & indentation & unnatural expressions
Apr 5, 2022
3d4f9af
Merge branch 'main' into kor
wavy-jung Apr 5, 2022
9855aa9
modified toctree.yml for chapter1/2
ftarlaci Apr 5, 2022
05cb27c
modified toctree.yml for chapter1/2 & fix typo
ftarlaci Apr 5, 2022
40a3ea8
French Translation - Chapter 5
melaniedrevet Apr 6, 2022
1f89e8a
Merge pull request #80 from Doohae/kor
lewtun Apr 6, 2022
2406a54
Merge pull request #91 from ftarlaci/main
lewtun Apr 6, 2022
c4a44e4
Merge pull request #89 from eNipu/main
lewtun Apr 6, 2022
eabce90
Merge pull request #96 from melaniedrevet/main
lewtun Apr 6, 2022
0821f1f
Add Bengali to CI
lewtun Apr 11, 2022
74c9f35
Update author list
lewtun Apr 11, 2022
de55784
Merge pull request #110 from huggingface/add-bengali
lewtun Apr 11, 2022
772400d
Adding translations for 2/4 and 2/5 🚀 (#74)
munozariasjm Apr 11, 2022
bec1205
Translation to Russian (#97)
svv73 Apr 12, 2022
f64e1e6
Translation of Chapter0 to Hindi (#86)
pandyaved98 Apr 12, 2022
79fea05
Chapter 0 Persian Translation First Draft (#95)
jowharshamshiri Apr 12, 2022
35b6378
Translation of Chapter0 (setup) to Arabic (#104)
giyaseddin Apr 12, 2022
12a5240
Russian - Chapter 1 finished (#98)
pdumin Apr 12, 2022
e812f74
Chinese - Chapter 1 finished (#113)
yaoqih Apr 13, 2022
98cc578
[PT] Translation of chapter 2 (#107)
johnnv1 Apr 13, 2022
421e837
[FR] Translation of chapter 2 & event + Review of chapters 0 & 5 (#106)
lbourdois Apr 13, 2022
e763d89
[th] Translated Chapter2/1 (#83)
ckingkan Apr 13, 2022
b660ef8
ko-chapter1/1
Apr 1, 2022
5fadfc2
ko _toctree.yml created
Apr 1, 2022
2900cd4
Fix the issue #80
Apr 2, 2022
8f422b7
Single expression changed
Apr 2, 2022
9830ec4
ko/chapter1 finished
Apr 2, 2022
5d5fa1c
ko/chapter0 finished
Apr 2, 2022
c07f2ee
ko/chapter0 finished
Apr 2, 2022
44654de
reviewed by @bzantium ko/chapter0
Apr 3, 2022
46d6de2
reviewed by @bzantium chapter0 & fixed typo
Apr 3, 2022
08dc39b
reviewed by @rainmaker712
Apr 3, 2022
98501f6
maximize Korean expressions
Apr 3, 2022
5204d77
[Chapter 1] bangla traslation initial commit
Apr 4, 2022
0d393cc
Update 1.mdx
eNipu Apr 4, 2022
6dcc9b8
Fix formating and typos
Apr 4, 2022
9126ded
translate _toctree.yml 0-1 chapter
Apr 4, 2022
5fe21ce
Add Korean to CI
lewtun Apr 4, 2022
810db39
remove translation from sec titles not yet translated
Apr 5, 2022
5fc58d0
Add authors [th ru]
lewtun Apr 5, 2022
41c466a
[FIX] _toctree.yml
Apr 5, 2022
5a9ac2a
Update chapters/bn/chapter0/1.mdx
eNipu Apr 5, 2022
69edf60
tag typos & indentation & unnatural expressions
Apr 5, 2022
ec1b5d9
modified toctree.yml for chapter1/2
ftarlaci Apr 5, 2022
6723a3f
modified toctree.yml for chapter1/2 & fix typo
ftarlaci Apr 5, 2022
90fbf37
Add Bengali to CI
lewtun Apr 11, 2022
e82904f
Update author list
lewtun Apr 11, 2022
9dcf5da
Adding translations for 2/4 and 2/5 🚀 (#74)
munozariasjm Apr 11, 2022
8e8e5c1
Translation to Russian (#97)
svv73 Apr 12, 2022
a02f0a4
Translation of Chapter0 to Hindi (#86)
pandyaved98 Apr 12, 2022
1bd43b6
Chapter 0 Persian Translation First Draft (#95)
jowharshamshiri Apr 12, 2022
303e83e
Translation of Chapter0 (setup) to Arabic (#104)
giyaseddin Apr 12, 2022
51d1a52
Russian - Chapter 1 finished (#98)
pdumin Apr 12, 2022
433f645
Chinese - Chapter 1 finished (#113)
yaoqih Apr 13, 2022
1d1a7a5
[PT] Translation of chapter 2 (#107)
johnnv1 Apr 13, 2022
0a3880d
[FR] Translation of chapter 2 & event + Review of chapters 0 & 5 (#106)
lbourdois Apr 13, 2022
a3de4dc
[th] Translated Chapter2/1 (#83)
ckingkan Apr 13, 2022
77de2c9
Merge remote-tracking branch 'origin/bump_release_3' into bump_release_3
lewtun Apr 13, 2022
0e39d95
Add Hindi to CI (#116)
lewtun Apr 13, 2022
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/build_documentation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@ jobs:
package: course
path_to_docs: course/chapters/
additional_args: --not_python_module
languages: bn en es fa fr he ko pt ru th tr
languages: ar bn en es fa fr he hi ko pt ru th tr zh
secrets:
token: ${{ secrets.HUGGINGFACE_PUSH }}
4 changes: 2 additions & 2 deletions .github/workflows/build_pr_documentation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,5 @@ jobs:
package: course
path_to_docs: course/chapters/
additional_args: --not_python_module
languages: bn en es fa fr he ko pt ru th tr
hub_base_path: https://moon-ci-docs.huggingface.co/course
languages: ar bn en es fa fr he hi ko pt ru th tr zh
hub_base_path: https://moon-ci-docs.huggingface.co/course
4 changes: 4 additions & 0 deletions chapters/ar/_toctree.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
- title: 0.الإعداد
sections:
- local: chapter0/1
title: مقدمة
136 changes: 136 additions & 0 deletions chapters/ar/chapter0/1.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
<div dir="rtl" style="direction:rtl;text-align:right;">

# مقدمة

مرحبًا بك في دورة Hugging Face! ستساعدك هذه المقدمة خلال إعداد بيئة العمل. إذا كنت قد بدأت الدورة للتو، فننصحك أولاً بإلقاء نظرة على [الفصل 1](/course/chapter1)، ثم العودة وإعداد بيئتك حتى تتمكن من تجربة الكود بنفسك.

تتوفر جميع المكتبات التي سنستخدمها في هذه الدورة التدريبية على شكل حزم (Package) Python، لذلك سنوضح لك هنا كيفية إعداد بيئة Python وتثبيت المكتبات المحددة التي ستحتاج إليها.

سنغطي طريقتين لإعداد بيئة العمل الخاصة بك، باستخدام دفتر Colab أو بيئة Python الافتراضية. لا تتردد في اختيار البيئة التي تناسبك أكثر.نوصي المبتدئين بشدة أن يبدأوا باستخدام دفتر Colab.

لاحظ أننا لن نغطي نظام Windows. إذا كنت تعمل على نظام Windows، فإننا نوصي بمتابعة استخدام دفتر Colab. إذا كنت تستخدم توزيعة Linux أو macOS، فيمكنك استخدام أي من الطريقتين الموضحتين هنا.

تعتمد معظم الدورة على امتلاكك لحساب Hugging Face. نوصي بإنشاء حساب الآن: [إنشاء حساب](https://huggingface.co/join).

## استخدام دفتر Google Colab

يعد استخدام دفتر Colab أبسط إعداد ممكن؛ فقط قم بتشغيل دفتر Colab في متصفحك ابدأ مباشرة بالبرمجة!

إذا لم تكن معتادًا على Colab، نوصيك بالبدء باتباع [المقدمة](https://colab.research.google.com/notebooks/intro.ipynb). يتيح لك Colab استخدام بعض أجهزة التسريع، مثل GPUs أو TPUs، وهو مجاني في حال تشغيل مهمات خفيفة.

بمجرد أن تشعر بالأريحية في التنقل في Colab، أنشئ دفتر ملاحظات جديدًا وابدأ في الإعداد:

<div class="flex justify-center">
<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/new_colab.png" alt="An empty colab notebook" width="80%"/>
</div>

الخطوة التالية هي تثبيت المكتبات التي سنستخدمها في هذه الدورة. سنستخدم `pip` للتثبيت، وهو مدير الحزم لPython. حتى تتمكن من تثبيت مكتبة 🤗 Transformers يمكنك تشغيل أوامر النظام عن طريق تسبقها بالحرف `!` في دفتر Colab, على النحو التالي:

</div>

```
!pip install transformers
```

<div dir="rtl" style="direction:rtl;text-align:right;">
يمكنك التأكد من تثبيت الحزمة بشكل صحيح عن طريق استيرادها (import) خلال وقت تشغيل Python:
</div>

```
import transformers
```

<div class="flex justify-center">
<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/install.gif" alt="A gif showing the result of the two commands above: installation and import" width="80%"/>
</div>

<div dir="rtl" style="direction:rtl;text-align:right;">
هذا يثبت نسخة خفيفة جدا من مكتبة 🤗 Transformers. أي أنه لم يتم تثبيت أي إطارات عمل محددة للتعلم الآلي (مثل PyTorch أو TensorFlow). نوصي بتثبيت "إصدار التطوير" للمكتبة لأننا سوف نستخدم الكثير من الميزات المختلفة, و هذا الإصدار يأتي مع جميع التبعيات المطلوبة تقريباً لأي حالة استخدام يمكن تخيلها:

</div>

```
!pip install transformers[sentencepiece]
```

<div dir="rtl" style="direction:rtl;text-align:right;">
سيستغرق هذا بعض الوقت، لكنك ستكون جاهزًا بعد ذلك لبقية الدورة!

## استخدام بيئة Python افتراضية

إذا كنت تفضل استخدام بيئة Python الافتراضية، فإن الخطوة الأولى هي تثبيت Python على نظامك. للبدء, نوصي باتباع [دليل الإرشادات هذا](https://realpython.com/installing-python/).

بمجرد تثبيت Python، يجب أن تكون قادرًا على تشغيل أوامر Python في الجهاز المستخدم. للتأكد من تثبيته بشكل صحيح قبل المتابعة إلى الخطوات التالية يمكنك البدء بتشغيل الأمر التالي: `python --version`. يجب أن يطبع هذا إصدار Python المتاح الآن على نظامك.

عند تشغيل أمر Python في الجهاز المستخدم، مثل `python --version`، يجب أن تفكر في البرنامج الذي يقوم بتشغيل الأمر الخاص بك باعتباره Python "الرئيسي" على نظامك. نوصي بالحفاظ على هذا التثبيت الرئيسي خاليًا من أي حزم، واستخدامه لإنشاء بيئات منفصلة لكل تطبيق تعمل عليه, وبهذه الطريقة، يمكن لكل تطبيق أن يكون له تبعيات وحزم خاصة به، ولن تقلق بشأن مشكلات التوافق المحتملة مع تطبيقات أخرى.

في Python، يتم ذلك باستخدام [* البيئات الافتراضية *](https://docs.python.org/3/tutorial/venv.html)، وهي عبارة عن تفرعات من المجلدات كل منها قائم بحد ذاته, ويحتوي كل منها على Python مثبت بإصدار معين بالإضافة إلى جميع الحزم التي يحتاجها التطبيق. يمكن إنشاء مثل هذه البيئة الافتراضية باستخدام عدد من الأدوات المختلفة ، لكننا سنستخدم حزمة Python الرسمية لهذا الغرض، والتي تسمى [`venv`](https://docs.python.org/3/library/venv.html#module-venv).

أولاً، قم بإنشاء المجلد الذي تريد أن يتواجد فيه التطبيق الخاص بك -على سبيل المثال، قد ترغب في إنشاء مجلد جديد يسمى *transformers-course* في المجلد الرئيسي للدورة:
</div>

```
mkdir ~/transformers-course
cd ~/transformers-course
```

<div dir="rtl" style="direction:rtl;text-align:right;">

من داخل هذا المجلد، أنشئ بيئة افتراضية باستخدام وحدة Python `venv`:

</div>

```
python -m venv .env
```

<div dir="rtl" style="direction:rtl;text-align:right;">
يجب أن يكون لديك الآن مجلد يسمى *.env* في المجلد الفارغ الخاص بك:
</div>

```
ls -a
```

```out
. .. .env
```

<div dir="rtl" style="direction:rtl;text-align:right;">
يمكنك الدخول والخروج من بيئتك الافتراضية باستخدام أوامر "التنشيط" و "إلغاء التنشيط":
</div>

```
# Activate the virtual environment
source .env/bin/activate

# Deactivate the virtual environment
source .env/bin/deactivate
```

<div dir="rtl" style="direction:rtl;text-align:right;">
يمكنك التأكد من تنشيط البيئة عن طريق تشغيل الأمر `which python`: إذا كان يشير إلى البيئة الافتراضية، فقد قمت بتنشيطها بنجاح!
</div>

```
which python
```

```out
/home/<user>/transformers-course/.env/bin/python
```

<div dir="rtl" style="direction:rtl;text-align:right;">

### تثبيت التبعيات

كما في القسم السابق حول استخدام مثيلات Google Colab، ستحتاج الآن إلى تثبيت الحزم المطلوبة للمتابعة. مرة أخرى، يمكنك تثبيت إصدار التطوير من 🤗 Transformers باستخدام مدير الحزم `pip`:
</div>

```
pip install "transformers[sentencepiece]"
```

<div dir="rtl" style="direction:rtl;text-align:right;">
أنت الآن جاهز تمامًا للانطلاق!
</div>
2 changes: 1 addition & 1 deletion chapters/en/chapter2/8.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@
choices={[
{
text: "A model that automatically trains on your data",
explain: "Incorrect. Are you mistaking this with our <a href='https://huggingface.co/autonlp'>AutoNLP</a> product?"
explain: "Incorrect. Are you mistaking this with our <a href='https://huggingface.co/autotrain'>AutoTrain</a> product?"
},
{
text: "An object that returns the correct architecture based on the checkpoint",
Expand Down
7 changes: 7 additions & 0 deletions chapters/es/_toctree.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,3 +26,10 @@
- local: chapter1/10
title: Quiz de final de capítulo
quiz: 1

- title: 2. Usando Transformers 🤗
sections:
- local: chapter2/4
title: Tokenizadores
- local: chapter2/5
title: Manejando Secuencias Múltiples
Loading