Masukan Anda masuk, situs web yang diterapkan keluar — dan semua yang operasional tetap di sampingnya.

Apa yang Anda miliki masuk

Semua yang ada di kiri alur adalah milik Anda dan tetap milik Anda. Tidak ada yang merupakan kode platform.

• Konfigurasi

  Identitas, bahasa, navigasi, sakelar fitur, dan pilihan antarmuka — pengaturan yang tervalidasi, bukan konstanta yang berserakan.

• Konten

  Halaman dan koleksi Anda sebagai berkas di repositori Anda, masing-masing dengan judul dan isi sendiri.

• Terjemahan

  Satu kamus antarmuka per bahasa, plus direktori konten untuk bahasa tersebut.

• Merek dan aset

  Logo, favicon, pratinjau sosial, dan ilustrasi opsional Anda, masing-masing dalam peran yang bernama.

Anda dapat mengubah semua ini tanpa menyentuh arsitektur basisnya.

Apa yang dilakukan Foundation dengan semuanya

Foundation membaca masukan Anda dan menghasilkan situsnya. Inilah bagian yang tidak perlu Anda bangun, dan ia berjalan saat Anda build dan menerapkan — bukan saat pengunjung menunggu.

1. 1

   Validasi

   Konfigurasi dan kamus diperiksa terhadap skemanya, sehingga pengaturan yang salah ketik menggagalkan build alih-alih sampai ke pengunjung.

2. 2

   Konten dan perutean

   Halaman dimuat melalui antarmuka konten, diberi alamat yang stabil, dan kembali ke bahasa bawaan per halaman ketika terjemahannya belum ada.

3. 3

   Penyajian

   Konten dan identitas Anda disusun melalui sistem token desain bersama, dalam mode terang atau gelap, di setiap lebar tampilan.

4. 4

   Visibilitas dan metadata

   Judul, alamat kanonis, anotasi bahasa, data terstruktur, serta keluaran sitemap dan robots dibuat dari apa yang Anda konfigurasi.

5. 5

   Titik integrasi

   Di tempat Anda mengaktifkan kemampuan, Foundation menampilkan koneksinya dan menyerahkan niat pengunjung ke penyedia Anda.

6. 6

   Keluaran

   Situs web statis, dibangun dan diterapkan ke akun serta domain Anda sendiri.

Tidak ada yang di sini berupa layanan yang Anda sewa: repositori yang sama dapat dibangun di mana pun Anda bisa menjalankannya.

Apa yang berjalan di samping Foundation, bukan di dalamnya

Foundation menyatakan niat — memesan janji, meminta petunjuk arah, mengirim pesan — dan tujuan di balik niat itu milik Anda untuk diubah. Ia tidak menjadi sistem-sistem tersebut.

Layanan eksternal terhubung melalui titik integrasi; layanan itu tetap menyimpan datanya, aturannya, dan akunnya sendiri.

Dari memperoleh Foundation hingga situs yang Anda pelihara

Sepuluh langkah praktis. Panduan di repositori membawa detailnya — halaman ini menunjukkan bentuk pekerjaannya.

1. 1

   Dapatkan

   Klon atau fork repositori publik ke akun Anda sendiri.

2. 2

   Jalankan

   Pasang dan jalankan, untuk melihat situs yang bekerja sebelum Anda mengubah apa pun.

3. 3

   Konfigurasi

   Tetapkan identitas, bahasa, navigasi, dan sakelar fitur Anda di konfigurasi.

4. 4

   Pasang identitas Anda

   Gantikan peran grafis yang bernama dengan logo, favicon, dan pratinjau Anda sendiri.

5. 5

   Tulis konten Anda

   Tulis halaman dan koleksi Anda sebagai berkas di repositori.

6. 6

   Pilih kemampuan Anda

   Aktifkan hanya yang Anda butuhkan; kemampuan yang tidak dipakai tidak menambah rute atau konten pengganti.

