Skip to content

Commit f9cdfea

Browse files
authored
docs: Improve config tables' readability (#19522)
## Which issue does this PR close? - Closes #19521. ## Rationale for this change Make the config tables at https://datafusion.apache.org/user-guide/configs.html easier to read, by avoiding horizontal scrolling. Before: <img width="1466" height="1001" alt="image" src="https://github.com/user-attachments/assets/bca9e64a-7d77-4f8c-8a17-78e00669fd6a" /> After: <img width="1510" height="1051" alt="image" src="https://github.com/user-attachments/assets/04c7d840-a4c3-4475-879a-31613157f6b4" /> Also works well on smaller screens: <img width="647" height="700" alt="image" src="https://github.com/user-attachments/assets/3667e2b6-1ced-47ca-9b8a-a68084a83bfe" /> ## What changes are included in this PR? - New css rules (these are only applied to the tables in the Configs page, every other table remains the same). ## Are these changes tested? Manual checks. ## Are there any user-facing changes? No.
1 parent 673d7c9 commit f9cdfea

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

docs/source/_static/theme_overrides.css

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -138,3 +138,21 @@ Details: 8rem for search box etc*/
138138
.bd-content table tbody tr:nth-of-type(odd) {
139139
background-color: rgba(0, 0, 0, 0.03);
140140
}
141+
142+
143+
/* Ensure the config tables are readable without having to scroll horizontally. */
144+
145+
:is(#configuration-settings, #runtime-configuration-settings) table {
146+
display: table;
147+
table-layout: fixed;
148+
}
149+
150+
:is(#configuration-settings, #runtime-configuration-settings) th,
151+
:is(#configuration-settings, #runtime-configuration-settings) td {
152+
word-wrap: break-word;
153+
}
154+
155+
:is(#configuration-settings, #runtime-configuration-settings) th:nth-child(2),
156+
:is(#configuration-settings, #runtime-configuration-settings) td:nth-child(2) {
157+
width: 15%;
158+
}

0 commit comments

Comments
 (0)