Lägga till ett språk¶

Förberedelser¶

Om det språk du vill översätta inte redan har startats av någon annan och du vill skapa en uppsättning nya filer för det önskade språket, till exempel ’fr’ (franska), måste du först använda den miljö du har skapat, enligt anvisningarna i Getting Started, i synnerhet avsnitten Installera beroenden och Uppbyggnad av manualen.

Detta kommer att ge dig en grundmiljö för:

Skapa en ny uppsättning översättningsspråk från engelsk källa.
Utför kommandot make för att omvandla översatta texter i po-filer till html-filer för lokal testning.
Uppdatera ändringar i engelska texter som har lagts till av andra bidragsgivare.

Nedanstående exempel visar processen för att skapa en ny uppsättning filer för franska, språkkod fr, på Linux-plattformen. Andra plattformar kan variera något men bör i huvudsak vara desamma.

skapa ett Blender-ID <https://id.blender.org/register/>`__ om du inte redan har gjort det.
Logga in på projects.blender.org och Create an Issue och begär commit access för att kunna överföra ändringar till översättningsteamets centrala arkiv.
Öppna en instans av en konsolapplikation.
Ändra den aktuella arbetskatalogen till katalogen för blender-manual, där instansen av Makefile finns.

Försök med Make Process för att skapa HTML-filer på engelska¶

Se till att den tidigare instansen av katalogen build tas bort, om den finns:
```
make clean
```
Konvertera alla rst-filer till pot-översättningsfiler:
```
make gettext
```
Skapa html-filer:
```
make html
```
Efter detta kan du faktiskt se de skapade html-filerna lokalt genom att öppna filen blender-manual/build/html/index.html.

Skapa en språkpost i HTML-menyn¶

Skapa en post för språket i html-menyn genom att öppna filen ./build_files/theme/js/version_switch.js (förutsatt att du befinner dig i underkatalogen blender-manual).
Hitta tabellen för språken i var all_langs = {..};.
Lägg till posten: ”fr”: ”Français”,, (”fr”: ”Français”). (Observera Unicode-tecknen.)

Överför den uppdaterade filen:

git add ./build_files/theme/js/version_switch.js
git commit -m "HTML: Add French to language menu"

Lägg till dina ändringar i upstream-förrådet:
```
git push
```

Generering av filuppsättningen för målspråket¶

Kolla in det aktuella översättningsarkivet med hjälp av kommandot:
```
git clone https://projects.blender.org/blender/blender-manual-translations.git locale
```
Detta kommer att ladda ner alla språkuppsättningar som finns i förrådet till katalogen locale på din hårddisk. Du kan gå till katalogen locale för att se den dolda underkatalogen .git i den, tillsammans med kataloger med språk. Du måste lägga till din egen uppsättning filer för det språk du försöker översätta till.
Från katalogen blender-manual för att generera en uppsättning filer för fr språk:
```
make update_po
```
Dessa filer är fortfarande endast på engelska, med alla msgstr-poster tomma.

Skicka en ny uppsättning filer till det centrala förrådet:

cd locale
git add fr
git commit -m "Initial commit language set of files for French"

Tips

Vi rekommenderar att du skapar två miljövariabler för dessa kataloger, i .bashrc för att göra det mer praktiskt att ändra eller skripta batch-/shellkommandon för översättningsprocessen och granskning av resultat:
```
export BLENDER_MAN_EN=$HOME/<directory to make file directory above>/blender-manual
export BLENDER_MAN_FR=$BLENDER_MAN_EN/locale
```
Nygenererade filer kommer att innehålla några platshållare för författare och revisionsdatum etc. Om du tycker att jobbet med att ersätta dem är repetitivt, använd skriptet change_placeholders.sh i underkatalogen ~/blender-manual/tools/util_maintenance, gör en kopia av det till din lokala bin-katalog och ersätt alla värden som nämns i filen med dina specifika uppgifter, sedan efter varje ändring av en fil, gör du följande kommandon för att uppdatera filen med dina personliga uppgifter, revisionsdatum och tid, plus generera html-filerna för ditt språk, som du kan visa med din webbläsare:
```
$HOME/bin/change_placeholders.sh $BLENDER_MAN_FR
make -d --trace -w -B -e SPHINXOPTS="-D language='fr'" 2>&1
```