Приступ ризници

Овде су упутства за преводиоце, за приступ  гитовој (Git) ризници у којој се чува превод. Под приступом ризници овде подразумевамо читање и писање „изворног кода“ ризнице, односно датотека које је чине, а не преглед садржаја кроз веб сучеље.

Ако само желите да разгледате, ово упутство није за вас. Вероватно ће вам у том случају бити занимљивије да погледате  превод на веб сајту.

Ако желите да видите како превод детаљно изгледа, и ако разматрате да ли да се прикључите превођењу, онда наставите са читањем.

Анонимни приступ

Најбржи начин да погледате изворни код превода јесте помоћу анонимног приступа. Приступ је анониман јер током пријема датотека са сервера ни у ком тренутку не шаљете податке који би могли да утврде ваш идентитет. Предност анонимног приступа је у томе што можете да га брзо подесите и остварите без ичије помоћи. Мана је што можете само да читате, а не и да директно мењате садржај превода.

Анонимни приступ ризници могућ је помоћу програма за управљањем верзија који се зове „гит“. Уколико није инсталиран на вашем рачунару, биће вам неопходно да га инсталирате како бисте могли да испратите примере који следе. Ово упутство неће улазити у детаље инсталације програма, за то ћете морати да потражите упутство за инсталацију за оперативни систем ког користите на рачуару.

Ризници се анонимно приступа кроз гитов протокол помоћу адресе: git://cowfarm.no-ip.org:9003/mozilla.git. Команда којом се ризница клонира на Ваш рачунар је:

git clone git://cowfarm.no-ip.org:9003/mozilla.git

Ако желите да проследите измене које сте направили помоћу анонимног приступа ризници, можете да користите систем закрпа које гит подржава. Направите разлику између ваше измене и складишта (изворно на енглеском ово се зове „diff“), добијени текст сачувајте у текстуалну датотеку и датотеку пошаљите електрнском поштом.

Закрпе можете да шаљете на адресу Нашег писма, или на адресе других преводилаца како Вам год воља; једино што треба да се потрудите да закрпе и стигну довде.

Приступ за писање (у грубим цртама)

Они који су раније отворили налог имају и могућност да директно прегурају измене у складиште. Свако ко жели може да добије приступ за писање, на следећи начин. Детаљи сваког корака дати су у тексту испод.

  1. Препорука: Потребно је да сте познати преводилац програма на српски језик, или да имате препоруку неког од познатих преводилаца на српски.
  2. Слање јавног кључа: Пошаљите свој јавни кључ на адресу: nasepismo@…. Ако не знате како се праве јавни кључеви , прочитајте  упутство. Кључ је потребан за једнозначно препознавање корисника.
  3. Подешавање приступа: Да наместите подразумевани порт за приступ рачунару cowfarm на 9001 (видите испод о томе)
  4. Одобрење приступа: Сачекајте да вас администратор ризнице обавести да Вам је приступ одобрен
  5. Пробни рад: Испробајте да ли приступ ради на очекивани начин на пробној ризници (детаљи су дати у тексту испод)

Приступ за писање (детаљно)

Препорука

Да бисте постали преводилац Мозиле, неопходно је најпре да Вам остали учесници у пројекту верују да заиста желите да урадите нешто корисно.

Ако сте један од старијих или познатијих преводилаца, то обично значи да већ знамо за вас, с обзиром да се као преводиоци појављују увек мање-више исти људи. У том случају све што треба јесте да се лично јавите на горе дату адресу и приложите шта се тражи.

У мање вероватном случају да вас не знамо, нађите неког од преводилаца и потражите да вас препоручи. Даље се све одвија на очекивани начин.

Слање јавног кључа

Јавни кључ је потребан да бисмо знали да баш ви приступате ризници, и да бисмо знали која права приступа су вам додељена. Слање јавног кључа такође значи да нећете морати да памтите и уписујете лозинке сваки пут када приступате ризници.

Све ово важи под условом да добро чувате и ником не дајете свој приватни кључ.

Подешавање приступа

Ризници се приступа помоћу програма који се зове „гит“, тако што се његове поруке тунелују кроз сигурносни протокол ССХ (SSH). Како би тунеловање исправно радило, неопходно је да подесите свој клијент за ССХ да зна адресу сервера на коју треба да се обрати.

Име сервера је cowfarm.no-ip.org, а број порта је 9001. Испод су наведена подешавања за оперативне системе за које знамо како се то ради. Ако знате нешто што није наведено, пишите на горе наведену адресу и тражите да се дода.

Линукс

У датотеку: ~/.ssh/config додати:

Host cowfarm.no-ip.org
Port 9001

Одобрење приступа

Сачекајте неко време да вам администратор подеси права приступа и обавести да је све спремно за пробу.

Пробни рад

Администратор ће вам дозволити писање у ризницу са преводом, али и писање у пробну ризницу. Пробну ризницу користите да бисте се навикли на радни ток и да бисте видели како у пракси изгледа радити са гитом.

Пробна ризница се помоћу програма гит види на адреси: git@cowfarm.no-ip.org:test.git. Слободно је клонирајте, у њој мењајте штагод вам воља и то слободно шаљите назад докле год се не навикнете на радни ток.

Испод је дат факсимил једне сесије у пробној ризници. Показани су клонирање, измена у коду, чување у локалу и слање у главну ризницу. Препоручујемо да поновите ова пример код себе и сами испробате како све ради, пре него што почнете да радите на ризници за преводе Мозилиних алата.

fmil@cow:~/personal/projs$ git clone git@cowfarm.no-ip.org:test.git
Initialized empty Git repository in /home/fmil/personal/projs/test/.git/
remote: Counting objects: 4, done.
remote: Compressing objects: 100% (3/3), done.
remote: Total 4 (delta 0), remote: reused 0 (delta 0)
Receiving objects: 100% (4/4), done.
fmil@cow:~/personal/projs$ cd test
fmil@cow:~/personal/projs/test$ ls
README  filip.txt
fmil@cow:~/personal/projs/test$ echo hello_world > hello_world.txt
fmil@cow:~/personal/projs/test$ git add .
fmil@cow:~/personal/projs/test$ git commit -a -m "Added Hello World"
Created commit 167a8fd: Added Hello World
 1 files changed, 1 insertions(+), 0 deletions(-)
 create mode 100644 hello_world.txt
fmil@cow:~/personal/projs/test$ git push origin
Counting objects: 4, done.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 347 bytes, done.
Total 3 (delta 0), reused 0 (delta 0)
To git@cowfarm.no-ip.org:test.git
   8c8cf37..167a8fd  master -> master
fmil@cow:~/personal/projs/test$ 

Подсетник за команде

Ово је списак кључних команди које ћете користити у раду.

git clone git@cowfarm.no-ip.org:mozilla.git — клонирање ризнице са удаљеног рачунара (када почнете са радом)
git pull git@cowfarm.no-ip.org:mozilla.git — синхронизација измена са удаљеног рачунара (током рада)
git push git@cowfarm.no-ip.org:mozilla.git — слање измена на удаљени рачунар

За остале мале и велике тајне рада са гитом:  упутство у шаке.