Post trước biên về ytuong tổng quát. Post này đi sâu hơn vào một số chitiet kythuat.

Kouveo đánh site với Hugo, những thứ khác không biết, không bàn.

Hugo có cái gọi là page bundles chứa toanbo noizung post và resource files¹. Kouveo thích cách sapxep noizung kiểu này. Cách zùng donjan nhất là chia fần noizung, đỡ lẫn khi bientap. Fuctap hơn là làm template riêng cho từng fần, tùy theo yeucau trình bày trong thietke. Tóm lại ít hạn chế hơn so với cách biên tất cả noizung vào một file index.md.

Đây là thietke single post với nhiều cách trinhbay noizung khác nhau.

Với thietke như trên, biên tất cả noizung vào index.md cũng được nhưng jaifap code để generate html cho từng truonghop rất mất công². Chưa kể lúc làm content cothe fải biên markdown theo cách riêng hoặc thamchi zùng shortcode. Cả hai đều fạm vào “kiêng kị” của Kouveo, cái này nói nhiều rồi.

bosung code render embed markdown file trong post

Việc đầu tiên là bosung markdown render hook logic. Đoạn ý đơi

1
2
3
4
5
6
7
8

{{ else if and (eq .Title "embed") (or (in $s "md") (in $s "markdown") (in $s "txt")) }}

    {{- with .Page.Resources.GetMatch $dest -}}
    {{- with .Title -}}<h4>{{- . -}}</h4>{{ else }}<h4>{{ $.Text }}</h4>{{- end -}}
    {{- .Content -}}
    {{ end }}

{{ else }}

File noizung cothe để đuôi .md, .markdown hay .txt đều được. Cũng cothe khai báo front matter hoặc không. Trường hợp khai báo front matter với title thì heading text sẽ hienthi noizung title³, nếu không sẽ lấy noizung .Text.

Kufap chỉ donjan thenay thoy (lưu ý vẫn chỉ là markdown standard syntax).

1

[what ever name](test-embed-content.md "embed")

Nó render ra như nài:

what ever name

Noizung biên riêng trong một file khác, cothe zùng trong truonghop cần bosung hoặc capnhat thongtin. File này cứ biên markdown binhthuong, thậm chí không cần front matter luôn.

embed file end

bosung code render gallery

Một truonghop khác với resource files là zùng nó để trinhbay gallery. Kouveo lọc các file .md bắt đầu bằng gallery (tên file, cùng bundle) rồi cho hienthi như trên đầu post này. Uh oh… Hiện tại, với theme đang zùng là “trên đầu”. Take cái screenshot lưu lại, biết đâu sau này sắp xếp khác nó lại xuống đít.

Xem code:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

{{ with .Resources.Match "gallery**.md" }}
    <div class="bg-cyan-600">

    {{ range . }}
        {{ if isset .Params "link" }}
        <h3>link: <a target="_blank" rel="noopener" href='{{ index .Params "link" }}'>{{ .Title }}</a></h3>
        {{ else }}
        <h3>resource: {{ .Title }}</h3>
        {{ end }}

        {{- .Content -}}
    {{ end }}
    </div>
{{ end }}

Ở đây chỉ có một điểm lưu ý là hình ảnh xếp vào gallery cần kiểu list (mỗi ảnh một gạch đầu zòng). Cách này hay hơn hinhzung ban đầu của Kouveo⁴. Nó hay hơn vì cothe bientap gallery thành từng nhóm khác nhau nếu cần. Thêm một rule cần nhớ khi làm content cho fần này (nhắc lại fát nữa, vẫn là kufap markdown tieuchuan chứ không có ji khác thường) cũng được.

Chăm hơn tí nữa thì biên logic để file gallery này không cần front matter cũng được. Nhưng hehe… lại lười cmnr. Thoy nghỉ.