From c48251c0ff853bb78ff7da715ed8088945dba560 Mon Sep 17 00:00:00 2001
From: "Ian Y. Choi" <ianyrchoi@gmail.com>
Date: Mon, 26 Aug 2019 23:34:08 +0900
Subject: [PATCH] Excludes tables and search on PDF version

PDF version on I18n Contributor Guide does not have to
include so detail tables which rendered version looks awkward.

This patch excludes the tables on PDF version and search tab by
using ".. only:: html" directive, and notes to link a corresponding
HTML page by using ".. only:: latex" directive.

Change-Id: I7b1b9d2d5d8c21827fe5a261f06f38d30b2d3709
---
 doc/source/atc-stats.rst | 77 +++++++++++++++++++++++++---------------
 doc/source/index.rst     |  8 +++--
 2 files changed, 54 insertions(+), 31 deletions(-)

diff --git a/doc/source/atc-stats.rst b/doc/source/atc-stats.rst
index c18b501..515d7aa 100644
--- a/doc/source/atc-stats.rst
+++ b/doc/source/atc-stats.rst
@@ -2,6 +2,13 @@
 ATC Statistics in past releases
 ===============================
 
+.. only:: latex
+
+   .. note::
+
+      You can see detail member-level statistics data on
+      `HTML version of the page <https://docs.openstack.org/i18n/latest/atc-stats.html>`_.
+
 Train cycle
 -----------
 
@@ -15,10 +22,12 @@ Stein cycle
 * Foundation membership was validated by calling a REST API in
   https://openstackid-resources.openstack.org
 
-.. csv-table::
-   :header-rows: 1
-   :widths: 2 1 1 1 1 1 1 1 1 1 1 2
-   :file: data/stein.csv
+.. only:: html
+
+   .. csv-table::
+      :header-rows: 1
+      :widths: 2 1 1 1 1 1 1 1 1 1 1 2
+      :file: data/stein.csv
 
 Rocky cycle
 -----------
@@ -28,10 +37,12 @@ Rocky cycle
 * Foundation membership was validated by calling a REST API in
   https://openstackid-resources.openstack.org
 
-.. csv-table::
-   :header-rows: 1
-   :widths: 2 1 1 1 1 1 1 1 1 1 1 2
-   :file: data/rocky.csv
+.. only:: html
+
+   .. csv-table::
+      :header-rows: 1
+      :widths: 2 1 1 1 1 1 1 1 1 1 1 2
+      :file: data/rocky.csv
 
 Queens cycle
 ------------
@@ -41,10 +52,12 @@ Queens cycle
 * Foundation membership was validated by calling a REST API in
   https://openstackid-resources.openstack.org
 
-.. csv-table::
-   :header-rows: 1
-   :widths: 2 1 1 1 1 1 1 1 1 1 1 2
-   :file: data/queens.csv
+.. only:: html
+
+   .. csv-table::
+      :header-rows: 1
+      :widths: 2 1 1 1 1 1 1 1 1 1 1 2
+      :file: data/queens.csv
 
 Pike cycle
 ----------
@@ -54,10 +67,12 @@ Pike cycle
 * Foundation membership was validated by calling a REST API in
   https://openstackid-resources.openstack.org
 
-.. csv-table::
-   :header-rows: 1
-   :widths: 2 1 1 1 1 1 2
-   :file: data/pike.csv
+.. only:: html
+
+   .. csv-table::
+      :header-rows: 1
+      :widths: 2 1 1 1 1 1 2
+      :file: data/pike.csv
 
 Ocata cycle
 -----------
@@ -77,10 +92,12 @@ Ocata cycle
   myamamot - 725 reviews, mucahit - 1241 reviews) are also regarded ATCs from
   Newton cycle :) - I keep it as record for the next ATC list changes.
 
-.. csv-table::
-   :header-rows: 1
-   :widths: 2 1 1 1 1
-   :file: data/ocata.csv
+.. only:: html
+
+   .. csv-table::
+      :header-rows: 1
+      :widths: 2 1 1 1 1
+      :file: data/ocata.csv
 
 Newton cycle
 ------------
@@ -89,10 +106,12 @@ Newton cycle
 * Patch on governance repository: https://review.opendev.org/#/c/351480/
   (`diff <https://opendev.org/openstack/governance/commit/3aa6cb3e52944f8bed250e0714c7373605b2ebc5>`__)
 
-.. csv-table::
-   :header-rows: 1
-   :widths: 2 1 1 1 1
-   :file: data/newton.csv
+.. only:: html
+
+   .. csv-table::
+      :header-rows: 1
+      :widths: 2 1 1 1 1
+      :file: data/newton.csv
 
 Mitaka cycle
 ------------
@@ -122,10 +141,12 @@ Mitaka cycle
   * Amandeep Singh Saini (jimidar) - Punjabi (India)
   * Łukasz Jernas (id: deejay1) - Polish (Poland)
 
-.. csv-table::
-   :header-rows: 1
-   :widths: 2 1 1 1 1
-   :file: data/mitaka.csv
+.. only:: html
+
+   .. csv-table::
+      :header-rows: 1
+      :widths: 2 1 1 1 1
+      :file: data/mitaka.csv
 
 Liberty cycle
 --------------
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 848b914..d5e6113 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -62,7 +62,9 @@ OpenStack I18n team
 * IRC channel: ``#openstack-i18n`` on freenode
 * :doc:`IRC meeting <i18n_team_meeting>`
 
-Search in this guide
---------------------
+.. only:: html
 
-* :ref:`search`
+   Search in this guide
+   --------------------
+
+   * :ref:`search`