Fix code block rendering inconsistencies and update page title on custom components command reference #1491
+27
−44
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Fix visual inconsistencies in code block rendering on custom components command reference page
Summary
Fixed visual inconsistencies in code block rendering on the
/docs/custom-components/command-reference/page that were causing some code blocks to appear empty or inconsistently styled. The issue was caused by mixing different rendering approaches (doccmdoutput(),rx._x.code_block(), and standard markdown) on the same page.Key Changes:
doccmdoutput()function calls to standardbash+textcode block pairsRisk Level: 🟡 Medium - Documentation system complexity and potential for markdown parsing edge cases
Review & Testing Checklist for Human
reflex component --help,reflex component init --help, etc. outputs to ensure they matchDiagram
%%{ init : { "theme" : "default" }}%% graph TD A["docs/custom-components/<br/>command-reference.md"]:::major-edit B["pcweb/pages/docs/<br/>__init__.py"]:::minor-edit C["pcweb/templates/docpage/<br/>blocks/code.py"]:::context D["Browser Rendering"]:::context E["Flexdown Markdown<br/>Parser"]:::context A --> E B --> D E --> D C --> D A -.->|"removed doccmdoutput()<br/>added language specs"| E B -.->|"added manual title"| D subgraph Legend L1[Major Edit]:::major-edit L2[Minor Edit]:::minor-edit L3[Context/No Edit]:::context end classDef major-edit fill:#90EE90 classDef minor-edit fill:#87CEEB classDef context fill:#FFFFFFNotes
reflex rundevelopment server - all code blocks now display correctly