Tentang kerangka kerja ShipLang
Tumpukan teknologi multibahasa pertama yang dirancang untuk AI, memungkinkan pengembang untuk fokus pada produk itu sendiri.
Pengantar Kerangka Kerja dan Ide-Ideal
ShipLang adalah tumpukan teknologi pertama yang dikembangkan oleh manajer produk, lahir dari refleksi terhadap proses pengembangan tradisional. Di era AI, yang kita butuhkan bukanlah alat yang lebih kompleks, tetapi solusi sederhana yang memungkinkan orang untuk fokus pada ide produk.
Ide inti dari kerangka kerja ini adalah untuk menjadikan globalisasi bukan lagi beban bagi produk. Setelah Anda menulis kode dalam bahasa Mandarin, pengguna di seluruh dunia dapat mengakses situs web Anda dalam bahasa asli mereka. Multibahasa harus otomatis dan cerdas, bukan memerlukan pemeliharaan manual puluhan file terjemahan.
ShipLang sepenuhnya gratis dan sumber terbuka. Ini bukan hanya tentang berbagi teknologi, tetapi juga upaya untuk mengeksplorasi peran manusia dalam era AI. Teknologi seharusnya melayani kreasi, bukan menjadi penghalang baginya.
Sistem kami dirancang untuk pengguna non-pemrogram dan kompatibel dengan kebiasaan penggunaan pengguna maupun AI, seperti yang ditunjukkan pada diagram di bawah ini:
Buatlah agar AI kompatibel, bukan sebaliknya (klik untuk melihat gambar yang lebih besar)
Buatlah agar AI kompatibel, bukan sebaliknya (klik untuk melihat gambar yang lebih besar)
Tentang penulis
Prinsip-prinsip Teknis
Mekanisme penerjemahan cerdas multibahasa
Tujuan dari dukungan multibahasa adalah untuk memastikan bahwa ketika Anda mengetik bahasa Mandarin di bagian backend kode, pengguna akan melihat bahasa lain.
Prinsipnya adalah, ketika pengguna mengunjungi situs untuk pertama kalinya, sistem akan memeriksa pengaturan bahasa pengguna. Jika tidak ada berkas terjemahan untuk bahasa tersebut, sistem akan memanggil API terjemahan, menerjemahkan bahasa tersebut, menampilkan hasil terjemahan di halaman, dan menyimpan hasil terjemahan di server untuk penggunaan di masa mendatang. Jika berkas terjemahan untuk bahasa yang sesuai sudah ada, berkas tersebut akan langsung dimuat, dan bahasa halaman akan ditampilkan secara otomatis.
Alur kerja
1. Saat pengguna mengunjungi suatu halaman, sistem secara otomatis mendeteksi preferensi bahasa peramban.
2. Periksa apakah server sudah memiliki file cache terjemahan untuk bahasa tersebut.
3. Jika cache ada, muat dan render langsung; jika tidak, panggil API terjemahan AI.
4. Setelah diterjemahkan, simpan ke cache server agar dapat langsung digunakan pada kunjungan berikutnya.
5. Seluruh proses transparan bagi pengguna, tidak memerlukan waktu tunggu, dan memberikan pengalaman yang lancar.
Panduan Pengguna
Penggunaan dasar
Jika terdapat konten yang perlu diterjemahkan ke dalam beberapa bahasa, tambahkan tag data-i18n ke file PHP yang bersangkutan.
Sebagai contoh, jika Anda ingin menerjemahkan bahasa Mandarin "欢迎用" (Selamat datang untuk menggunakan) ke dalam berbagai bahasa di halaman web langany.com/docs/lang-i18n, Anda perlu menambahkan hal berikut ke file PHP yang sesuai:
<p data-i18n="welcome">欢迎使用</p>Saat pengguna menggunakan antarmuka bahasa Inggris, "Selamat Datang" akan ditampilkan di lokasi yang sesuai di langany.com/docs/lang-i18n.
Mekanisme penggunaan ulang tag
Saat menambahkan tag data-i18n multibahasa, Anda dapat menyalin tag yang Anda gunakan sebelumnya dan hanya memodifikasi teksnya; tidak perlu mendefinisikan ulang tag data-i18n.
Misalnya, jika tag untuk "你好" didefinisikan sebagai "k", maka "你好" di halaman akan secara otomatis diterjemahkan sebagai "hello" dalam bahasa Inggris. Jika Anda juga ingin menerjemahkan "不错" (tidak buruk) ke dalam beberapa bahasa, Anda dapat langsung menyalin tag tersebut:
<p data-i18n="k">你好</p>
<p data-i18n="k">不错</p>Saat ini, di semua sistem yang ada di pasaran, tag yang sama diterjemahkan ke dalam konten yang sama. Namun, di ShipLang, sistem mendukung penggunaan kembali nilai tag data-i18n. Ketika beberapa elemen menggunakan tag yang sama tetapi memiliki konten yang berbeda, sistem secara otomatis mengonversinya menjadi k_你好 (halo) atau k_不错 (tidak buruk), memastikan bahwa terjemahan tersebut sesuai dengan teks aslinya.
Pertahankan teks aslinya.
Jika teks tertentu pada halaman tersebut tidak perlu diterjemahkan dan harus tetap dalam bentuk aslinya dalam bahasa Mandarin, maka tag data-i18n tidak perlu ditambahkan ke teks tersebut.
Edit terjemahan secara manual
Jika Anda tidak puas dengan konten yang diterjemahkan secara otomatis, Anda dapat mengubah terjemahan secara manual:
1. Temukan nilai tag data-i18n di file HTML tempat Anda ingin memodifikasi konten.
2. Cari tag tersebut di dalam file JSON bahasa yang bersangkutan.
3. Edit terjemahan dan simpan.
Misalnya, untuk memodifikasi terjemahan bahasa Inggris dari "1. Hello" di https://langany.com/refund, temukan tag section1_title, cari di lang/en/docs/refund.json dan modifikasi.
Pertanyaan yang Sering Diajukan
Mengapa memilih PHP sebagai bahasa backend?
PHP mudah diimplementasikan, murah, dan memiliki ekosistem yang matang, menjadikannya ideal untuk implementasi dan iterasi yang cepat. Bagi pengembang independen dan tim kecil, kombinasi PHP dan virtual hosting memungkinkan Anda untuk melayani pengguna global dengan biaya minimal. Tujuan ShipLang adalah untuk menurunkan hambatan masuk, bukan untuk mengejar teknologi yang sedang tren.
Bagaimana kualitas terjemahan dapat dijamin?
ShipLang menggunakan API terjemahan AI terkemuka di industri, menghasilkan kualitas terjemahan tingkat profesional. Untuk konten penting, Anda dapat memodifikasi file terjemahan secara manual kapan saja. Yang penting, terjemahan disimpan secara permanen setelah satu kali pengiriman, sehingga menghilangkan biaya panggilan API ganda.
Bahasa apa saja yang didukung?
Secara teori, sistem ini mendukung semua bahasa utama di seluruh dunia. Sistem akan secara otomatis mencocokkan berdasarkan preferensi bahasa peramban pengguna, termasuk namun tidak terbatas pada bahasa Inggris, Jepang, Korea, Prancis, Jerman, Spanyol, Arab, dan lebih dari 100 bahasa lainnya.
Berapa lama waktu yang dibutuhkan untuk penerjemahan pertama?
Saat pengguna pertama kali mengakses bahasa baru, terjemahan biasanya membutuhkan waktu 1-3 detik. Akses selanjutnya ke bahasa tersebut akan langsung dimuat dari cache, dengan kecepatan yang sama seperti halaman web biasa. Untuk situs web dengan basis pengguna yang besar, disarankan untuk membuat file terjemahan terlebih dahulu untuk bahasa-bahasa yang umum digunakan.
Bagaimana cara memperbarui konten terjemahan?
Ada dua metode: pertama, memodifikasi langsung file JSON dalam bahasa yang bersangkutan, dan kedua, menghapus cache terjemahan lama, dan sistem akan menerjemahkannya kembali pada kunjungan berikutnya. Untuk halaman dengan konten yang sering diperbarui, disarankan untuk menggunakan mekanisme manajemen versi.
Apa saja keuntungan dari mekanisme penggunaan ulang tag?
Sistem multibahasa tradisional mengharuskan setiap konten terjemahan memiliki tag unik, yang menyebabkan kesulitan dalam penamaan dan pengelolaan tag. ShipLang memungkinkan Anda untuk menggunakan kembali tag, dan sistem secara cerdas mengidentifikasi perbedaan konten. Hal ini sangat meningkatkan efisiensi pengembangan; Anda tidak perlu lagi pusing memikirkan nama tag.
Jenis proyek apa saja yang cocok untuk ShipLang?
ShipLang sangat cocok untuk proyek yang membutuhkan globalisasi cepat, seperti produk SaaS, halaman arahan pemasaran, situs web e-commerce, dan platform konten. Jika Anda ingin menjangkau pasar global dengan biaya minimal, ShipLang adalah pilihan yang ideal. Untuk aplikasi perusahaan besar, ShipLang juga dapat digunakan sebagai alat pembuatan prototipe cepat.
Mengapa ShipLang dikatakan dirancang untuk era AI?
Di era AI, penerjemahan seharusnya bukan lagi tugas yang memakan banyak tenaga. ShipLang memanfaatkan sepenuhnya kemampuan AI untuk mengotomatisasi dan mentransformasi penerjemahan secara cerdas. Lebih jauh lagi, arsitekturnya yang efisien memudahkan integrasi lebih banyak fungsi AI di masa mendatang, seperti pembuatan konten cerdas dan analisis perilaku pengguna.
Memulai Menggunakan ShipLang
Kerangka kerja ini sepenuhnya bersifat sumber terbuka; Anda bebas untuk menggunakan, memodifikasi, dan mendistribusikannya. Kami percaya bahwa di era AI, teknologi harus terbuka, mudah digunakan, dan melayani para pencipta.
Jika Anda setuju dengan konsep ini, silakan bergabung dengan komunitas ShipLang dan jelajahi paradigma baru untuk pengembangan produk di era AI.