PENAWARAN Langkah besar dimulai dari sini. Lihat promo
JAGOWEB INSIGHT

Tutorial Membandingkan Berkas HTML dengan git diff --no-index Sebelum Rilis

Bandingkan dua versi HTML secara lokal dengan Git. Pelajari arah perubahan, tanda plus dan minus, kode hasil, serta pemeriksaan ulang sebelum peninjauan website.

Lihat perubahan sebelum menilai hasil halaman

Saat menerima dua versi berkas HTML, pengelola website sering ingin mengetahui bagian mana yang berubah. Membuka kedua berkas pada editor dapat membantu, tetapi perubahan kecil mudah terlewat ketika isi mulai panjang. Perbandingan teks memberi cara lain untuk meninjau usulan: baris yang hilang, baris yang ditambahkan, dan konteks di sekitarnya ditampilkan bersama. Hasil ini berguna untuk membahas perubahan judul atau keterangan layanan sebelum tim melanjutkan pemeriksaan tampilan dan perilaku halaman pada lingkungan uji.

Tutorial ini memakai git diff --no-index untuk membandingkan dua berkas lokal yang disediakan sebagai latihan. Dokumentasi Git menjelaskan bahwa bentuk tersebut membandingkan dua path pada sistem berkas; Anda tidak perlu membuat riwayat commit untuk mengikuti contoh. Perbandingan tidak menerapkan perubahan ke berkas tujuan. Pada persiapan artikel, empat kasus buatan diuji dan isi berkas diperiksa tetap sama sebelum serta sesudah perbandingan. Hasil tersebut merupakan bukti untuk prosedur lokal, bukan laporan pemeriksaan atau penerbitan website pelanggan.

Dua berkas HTML contoh dibandingkan untuk memperlihatkan judul utama dan paragraf yang berubah.
Perbandingan menunjukkan perubahan teks pada dua versi lokal, tanpa menerapkan perubahan atau menguji perilaku halaman.

Prasyarat: Git dan salinan kerja yang terpisah

Siapkan Git yang sudah tersedia pada terminal, editor teks biasa, dan folder latihan milik Anda. Jalankan git --version untuk mencatat program yang digunakan. Contoh artikel diuji memakai Git 2.56.0.windows.4 dengan terminal PowerShell di Windows. Nomor tersebut mencatat lingkungan pengujian, bukan kewajiban memakai versi yang sama atau klaim versi terbaru. Jika perintah belum tersedia, siapkan lingkungan melalui panduan resmi Git sebelum melanjutkan. Tidak ada kebutuhan membuat repository, menambahkan remote, atau masuk ke akun layanan untuk latihan ini.

Gunakan berkas contoh yang disediakan, bukan salinan konfigurasi yang belum Anda pahami. Pisahkan folder latihan dari berkas website yang sedang digunakan agar percobaan menyunting tidak tertukar dengan perubahan produksi. Buat catatan sederhana berisi berkas pertama, berkas kedua, perubahan yang diharapkan, dan hasil perbandingan. Urutan dua berkas penting karena menentukan arah pembacaan tanda pengurangan dan penambahan. Sepakati versi mana yang menjadi pembanding awal sebelum mulai berdiskusi dengan rekan, terutama bila nama berkas dari beberapa kiriman terlihat mirip.

Diagram arah pembandingan dan empat hasil lokal, termasuk kode satu untuk perbedaan dan nol untuk salinan identik.
Kode satu pada diff --no-index berarti ada perbedaan; arah masukan menentukan makna tanda pengurangan dan penambahan.

Langkah 1: simpan contoh awal yang utuh

Buat berkas sebelum.html menggunakan kode latihan pada bagian ini. Simpan sebagai teks UTF-8 dan pastikan editor tidak menambahkan akhiran .txt tanpa disadari. Berkas berisi judul halaman, judul utama, satu paragraf layanan, serta tautan ke bagian kontak. Pada latihan, isi sengaja pendek agar setiap perubahan dapat dihubungkan dengan sasaran yang jelas. Anda belum perlu menambahkan gaya, gambar, atau kode aplikasi lain. Pertahankan berkas awal ini sebagai pembanding ketika menilai hasil langkah berikutnya.

Kode latihan (simpan sebagai sebelum.html):

<!doctype html>
<html lang="id">
<head>
<meta charset="utf-8">
<title>Profil Usaha</title>
</head>
<body>
<h1>Profil Usaha</h1>
<p>Informasi layanan kami.</p>
<a href="#kontak">Lihat kontak</a>
<section id="kontak">Hubungi tim kami.</section>
</body>
</html>

