Skip to content

[feat] Improve rendering of emoji parsed changelog #1409

@codejedi365

Description

@codejedi365

Feature Request

Description

Currently the changelog renders with only the emoji code's as the heading, where it should be more descriptive. And the per commit comments underneath the section also still have the same emoji there, this is redundant and not visually appealing.

Current implementation example:

# CHANGELOG

<!-- version list -->

## v0.1.1 (2026-01-04)

### :bug:

- :bug: correct some text
  ([`fa36766`](https://example.com/example_owner/example_repo/commit/fa36766e8c502a4972cbbaed49f3c487738269e0))

Desired result:

# CHANGELOG

<!-- version list -->

## v0.1.1 (2026-01-04)

### 🐛 Bug Fixes

- correct some text ([`fa36766`](https://example.com/example_owner/example_repo/commit/fa36766e8c502a4972cbbaed49f3c487738269e0))

- **scope**: correct some text ([`fa36766`](https://example.com/example_owner/example_repo/commit/fa36766e8c502a4972cbbaed49f3c487738269e0))

Possible implementation

Add a config option to render the emojis (convert codes to unicodes) and provide a text description of the header similar to how PSR renders its changelog. There is a library python-gitemojis that can handle the conversions.

Likely would require a new default changelog template directory.

Consider user discussion on #963 as well.

Metadata

Metadata

Assignees

No one assigned

    Labels

    confirmedPrevent from becoming stalefeatureA new feature or a feature requesthelp-wantedExtra attention is required

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions