Rendering

🚀Rendering

Active + Loaded-Only Fields

Atur final Markdown layout sambil membedakan active template behavior dari loaded-only fields.

Command[tool.custy.changelog.render]

📦Category

Changelog Configuration

🚀Quick Command

[tool.custy.changelog.render]

---

visibilitylayoutsorting

---

📋

Properties

28

📁

Groups

5

📄

Template

changelog.j2

⚠️

Loaded-Only

Documented below

General Visibility

📋Properties

Property	Type	Description	Default	Required
show_title	Boolean	Render main Changelog heading. Active dalam generated Jinja template.	true	No
show_description	Boolean	Render introductory description. Active dalam template.	true	No
show_release_status	Boolean	Render release label jika status tersedia. Active.	true	No
show_summary	Boolean	Render resolved release summary. Active.	true	No
show_promoted_from	Boolean	Render pre-release versions yang dipromosikan ke release. Active.	true	No
show_compare_link	Boolean	Tampilkan comparison URL jika link generation menghasilkannya. Active.	true	No

Layout dan Empty Content

📋Properties

Property	Type	Description	Default	Required
group_by_scope	Boolean	Buat scope subsections dalam commit-type groups. Active.	true	No
collapse_generic_scopes	Boolean	Hindari subsections untuk scopes yang tidak menambah banyak makna. Active.	true	No
generic_scopes	String array	Scope names yang dianggap generic setelah scope mapping. Active dan dinormalisasi menjadi lowercase.	8 generated values	No
deduplicate	Boolean	Hapus overlapping changelog entries selama processing dan context construction. Active.	true	No
show_empty_sections	Boolean	Dimuat ke rendering model tetapi tidak digunakan current active template atau context.	false	No
show_empty_groups	Boolean	Pertahankan empty commit-type groups dalam render context. Active.	false	No
show_empty_scopes	Boolean	Pertahankan empty scope subsections. Active.	false	No
show_empty_metadata	Boolean	Loaded only; current generated template tidak memiliki metadata section.	false	No
show_empty_tags	Boolean	Render empty Tags section saat show_tags aktif. Active.	false	No

Generated generic scopes

toml

generic_scopes = [
"", "main", "core", "general",
"default", "root", "changelog", "release",
]

Optional Sections

📋Properties

Property	Type	Description	Default	Required
show_metadata	Boolean	Loaded only; current generated template tidak merender metadata block.	true	No
show_tags	Boolean	Render grouped release tags. Active.	true	No
show_contributors	Boolean	Loaded only dan ditandai sebagai future feature dalam generated configuration.	false	No
show_statistics	Boolean	Loaded only dan ditandai sebagai future feature dalam generated configuration.	false	No

Formatting

📋Properties

Property	Type	Description	Default	Required
bullet	String	Character atau string sebelum rendered items. Active.	-	No
indent	Non-negative integer	Leading spaces sebelum list items. Invalid negative values fallback ke 0. Active.	0	No
blank_lines_between_releases	Non-negative integer	Loaded only; spacing saat ini diatur Jinja template structure.	2	No
blank_lines_between_commit_groups	Non-negative integer	Loaded only; spacing saat ini diatur Jinja template structure.	1	No

Sorting dan Visuals

📋Properties

Property	Type	Description	Default	Required
sort_groups	Boolean	Sort commit-type groups secara alfabetis, bukan mapped order. Active.	false	No
sort_scopes	Boolean	Sort scope subsections secara alfabetis. Active.	true	No
sort_items	Boolean	Sort individual entries secara alfabetis. Active.	false	No
show_section_icons	Boolean	Pertahankan atau hapus icon prefixes dari mapped section titles. Active.	true	No
show_footer	Boolean	Render footer Generated by Custy. Active dalam generated template.	false	No

⚠️Loaded Tidak Selalu Berarti Visible

Resolver menerima setiap property di atas, tetapi current generated template tidak menerapkan metadata, contributors, statistics, global empty-section, atau blank-line controls. Fields tersebut didokumentasikan sebagai loaded only.

Review Workflow

Ubah satu rendering group setiap kali, jalankan custy changelog generate, lalu periksa rendered Markdown dan Git diff. Template customization juga dapat mengubah rendering fields yang memiliki visible effect.

Lanjutkan

🚀Related Commands

Commands commonly used together with this command.

Mappings

Konfigurasikan labels yang di-sort dan dirender.

Links

Konfigurasikan comparison URL generation.

Generated Output

Tinjau expected Markdown structure.

Troubleshooting

Diagnosis missing atau unexpected sections.