You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

86 lines
3.3 KiB

4 years ago
  1. +++
  2. title = "Custom Layouts"
  3. description = "Menyesuaikan tata letak tanpa memodifikasi sumber tema."
  4. categories = ["customizing"]
  5. tags = ["layout", "templating", "style"]
  6. feature = ["code highlighter", "snippets", "related content"]
  7. [[copyright]]
  8. owner = "Josh Habdas"
  9. date = "2019"
  10. license = "agpl-3.0-or-later"
  11. +++
  12. After Dark menggunakan blok template untuk memfasilitasi pembuatan tata letak halaman yang unik di mana saja di dalam situs anda. Gunakan itu untuk menambah [Snippets](../snippets) ke setiap bagian halaman, secara selektif [Custom Styles](../custom-styles) atau tambahkan kira-kira satu bagian ke beranda.
  13. ## Bagaimana cara kerjanya
  14. Berikan 'block' berikut ini dengan nilai standart pilihan:
  15. ```go-html-template
  16. <title>{{ block "title" }}Judul Situs{{ end }}</title>
  17. ```
  18. Templates warisan dapat menghilangkan blok dan mempertahankan nilai standart atau menerangkan block untuk mengubah nilainya, seperti yang ditunjukan berikut ini:
  19. ```go-html-template
  20. {{ define "title" }}Judul Halaman | Site Title{{ end }}
  21. ```
  22. Digabungkan dengan {{< external href="https://gohugo.io/templates/lookup-order/" text="Lookup Order in Hugo" />}} block menjadi penting dalam menunjuk bagian dalam yang dapat diedit, dan meningkatkan penggunaan kembali file templates yang sudah ada.
  23. ## Diterapkan dalam konteks
  24. Inilah template yang digunakan untuk menampilkan sebuah halaman di After Dark:
  25. {{< highlight go-html-template >}}
  26. {{< include "themes/after-dark/layouts/_default/single.html" >}}
  27. {{< /highlight >}}
  28. Tidak banyak tentang itu. Sebagian besar kode diwarisi dari template lain, memberikan gambaran yang jelas tentang struktur halaman dan membuat modifikasi yang sepele.
  29. ## Membuat milik anda sendiri
  30. Bayangkan anda membuat bagian Buku Audio untuk situs anda dan menginginkan dua layout khusus baru: yang satu untuk membuat daftar klip audio dan yang lain untuk menjelaskan.
  31. Untuk mendapatkan hal tersebut dengan menggunakan template block, pertama buat bagian 'audiobook' dengan satu halaman untuk menggambarkan klip:
  32. ```sh
  33. $ hugo new audiobook/the-power-of-now.md
  34. ```
  35. Menghasilkan struktur pohon sebagai berikut:
  36. ```
  37. ├── assets
  38. ├── content
  39. │   └── audiobook
  40. │   └── the-power-of-now.md
  41. ├── layouts
  42. ```
  43. Jika sudah melayani situs anda bagian dan halaman audiobooks anda akan segera muncul menggunakan standart template block. Untuk menyesuaikan dari standart, tambahkan `list.html` dan `single.html` ke a `layouts/audiobook` di situs direktori anda.
  44. Jika file belum ada, salinlah dari tema standart:
  45. ```sh
  46. $ mkdir -p layouts/audiobook
  47. $ cp themes/after-dark/layouts/_default/list.html layouts/audiobook
  48. $ cp themes/after-dark/layouts/_default/single.html layouts/audiobook
  49. ```
  50. Menghasilkan struktur pohon`layouts` sebagai berikut:
  51. ```
  52. ├── content
  53. ├── layouts
  54. │   └── audiobook
  55. │   ├── list.html
  56. │ └── single.html
  57. ├── static
  58. ```
  59. Sesuaikan `list.html` dan `single.html` layouts dan gunakan [Custom Styles](../custom-styles) untuk mendapatkan hasil yang diinginkan. Gunakan referensi sumber daya berikut sebagai bantuan:
  60. - {{< external "https://gohugo.io/templates/" />}} untuk fungsi templating dan logika
  61. - {{< external "https://devdocs.io" />}} untuk HTML yang komprehensif dan CSS reference
  62. - {{< external "https://inclusive-components.design" />}} untuk ide pola design