ADOPTION
Nehmen Sie den Quellcode und machen Sie ihn zu Ihrem
Foundation ist öffentlich und auf Selbstbedienung ausgelegt. Beschaffen Sie das Repository, starten Sie es, ersetzen Sie Identität und Inhalte, validieren Sie es und stellen Sie es in einem Konto bereit, das Ihnen gehört. Das öffentliche Repository ist die kanonische technische Quelle; diese Seite ist der kürzeste ehrliche Weg hindurch.
- Es gibt kein Foundation-Konto zu erstellen und keine Lizenzgebühr für die Software. Hosting und Domain bleiben Ihre eigenen Kosten.
- Jedes hier genannte Dokument wird im öffentlichen Repository mitgeliefert, versioniert neben dem Code, den es beschreibt.
- Nichts auf dieser Seite muss man Ihnen glauben: Das Repository ist einen Klick entfernt.
Drei legitime Wege zur Adoption
Foundation verlangt weder Provelopment noch, dass Sie allein arbeiten. Das sind die drei Wege, die Adopter tatsächlich gehen — und sie sind gleichwertig.
Foundation selbst nutzen
Für technisch versierte Adopter: Repository beschaffen, lokal starten, Identität konfigurieren, Inhalte verfassen, validieren und bereitstellen. Alles Nötige liegt im öffentlichen Repository, und nichts darin hängt von Provelopment ab.
Ihre eigene Entwicklerin oder Agentur nutzen
Die Änderungen an Ihrem Deployment liegen in Konfiguration, Inhalten und Assets statt in Plattformcode, sodass jede versierte Webentwicklerin an einer Foundation-Website arbeiten kann — auch eine, die Foundation noch nie gesehen hat.
Provelopment um Unterstützung bitten
Provelopment kann Umsetzungshilfe, technische Unterstützung, Betreuung und verwaltete Dienste anbieten. Diese Hilfe ist von der Grundlage getrennt und vollständig optional.
Keiner der drei Wege ist der empfohlene: Die Website, die am Ende dabei herauskommt, ist dieselbe, und der Quellcode bleibt bei Ihnen, welchen Sie auch wählen. Hilfe hinzuzuziehen — oder darauf zu verzichten — ist eine Diensteentscheidung, die Sie jederzeit treffen oder umkehren können.
Der Weg vom Repository zur laufenden Website
Das ist die gesamte Adoptionsreihenfolge. Nichts davon wird hier wiederholt: Jeder Schritt nennt das Dokument, das die Details besitzt, sodass diese Website nie eine zweite, auseinanderdriftende Kopie der Repository-Anleitungen wird.
1
Die laufenden Websites ansehen
Beginnen Sie mit den Demos. Vergleichen Sie eine davon mit dieser Website und notieren Sie, was sich geändert hat — Identität, Inhalte, Navigation, Funktionsmischung. Alles, was Sie dort beobachten, lässt sich auf Ihrer eigenen Kopie konfigurieren.
2
Das Projekt auf GitHub prüfen
Lesen Sie, was das Projekt ist, was es enthält und wie das Repository aufgebaut ist, und überfliegen Sie das Architektur-Dokument, bevor Sie Zeit investieren.
3
Den Quellcode beschaffen
Klonen oder forken Sie das öffentliche Repository. Sie halten Ihre eigene Kopie ab der ersten Minute unter Ihrer Kontrolle — es gibt nichts zu registrieren, nichts zu beantragen und nichts abzuwarten.
4
Lokal starten
Die Starter-Website rendert unmittelbar nach einer Abhängigkeitsinstallation und dem Start des Entwicklungsservers: eine funktionierende Website statt eines leeren Ordners zum Füllen.
5
Identität und Website-Einstellungen konfigurieren
Ersetzen Sie die Platzhalter-Identität in der Website-Konfiguration — URL, Name, Slogan und Beschreibung — und entscheiden Sie dann, welche optionalen Fähigkeiten Ihre Website braucht. Jede Fähigkeit hat einen ausdrücklichen Aus-Zustand.
6
Inhalte und Assets verfassen
Ihre Seiten und Ihre Geschäftsinhalte liegen als Markdown und Konfiguration in Ihrem eigenen Website-Verzeichnis, und Ihre Grafiken ersetzen die Platzhaltergrafik Rolle für Rolle.
7
Externe Dienste verbinden, wo nötig
Nur die Fähigkeiten, die Sie aktivieren, brauchen Ziele: einen Anfrage-Endpunkt, ein Buchungsziel, einen Kartenstandort oder einen Analyseanbieter. Zugangsdaten gehören in Ihre Deployment-Umgebung, niemals in die Konfigurationsdatei.
8
Validieren, bevor Sie ausliefern
Führen Sie das dokumentierte Gate des Repositorys aus. Die Konfiguration wird zur Build-Zeit geprüft, und eine aktivierte Fähigkeit, die nie fertiggestellt wurde, scheitert laut, statt zu arbeiten vorzugeben.
9
In Ihr eigenes Konto bereitstellen
Stellen Sie auf Hosting bereit, das Sie kontrollieren, und richten Sie Ihre eigene Domain darauf aus. Das Deployment-Handbuch dokumentiert das erste Deployment, die Continuous-Integration-Absicherung, den Schritt zur eigenen Domain und die Prüfungen nach dem Deployment.
10
Pflegen und aktualisieren
Halten Sie Ihre Kopie mit dem Repository verbunden, damit Sie Verbesserungen aus dem Upstream bewusst übernehmen können. Ihre Konfiguration, Inhalte, Wörterbücher und Assets überstehen ein Update; Plattformcode wird ersetzt.
Zehn Schritte, in der Reihenfolge, in der ein echtes Deployment sie durchläuft. Die genauen Befehle und Einstellungen bleiben im Repository, wo sie geprüft, versioniert und mit dem Code aktuell gehalten werden.
Was Sie vor dem Start brauchen
Foundation ist eine echte Codebasis und kein gehosteter Website-Baukasten, daher hat die Adoption ehrliche Voraussetzungen. Sie sind bescheiden, und keine davon verlangt einen Anbieter, den Sie nicht gewählt haben.
- Vertrautheit mit einem modernen Webprojekt: eine Konfigurationsdatei, Markdown-Dateien und einige Terminal-Befehle.
- Ein Hosting-Konto, das Sie kontrollieren, und eine Domain, wenn Sie eine eigene Adresse möchten. Das Deployment-Handbuch dokumentiert Vercel vollständig.
- Ihre eigene Identität, Inhalte und Bilder, um die Platzhalter zu ersetzen.
- Konten bei externen Diensten nur dort, wo Sie eine Integration aktivieren, die eines braucht.
Nichts anderes ist verpflichtend. Foundation verlangt kein Konto bei Provelopment, keine bezahlte Stufe, keinen bestimmten Hosting-Anbieter und keine bestimmte Entwicklerin.
Ihre Website gehört Ihnen
Foundation ist die Software; die Website ist Ihre. Bei Provelopment zu bleiben, ist eine Diensteentscheidung und keine technische Geiselnahme.
Der Quellcode gehört Ihnen
Ihre Kopie des Repositorys ist Ihr Deployment. Es gibt keinen Aktivierungsschritt, keinen Lizenzserver und kein Konto, von dem eine laufende Website abhängt.
Das Deployment gehört Ihnen
Sie stellen in Ihrem eigenen Hosting-Konto und auf Ihrer eigenen Domain bereit, und die Deployment-Anleitung setzt Ihre Konten voraus, nicht unsere.
Die Wahl Ihrer Entwicklerin gehört Ihnen
Konfiguration, Inhalte und Assets können Sie ändern, sodass die Arbeit mit jeder versierten Entwicklerin fortgesetzt werden kann — ohne angesammeltes Insider-Wissen und ohne Abhängigkeit von der Person, die es eingerichtet hat.
Die Wahl Ihrer Anbieter gehört Ihnen
Anfragezustellung, Buchung, Kartenrouten und Analyse werden je Website konfiguriert, sodass Sie diese Anbieter wählen, statt eine feste Auswahl zu erben.
Nachgelagerte Arbeit bleibt trennbar
Was Sie oder Ihre Agentur auf Foundation aufbauen, liegt in Ihrer eigenen Konfiguration, Ihren Inhalten und Ihren Assets, sodass Verbesserungen aus dem Upstream übernommen werden können, ohne es zu verwerfen.
Foundation ist Open Source unter der Apache License 2.0. Sie dürfen den eigenen Code und die Dokumentation des Projekts verwenden, verändern, verbreiten und kommerziell nutzen — auch innerhalb Ihrer eigenen proprietären Website — sofern die Lizenzbedingungen eingehalten werden: eine Kopie der Lizenz und die Urheberrechtshinweise bleiben erhalten, Änderungen werden nicht falsch dargestellt, und die Software wird ohne Gewährleistung bereitgestellt. Die Lizenz ist eine Urheberrechtslizenz: Sie gewährt keine Rechte am Namen, an den Logos oder am Branding von Provelopment, und mitgeliefertes Material Dritter behält seine eigene Lizenz und Namensnennung. Dieser Absatz fasst die Lizenz zusammen; maßgeblich ist der Lizenztext.
Marken und Icons Dritter, die mit dem Projekt ausgeliefert werden, gehören ihren Inhabern und unterliegen deren eigenen Bedingungen, nicht der Lizenz von Foundation.
Die Dokumente, die die Details besitzen
Die Dokumentation von Foundation wird mit dem Code ausgeliefert, sodass sie nicht davon abweichen kann. Jedes Dokument unten ist für sein Thema maßgeblich — auch dort, wo diese Seite es sonst wiederholen müsste.
README
Was das Projekt ist, wie man startet, der Aufbau des Repositorys und die echten Validierungsbefehle.
CUSTOMIZING.md
Der Leitfaden für Anwender und die vollständige Konfigurationsreferenz, einschließlich der Tabelle, die trennt, was Ihnen gehört und was der Plattform.
ARCHITECTURE.md
Architekturstil, Grenzen, Abhängigkeitsrichtung und Integrationsmuster — der kürzeste Weg von nie gesehenem Foundation zu produktiv.
BRAND_ASSETS.md
Der Vertrag zum Austausch von Marken-Assets: jede austauschbare Grafikrolle, in der Reihenfolge des Ersetzens.
DEPLOYMENT.md
Das Start-Runbook: erstes Deployment, Continuous-Integration-Absicherung, eigene Domain und die Prüfliste nach dem Deployment.
instruction-manuals/
Die Verfahren: Adoption, Anpassung, Inhalte, Branding, Validierung, Deployment, Upgrade und Fehlerbehebung.
LICENSE
Der Text der Apache License 2.0, der Nutzung, Veränderung und Weitergabe regelt.
Falls diese Seite und das Repository je nicht übereinstimmen, hat das Repository recht. Diese Seite erklärt die Form der Adoption; das Repository führt sie aus.
Wenn Sie Hilfe möchten, ist sie verfügbar
Provelopment kann Umsetzungshilfe, technische Unterstützung, Betreuung und verwaltete Dienste anbieten. Das ist von der Grundlage getrennt und vollständig optional.
- Foundation zu übernehmen, selbst bereitzustellen und Provelopment nie zu kontaktieren, ist ein vollständig erfolgreiches Ergebnis.
- Nichts in der Software hängt von Provelopment ab, und kein Teil der Dokumentation oder des Codes wird hinter einer bezahlten Stufe zurückgehalten.
- Hilfe wird getrennt vom Projekt vereinbart, und diese Website betreibt keinen Vertriebs- oder Supportkanal.
Die Reihenfolge ist wichtig: zuerst Foundation, zu ihren eigenen Bedingungen; Hilfe danach, wenn Sie sie möchten.
Starten Sie dort, wo Sie stehen
Öffnen Sie eine Demo, um zu sehen, wie eine fertige Foundation-Website aussieht, lesen Sie das Repository, um zu sehen, womit Sie tatsächlich arbeiten würden, und nutzen Sie die Handbücher, wenn Sie bereit zum Bauen sind.