Kako urediti datoteko in narediti commit iz wikija
Okoliščina
Popraviti je treba eno datoteko v priklopljenem repozitoriju, na primer tipkarsko napako v datoteki README ali vrednost v nastavitveni datoteki – in to brez odjemalca git in brez lokalne kopije.
Pregled rešitve
Brskalnik repozitorija ponuja urejevalnik za posamezne datoteke. Zanj potrebujete pravico pisanja (stopnja ACL 8) na imenskem prostoru priklopa; pri nižji stopnji ACL gumba ni.
Commit velja za različico datoteke, ki jo je urejevalnik naložil. Če se je datoteka medtem spremenila, strežnik commit zavrne, namesto da bi tujo spremembo tiho prepisal.
Pri Azure DevOps commit odda storitveni račun. Vrednost pushedBy je zato storitveni račun, avtor commita pa ostane uporabnik wikija; ime in e-poštni naslov se prevzameta iz njegovega profila.
Postopek
- Odprite repozitorij. Najkrajša pot vodi prek seznama Repozitoriji ali prek strani z repozitoriji vašega projekta; enako dobro deluje stran wikija z oznako
{{wk:adogit>…}}. Celotno pot od začetka opisuje vadnica. - V glavi preverite, na kateri veji ste – tja bo šel commit. V delovnem prostoru drugo vejo izberete v izbirnem polju Veja.
- Poiščite datoteko v drevesu. Če imate pravico pisanja, je ob njej gumb Uredi.
- Izberite Uredi. Odpre se urejevalnik s poljema Vsebina datoteke in Sporočilo commita.
- Uredite vsebino in vnesite sporočilo commita.
- Izberite Commit. Sprememba gre neposredno na vejo, ki jo prikazuje glava brskalnika.
Strežnik odgovori z enim od petih stanj.
| Stanje | Pomen | Kaj storite |
|---|---|---|
ok | commit je uveljavljen | nič; drevo prikaže novo stanje |
denied | na imenskem prostoru priklopa nimate pravice pisanja | zaprosite za raven vidnosti priklopa, ki vam daje pravico pisanja |
conflict | datoteka se je med urejanjem spremenila | zaprite urejevalnik, znova odprite datoteko in spremembo ponovite |
rejected | pot, veja ali vsebina ni prestala preverjanja | popravite pot ali vejo |
error | prijava, prenos ali nepričakovan odgovor strežnika | glejte Diagnostika |
Nova veja ali oznaka
Kadar sprememba ne sodi na prikazano vejo, ustvarite novo. V glavi brskalnika je gumb Nova veja/oznaka, ki ga vidijo samo uporabniki s pravico pisanja.
- Izberite Nova veja/oznaka.
- Izberite vrsto (veja ali oznaka), vnesite novo ime in potrdite.
- Nova veja ali oznaka nastane na vrhu veje, na katero je brskalnik trenutno vezan.
Obstoječe ime se ne prepiše; strežnik odgovori s stanjem conflict.
Na novo vejo preklopite v delovnem prostoru z izbirnim poljem Veja ali prek zavihka Veje. Na vgrajeni strani te izbire ni; tam ime vnesete kot četrto polje oznake:
{{wk:adogit>wvds:DokuWiki-Plugins:wkdoadogit:users/janez/popravek}}
Opombe
- Vgrajeni in samostojni pogled se razlikujeta. Delovni prostor (
do=wkdoadogit_repo) ima zavihke Koda, Commiti, Veje in Oznake ter izbiro repozitorija in veje. Vgrajena oznaka na strani wikija izbire nima: prikaže stanje, ki ga navaja, njena zavihka Veje in Oznake pa vodita v delovni prostor. - Datoteke, ki še ne obstaja, ne ustvarite tukaj. Za to je ukaz Nova datoteka; glejte Kako ustvariti novo datoteko v brskalniku. Razlika je v zaščiti: urejevalnik preveri naloženo različico, ustvarjanje pa preveri, da je pot prosta.
- Urejevalnik obdela eno datoteko naenkrat. Za več datotek v enem commitu uporabite
git clone; glejte Kako klonirati priklopljen repozitorij. - Osebni žeton tu ni potreben. Znotraj wikija odločajo pravice DokuWikija; žeton je namenjen zunanjim odjemalcem git.
- Vsak klic se znova preveri. Urejanje in commit potekata prek klicev, ki pravico preverijo na strežniku; gumb je le udobje, ne pooblastilo.
- Binarnih in prevelikih datotek urejevalnik ne odpre. Namesto vsebine vrne stanje.
- Delnega uspeha ni. Če commit ne uspe, se v repozitoriju ne spremeni nič.
Sorodne teme
- Vadnica: mapa in datoteka – odpiranje datoteke v drevesu
- Kako ustvariti novo datoteko v brskalniku – ustvarjanje datoteke, ki še ne obstaja
- Kako klonirati priklopljen repozitorij – več datotek v enem commitu, prek odjemalca git
- Koncepti: raven vidnosti – katera raven vidnosti prinese pravico pisanja
- Diagnostika – simptom, vzrok in rešitev