Baca isi yang telah tersimpan, lalu catat bahwa judul utama adalah Profil Usaha dan paragrafnya berbunyi Informasi layanan kami. Bagian kontak dipakai sebagai konteks yang tidak diubah dalam percobaan pertama. Dengan sasaran ini, Anda dapat mengenali bila hasil perbandingan memuat perubahan tambahan yang tidak direncanakan. Jangan langsung menganggap semua baris yang tampil pada keluaran merupakan baris berubah; sebagian ditampilkan untuk menunjukkan lingkungan perubahan. Pembedaan antara isi berubah dan konteks akan diperiksa setelah kedua versi siap.

Langkah 2: buat versi kedua dengan dua perubahan

Buat salinan bernama sesudah.html. Pada salinan ini saja, ganti <h1>Profil Usaha</h1> menjadi <h1>Profil Layanan</h1>, lalu ganti <p>Informasi layanan kami.</p> menjadi <p>Informasi layanan dan jadwal konsultasi.</p>. Simpan perubahan. Bagian title dalam head serta tautan kontak tetap seperti contoh awal. Pembatasan dua perubahan ini membantu Anda menentukan hasil yang diharapkan sebelum menjalankan alat, sehingga pembacaan keluaran tidak bergantung pada dugaan tentang apa yang baru disunting pada editor.

Periksa nama dan lokasi kedua berkas. Bila ingin memakai nama folder yang mengandung spasi, pertahankan tanda kutip pada path yang dimasukkan ke terminal. Jangan membandingkan dua tab editor yang belum disimpan, karena perintah akan membaca isi berkas pada penyimpanan. Jika rekan mengirim versi baru, simpan dengan nama yang jelas sebelum memasukkannya sebagai berkas kedua. Kebiasaan ini mencegah kesimpulan bahwa sebuah usulan tidak mengandung perubahan, padahal alat sebenarnya memeriksa salinan lama yang belum diganti.

Langkah 3: jalankan perbandingan dua path

Dari folder latihan, jalankan git --no-pager diff --no-index --no-ext-diff --no-textconv --no-color -- '.\sebelum.html' '.\sesudah.html'. Opsi --no-pager menjaga keluaran langsung di terminal. Pada perbandingan ini, --no-ext-diff melarang driver diff eksternal dan --no-textconv melarang filter konversi teks eksternal; --no-color memudahkan pembacaan teks tanpa bergantung pada warna. Nama berkas pertama dan kedua diberikan setelah pemisah --. Perintah tersebut dipakai untuk membaca perbedaan, tanpa memerlukan langkah staging atau commit pada latihan ini.

Anda mengharapkan dua baris lama dan dua baris baru terlihat pada bagian perubahan, bersama beberapa baris konteks. Jika terminal menyatakan berkas tidak ditemukan, periksa lokasi kerja dan ejaan path sebelum mengubah isi HTML. Masalah menemukan masukan berbeda dari hasil yang menyatakan tidak ada perbedaan. Perhatikan juga apakah yang diberikan benar-benar dua berkas, bukan folder yang tidak dimaksud. Batasi pemeriksaan awal pada pasangan kecil ini supaya keluaran tetap dapat dicocokkan dengan dua suntingan yang sudah direncanakan.

Langkah 4: baca arah, tanda baris, dan konteks

Periksa header yang memuat nama sebelum.html dan sesudah.html untuk mengonfirmasi arah perbandingan. Dokumentasi format diff Git menjelaskan bentuk header dan penanda perubahan. Pada isi hunk, awalan minus menandai baris dari sisi pertama yang dihapus, awalan plus menandai baris dari sisi kedua yang ditambahkan, dan spasi menandai konteks yang tidak berubah. Jangan menyamakan header --- atau +++ yang menunjuk berkas dengan baris isi HTML. Baca perannya terlebih dahulu sebelum menghitung baris yang benar-benar disunting.

Pada contoh yang diuji, judul utama lama dan paragraf lama muncul dengan minus, sedangkan versi penggantinya muncul dengan plus. Tautan Lihat kontak tetap hadir sebagai konteks. Penanda @@ membantu mengenali kelompok baris yang sedang ditampilkan; Anda tidak perlu menafsirkan semua metadata untuk memeriksa dua suntingan pertama. Fokuskan pertanyaan editorial pada apakah perubahan sesuai permintaan dan apakah ada bagian lain yang ikut berubah tanpa alasan. Simpan temuan sebagai catatan spesifik, misalnya paragraf layanan berubah sesuai usulan sementara tautan kontak tetap sama.

Langkah 5: bedakan ada perubahan dari perintah gagal