7. 7

   Hubungkan penyedia Anda

   Arahkan setiap titik integrasi yang aktif ke penyedia yang sudah Anda pakai.

8. 8

   Validasi

   Jalankan gerbang dan verifikasi browser, agar masalah muncul sebelum pengunjung Anda.

9. 9

   Terapkan

   Build dan terapkan ke akun serta domain Anda sendiri.

10. 10

    Pelihara

    Jaga konten dan konfigurasi Anda tetap milik Anda, dan serap perbaikan berikutnya saat Anda memilihnya.

Panduan

Situs web ini tidak pernah menjadi salinan kedua dari panduan di GitHub.

Siapa memiliki apa

Foundation adalah infrastruktur yang Anda pegang, bukan layanan yang Anda sewa. Pembagiannya sengaja dibuat sederhana.

Anda bisa pergi, dan semua yang Anda miliki ikut pergi — repositori adalah sumber Anda.

Apa yang terjadi saat Anda mengubah sesuatu

Dua aturan yang disengaja membuat ini dapat diprediksi: konten menentukan keberadaan, konfigurasi menentukan penyajian — dan keduanya tidak dapat diam-diam mengarang yang lain.

• Nama, slogan, atau deskripsi situs

  Header, footer, judul halaman, metadata sosial, dan data terstruktur.

• Berkas halaman itu sendiri

  Konten halaman tersebut, dan sitemap yang dihasilkan.

• Berkas kamus

  Teks antarmuka untuk bahasa tersebut.

• Token warna aksen

  Setiap elemen bermerek dan elemen penekanan di seluruh situs.

• Aset logo, favicon, atau pratinjau

  Hanya peran visual yang bersangkutan.

• Konfigurasi navigasi

  Urutan dan label menu — tidak pernah apakah halamannya sendiri ada.

• Sakelar fitur

  Apakah rute dan permukaan kemampuan tersebut ada.

• Lokasi operasional

  Status buka, alamat, petunjuk arah, dan data terstruktur lokasi itu sendiri.

Hal opsional yang tidak ada tidak menampilkan apa pun: tanpa halaman pengganti, tanpa ilustrasi pinjaman, tanpa cangkang kosong.

Mengapa perubahan yang buruk gagal lebih awal

Konfigurasi Anda diperiksa saat situs dibangun, bukan saat pengunjung tiba, sehingga kesalahan muncul segera.

• Pengaturan yang tidak dikenal atau salah eja ditolak, bukan diabaikan
• Nilai yang tidak valid secara struktur menggagalkan build sambil menyebutkan pengaturannya
• Kemampuan yang dikonfigurasi tetapi tidak lengkap gagal alih-alih diam-diam tidak menampilkan apa pun
• Bahasa yang dideklarasikan tanpa kamus gagal alih-alih diam-diam menampilkan bahasa lain

Karena itulah siklusnya: ubah berkas, build, dan lihat kebenarannya — bukan menemukannya di produksi.

Mengadopsi perbaikan tanpa kehilangan pekerjaan Anda

Konfigurasi, konten, kamus, dan aset Anda berada di wilayahnya sendiri, dan itulah yang membuat perbaikan berikutnya mungkin diadopsi tanpa menulis ulang situs Anda.

• Wilayah situs Anda sendiri tetap milik Anda saat meningkatkan versi
• Anda yang memutuskan kapan mengadopsi perbaikan, bukan didorong ke dalamnya
• Repositori mencatat apa yang berubah dan mengapa, sehingga keputusannya berbasis informasi

Baca panduan peningkatan

Ini model yang didokumentasikan. Ini bukan layanan pembaruan otomatis, dan proyek tidak mengklaimnya.

Mulailah dari basis yang sudah bekerja

Baca kemampuannya, lihat dua bisnis yang sudah berjalan di atasnya, lalu mulailah dari sesuatu yang sudah bekerja.

• Jelajahi demo
• Lihat di GitHub