RE: Sphinx/CSS question

[Mark Rivers via Tech-talk <tech-talk@aps.anl.gov>]

Hi Tom,

 

Ø  div.body {

Ø  min-width: 450px;

Ø  max-width: 800px;   <--------

Ø  }

 

Ø  I disabled this line (using inspect element in firefox on the top level div, similar tools exist in chrome) and the page seems to work as expected.

Ø  You could increase that limit in the theme_overides.css file to get around it, although it is odd that it works differently on your local machine to github.io.

 

Thanks for the hint.  I was not able to find a way to edit that in Chrome, but I did manage to do it in Firefox.  However, I have 2 problems.

 

-          I can increase 800px up to 1170px and the page width increases.  However, above 1170px it does not increase further, even if the browser window is much larger.  Any idea where this limit is coming from?

-          I changed theme_overrides.css to this, i.e. I added the div.body block.

 

corvette:docs/source/_static>more theme_overrides.css

/* override table width restrictions */

@media screen and (min-width: 1024px) {

 

   .wy-table-responsive table td {

      /* !important prevents the common CSS stylesheets from overriding

         this as on RTD they are loaded after this stylesheet */

      white-space: normal !important;

   }

 

   .wy-table-responsive {

      overflow: visible !important;

   }

}

 

div.body {

    min-width: 450px;

    max-width: 1200px;

}

 

I pushed that to github, which causes the areadetector.github.io pages to be updated by Travis.  However, the display is still limited to 800px, it is not 1170px or 1200px.

 

Is my syntax in theme_overrides.css OK?

 

Is there something one needs to do to have theme_overrides.css be loaded, or is that automatic?

 

Thanks,

Mark

 

 

From: Tech-talk <tech-talk-bounces@aps.anl.gov> On Behalf Of Cobb, Tom (DLSLtd,RAL,LSCI) via Tech-talk
Sent: Thursday, January 2, 2020 3:02 AM
To: Mark Rivers via Tech-talk <tech-talk@aps.anl.gov>
Subject: Re: Sphinx/CSS question

 

Hi Mark,

 

The line of code that is restricting the max width is in line 220 of _static/basic.css:

 

div.body {

    min-width: 450px;

    max-width: 800px;   <--------

}

 

This appears to be provided by the sphinx theme.

 

I disabled this line (using inspect element in firefox on the top level div, similar tools exist in chrome) and the page seems to work as expected. You could increase that limit in the theme_overides.css file to get around it, although it is odd that it works differently on your local machine to github.io.

 

Thanks,

Tom

---

From: Tech-talk <tech-talk-bounces@aps.anl.gov> on behalf of Mark Rivers via Tech-talk <tech-talk@aps.anl.gov>
Sent: 01 January 2020 21:01
To: 'tech-talk@aps.anl.gov' <tech-talk@aps.anl.gov>
Subject: RE: Sphinx/CSS question

 

Folks,

 

Thanks to Stuart Wilkins much of the EPICS areaDetector documentation has been converted from raw HTML to ReST, using Sphinx to generate Web pages on areadetector.github.io.

 

 

   .wy-table-responsive {

      overflow: visible !important;

   }

} Much of the documentation is in the form of large tables, and I would like those to look as nice as possible.  Stuart created a theme_override.css file that looks like this:

 

/* override table width restrictions */

@media screen and (min-width: 1024px) {

 

   .wy-table-responsive table td {

      /* !important prevents the common CSS stylesheets from overriding

         this as on RTD they are loaded after this stylesheet */

      white-space: normal !important;

   }

 

 

I am having an issue where the tables look good when I build and serve the documents on my local machine, but they do not look as good on github.io.  The problem is the maximum width of the page. 

 

This is what a page looks like when I build and display on my local machine, where it looks OK.  As I increase the width of the browser window the page gets larger up to some width, and then stops changing.  When I change the min-width in the theme_override.css it does not seem to make any difference.

 

 

This is what the same page looks like on areadetector.github.io.  I am displaying it in the same browser session, just a different tab.  Note that the page is much narrower, even though the browser window is the same width.

 

 

 

 

My questions:

-          Why is the .rst file being displayed differently on github.io versus my local machine?  Both pages eventually stop growing wider as the browser window width is increased, but that limit is much narrower on github.io than on my local machine.

-          Is there a setting I can change to make the page grow wider than the current maximum as the browser window width is increased?

 

Thanks,

Mark

 

 

 

-- 

This e-mail and any attachments may contain confidential, copyright and or privileged material, and are for the use of the intended addressee only. If you are not the intended addressee or an authorised recipient of the addressee please notify us of receipt by returning the e-mail and do not use, copy, retain, distribute or disclose the information in or attached to the e-mail.
Any opinions expressed within this e-mail are those of the individual and not necessarily of Diamond Light Source Ltd.
Diamond Light Source Ltd. cannot guarantee that this e-mail or any attachments are free from viruses and we cannot accept liability for any damage which you may sustain as a result of software viruses which may be transmitted in or with the message.
Diamond Light Source Limited (company no. 4375679). Registered in England and Wales with its registered office at Diamond House, Harwell Science and Innovation Campus, Didcot, Oxfordshire, OX11 0DE, United Kingdom