Re: [Fuego] [PATCH] Docs: Convert tbwiki pages into .rst files

Hi,

To avoid scroll bar at bottom of the table:

I made following changes to:

*_static/custom.css:*

.wy-table-responsive table td {
white-space: normal;
}

Declared it in conf.py as:

    def setup(app):
        app.add_stylesheet('custom.css')

But it did not work. I will update you regarding the same if I find a
solution for it.

Thanks and regards

Pooja More



On Thu, Dec 3, 2020 at 3:15 AM Bird, Tim <[email protected]> wrote:

> I committed this patch, and updated a lot of content in the
> Fuego_directories and Glossary files.
>
> I mention one outstanding issue is below...
>
> > -----Original Message-----
> > From: Pooja <[email protected]>
> >
> > From: Pooja More <[email protected]>
> >
> > Following pages are converted:
> > Coding_style.rst
> > Fuego_directories.rst
> > Glossary.rst
> >
> > Signed-off-by: Pooja More <[email protected]>
> > ---
> >  docs/rst_src/Coding_style.rst      | 111 +++++++++++++++
> >  docs/rst_src/Fuego_directories.rst | 161 +++++++++++++++++++++
> >  docs/rst_src/Glossary.rst          | 277
> +++++++++++++++++++++++++++++++++++++
> >  3 files changed, 549 insertions(+)
> >  create mode 100644 docs/rst_src/Coding_style.rst
> >  create mode 100644 docs/rst_src/Fuego_directories.rst
> >  create mode 100644 docs/rst_src/Glossary.rst
> >
> > diff --git a/docs/rst_src/Coding_style.rst
> b/docs/rst_src/Coding_style.rst
> ...
>
> > diff --git a/docs/rst_src/Glossary.rst b/docs/rst_src/Glossary.rst
> > new file mode 100644
> > index 0000000..61bb3d7
> > --- /dev/null
> > +++ b/docs/rst_src/Glossary.rst
> > @@ -0,0 +1,277 @@
> > +##############
> > +Glossary
> > +##############
> > +
> > +Here is a glossary of terms used in this wiki:
> > +
> > +Here is a short table that relates a few Jenkins terms to Fuego terms:
> > +
> > +show_sort_link=0
> > +
> > +show_edit_links=0
> > +
> > +Table:
> > +
> >
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> > +| Jenkins term |Fuego term        |Description
>                                                            |
> >
> ++==============+==================+==================================================================================
> > ==============+
> > +|slave         |''none''          |this is a long-running jenkins
> process, that executes jobs.  It is usually (?) assigned to a    |
> > +|              |                  |particular node
>                                                            |
> >
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> > +|node          |board             |item being tested (Fuego defines a
> Jenkins node for each board in the system)                   |
> >
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> > +|job           |test              |a collection of information needed
> to perform a single test                                     |
> >
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> > +|''none''      |request           |a request to run a particular test
> on a board                                                   |
> >
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> > +|build         |run(or 'test run')|the results from executing the job
> or test                                                      |
> >
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> > +|''none''      |plan              |the plan has the list of tests and
> how to run them (which variation, or 'spec' to use)          |
> >
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> > +|''none''      |spec              |the spec indicates a particular
> variation of a test                                             |
> >
> ++--------------+------------------+------------------------------------------------------------------------------------------------+
> > +
>
> I shortened the lines on this table so that the source is only 80-columns
> wide.
>
> When rendered by sphinx for html output ('make html'), the resulting html
> file has a table that is not fit to the page.  It has a horizontal scroll
> bar, instead
> of expanding the table cells vertically and wrapping the text.
>
> Can you see if there's a setting that would allow this table to appear
> without
> needing a scroll bar?
>
> Thanks,
>  -- Tim
>
>

-- 






This
message contains confidential information and is intended only 
for the
individual(s) named. If you are not the intended
recipient, you are 
notified that disclosing, copying, distributing or taking any
action in 
reliance on the contents of this mail and attached file/s is strictly
prohibited. Please notify the
sender immediately and delete this e-mail 
from your system. E-mail transmission
cannot be guaranteed to be secured or 
error-free as information could be
intercepted, corrupted, lost, destroyed, 
arrive late or incomplete, or contain
viruses. The sender therefore does 
not accept liability for any errors or
omissions in the contents of this 
message, which arise as a result of e-mail
transmission.