Pyramid documentation

[Mark Erbaugh]

I've used Sphinx to build a local copy of the Pyramid (1.2) documentation. I then access this in my web browser.  I've noticed delays in loading these local docs in my web browser that I don't see with similar documentation from other projects. I looked at the HTML source discovered that even though it's a local copy, it's still looking for some files online:

<link rel="stylesheet" href="https://static.pylonsproject.org/fonts/nobile/stylesheet.css" type="text/css" media="screen" charset="utf-8" />
<link rel="stylesheet" href="https://static.pylonsproject.org/fonts/neuton/stylesheet.css" type="text/css" media="screen" charset="utf-8" />

My web browser is Safari (on a Mac), and having these lines causes a delay when I'm connected to the internet. If I'm not connected to the internet, the page loads immediately and seems okay.  I looked and those same lines are included in many of the HTML files in the docs.  Do they need to be there or should the documentation source be changed to use local copies of those stylesheets?

Thanks,

Mark

[Blaise Laflamme]

Hi Mark,

that's weird because I build all of them locally without having any issues. Those stylesheets are loaded from the internet to provide custom web fonts used by the theme to fits better the layout and signature and it won't make sense to include them locally for every build, however you are free to select another theme to render the documentation if it cause you any troubles.

[Mark Erbaugh]

On Nov 30, 2011, at 6:22 PM, Blaise Laflamme wrote:

Hi Mark,

that's weird because I build all of them locally without having any issues. Those stylesheets are loaded from the internet to provide custom web fonts used by the theme to fits better the layout and signature and it won't make sense to include them locally for every build, however you are free to select another theme to render the documentation if it cause you any troubles.

Blaise,

I have found that they do work locally without internet connectivity for me.  It's just when I do have internet connectivity there seems to be a delay.  I'm guessing it checks for the stylesheets and either downloads them or ignores them if they can't be downloaded. If there is no internet connection at all, apparently, Safari knows to not try to download those files.

I'm not familiar with Sphinx. How do I select a theme?

Thanks,

Mark

[Blaise Laflamme]

yes thats possible... however I see no reason to have a delay, or google has a problem. You can change the theme in the conf.py file under html_theme = 'pyramid', change pyramid for any available sphinx theme.