Panduan Langkah demi Langkah untuk Menggunakan Hugo di Vercel

Panduan ini akan memandu anda menggunakan tapak web Hugo ke Vercel.
Saya akan memastikan anda mengelakkan sekurang-kurangnya satu kesilapan biasa.

1. Cipta Laman Hugo Anda Secara Tempatan

Dengan mengandaikan Hugo sudah dipasang:

tapak baharu Hugo

---

2. Tolak Laman Hugo Anda ke GitHub

Kemudian sediakan repositori git untuk tapak.

git init

Tambahkan komitmen dan tolak fail projek anda:

git add .
git commit
git push -u induk asal

---

3.Tambahkan tema untuk tapak Hugo anda.

Sebagai contoh, anda boleh menggunakan Nno jQuery, tiada Bootstrap tema yang sangat pantas seperti hugo-blog-awesome:

Sebagai modul github:
submodul git tambah https://github.com/hugo-sid/hugo-blog-awesome.git

Atau modul Hugo
hugo mod dapatkan github.com/hugo-sid/hugo-blog-awesome

---

4. Tambahkan konfigurasi vercel (vercel.json)

Dalam dir akar tambah vercel.json di mana kita akan mentakrifkan versi hugo versi Go dan buildCommand, selepas mentakrifkan hugo sebagai Pratetap Rangka Kerja dalam vercel, konfigurasi tersebut akan dikesan secara automatik.


vercel.json

{
  "build": {
    "env": {
      "HUGO_VERSION": "0.135.0",
      "GO_VERSION": "1.19.5"
    }
  },
 "buildCommand": "hugo --gc --minify"
}

- gunakan hugo env untuk menunjukkan versi Go dan Hugo yang anda gunakan

Kemudian tolak kemas kini ke Github:
git add .
git commit -m "vercel deploy"
git push -u induk asal

---

5 . Gunakan Tapak Anda di Vercel

Semasa proses import, pastikan projek disambungkan dengan betul ke repositori Hugo anda.

Vercel mengesan env dan binaan perintah:

Atau anda boleh menetapkannya secara manual dalam pembolehubah persekitaran Vercel di sini

Log penempatan:

Selepas binaan yang berjaya ??, Vercel akan menyediakan pautan pratonton di mana anda boleh melihat tapak web Hugo secara langsung anda. Anda juga boleh mengkonfigurasi domain tersuai melalui tetapan Vercel untuk projek anda.

---

6. Tambah Domain

Jika anda mempunyai nama domain, anda boleh menambah nama domain pada bahagian vercel dalam domain dalam tetapan projek. Kemudian tambahkan CNAME pada penyedia domain anda untuk menunjuk ke domain vercel.

---

?️ Selesaikan Isu Penggunaan Biasa

Masalah utama ialah sokongan hugo tidak begitu baik walaupun vercel telah mengemas kini imej Node mereka untuk mempunyai Hugo dan dengan tetapan lalai, saya bertemu dengan ralat susun atur hugo tidak ditemui dan penggunaan saya membawa kepada XML muka surat.
Ini kerana parameter env versi Hugo dan Go perlu ditakrifkan dalam fail json vercel.json

Menyediakan tapak peribadi dengan Hugo dan Vercel adalah sangat mudah, walaupun terdapat beberapa masalah kecil. Saya harap siaran ini dapat membantu anda untuk menyediakan tapak anda sendiri. Untuk mendapatkan butiran lanjut tentang perubahan yang saya buat pada tapak, lihat sejarah komit tapak saya.

---

Beberapa Sumber:
https://vercel.com/guides/deploying-hugo-with-vercel
https://vercel.com/docs/projects/project-configuration
https://blog.gusibi.site/article/Best-Practices-for-Deploying-Hugo-on-Vercel

Atas ialah kandungan terperinci Panduan Langkah demi Langkah untuk Menggunakan Hugo di Vercel. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!