Dokumentasi Git menjelaskan bahwa mode --no-index menyiratkan --exit-code: kode satu berarti ada perbedaan, sedangkan nol berarti tidak ada perbedaan. Di PowerShell, Anda dapat melihat $LASTEXITCODE segera setelah menjalankan perintah. Jangan menganggap kode satu pada kasus ini otomatis berarti pembandingan gagal. Baca keluaran serta konteks perintah yang digunakan. Untuk latihan sebelum.html melawan sesudah.html, kode satu merupakan hasil yang diharapkan karena kedua berkas memang sengaja mempunyai dua perubahan yang telah ditentukan.

Buat salinan identik dari sebelum.html bernama salinan.html, lalu ulangi perintah dengan pasangan sebelum.html dan salinan.html. Hasil yang diharapkan adalah tidak ada isi diff dan kode nol. Selanjutnya, tukar urutan pasangan yang berbeda: sesudah.html sebagai sisi pertama dan sebelum.html sebagai sisi kedua. Tanda baris yang Anda baca akan berbalik arah. Kasus berpasangan ini membangun pemahaman bahwa hasil alat menjelaskan hubungan dua masukan, bukan penilaian bahwa versi tertentu selalu lebih baru, lebih benar, atau sudah siap dipakai.

Langkah 6: pulihkan contoh dan lakukan verifikasi ulang

Untuk latihan pemulihan, buat berkas dipulihkan.html dengan menyalin seluruh isi sebelum.html menggunakan editor. Bandingkan sebelum.html dengan dipulihkan.html memakai opsi yang sama. Hasil yang diharapkan kembali tidak memuat diff dan berkode nol. Perhatikan bahwa pemulihan terjadi karena Anda menyalin isi ke berkas latihan, bukan karena perintah diff menerapkan perubahan. Perbandingan hanya membantu memeriksa hasil penyalinan tersebut. Pada pekerjaan nyata, tindakan mengubah berkas perlu mengikuti keputusan dan prosedur proyek yang berlaku.

Empat kondisi yang diperiksa dalam persiapan artikel ialah pasangan berbeda, salinan identik, pasangan dengan arah terbalik, dan salinan yang dipulihkan. Seluruh hasil sesuai dengan sasaran, serta pemeriksaan isi sebelum dan sesudah menunjukkan perintah perbandingan tidak mengubah berkas latihan. Setelah memahami pola ini, terapkan pada perubahan yang ruang lingkupnya telah disepakati. Namun, lanjutkan dengan pengujian tampilan serta fungsi di lingkungan uji: keberhasilan membaca diff tidak membuktikan HTML benar, tautan bekerja, atau kebutuhan pengunjung sudah terpenuhi.

Kesalahan umum dan catatan untuk peninjau

Kesalahan umum meliputi lupa menyimpan perubahan, salah memilih versi awal, membaca semua konteks sebagai perubahan, serta mengira kode satu selalu menandakan kegagalan. Jika seluruh berkas tampak berbeda, periksa dahulu format berkas dan perubahan yang sebenarnya terjadi bersama pengembang; jangan langsung mengabaikan bagian besar keluaran. Sebelum menyerahkan hasil, tuliskan pasangan masukan dan dua atau tiga temuan yang paling penting. Catatan ini membantu peninjau lain mengulang pemeriksaan tanpa harus menebak arah dan maksud perbandingan dari nama kiriman semata.

Untuk perencanaan halaman usaha, pengantar layanan tersedia di https://www.jagoweb.com/ dan halaman website perusahaan di https://www.jagoweb.com/website-perusahaan. Bawa catatan perubahan yang ingin ditinjau ketika mendiskusikan pengembangan website. Tutorial ini tidak mengasumsikan cara pengelolaan berkas pada setiap layanan sama. Manfaat utamanya adalah menyusun bukti yang mudah dibaca: isi apa yang berubah, isi apa yang menjadi konteks, dan pengujian apa yang masih perlu dilakukan sebelum perubahan dipertimbangkan untuk digunakan pada website yang sesungguhnya.

Bacaan terkait

Sumber dan referensi

← Kembali ke semua insight
LANJUT BELAJAR

Bekal untuk ide berikutnya.

LANGKAH BERIKUTNYA UNTUK Jagoweb

Ide Anda punya tempat. Kita mulai bareng.

Mulai dari nama domain, website pertama, atau kebutuhan aplikasi. Ceritakan rencana Anda kepada tim Jagoweb.

Temukan pilihan Anda
Tim Jagoweb siap mendiskusikan kebutuhan Jagoweb