GitHub Sync adalah plugin yang secara otomatis mengimpor file .md dari repositori GitHub ke dalam koleksi FramerFramer CMS. Jika tim Anda menggunakan dokumen markdown sebagai konten, Anda tidak perlu lagi menyalin dan menempel satu per satu di FramerFramer.

Fitur Utama

Impor Konten Otomatis dari GitHub

File .md dari folder tertentu disinkronkan ke koleksi FramerFramer CMS.

• Sinkronisasi Berbasis Folder: Anda dapat menentukan jalur tertentu di dalam repositori dan hanya menghubungkan konten yang diperlukan.

• Dukungan Frontmatter: Informasi YAML di bagian atas markdown dibaca dan secara otomatis dipetakan ke bidang CMS. Berbagai metadata, seperti tanggal, tag, dan ringkasan, dapat digunakan.

• Pemeliharaan Format Markdown: Elemen markdown seperti bullet point, judul, dan tautan diterapkan seperti apa adanya, dan file .mdx juga didukung sebagian.

Penyusunan Otomatis Jalur Gambar dan Tautan

Gambar atau file dengan jalur relatif juga secara otomatis ditemukan dan diterapkan.

• Gambar yang dimasukkan dengan jalur relatif seperti ./image.png, plugin akan mencarinya secara otomatis dalam repositori dan menghubungkannya.

• Jalur absolut (https://...) tetap dibiarkan seperti apa adanya, dan jika jalurnya salah, akan dihapus secara otomatis untuk mencegah tautan rusak.

Pembersihan Struktur Kompleks

Struktur direktori yang terbenam dalam (contoh: docs/guides/getting-started.md → slug: docs/guides/getting-started) juga dibersihkan menjadi slug yang rapi. Jika Anda ingin membagi koleksi berdasarkan struktur terbenam, setiap folder bisa dibuat menjadi koleksi terpisah untuk dihubungkan.

Dukungan Repositori Pribadi

Repositori GitHub pribadi dapat dihubungkan dengan aman melalui token akses pribadi.

Informasi Tambahan

File .mdx diproses sebagai markdown, dan komponen React atau kode JavaScript diabaikan. Jika struktur folder GitHub berubah di tengah-tengah, base path juga harus diperbarui agar sinkronisasi tetap konsisten, jadi harap diperhatikan.