[v2,2/2] doc: give full width to NIC overview page
Checks
Commit Message
The wide tables in the NIC overview exceed the normal page width
because of the large number of drivers.
A CSS trick is added to allow displaying this page in the full width
of the browser window.
Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
---
v2: no change
---
doc/guides/custom.css | 8 ++++++++
doc/guides/nics/overview.rst | 2 ++
2 files changed, 10 insertions(+)
Comments
On 7/31/2024 9:31 AM, Thomas Monjalon wrote:
> The wide tables in the NIC overview exceed the normal page width
> because of the large number of drivers.
>
> A CSS trick is added to allow displaying this page in the full width
> of the browser window.
>
> Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
>
This makes the feature table wider, so all table can fit, and scroll bar
below the table is gone, this is good.
But also it makes all paragraphs and 'Note' boxes in that page fill all
the screen, and with a wide screen this becomes a long box through end
of the screen and personally I think doesn't look nice.
Instead of making it full screen, is there are way to make it fixed
size, but larger than previous so that table still can expand fully?
31/07/2024 13:29, Ferruh Yigit:
> On 7/31/2024 9:31 AM, Thomas Monjalon wrote:
> > The wide tables in the NIC overview exceed the normal page width
> > because of the large number of drivers.
> >
> > A CSS trick is added to allow displaying this page in the full width
> > of the browser window.
> >
> > Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
> >
>
> This makes the feature table wider, so all table can fit, and scroll bar
> below the table is gone, this is good.
>
> But also it makes all paragraphs and 'Note' boxes in that page fill all
> the screen, and with a wide screen this becomes a long box through end
> of the screen and personally I think doesn't look nice.
>
> Instead of making it full screen, is there are way to make it fixed
> size, but larger than previous so that table still can expand fully?
We may try to restrict non-table containers, but then it will be less generic.
I mean this solution could apply to any large page today.
We may try to force the width of <p> and <ul>.
31/07/2024 14:43, Thomas Monjalon:
> 31/07/2024 13:29, Ferruh Yigit:
> > On 7/31/2024 9:31 AM, Thomas Monjalon wrote:
> > > The wide tables in the NIC overview exceed the normal page width
> > > because of the large number of drivers.
> > >
> > > A CSS trick is added to allow displaying this page in the full width
> > > of the browser window.
> > >
> > > Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
> > >
> >
> > This makes the feature table wider, so all table can fit, and scroll bar
> > below the table is gone, this is good.
> >
> > But also it makes all paragraphs and 'Note' boxes in that page fill all
> > the screen, and with a wide screen this becomes a long box through end
> > of the screen and personally I think doesn't look nice.
> >
> > Instead of making it full screen, is there are way to make it fixed
> > size, but larger than previous so that table still can expand fully?
>
> We may try to restrict non-table containers, but then it will be less generic.
> I mean this solution could apply to any large page today.
>
> We may try to force the width of <p> and <ul>.
I've found another trick to let only tables overflow.
I'll send a v3 and will apply quickly.
@@ -4,6 +4,14 @@
/* Override readthedocs theme */
+/* Set full width on a page.
+ * Usage: insert the following line in the doc.
+ * .. rst-class:: widepage
+ */
+.wy-nav-content:has(.widepage) {
+ max-width: none !important;
+}
+
/* Spacing before a list item must be bigger than spacing inside the item.
* Complex list items start with a p.first element. */
.section li > .first {
@@ -24,6 +24,8 @@ Most of these differences are summarized below.
More details about features can be found in :doc:`features`.
+.. rst-class:: widepage
+
.. _table_net_pmd_features:
.. include:: overview_table.txt