Zum Inhalt springen

Erste Schritte

Ein Projekt in Ikasu ist eine Website. Du kannst auf drei Arten anfangen:

  • Mit einer Vorlage: eine komplette, erfundene Website zum Ausprobieren.
  • Mit deinem eigenen Repository: die Seite, die du schon auf GitHub, GitLab oder einem anderen Git-Host hast.
  • Mit hochgeladenen Dateien: ein Ordner, einzelne Dateien oder eine ZIP, zum Beispiel eine Seite, die du mit einem anderen Werkzeug gebaut hast.

Egal wie du startest: Bearbeiten und Vorschau gehen sofort. Ein eigenes Repository brauchst du erst, wenn du Änderungen shippen willst, und verknüpfen kannst du es auch später.

Hast du noch keine Projekte, zeigt die Startseite die Vorlagen direkt unter Starte dein erstes Projekt. Sonst klickst du auf Neues Projekt und wählst Mit einer Vorlage starten.

Such dir eine Karte aus und klick auf Diese Vorlage verwenden. Ikasu legt eine eigene Kopie dieser Seite für dich an und öffnet sie. Veröffentlicht wird nichts: Die Kopie bleibt in Ikasu, bis du dein eigenes Repository verknüpfst.

Unter den Karten nimmt Oder mit einem anderen öffentlichen Repo starten die Adresse eines beliebigen öffentlichen Repositorys (beginnend mit https://) als Ausgangspunkt. Es wird kopiert, nicht verbunden. Willst du an deiner eigenen Seite arbeiten, nimm stattdessen Eigenes Repo verwenden.

Klick auf Neues Projekt, wähl Eigenes Repo verwenden und gib dem Projekt einen Namen.

  1. Klick auf Mit GitHub verbinden oder Mit GitLab verbinden.
  2. Bestätige einmal bei GitHub oder GitLab.
  3. Zurück in Ikasu wählst du das Repository aus oder legst ein neues, leeres an. Dann klickst du auf Dieses Repo verknüpfen oder Anlegen und verknüpfen.

Ikasu hinterlegt dabei selbst einen Deploy-Key in genau diesem einen Repository. Danach hat Ikasu keinen Zugriff mehr auf dein GitHub- oder GitLab-Konto: Der Deploy-Key ist der einzige Weg ins Repository.

Trag unter Repo-URL die SSH-Adresse des Repositorys ein, zum Beispiel git@git.example.com:du/seite.git, und klick auf Projekt erstellen. Ikasu zeigt dir dann einen öffentlichen Schlüssel.

  1. Öffne bei deinem Git-Host die Einstellungen des Repositorys (nicht die deines persönlichen Kontos) und such den Bereich Deploy keys.
  2. Füg dort den Schlüssel aus Ikasu ein und schalte Schreibzugriff ein. Auf GitHub heißt das „Allow write access“, auf GitLab „Grant write permissions to this key“. Ohne Schreibzugriff kann Ikasu deine Seite lesen, aber keine Änderungen zurückschicken.
  3. Zurück in Ikasu klickst du auf Überprüfen. Steht dort Schlüssel bestätigt, ist alles eingerichtet.

Unter dem Schlüssel zeigt Wie füge ich das als Deploy-Key hinzu? diese Schritte für GitHub, GitLab und andere Hosts, mit einem Link auf die richtige Einstellungsseite. Geht es gerade nicht, klick auf Mache ich später: Der Schlüssel bleibt in den Projekteinstellungen. Ein öffentliches Repository kann Ikasu auch ohne Schlüssel lesen. Du kannst also gleich loslegen und den Schlüssel vor dem ersten Ship eintragen.

Klick auf Neues Projekt und wähl Dateien hochladen. Zieh einen Ordner, Dateien oder eine ZIP in das Feld, oder nimm Dateien auswählen bzw. Ordner auswählen. Es geht beides: der Quellcode einer Seite oder eine fertig gebaute Seite.

Eine einzelne ZIP, etwa eine heruntergeladene Seite, wird entpackt. Soll die ZIP selbst eine Datei auf deiner Seite sein, klick auf Als ZIP behalten. Hochladen kannst du bis zu 200 MB.

Wie bei einer Vorlage ist der Upload deine eigene Kopie in Ikasu, bis du ein Repository verknüpfst.

Vor der ersten Sitzung muss Ikasu wissen, wie deine Seite gebaut wird:

  • Installationsbefehl und Build-Befehl, je einer pro Zeile.
  • Build-Ausgabeverzeichnis: der Ordner, in den der Build die fertige Seite schreibt, zum Beispiel dist. Eine Seite ohne Build nimmt ..

Bei einer Vorlage aus den Karten trägt Ikasu das selbst ein, bei einem Upload, sobald es die Seite erkennt. Bei deinem eigenen oder einem anderen öffentlichen Repository klickst du auf Aus Repo erkennen und prüfst, was gefunden wurde. Erkennt Ikasu das Framework nicht, frag am besten die Person, die die Seite gebaut hat, nach den Befehlen.

Dann klickst du auf Sitzung starten. Ikasu baut die Seite und zeigt die Vorschau.

Ein Projekt aus einer Vorlage oder einem Upload funktioniert auch ohne Repository: Du kannst es bearbeiten, in der Vorschau ansehen und seine Dateien herunterladen. Um Änderungen zu shippen, verknüpfst du in den Projekteinstellungen unter Repository ein Repository, genauso wie oben beschrieben.

Das Repository muss leer sein oder nur Startdateien enthalten, etwa eine README, eine Lizenz oder eine .gitignore. Ikasu schreibt deine Seite als ersten Commit hinein und lässt diese Startdateien stehen. Ein Repository, in dem schon eine andere Seite liegt, wird abgelehnt.