For udviklere

Arbejd med din hjemmeside i GitHub

Du kan koble din HiveWork-hjemmeside til et GitHub-arkiv, du selv ejer. Så ligger siden som filer, du kan rette i din editor, i en pull request eller med det AI-værktøj, du nu bruger — og ændringen kommer tilbage til hjemmesiden af sig selv.

Vejen går begge veje: retter du noget i HiveWork, bliver det til et commit hos dig. Retter du noget hos dig, bliver det til din kladde. Vil du hellere lade et AI-værktøj tale direkte med HiveWork uden et arkiv imellem, så er det MCP-vejledningen, du skal bruge i stedet.

Sådan kobler du den på

1. 1 · Find hjemmesiden i HiveWork

   Forbindelsen hører til ÉN hjemmeside og ikke til din konto — du kan have flere hjemmesider og vil sjældent have dem i det samme arkiv. Derfor står kortet «Din side på GitHub» på hjemmesidens egen forside i kontrolrummet under «Udvikler», som viser vej derhen.

2. 2 · Vælg arkivet hos GitHub

   Du sendes til GitHub, hvor du installerer HiveWorks app og vælger præcis de arkiver, den må røre. Vælger du flere, spørger vi bagefter hvilket ét der er hjemmesiden — vi gætter aldrig. Arkivet må ikke være helt tomt: der skal ligge mindst ét commit at bygge videre på, så lav en README først, hvis det er nyt.

3. 3 · Filerne bliver lagt op

   Med det samme skriver HiveWork din nuværende side ind på en gren, der hedder hivework. Den gren ER din kladde. Din hovedgren — main eller det, dit arkiv nu kalder den — er det, der er live.

Hvilke filer du får

Hjemmesiden er JSON, ikke HTML. Én fil pr. side, plus et kort over dem. Alt er skrevet med to mellemrums indrykning, så et git diff kan læses i en pull request.

• sider.json — kortet

  Sidernes rækkefølge, deres id, adresse, titel, hvilken der er forsiden, og hvilken fil hver af dem ligger i. Feltet filform står på 1; ændrer formatet sig en dag, kan en gammel fil kendes fra en ny i stedet for at blive læst forkert i stilhed. Mangler kortet, kan vi ikke læse noget — så er filerne under sider/ bare løse filer.

• sider/<navn>.json — indholdet

  Én fil pr. side med sidens blokke og dens rod-indstillinger (tema, brandfarve, menu, footer, logo). Filnavnet er kun en etikette til mennesker — det er kortet, der siger hvilken side filen ER. Derfor kan du omdøbe en fil, så længe kortet peger på det nye navn, og to sider kan aldrig komme til at dele en fil.

