Integracija

GitHub

Ako je sajt statički i živi u repou, članak je fajl. Inowara upisuje markdown i slike u vaš repo, a dalje sve radi vaš postojeći build.

Šta treba od vas

  • Repo u obliku vlasnik/ime i grana na koju se upisuje.
  • Pristup za pisanje sadržaja u tom repou.
  • Putanje za tekstove i slike, ako nisu podrazumevane.

Šta stiže na odredište

  • Markdown fajl sa frontmatter-om (naslov, meta naslov, opis, datum, slika, kategorija)
  • Slike članka u folder slika u repou
  • Zaseban folder za landing stranice, ako ih koristite

Kako radi

Tok objave, korak po korak

01

Slike pa tekst

Prvo idu slike, pa markdown. Redosled je namerno takav: commit markdown fajla pokreće vaš build, pa slike moraju već biti gore da prvi build ne bi imao polomljene slike.

02

Frontmatter po vašem šablonu

Naslov, opis, datum, slika, kategorija i autor idu u frontmatter. Telo ostaje HTML unutar markdown-a, što svaki generator statičkih sajtova ume da renderuje.

03

Promena slug-a ne ostavlja duplikat

Ako se slug promeni, stari fajl se briše u istom potezu, pa na sajtu ne ostaju dve verzije istog teksta.

Granice

Šta ova integracija ne radi

Stoji na stranici namerno. Bolje da se vidi sada nego posle prve objave.

  • Ne diramo ništa osim foldera za sadržaj i slike. Build, podešavanja i ostatak repoa su vaši.
  • Ako build padne zbog vašeg šablona, to vidite u GitHub Actions kao i za svaki drugi commit.

FAQ

Česta pitanja — GitHub

Radi li sa Astro, Hugo i Next.js?

Da, sa svim generatorima koji čitaju markdown iz repoa. Frontmatter polja se podese prema vašem šablonu.

Da li vidim izmene kao obične commit-e?

Da. Svaka objava je commit sa jasnom porukom, pa istorija članaka stoji u git-u kao i sve ostalo.

Sledeći korak

Spremni za organski rast?

Povežite bilo koji sajt — usluge, webshop ili blog. Plan se pravi sam, tekstovi se pišu i objavljuju po rasporedu, a prvi članak je besplatan.