Elabora Dokumentazioa

Dokumentu hau Sphinx-en Parrot aplikazioa dokumentatzeko egitean edoitu aurkezten da. Bai, lan egingo dugu: virtual environment (venv) ezartzen, pip

Oharra

Zerbitzaria ez da abian dagoenik erabiltzaileentzat.

Itxa ezagutzeko argibideak

Klonu irteera: Lehenengo, klonatu irteera honela den komandoa erabaten:

git clone --recursive https://spacecruft.org/deepcrayon/parrot-wtf

Sailketaren direktorioan aldatu: Klonatze ondoren, joan proiektaren zuzenbideren arabera, ekintza:
```
cd parrot-wtf
```

«Instalatu python3-venv (apt): Hau beharrezkoa da virtual aginte bat sortzeko. Exekutatu komentario hau:»

sudo apt update
sudo apt install docutils gettext python3-pip python3-venv
# To build PDFs with LaTeX
sudo apt install texlive-full xindy

Jarrau bidezko inguruko entitatea (venv) egin: Zure proiektuaren gurekin etxekin joan eta exekutatu:
```
python3 -m venv venv
```
Jartzean itxi virtual gailuaren: Pacoteetak instalatzen aurretik, jartzi virtual gailua exekutatzen:
```
source venv/bin/activate
```
Erabili requirements.txt-a: Proiektuaren beharrezkoak zerrenda da. Pip-ekin instala ezazu: exekutatu hemen:
```
pip install -r requirements.txt
```

Submoduluen instala: Instala beste Parrot repositorioaren submoduluetako dokumentazioa barneratzeko.

pip install -r datasets/requirements.txt
pip install -r extension/requirements.txt
pip install -r ide/requirements.txt
pip install -r models/requirements.txt

pip install -e datasets

Dokumentazioa eraiki zen

Garbitu existitzen dagoen elkarketa: Dokumentazioa aurre egite baduzu, garbitu existitzen zegoak komando hau exekutatzeari:
```
make clean
```
Erakutsi dokumentazioaren HTML bertsioa: Parrot aplikazioak Sphinx-a erabiltzen diren dokumentaziorik sortzeko. HTML bertsioa sortzeko, ekinez:
```
make html
```
Other useful ``make`` commands: There are other make commands available in the Makefile. You can view them by running:
```
make help
```

Aurrera web zerbitzariarekin

Ondoren dokumentazioa egitean, HTML fitxategiak build/html direktorion banan dituzu. Guk sortu beharreko fitxategiak zure web zerbitzaria igotzeko.

Editu .env zerbitzaren URLa ezartzeko, honako bezala:

URL="parrot.wtf:/var/www/html/parrot-wtf/"

Ekintza hau exekutatu rsync zerbitzarian jarraitzeko:

./scripts/rsync-parrot-wtf

Hau HTML fitxategiak build/html-tik gora mugitzeko jarriko dira zure lehen-servera.

Oharra

Parrotaren dokumentazioa ingelesan egina da eta AI maшин аузаilarien bat ditu beste hizkuntetara.