feat!: allow different separators to be applied individually to the left and right sides of the status bar

[PFiS1737]

Close: #2312

Description

• Add configurations for status line separator and format
  • sep_left = { open = "", close = "" }
  • sep_right = { open = "", close = "" }
  • format_percent = [ "Top", "%2d%%", "Bot" ]
  • format_position = "%2d/%-2d"
  • format_mode = "%.3s"

Checklist:

• make another PR to update the docs

[sxyazi]

Actually, separator_left and separator_right don't seem to make the theme.toml that much more complicated.

Do you have a screenshot showing what it looks like when different values are set for them?

[PFiS1737]

Certainly

Example

[sxyazi]

That looks great, this will be a nice improvement!

Could you make this PR only include the changes for separator_left and separator_right?

[PFiS1737]

done

[PFiS1737]

I sincerely request you to reconsider whether the formatting-related features can be merged into the main branch. They are not complex and provide convenience for those who want customization. For others, they can simply remain unchanged.

If possible, I will submit another PR. Those changes don’t seem to be breaking.

[PFiS1737]

docs update: yazi-rs/yazi-rs.github.io#203

[sxyazi]

All look good to me now, and thanks for updating the documentation!

Sorry, I can't accept formatting-related fields for the following reasons:

1. %2d%% is unclear — without looking at the Lua source code, it's hard to understand the specific data represented by %d.
2. %2d%% is a Lua-specific syntax, and to configure it, the user would need some knowledge of Lua. This somewhat goes against the idea of keeping TOML and Lua separate — TOML, as an easy-to-use front-end, is meant to provide users with a simplified configuration method.

[sxyazi]

Thank you!

[PFiS1737]

Thanks for your reply, but I’d still like to push for this.

%2d%% is a Lua-specific syntax

In fact, this is the standard C printf syntax (though it does still introduce a connection between TOML and another language, but they are not complex and easy to understand).

%2d%% is unclear

We can clarify the meaning of placeholders and provide a short explanation of this syntax in the documentation.

Additionally, for users who don’t need these formatting options, just keeping these settings at their default values, and the current appearance remains unchanged.

I understand that you have broader considerations. If this update is ultimately unacceptable, I won’t push further on this and will look for alternative solutions.