• Alt andet lader vi stå

  Vi læser kun sider.json og sider/*.json. Din README, din .github/-mappe, dine billeder og dine egne noter bliver liggende urørt — og vi sletter aldrig en fil, vi ikke selv har skrevet.

Hvilken vej ændringerne går

Det her er hele modellen, og den er ikke opfundet til lejligheden: kladde og udgivet ER allerede gren og hovedgren. «Udgiv» er merge'n.

• Du gemmer i HiveWork → et commit hos dig

  Hver gang du trykker «Gem kladde» — i editoren, i Byggebien eller gennem et AI-værktøj — skriver vi filerne til grenen hivework. Ét commit pr. gemning; der er ingen autogemning i HiveWork, så kadencen er din egen. Det sker, efter dit svar er sendt, så din gemning bliver ikke langsommere af, at du har et arkiv.

• Du pusher til hivework → din kladde bliver opdateret

  Besøgende ser intet. Siden er præcis som før, indtil der udgives. Det gælder også en merge, der lander i kladdegrenen: et push dertil er en kladde-rettelse, uanset hvordan det kom dertil.

• Du merger til hovedgrenen → siden bliver udgivet

  En merget pull request tæller som et push til den gren, den blev merget IND I — og det er dét, der gør «udgiv» til en merge. Udgivelsen går gennem nøjagtig samme port som knappen i panelet: pakkens sidegrænse gælder, der gemmes en sikkerhedskopi, og billedporten dømmer på samme måde. Et arkiv er ingen vej udenom.

• Arbejder du på en tredje gren, blander vi os ikke

  Push til en feature-gren rører hverken din kladde eller din side. Først når den lander i hivework eller i hovedgrenen, sker der noget.

Det kan GitHub-vejen ikke

Det her er den ærlige liste. Den står her, fordi et loft, man først opdager efter købet, er et løfte, der blev brudt.

• Give hjemmesiden dens første adresse

  En merge til hovedgrenen udgiver en side, der HAR været udgivet før. Den allerførste udgivelse vælger sidens underdomæne, og det navn tages fra alle andre kunder for altid; der findes ingen vej til at lave det om bagefter. Derfor gør du det selv, én gang, i HiveWork. Bagefter udgiver en merge lige så tit, du vil.

• Skrive din egen HTML, CSS eller JavaScript

  Filerne er JSON, og en side bygges af HiveWorks blokke. Der findes ingen kode-blok, ingen embed-blok og intet felt, du kan lægge rå HTML i — hverken herfra eller nogen anden vej. Lægger du en .html- eller .css-fil i arkivet, bliver den liggende, og vi ser den ikke.

• Vise dig, hvordan det kommer til at se ud

  Der er ingen forhåndsvisning i arkivet, og en pull request viser dig JSON, ikke en side. Vil du se resultatet, før du merger, så push til hivework og åbn kladden i HiveWorks editor — dér males siden, som den bliver.

• Skifte domæne eller SEO-opsætning

  Hjemmesidens domæne og dens SEO-titel og -beskrivelse ligger ikke i filerne. Det bliver i panelet.

Hvad der sker ved en konflikt

Der er to steder, den samme side kan blive rettet: hos os og hos dig. Bliver de uenige, overskriver vi aldrig det, et menneske har rørt siden sidst.

• Vi stopper og siger det

  Har du rettet kladden i HiveWork, siden arkivet og kladden sidst var enige, bliver dit push IKKE hentet hjem. Kortet på hjemmesiden viser i stedet, at kladden er ændret hos os, og at intet er overskrevet. Der findes ingen automatisk fletning: en halv side, sat sammen af to versioner, er værre end et nej.

• Sådan kommer du videre

  Gem én gang i HiveWork. Så skriver vi kladden ud i arkivet igen, og de to er enige. Rebase dit arbejde oven på det commit, og push. Vil du hellere beholde din egen udgave, kan du bare gemme den samme side i HiveWork først og derefter pushe.

• Vi svarer ikke på vores egne commits

  De commits, HiveWork selv skriver, bliver genkendt og sprunget over — ellers ville hver eneste gemning hente sig selv hjem igen i en rundkreds. Du kender dem i loggen på beskeden: HiveWork: kladden opdateret (3 sider).

Tallene

• 74 filer pr. skrivning ud til arkivet

  GitHub sætter en grænse for, hvor meget der må skrives i minuttet, og den gælder pr. installation. En hjemmeside, der er større end det, får et nej i stedet for et halvt commit — siden bliver hos os uanset hvad, den kan bare ikke også ligge i et arkiv.

• 2.000 sider i kortet, 2.100 filer i bunken

  Grænserne på vejen hjem. De ligger langt over, hvad en rigtig hjemmeside fylder, og de findes for at afvise en ødelagt eller opsvulmet fil, før den koster arbejde.

• Pakkens sidegrænse gælder stadig

  Udgivelsen spørger din pakke om antallet af sider, præcis som panelet gør. Ligger din hjemmeside allerede over loftet, spærres den ikke — du kan blive ved med at udgive den, du kan bare ikke lægge flere sider oveni uden en større pakke.

Vil du koble fra igen, gør du det på det samme kort i HiveWork. Filerne bliver liggende hos dig — vi rører dem ikke, og du kan forbinde igen i morgen.