Things to avoid and practical notes for Vietnamese offering rites

What the columns mean

id (string)

Stable row identifier, unchanged across versions

id_nghi_thuc (string)

id of the procedure row containing this item, in the nghi-thuc-cung-viet-nam dataset

ma_le (string)

Rite type code, the id in the loai-le-cung-viet-nam dataset

ten_le (string)

Vietnamese name of that rite

ten_le_en (string)

English version of the ten_le column, machine translated and not yet reviewed; empty where there is no translation yet

ten_le_zh (string)

Simplified Chinese version of the ten_le column, machine translated and not yet reviewed; empty where there is no translation yet

mien (string)

Region code: toan-quoc, bac (north), trung (centre), nam (south). toan-quoc means the source ties it to no region, not that nationwide use was verified

tieu_vung (string)

Sub-region code within the region; empty when the source does not say

dia_danh (string)

Provinces, cities and villages exactly as the source names them, including province names from before the 2025 mergers; separated by semicolons

nhom_nghe (string)

Occupational group code (fishing communities, traders...) when the rite belongs to a trade; otherwise empty

muc_chung_vung (string)

Basis for the regional tag: nguon-noi-ro (stated by the source) or suy-tu-nguon (inferred from pronunciation, place of composition or custom); empty when no region is tagged

truyen_thong (string)

Tradition code of the procedure row: folk practice, Buddhist, family ritual manuals, Mother Goddess worship...

kieu (string)

kieng-ky: a thing to avoid according to the sources; luu-y: a practical note according to the sources

loai (string)

Type of the item (time, offerings, people, actions, place, speech; substitutes, vegetarian or not, common mistakes, safety, housing, guests...); empty for older-format items not yet classified

chu (string)

The item's sentence, worded as the tradition's own view (by custom, some guides note)

chu_en (string)

English version of the chu column, machine translated and not yet reviewed; empty where there is no translation yet

chu_zh (string)

Simplified Chinese version of the chu column, machine translated and not yet reviewed; empty where there is no translation yet

pham_vi_nguon (string)

muc: the item has its own sources; dong: an older-format item whose sources are those of the whole procedure row

nguon_url (string)

Addresses of the row's source pages, separated by semicolons; source pages of collected texts whose source is not named are left out, so some rows are empty

trang (string)

Address of the rite's customs page on nhatnguyet.org

nguon (string)

Kind of source for this row, one or more parts separated by semicolons, each being tinh-toan (computed by the engine), quy-uoc-truyen-thong, quy-uoc-he-hien-dai (convention of a tradition or of a modern system), van-ban (with the work after a colon) or bien-tap (with details); static details are also in the metadata nguon_chi_tiet, and the two largest datasets give them only there; which column belongs to which part is given by each column's loai_bang_chung in the metadata

ghi_chu (string)

Where the schools disagree on this row; empty when they do not

Release

Data release ID

2026.10.17-211ee414 · manifest.json

Dataset version

1.0.0

Dataset last changed

2026-10-17

Generated

2026-10-18 01:11 UTC

Rows

132 rows, 22 columns

Schema hash

7c2a70b3207f09c1…Copysha256 of each column's name and type

Download this exact release

• kieng-ky-luu-y-le-cung.csv · 99.6 KB · sha256 ea76eb14d194dddc…Copy
• kieng-ky-luu-y-le-cung.json · 151.9 KB · sha256 7ba31a0587d9917f…Copy
• kieng-ky-luu-y-le-cung.meta.json · 37.1 KB · sha256 59cd1013191a298e…Copy

The “CSV for Excel” button at the top serves a copy with a BOM, so its hash differs from the CSV here.

Changes

Version 1.0.0 (2026-10-17), type data: First release: 132 things to avoid and practical notes for 38 rite types, taken from reviewed procedure rows, following source schema 2.0.0.

Changelog of every dataset (CHANGELOG on GitHub)

Method

This dataset goes through no calendar model.

Engine version of the release: 2.0.0.

Verification

Evidence types in this dataset, and how far each can be checked:

• D. Cultural editing: selected, summarised or recorded by Nhật Nguyệt from the site's articles, festival store or question set.

Provenance

Content selected and edited by Nhật Nguyệt; each row's source is in the nguon column.

• D. Cultural editing: id_nghi_thuc, ma_le, ten_le, ten_le_en, ten_le_zh, mien, tieu_vung, dia_danh, nhom_nghe, muc_chung_vung, truyen_thong, kieu, loai, chu, chu_en, chu_zh, pham_vi_nguon, nguon_url, trang

Reuses content from: loai-le-cung-viet-nam, nghi-thuc-cung-viet-nam; and through them: le-vat-cung-viet-nam.

Cite this dataset

Nhật Nguyệt (2026). Things to avoid and practical notes for Vietnamese offering rites (version 1.0.0, data release 2026.10.17-211ee414) [Data set]. CC BY 4.0. DOI 10.5281/zenodo.23009396. https://nhatnguyet.org/en/bang/kieng-ky-luu-y-le-cungCopy

The concept DOI always resolves to the latest release. Zenodo mints a DOI for each release after it is published, and the next release records it in the manifest.

Licence and limitations

Released under CC BY 4.0: reuse commercially, adapt freely, attribution is all that is asked.

Source: Nhật Nguyệt (nhatnguyet.org), CC BY 4.0

This dataset records cultural and calendrical conventions, not scientific claims. It is suitable for cultural research, NLP, and calendar applications. It is not intended for predicting events, evaluating people, or making decisions that affect anyone.

Source texts: Bộ sưu tầm văn cúng và lễ nghi cúng Việt Nam của Nhật Nguyệt.

Other reference tables

• The ten heavenly stems
• Compatibility matrix of the 12 earthly branches
• The twelve earthly branches
• The twelve day officers (Thap Nhi Truc)
• The 22 Major Arcana of the Tarot
• The 24 solar terms
• The 56 Minor Arcana cards
• Sexagenary cycle table (60 Hoa Giap)
• The 64 hexagrams of the I Ching
• The nine presiding stars (Cuu Dieu)
• Zodiac sign boundaries year by year, 1950 to 2050
• Retrieval evaluation set for Vietnamese folk belief and calendar
• Letter to number tables, Pythagorean and Chaldean
• Kua number and Bat Trach directions
• Where the schools disagree
• Auspicious hours across the sixty-day stem-branch cycle
• The sixty stem-branch pairs crossed: sounds, harmony, clash and element relation
• Questions and answers on Vietnamese offering rites
• Vietnamese festivals mapped to solar dates, 2026 to 2030
• Festivals and folk beliefs of the 54 ethnic groups of Vietnam
• Vietnamese festivals, seasonal feasts and public holidays
• Vietnamese ritual offerings
• Vietnamese lunisolar calendar, 1900 to 2100
• Types of Vietnamese offering rites
• Start moments of the 24 solar terms, 1900 to 2100
• Folk inauspicious days mapped onto solar dates, 2026 to 2035
• Vietnamese offering procedures
• Daily hexagram by the Gua Qi method, 1900 to 2100
• Tam Tai, Kim Lau and Hoang Oc by birth year and year in question
• Order of the sixty Gua Qi hexagrams
• Segments of the three Lo Ban rules
• Vietnamese offering prayers (văn cúng)

See every reference table