Eine Dokumentationswebsite erstellen

dokumentation gibt es in vielen formen sie haben möglicherweise bereits einige ressourcen oder müssen von grund auf neu beginnen lassen sie uns durchgehen, wie sie inhalte mit archbee hinzufügen können i n archbee schreiben sobald sie ein neues dokument erstellt haben, können sie beginnen, inhalte hinzuzufügen, entweder mit markdown kurzbefehlen oder einem der 30+ benutzerdefinierten blöcke die benutzerdefinierten blöcke helfen ihnen, den inhalt nach bedarf zu formatieren um sie zu öffnen, tippen sie einen schrägstrich / im editor und gehen sie die optionen durch die blöcke sind gruppiert unter grundlegend , medien , dev , einbetten , und inhaltswiederverwendung wenn sie beispielsweise dynamisch auf andere dokumente verlinken möchten, tippen sie @ und den dokumenttitel dies stellt eine verbindung zur dokument id her wenn sie den titel oder die position des dokuments ändern, wird der link immer darauf verweisen ein weiteres beispiel ist das aufrufen des blocknamens drücken sie / und geben sie den namen des blocks ein, z b /verticalsplit , wodurch der gewünschte block herausgefiltert wird die dritte option besteht darin, klammern und den namen des blocks zu verwenden – z b (api) – dies fügt den api endpoint block hinzu copy paste die altbewährten copy paste brüder aber warum darauf eingehen? da der editor von archbee markdown unterstützt, kann es sein, dass sie beim einfügen in diesem format die folgende meldung erhalten wir haben markdown inhalt in ihrer zwischenablage erkannt versuchen sie, markdown einzufügen? wenn sie auf die schaltfläche abbrechen klicken, wird der inhalt nicht gerendert, und wenn sie im dialogfeld auf ok klicken, konvertieren wir das markdown in archbee blöcke so haben sie ein codebeispiel, das in archbee als code editor block gerendert wird markdown oder word dateien importieren copy pasting funktioniert einwandfrei, aber wenn sie markdown oder word dateien haben, warum diese nicht in einen space importieren? bevor sie inhalte importieren, stellen sie sicher, dass sie auf den space klicken, in den sie die dateien importieren möchten sie haben gerade auf den dateityp geklickt, den sie besitzen, und dadurch minuten an copy paste arbeit gespart openapi/swagger dateien oder postman collections importieren wenn es um die dokumentation von apis geht, haben sie mehrere optionen nehmen wir an, sie verwenden den openapi standard (früher swagger) dies ermöglicht einen einfachen import und sync der dateien sobald der inhalt in archbee importiert wurde, wird er in einem 3 spalten layout dargestellt, das eine leicht zu verwaltende dokumentation ermöglicht ein github repository synchronisieren es kommt vor, dass die dokumentation in einem github repository geschrieben wird sie können weiterhin in github schreiben und das repository mit einem archbee space synchronisieren der vorteil besteht darin, dass sie diesen space auf ihrer benutzerdefinierten domain veröffentlichen und weitere spaces mit zusätzlichen informationen wie api referenzen hinzufügen können die benutzerdefinierte domain und zugriffskontrolle einrichten bevor sie mit den inhalten beginnen, machen sie einen kleinen schritt, der später einen unterschied macht richten sie ihre subdomain ein, um zugriff auf die preview und produktionsumgebungen zu haben gehen sie zur dokumentationsseite https //docs archbee com/hosting spaces on a custom domain und folgen sie den schritten, um ihre benutzerdefinierte domain hinzuzufügen unter dem tab allgemein stehen mehrere optionen zur verfügung – sie können durch suchmaschinen indexierbar (falls öffentlich) in den selben space einstellungen deaktivieren oft möchten sie dies aktiviert lassen, damit nutzer ihre seite in den suchergebnissen finden sie können die option public access control öffnen und eine der fünf optionen für mehr kontrolle auswählen keine tut genau das, was der name sagt, und bewahrt ihre einstellungen für den öffentlichen space passwort legen sie ein space passwort fest jeder mit dem link und passwort kann den inhalt lesen gastkonten erstellen sie gastkonten jeder mit dem link und einem gastkonto kann den inhalt lesen gastkonten werden in archbee nicht als seats berechnet magischer link sie geben bestimmte e mails ein oder setzen ganze domänennamen auf die allowlist, und nutzer authentifizieren sich über einen link, den wir an ihre e mail adresse senden; jwt authentifizierung siehe die dokumentseite https //docs archbee io/authentication options? hstc=59513074 901e138137246d5bde4ccdbd22c4c426 1657529807386 1664186053341 1664199496535 118& hssc=59513074 7 1664199496535& hsfp=13091307 zur einrichtung dies ist eine perfekte option, wenn sie nicht möchten, dass sich nutzer jedes mal anmelden müssen starten sie mit dem erstellen von seiten bevor sie dokumentation schreiben, überlegen sie sich die hauptthemen, die sie abdecken werden dieses mal können stift und papier helfen, die struktur zu skizzieren erstellen sie als nächstes ein dokument, konvertieren sie es in eine kategorie und geben sie ihm einen namen sobald sie diese haben, können sie dokumente unter jeder kategorie hinzufügen beginnen sie mit einem dokument, das die hauptaspekte einführt, die ein nutzer auf der dokumentationsseite finden wird es muss nicht kompliziert sein; so haben wir es in unserem benutzer & dev handbuch gemacht marken sie ihre dokumentations website und passen sie sie an im tab darstellung finden sie die branding optionen wie akzentfarbe , logo , und favicon , zusammen mit weiteren optionen für die vorlage erstellen sie ein navigationsmenü mit multiprodukt oder produktversionen je nach art der produkte oder dienstleistungen möchten sie möglicherweise unterschiedliche space url pfade haben sie können einen space als primäre dokumentation haben und verschiedene spaces für andere produkte oder sogar deren versionen erstellen es gibt eine abkürzung! sie können einen klon eines beliebigen space erstellen, wenn die änderungen inkrementell sind dies hilft ihnen, die struktur beizubehalten und die änderungen für die neue version vorzunehmen wenn versionierung und multiprodukt also etwas ist, das sie benötigen, verwenden sie unterschiedliche spaces und ergänzen sie diese mit dem entsprechenden pfad oder einer benutzerdefinierten domain gehen sie zu space links https //docs archbee com/space links und beginnen sie mit dem aufbau ihrer navigation erstellen sie eine landingpage das hauptziel der homepage besteht darin, dem besucher zu helfen, zur nächsten seite zu gelangen beim erstellen einer landingpage für ihre dokumentations website müssen nicht dieselben praktiken wie für eine präsentations website berücksichtigt werden die erste dokumentseite ist wichtig, um ihr produkt oder ihre dienstleistung den nutzern vorzustellen daher ist es sinnvoll, sie kurz zu halten und erwartungen zu setzen sie können die funktion benutzerdefinierte landingpage https //docs archbee io/custom landing page? hstc=59513074 901e138137246d5bde4ccdbd22c4c426 1657529807386 1664186053341 1664199496535 118& hssc=59513074 7 1664199496535& hsfp=13091307 verwenden und ihr eigenes html hinzufügen, um mehr kontrolle über die erste seite zu haben es gibt viele optionen zur inspiration, und wenn sie das erscheinungsbild der ersten seite ändern möchten, ist dies die richtige wahl hier sehen sie, wie einer unserer kunden seine startseite für seine hilfeseite erstellt hat benutzerdefinierten code hinzufügen verwenden sie benutzerdefiniertes css https //docs archbee io/custom css? hstc=59513074 901e138137246d5bde4ccdbd22c4c426 1657529807386 1664186053341 1664199496535 118& hssc=59513074 7 1664199496535& hsfp=13091307 wenn sie ihrer dokumentationsseite ihren eigenen \<font color="#a855f7"> geschmack \</font> hinzufügen möchten wenn sie mit css klassen vertraut sind, finden sie einige ausgangspunkte und können diese gezielt ansprechen