[dpdk-dev] [PATCH] doc: factorize overview table CSS

Thomas Monjalon thomas at monjalon.net
Thu May 4 23:56:29 CEST 2017


There were several tables in NIC and crypto guides with the same
copy-pasted CSS addition.
It is moved into one unique place: conf.py.

Signed-off-by: Thomas Monjalon <thomas at monjalon.net>
---
 doc/guides/conf.py                 |  75 +++++++++++--
 doc/guides/cryptodevs/overview.rst | 212 -------------------------------------
 doc/guides/nics/overview.rst       |  53 ----------
 3 files changed, 66 insertions(+), 274 deletions(-)

diff --git a/doc/guides/conf.py b/doc/guides/conf.py
index ef0e1c607..c3cd0bd69 100644
--- a/doc/guides/conf.py
+++ b/doc/guides/conf.py
@@ -178,7 +178,7 @@ def process_numref(app, doctree, from_docname):
             node.replace_self(newnode)
 
 
-def generate_overview_table(output_filename, section, table_name, title):
+def generate_overview_table(output_filename, table_id, section, table_name, title):
     """
     Function to generate the Overview Table from the ini files that define
     the features for each driver.
@@ -258,9 +258,8 @@ def generate_overview_table(output_filename, section, table_name, title):
     outfile = open(output_filename, 'w')
     num_cols = len(header_names)
 
-    print('.. table:: ' + table_name + '\n',
-          file=outfile)
-
+    print_table_css(outfile, table_id)
+    print('.. table:: ' + table_name + '\n', file=outfile)
     print_table_header(outfile, num_cols, header_names, title)
     print_table_body(outfile, num_cols, ini_files, ini_data, default_features)
 
@@ -316,29 +315,87 @@ def print_table_divider(outfile, num_cols):
     print_table_row(outfile, feature, line)
 
 
+def print_table_css(outfile, table_id):
+    template = """
+.. raw:: html
+
+   <style>
+      .wy-nav-content {
+         opacity: .99;
+      }
+      table#idx {
+         cursor: default;
+         overflow: hidden;
+      }
+      table#idx th, table#idx td {
+         text-align: center;
+      }
+      table#idx th {
+         font-size: 80%;
+         white-space: pre-wrap;
+         vertical-align: top;
+         padding: 2px;
+      }
+      table#idx th:first-child {
+         vertical-align: bottom;
+      }
+      table#idx td {
+         font-size: 70%;
+         padding: 1px;
+      }
+      table#idx td:first-child {
+         padding-left: 1em;
+         text-align: left;
+      }
+      table#idx tr:nth-child(2n-1) td {
+         background-color: rgba(210, 210, 210, 0.2);
+      }
+      table#idx th:not(:first-child):hover,
+      table#idx td:not(:first-child):hover {
+         position: relative;
+      }
+      table#idx th:not(:first-child):hover::after,
+      table#idx td:not(:first-child):hover::after {
+         content: '';
+         height: 6000px;
+         top: -3000px;
+         width: 100%;
+         left: 0;
+         position: absolute;
+         z-index: -1;
+         background-color: #ffb;
+      }
+      table#idx tr:hover td {
+         background-color: #ffb;
+      }
+   </style>
+"""
+    print(template.replace("idx", "id%d" % (table_id)), file=outfile)
+
+
 def setup(app):
     table_file = dirname(__file__) + '/nics/overview_table.txt'
-    generate_overview_table(table_file,
+    generate_overview_table(table_file, 1,
                             'Features',
                             'Features availability in networking drivers',
                             'Feature')
     table_file = dirname(__file__) + '/cryptodevs/overview_feature_table.txt'
-    generate_overview_table(table_file,
+    generate_overview_table(table_file, 1,
                             'Features',
                             'Features availability in crypto drivers',
                             'Feature')
     table_file = dirname(__file__) + '/cryptodevs/overview_cipher_table.txt'
-    generate_overview_table(table_file,
+    generate_overview_table(table_file, 2,
                             'Cipher',
                             'Cipher algorithms in crypto drivers',
                             'Cipher algorithm')
     table_file = dirname(__file__) + '/cryptodevs/overview_auth_table.txt'
-    generate_overview_table(table_file,
+    generate_overview_table(table_file, 3,
                             'Auth',
                             'Authentication algorithms in crypto drivers',
                             'Authentication algorithm')
     table_file = dirname(__file__) + '/cryptodevs/overview_aead_table.txt'
-    generate_overview_table(table_file,
+    generate_overview_table(table_file, 4,
                             'AEAD',
                             'AEAD algorithms in crypto drivers',
                             'AEAD algorithm')
diff --git a/doc/guides/cryptodevs/overview.rst b/doc/guides/cryptodevs/overview.rst
index 656cf18c9..6764d0d93 100644
--- a/doc/guides/cryptodevs/overview.rst
+++ b/doc/guides/cryptodevs/overview.rst
@@ -35,59 +35,6 @@ Supported Feature Flags
 
 .. _table_crypto_pmd_features:
 
-.. raw:: html
-
-   <style>
-      .wy-nav-content {
-         opacity: .99;
-      }
-      table#id1 {
-         cursor: default;
-         overflow: hidden;
-      }
-      table#id1 th, table#id1 td {
-         text-align: center;
-      }
-      table#id1 th {
-         font-size: 80%;
-         white-space: pre-wrap;
-         vertical-align: top;
-         padding: 2px;
-      }
-      table#id1 th:first-child {
-         vertical-align: bottom;
-      }
-      table#id1 td {
-         font-size: 70%;
-         padding: 1px;
-      }
-      table#id1 td:first-child {
-         padding-left: 1em;
-         text-align: left;
-      }
-      table#id1 tr:nth-child(2n-1) td {
-         background-color: rgba(210, 210, 210, 0.2);
-      }
-      table#id1 th:not(:first-child):hover,
-      table#id1 td:not(:first-child):hover {
-         position: relative;
-      }
-      table#id1 th:not(:first-child):hover::after,
-      table#id1 td:not(:first-child):hover::after {
-         content: '';
-         height: 6000px;
-         top: -3000px;
-         width: 100%;
-         left: 0;
-         position: absolute;
-         z-index: -1;
-         background-color: #ffb;
-      }
-      table#id1 tr:hover td {
-         background-color: #ffb;
-      }
-   </style>
-
 .. include:: overview_feature_table.txt
 
 Supported Cipher Algorithms
@@ -95,59 +42,6 @@ Supported Cipher Algorithms
 
 .. _table_crypto_pmd_cipher_algos:
 
-.. raw:: html
-
-   <style>
-      .wy-nav-content {
-         opacity: .99;
-      }
-      table#id2 {
-         cursor: default;
-         overflow: hidden;
-      }
-      table#id2 th, table#id2 td {
-         text-align: center;
-      }
-      table#id2 th {
-         font-size: 80%;
-         white-space: pre-wrap;
-         vertical-align: top;
-         padding: 2px;
-      }
-      table#id2 th:first-child {
-         vertical-align: bottom;
-      }
-      table#id2 td {
-         font-size: 70%;
-         padding: 1px;
-      }
-      table#id2 td:first-child {
-         padding-left: 1em;
-         text-align: left;
-      }
-      table#id2 tr:nth-child(2n-1) td {
-         background-color: rgba(210, 210, 210, 0.2);
-      }
-      table#id2 th:not(:first-child):hover,
-      table#id2 td:not(:first-child):hover {
-         position: relative;
-      }
-      table#id2 th:not(:first-child):hover::after,
-      table#id2 td:not(:first-child):hover::after {
-         content: '';
-         height: 6000px;
-         top: -3000px;
-         width: 100%;
-         left: 0;
-         position: absolute;
-         z-index: -1;
-         background-color: #ffb;
-      }
-      table#id2 tr:hover td {
-         background-color: #ffb;
-      }
-   </style>
-
 .. include:: overview_cipher_table.txt
 
 Supported Authentication Algorithms
@@ -155,59 +49,6 @@ Supported Authentication Algorithms
 
 .. _table_crypto_pmd_auth_algos:
 
-.. raw:: html
-
-   <style>
-      .wy-nav-content {
-         opacity: .99;
-      }
-      table#id3 {
-         cursor: default;
-         overflow: hidden;
-      }
-      table#id3 th, table#id3 td {
-         text-align: center;
-      }
-      table#id3 th {
-         font-size: 80%;
-         white-space: pre-wrap;
-         vertical-align: top;
-         padding: 2px;
-      }
-      table#id3 th:first-child {
-         vertical-align: bottom;
-      }
-      table#id3 td {
-         font-size: 70%;
-         padding: 1px;
-      }
-      table#id3 td:first-child {
-         padding-left: 1em;
-         text-align: left;
-      }
-      table#id3 tr:nth-child(2n-1) td {
-         background-color: rgba(210, 210, 210, 0.2);
-      }
-      table#id3 th:not(:first-child):hover,
-      table#id3 td:not(:first-child):hover {
-         position: relative;
-      }
-      table#id3 th:not(:first-child):hover::after,
-      table#id3 td:not(:first-child):hover::after {
-         content: '';
-         height: 6000px;
-         top: -3000px;
-         width: 100%;
-         left: 0;
-         position: absolute;
-         z-index: -1;
-         background-color: #ffb;
-      }
-      table#id3 tr:hover td {
-         background-color: #ffb;
-      }
-   </style>
-
 .. include:: overview_auth_table.txt
 
 Supported AEAD Algorithms
@@ -215,57 +56,4 @@ Supported AEAD Algorithms
 
 .. _table_crypto_pmd_aead_algos:
 
-.. raw:: html
-
-   <style>
-      .wy-nav-content {
-         opacity: .99;
-      }
-      table#id4 {
-         cursor: default;
-         overflow: hidden;
-      }
-      table#id4 th, table#id4 td {
-         text-align: center;
-      }
-      table#id4 th {
-         font-size: 80%;
-         white-space: pre-wrap;
-         vertical-align: top;
-         padding: 2px;
-      }
-      table#id4 th:first-child {
-         vertical-align: bottom;
-      }
-      table#id4 td {
-         font-size: 70%;
-         padding: 1px;
-      }
-      table#id4 td:first-child {
-         padding-left: 1em;
-         text-align: left;
-      }
-      table#id4 tr:nth-child(2n-1) td {
-         background-color: rgba(210, 210, 210, 0.2);
-      }
-      table#id4 th:not(:first-child):hover,
-      table#id4 td:not(:first-child):hover {
-         position: relative;
-      }
-      table#id4 th:not(:first-child):hover::after,
-      table#id4 td:not(:first-child):hover::after {
-         content: '';
-         height: 6000px;
-         top: -3000px;
-         width: 100%;
-         left: 0;
-         position: absolute;
-         z-index: -1;
-         background-color: #ffb;
-      }
-      table#id4 tr:hover td {
-         background-color: #ffb;
-      }
-   </style>
-
 .. include:: overview_aead_table.txt
diff --git a/doc/guides/nics/overview.rst b/doc/guides/nics/overview.rst
index afb65038b..757a3c901 100644
--- a/doc/guides/nics/overview.rst
+++ b/doc/guides/nics/overview.rst
@@ -50,59 +50,6 @@ Most of these differences are summarized below.
 
 .. _table_net_pmd_features:
 
-.. raw:: html
-
-   <style>
-      .wy-nav-content {
-         opacity: .99;
-      }
-      table#id1 {
-         cursor: default;
-         overflow: hidden;
-      }
-      table#id1 th, table#id1 td {
-         text-align: center;
-      }
-      table#id1 th {
-         font-size: 80%;
-         white-space: pre-wrap;
-         vertical-align: top;
-         padding: 2px;
-      }
-      table#id1 th:first-child {
-         vertical-align: bottom;
-      }
-      table#id1 td {
-         font-size: 70%;
-         padding: 1px;
-      }
-      table#id1 td:first-child {
-         padding-left: 1em;
-         text-align: left;
-      }
-      table#id1 tr:nth-child(2n-1) td {
-         background-color: rgba(210, 210, 210, 0.2);
-      }
-      table#id1 th:not(:first-child):hover,
-      table#id1 td:not(:first-child):hover {
-         position: relative;
-      }
-      table#id1 th:not(:first-child):hover::after,
-      table#id1 td:not(:first-child):hover::after {
-         content: '';
-         height: 6000px;
-         top: -3000px;
-         width: 100%;
-         left: 0;
-         position: absolute;
-         z-index: -1;
-         background-color: #ffb;
-      }
-      table#id1 tr:hover td {
-         background-color: #ffb;
-      }
-   </style>
-
 .. include:: overview_table.txt
 
 .. Note::
-- 
2.12.2



More information about the dev mailing list