Mercurial > p > roundup > code
comparison website/www/conf.py @ 6763:d93b441ee778
Handle build issues, update css for mobile
I added www.roundup-tracker.org as a property of mine in google search
console. It reports bad mobile experience.
According to the goatcounter tracker I put in, we get 400 hits from
phones/small tablets; 400 from tablets/small laptops and 800 from
computer screens. So 1/4 is mobile and 1/2 is not a large computer
screen.
On mobile (<960px) the left hand menu is stacked on top of the column
in mobile sizes. Sub-menu links are spaced apart to make them easier
to clkick on with a finger. Same with the table of contents in the
documents. The main document content is now full display width (rather
than scrunched to the right side of the display). This is just a quick
hack, but it should make the docs more usable.
As I worked, I found that _static/style.css changes were not being
copied into the html build directory when sphinx was rerun. Nuke
entire html subdir and rebuild from scratch each time. Also added
comments to Makefile.
Also robots.txt was being added as extra_html by sphinx, but it causes
a missing from TOC error that exits the build (when using -W). Since
exiting on warning is better, I changed Makefile to add
robots.txt. Removed robots.txt references from conf.py.
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Sun, 10 Jul 2022 18:16:13 -0400 |
| parents | b3ba03d2b214 |
| children | 339805c4a85b |
comparison
equal
deleted
inserted
replaced
| 6762:f8ee14436371 | 6763:d93b441ee778 |
|---|---|
| 72 # List of documents that shouldn't be included in the build. | 72 # List of documents that shouldn't be included in the build. |
| 73 exclude_patterns = ['docs/index.txt', | 73 exclude_patterns = ['docs/index.txt', |
| 74 'docs/whatsnew-0.7.txt', | 74 'docs/whatsnew-0.7.txt', |
| 75 'docs/whatsnew-0.8.txt', | 75 'docs/whatsnew-0.8.txt', |
| 76 'docs/security.txt', | 76 'docs/security.txt', |
| 77 'robots.txt', | |
| 77 '_tmp'] | 78 '_tmp'] |
| 78 | 79 |
| 79 # The reST default role (used for this markup: `text`) to use for all documents. | 80 # The reST default role (used for this markup: `text`) to use for all documents. |
| 80 #default_role = None | 81 #default_role = None |
| 81 | 82 |
| 138 # A list of paths that contain extra files not directly related to the | 139 # A list of paths that contain extra files not directly related to the |
| 139 # documentation, such as robots.txt or .htaccess. Relative paths are | 140 # documentation, such as robots.txt or .htaccess. Relative paths are |
| 140 # taken as relative to the configuration directory. They are copied to | 141 # taken as relative to the configuration directory. They are copied to |
| 141 # the output directory. They will overwrite any existing file of the | 142 # the output directory. They will overwrite any existing file of the |
| 142 # same name. | 143 # same name. |
| 143 html_extra_path = ['robots.txt'] | 144 # warning about it nt being in TOC tree causes build to fail with -W. |
| 145 # so install robots.txt via Makefile | |
| 146 # html_extra_path = ['robots.txt'] | |
| 144 | 147 |
| 145 # Custom sidebar templates, maps document names to template names. | 148 # Custom sidebar templates, maps document names to template names. |
| 146 #html_sidebars = {} | 149 #html_sidebars = {} |
| 147 | 150 |
| 148 html_collapse_toctree = True | 151 html_collapse_toctree = True |