Support explicit renderer order
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 22.2k
- Forks
- 1.9k
- PR merge metrics
- PR metrics pending
Description
Problem
Similar to how preprocessors allow specifying the order (added in https://github.com/rust-lang/mdBook/pull/1607), it might be a good idea to also support this for renderers. Apparently, from https://github.com/rust-lang/mdBook/pull/2801, it was noted that some renderers depend on a particular order. Depending on the alphabetical order isn't probably the best way to make that dependency.
Proposed Solution
Support the same before/after keys from preprocessors in the output table.
Notes
mdbook v0.4.52
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by comparing the renderer output table handling with the existing preprocessor ordering behavior described in the issue. The work is done when renderers accept the same before/after keys and their order no longer depends on alphabetical sorting.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cli
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100