Skip to content

Commit 2aec8a2

Browse files
committed
Bootstrap Greek translation (chapter 0)
Adds chapters/el/ with _toctree.yml and a Greek translation of chapter0/1.mdx (Introduction). Registers Greek in the README languages table. Closes part of #1257.
1 parent 80133b2 commit 2aec8a2

3 files changed

Lines changed: 115 additions & 0 deletions

File tree

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ This repo contains the content that's used to create the **[Hugging Face course]
99
| [English](https://huggingface.co/course/en/chapter1/1) | [`chapters/en`](https://github.com/huggingface/course/tree/main/chapters/en) | [@sgugger](https://github.com/sgugger), [@lewtun](https://github.com/lewtun), [@LysandreJik](https://github.com/LysandreJik), [@Rocketknight1](https://github.com/Rocketknight1), [@sashavor](https://github.com/sashavor), [@osanseviero](https://github.com/osanseviero), [@SaulLu](https://github.com/SaulLu), [@lvwerra](https://github.com/lvwerra) |
1010
| [Bengali](https://huggingface.co/course/bn/chapter1/1) (WIP) | [`chapters/bn`](https://github.com/huggingface/course/tree/main/chapters/bn) | [@avishek-018](https://github.com/avishek-018), [@eNipu](https://github.com/eNipu) |
1111
| [German](https://huggingface.co/course/de/chapter1/1) (WIP) | [`chapters/de`](https://github.com/huggingface/course/tree/main/chapters/de) | [@JesperDramsch](https://github.com/JesperDramsch), [@MarcusFra](https://github.com/MarcusFra), [@fabridamicelli](https://github.com/fabridamicelli) |
12+
| [Greek](https://huggingface.co/course/el/chapter0/1) (WIP) | [`chapters/el`](https://github.com/huggingface/course/tree/main/chapters/el) | [@ctribuna](https://github.com/ctribuna) |
1213
| [Spanish](https://huggingface.co/course/es/chapter1/1) (WIP) | [`chapters/es`](https://github.com/huggingface/course/tree/main/chapters/es) | [@camartinezbu](https://github.com/camartinezbu), [@munozariasjm](https://github.com/munozariasjm), [@fordaz](https://github.com/fordaz) |
1314
| [Persian](https://huggingface.co/course/fa/chapter1/1) (WIP) | [`chapters/fa`](https://github.com/huggingface/course/tree/main/chapters/fa) | [@jowharshamshiri](https://github.com/jowharshamshiri), [@schoobani](https://github.com/schoobani) |
1415
| [French](https://huggingface.co/course/fr/chapter1/1) | [`chapters/fr`](https://github.com/huggingface/course/tree/main/chapters/fr) | [@lbourdois](https://github.com/lbourdois), [@ChainYo](https://github.com/ChainYo), [@melaniedrevet](https://github.com/melaniedrevet), [@abdouaziz](https://github.com/abdouaziz) |

chapters/el/_toctree.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
- title: 0. Εγκατάσταση
2+
sections:
3+
- local: chapter0/1
4+
title: Εισαγωγή

chapters/el/chapter0/1.mdx

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
# Εισαγωγή[[introduction]]
2+
3+
Καλώς ήρθατε στο μάθημα του Hugging Face! Αυτή η εισαγωγή θα σας καθοδηγήσει στη ρύθμιση ενός λειτουργικού περιβάλλοντος εργασίας. Αν μόλις ξεκινάτε το μάθημα, σας προτείνουμε να ρίξετε πρώτα μια ματιά στο [Κεφάλαιο 1](/course/chapter1), και μετά να επιστρέψετε και να ρυθμίσετε το περιβάλλον σας ώστε να μπορέσετε να δοκιμάσετε τον κώδικα μόνοι σας.
4+
5+
Όλες οι βιβλιοθήκες που θα χρησιμοποιήσουμε σε αυτό το μάθημα είναι διαθέσιμες ως πακέτα Python, οπότε εδώ θα σας δείξουμε πώς να ρυθμίσετε ένα περιβάλλον Python και να εγκαταστήσετε τις συγκεκριμένες βιβλιοθήκες που θα χρειαστείτε.
6+
7+
Θα καλύψουμε δύο τρόπους για τη ρύθμιση του περιβάλλοντος εργασίας σας: μέσω ενός Colab notebook ή ενός εικονικού περιβάλλοντος Python (virtual environment). Διαλέξτε αυτόν που σας ταιριάζει καλύτερα. Για αρχάριους, συνιστούμε ανεπιφύλακτα να ξεκινήσετε με ένα Colab notebook.
8+
9+
Σημειώστε ότι δεν θα καλύψουμε το λειτουργικό σύστημα Windows. Αν εργάζεστε σε Windows, σας προτείνουμε να ακολουθήσετε το μάθημα χρησιμοποιώντας ένα Colab notebook. Αν χρησιμοποιείτε μια διανομή Linux ή macOS, μπορείτε να ακολουθήσετε οποιαδήποτε από τις δύο προσεγγίσεις που περιγράφονται εδώ.
10+
11+
Το μεγαλύτερο μέρος του μαθήματος βασίζεται στο ότι διαθέτετε λογαριασμό Hugging Face. Σας προτείνουμε να δημιουργήσετε έναν τώρα: [δημιουργία λογαριασμού](https://huggingface.co/join).
12+
13+
## Χρήση Google Colab notebook[[using-a-google-colab-notebook]]
14+
15+
Η χρήση ενός Colab notebook είναι η πιο απλή δυνατή ρύθμιση· ανοίξτε ένα notebook στον browser σας και ξεκινήστε αμέσως να γράφετε κώδικα!
16+
17+
Αν δεν είστε εξοικειωμένοι με το Colab, σας προτείνουμε να ξεκινήσετε ακολουθώντας την [εισαγωγή του](https://colab.research.google.com/notebooks/intro.ipynb). Το Colab σας επιτρέπει να χρησιμοποιείτε επιταχυντικό υλικό (hardware), όπως GPUs ή TPUs, και είναι δωρεάν για μικρότερους φόρτους εργασίας.
18+
19+
Μόλις νιώσετε άνετα να κινείστε στο περιβάλλον του Colab, δημιουργήστε ένα νέο notebook και ξεκινήστε με την εγκατάσταση:
20+
21+
<div class="flex justify-center">
22+
<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/new_colab.png" alt="An empty colab notebook" width="80%"/>
23+
</div>
24+
25+
Το επόμενο βήμα είναι να εγκαταστήσουμε τις βιβλιοθήκες που θα χρησιμοποιήσουμε σε αυτό το μάθημα. Για την εγκατάσταση θα χρησιμοποιήσουμε το `pip`, τον διαχειριστή πακέτων της Python. Στα notebooks, μπορείτε να εκτελέσετε εντολές συστήματος προσθέτοντας τον χαρακτήρα `!` μπροστά από αυτές, οπότε μπορείτε να εγκαταστήσετε τη βιβλιοθήκη 🤗 Transformers ως εξής:
26+
27+
```
28+
!pip install transformers
29+
```
30+
31+
Μπορείτε να βεβαιωθείτε ότι το πακέτο εγκαταστάθηκε σωστά εισάγοντάς το μέσα στο Python runtime σας:
32+
33+
```
34+
import transformers
35+
```
36+
37+
<div class="flex justify-center">
38+
<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%"/>
39+
</div>
40+
41+
Με αυτόν τον τρόπο εγκαθίσταται μια πολύ ελαφριά έκδοση του 🤗 Transformers. Συγκεκριμένα, δεν εγκαθίσταται κανένα συγκεκριμένο πλαίσιο μηχανικής μάθησης (όπως το PyTorch ή το TensorFlow). Καθώς θα χρησιμοποιήσουμε πολλές διαφορετικές λειτουργίες της βιβλιοθήκης, σας προτείνουμε να εγκαταστήσετε την έκδοση ανάπτυξης (development version), η οποία περιλαμβάνει όλες τις απαραίτητες εξαρτήσεις για σχεδόν οποιαδήποτε περίπτωση χρήσης μπορείτε να φανταστείτε:
42+
43+
```
44+
!pip install transformers[sentencepiece]
45+
```
46+
47+
Αυτό θα πάρει λίγο χρόνο, αλλά μετά θα είστε έτοιμοι για το υπόλοιπο του μαθήματος!
48+
49+
## Χρήση εικονικού περιβάλλοντος Python[[using-a-python-virtual-environment]]
50+
51+
Αν προτιμάτε να χρησιμοποιήσετε ένα εικονικό περιβάλλον Python, το πρώτο βήμα είναι να εγκαταστήσετε την Python στο σύστημά σας. Σας προτείνουμε να ακολουθήσετε [αυτόν τον οδηγό](https://realpython.com/installing-python/) για να ξεκινήσετε.
52+
53+
Μόλις εγκαταστήσετε την Python, θα μπορείτε να εκτελείτε εντολές Python στο terminal σας. Μπορείτε να ξεκινήσετε εκτελώντας την παρακάτω εντολή ώστε να βεβαιωθείτε ότι έχει εγκατασταθεί σωστά πριν προχωρήσετε στα επόμενα βήματα: `python --version`. Αυτή η εντολή θα εκτυπώσει την έκδοση Python που είναι διαθέσιμη στο σύστημά σας.
54+
55+
Όταν εκτελείτε μια εντολή Python στο terminal σας, όπως `python --version`, θα πρέπει να θεωρείτε το πρόγραμμα που εκτελεί την εντολή σας ως την «κύρια» Python του συστήματος. Σας προτείνουμε να κρατάτε αυτήν την κύρια εγκατάσταση χωρίς κανένα πακέτο και να τη χρησιμοποιείτε για να δημιουργείτε ξεχωριστά περιβάλλοντα για κάθε εφαρμογή στην οποία εργάζεστε — με αυτόν τον τρόπο, κάθε εφαρμογή μπορεί να έχει τις δικές της εξαρτήσεις και πακέτα, και δεν θα χρειάζεται να ανησυχείτε για πιθανά προβλήματα συμβατότητας με άλλες εφαρμογές.
56+
57+
Στην Python αυτό γίνεται με τα [*εικονικά περιβάλλοντα*](https://docs.python.org/3/tutorial/venv.html), τα οποία είναι αυτοτελείς δομές καταλόγων που η καθεμία περιέχει μια εγκατάσταση Python με μια συγκεκριμένη έκδοση, μαζί με όλα τα πακέτα που χρειάζεται η εφαρμογή. Η δημιουργία ενός τέτοιου εικονικού περιβάλλοντος μπορεί να γίνει με διάφορα εργαλεία, αλλά εμείς θα χρησιμοποιήσουμε το επίσημο πακέτο της Python για αυτόν τον σκοπό, που ονομάζεται [`venv`](https://docs.python.org/3/library/venv.html#module-venv).
58+
59+
Πρώτα, δημιουργήστε τον κατάλογο μέσα στον οποίο θέλετε να ζει η εφαρμογή σας — για παράδειγμα, μπορεί να θέλετε να φτιάξετε έναν νέο κατάλογο με όνομα *transformers-course* στη ρίζα του home directory σας:
60+
61+
```
62+
mkdir ~/transformers-course
63+
cd ~/transformers-course
64+
```
65+
66+
Μέσα από αυτόν τον κατάλογο, δημιουργήστε ένα εικονικό περιβάλλον χρησιμοποιώντας το module `venv` της Python:
67+
68+
```
69+
python -m venv .env
70+
```
71+
72+
Θα πρέπει τώρα να έχετε έναν κατάλογο με όνομα *.env* μέσα στον κατά τα άλλα κενό φάκελό σας:
73+
74+
```
75+
ls -a
76+
```
77+
78+
```out
79+
. .. .env
80+
```
81+
82+
Μπορείτε να μπαίνετε και να βγαίνετε από το εικονικό σας περιβάλλον με τα scripts `activate` και `deactivate`:
83+
84+
```
85+
# Ενεργοποίηση του εικονικού περιβάλλοντος
86+
source .env/bin/activate
87+
88+
# Απενεργοποίηση του εικονικού περιβάλλοντος
89+
deactivate
90+
```
91+
92+
Μπορείτε να βεβαιωθείτε ότι το περιβάλλον είναι ενεργοποιημένο εκτελώντας την εντολή `which python`: αν δείχνει στο εικονικό περιβάλλον, τότε το έχετε ενεργοποιήσει επιτυχώς!
93+
94+
```
95+
which python
96+
```
97+
98+
```out
99+
/home/<user>/transformers-course/.env/bin/python
100+
```
101+
102+
### Εγκατάσταση εξαρτήσεων[[installing-dependencies]]
103+
104+
Όπως και στην προηγούμενη ενότητα σχετικά με τη χρήση των instances Google Colab, τώρα θα χρειαστεί να εγκαταστήσετε τα πακέτα που απαιτούνται για να συνεχίσετε. Και πάλι, μπορείτε να εγκαταστήσετε την έκδοση ανάπτυξης του 🤗 Transformers χρησιμοποιώντας τον διαχειριστή πακέτων `pip`:
105+
106+
```
107+
pip install "transformers[sentencepiece]"
108+
```
109+
110+
Είστε πλέον έτοιμοι για τη συνέχεια!

0 commit comments

Comments
 (0)