Kako urediti datoteku i napraviti commit iz wikija
Okolnost
Treba ispraviti jednu datoteku u montiranom repozitoriju, primjerice tipfeler u datoteci README ili vrijednost u konfiguracijskoj datoteci, i to bez git klijenta i bez lokalne kopije.
Pregled rješenja
Preglednik repozitorija nudi uređivač pojedine datoteke. Za njega je potrebno pravo pisanja (razina 8) na imenskom prostoru montiranja; s nižom razinom gumba nema.
Commit se primjenjuje na inačicu datoteke koju je uređivač učitao. Ako se datoteka u međuvremenu promijenila, poslužitelj commit odbija umjesto da tiho pregazi tuđu promjenu.
Prema Azure DevOpsu commit predaje servisni račun. Vrijednost pushedBy ondje je zato servisni račun, a autor commita ostaje korisnik wikija; ime i adresa e-pošte preuzimaju se iz njegova profila.
Izvedba
- Otvorite stranicu s oznakom
{{wk:adogit>…}}, primjerice stranicu repos svog projekta. Cijeli put od početka opisuje vodič. - Pronađite datoteku u stablu. Ako imate pravo pisanja, uz nju stoji gumb Uredi.
- Odaberite Uredi. Otvara se uređivač s poljima Sadržaj datoteke i Poruka commita.
- Uredite sadržaj i unesite poruku commita.
- Odaberite Commit. Promjena ide izravno na granu koju prikazuje zaglavlje preglednika.
Poslužitelj odgovara jednim od pet stanja.
| Stanje | Značenje | Što učiniti |
|---|---|---|
ok | commit je primijenjen | ništa; stablo prikazuje novo stanje |
denied | na imenskom prostoru montiranja nemate pravo pisanja | zatražite višu razinu montiranja |
conflict | datoteka se promijenila tijekom uređivanja | zatvorite uređivač, otvorite datoteku ponovno i ponovite promjenu |
rejected | putanja, grana ili sadržaj nisu prošli provjeru | ispravite putanju ili granu |
error | prijava, prijenos ili neočekivan odgovor poslužitelja | vidi dijagnostiku |
Nova grana ili oznaka
Kad promjena ne pripada na prikazanu granu, stvorite novu. U zaglavlju preglednika stoji gumb Nova grana/oznaka, vidljiv samo uz pravo pisanja.
- Odaberite Nova grana/oznaka.
- Odaberite vrstu (grana ili oznaka tag), unesite novo ime i potvrdite.
- Nova grana ili oznaka nastaje na vrhu grane uz koju je preglednik pričvršćen.
Postojeće se ime ne prepisuje; poslužitelj odgovara stanjem conflict.
Da biste novu granu i vidjeli, unesite njezino ime kao četvrto polje oznake na stranici:
{{wk:adogit>wvds:DokuWiki-Plugins:wkdoadogit:users/ihorvat/ispravak}}
Napomene
- Kartice Branches i Tags u zaglavlju su neaktivne. Prikazanu granu birate u oznaci na stranici, a ne u sučelju. Novu je granu dakle moguće stvoriti, ali prebaciti se na nju samo uređivanjem stranice.
- Uređivač obrađuje jednu datoteku odjednom. Za više datoteka u jednom commitu poslužite se naredbom
git clone; vidi kloniranje repozitorija. - Osobni token ovdje nije potreban. Unutar wikija odlučuju prava DokuWikija, a token je namijenjen vanjskim git klijentima.
- Svaki se poziv provjerava iznova. Uređivanje i commit teku pozivima koji pravo provjeravaju na poslužitelju; gumb je udobnost, a ne dopuštenje.
- Binarne i prevelike datoteke uređivač ne otvara. Umjesto sadržaja vraća stanje.
- Djelomičnog uspjeha nema. Ne uspije li commit, u repozitoriju se nije promijenilo ništa.
Povezane teme
- Vodič: mapa i datoteka – otvaranje datoteke u stablu
- Kako klonirati montirani repozitorij – više datoteka u jednom commitu, preko git klijenta
- Tehnička referenca: razina vidljivosti – koja razina donosi pravo pisanja
- Dijagnostika – simptom, uzrok i rješenje