| changeset | 695399dea532 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | doc: provide card look for "sections" on features page. Make each section on the features page look like a raised card. Note the sections aren't headers 8-(. The markup is: .. container:: card **pseudo header** - list stuff .. container:: card I can't put: pseudo header ============= in there even though each card is its own section. I would like to have real headers for them (allow text->speech and othr devices easiera access). Starting a header in column 1 seems to be a requirement of the syntax 8-(. |
| files |
| changeset | 93f9d8622111 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | doc: update styles to WCAG AAA; add accessibility statement; reword Update to AA WCAG 2.2 contrast: in note admonitions, link contrast was too low in python code examples, comments were too low contrast Added accessability statement. It is only in the tree and not linked to the website currently. Updated install directions for future 2.6 release. Updated paragraph to make it clearer. |
| files |
| changeset | c99e37d270b3 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | doc: move #target a 2em from top of viewport. Make sure there is a little space between top of viewport and the element selected with a #fragment. This looks cleaner. |
| files |
| changeset | f061e614320a |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | doc: tighten up line spacing in multicol lists by removing p margins. |
| files |
| changeset | a50af46803f0 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | docs(style): make shadows on pre sections have tint of background The grey shadows on a wheat colored background looked bad. Add some of the backgound color to the shadow. |
| files |
| changeset | 586e49dda652 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | docs: fix doc for registerUtilMethod; style tweak for internal docs. Pul the list pseudoheader style spacing tweat ot the stylesheet used to generate the released docs. Fix doc on arg to function defined with registerUtilMethod. |
| files |
| changeset | 740c1c5d9ec4 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | docs: move first paragraph close to footnote return link Footnotes used to look like: [1] first paragraph starts 1.2 em away because of default * + * spacing. More paragraph lines. ... It looks wrong. The return link should be closer to the first paragraph so they are seen as more of a unit. Ideally the return link '[1]' should be a hanging indent and all paragraphs for the footnote should be indented. But I can't figure out how to do that. So tighten up the space before the first paragraph. [1] So the first paragraph after the label starts right below it tying the footnote to the text. |
| files |
| changeset | 878cec551d86 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | docs: change css for footnotes and links in headers Set up footnotes to look different from running text by adding a light dotted border, inline margins and a smaller font size. The underline under a link located in a header (h1...h4) is too far down given the increase in font size. Snug it up to the text by adding a negative text-underline-offset. |
| files |
| changeset | 9ed6f48c43c5 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | doc: make table alignment on both doc and website/www Make doc generation use same table alignment. Make the style.css files as identical as possible. website/www/_statis/style.css has more in it, but doc/_static/style.css is a prefix of www. |
| files |
| changeset | 4c85e3e16dfe |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | doc: fix link; make cells in table align at top "Query Parameters Examples" table aligned the labels in column 1 in the middle of the text in column 2. Change that to align cells at the top of the row. Also fix a bad link. |
| files |
| changeset | c1ef0827705a |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Clamp link underline to max 4px Clamp link underline between 1 and 4px. For headers the underline was 6+px and was intersecting the letterforms when the header line wrapped. |
| files |
| changeset | 055f47b41b8b |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Try to improve visited link contrast Tested link/text/background contrast using: https://contrast-triangle.com/ For unvisited links it was fine. For visited links it was too low. Bumped visited link to a lighter color. However it is only 20 points away from unvisited link color now. (Even before visited/unvisited were not distinguishable.) So tried to make visited/unvisited links different in some way. Can't set text-decoration-style to dotted because people are privacy invading jerks. Other things I attempted (adding an ::after item to visited links) and other ignored properties on hover didn't work. So I settled for making the underline-color on visited links darkgrey. Also use underline shortcut rather than separate props. |
| files |
| changeset | dcf37ca1a47d |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Reduce line height for headers; change link decorations thicken underlines and place below test so it doesn't intersect decenders. |
| files |
| changeset | 6dca1626f652 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Solve 2 axe contrast issues; make menu links fill block Also add commented out code to highlight linked headers. Not sure if I like it and if the link target is not before a header the wrong headers gets highlighted. |
| files |
| changeset | a4987f5ebee0 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Add padding around code examples. They were all squished against the edges of the box. This makes them less squished and prevents overlap of bottom scroll bar with the bottom row of text. |
| files |
| changeset | a2dfb82456af |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Make top of navigation bock align with main block. |
| files |
| changeset | 92fb16035d92 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Reclass release info badge block on home page. The comment for the note/news block was incorrect. Fix the release info block on the homepage so it floats to the right. |
| files |
| changeset | 575002bb3f8a |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Convert .note style to .news style on main page .note style's comment says it's for a news banner. So change .note to .news so it doesn't interfere with .. note:: directives used on the main page. AFAICT, this style isn't actually used anywhere. |
| files |
| changeset | 0d9f704a7ef2 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Reformat inclusion of COPYING.txt into license.txt. Include as non-literal text. This removes the need to scroll to read the license. Also makes the hyperlinks work. Colorize the background under the included file to allow easy identification of part of license.txt that is from COPYING.txt like we used to have with the literal inclusion. Had to add raw html to create a div to add the color. Using .. container:: didn't work since indenting .. include:: caused sphinx to throw errors on the headers in COPYING.txt. Reformated COPYING.txt to eliminate unwanted indentation caused by blockquote being triggered. |
| files |
| changeset | e1d06d4dc81f |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Adjust multicol links to be larger on narrow width (mobile) devices. |
| files |
| changeset | bd5bebb11695 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | add headers; make signature list multicolum |
| files |
| changeset | 639a926cbb1a |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Add style for captionbelow class for tables taken from sphinx 5 minimal.css style sheet to put caption on bottom of primary/session db compatibility table. |
| files |
| changeset | 0645e3bdd5a3 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Document three commented out attempts at full bleed code examples None of them work. Documenting what has been tried so somebody can benefit from the work on the next attempt to do it. |
| files |
| changeset | 5e9b0ff1c695 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Extend fluid fonts and record location. I needed smaller fonts (footnotes) and couldn't find the original site I got it from. So I grabbed them from utopia which is a diferent location than I got the original from. Parameters used: param start end screen 320 1280 width Font 16px 18px Size Type 1.25 1.33 (Major third scale, perfect fourth scale) Scale |
| files |
| changeset | 113debfd383b |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | revert attempt to make pre full bleed. Turns out li, dd etc. are not limited to 65ch. So revert to make main column 65ch. |
| files |
| changeset | 8811f1934a79 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Remove extra comma prevening 65 ch rule from applying. |
| files |
| changeset | 527cad3a860c |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | color and full width example pre; change way to do max width Color pre blocks light yellow so they stand out from background. The white background wasn't enough contrast to make them scannable. Also try to make pre blocks full bleed to the right to use all available screen space without overflowing the screen. This makes viewing, cut/paste etc. the examples easier. When pre extends past edge of screen, pre will overflow and scrolling will kick in. I still have an issue with pre inside tables. They cause the table to overflow. Hence the page needs to be x-scrolled. I can change the restructured text to insert a div/container and set the conteiner to scroll on overflow, but I don't have another good answer at the moment. |
| files |
| changeset | ff5a50069822 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Add space between level 2 items in left menu/sidebar. They were too scrunched. Also reconcile installed doc stylesheet with website stylesheet. |
| files |
| changeset | 4295ac110551 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Ad skiplink to main on moblie; fix overlapping links On mobile, the Roundup label at the top of the stacked table of contents becomes a link to jump to the top of the main body of the page. Without this there is no indication that a link on the main menu has been clicked and there is a lot of scrolling to get to the real content of the page. Ideally the left sidebar would become a menu link an be shown only when activated but .... Ran the top level pages through lighthouse to see how they do on mobile. Style changes added to fix links that overlap; fix links that were incorrectly displayed as blocks rather than in running text. Fixes some spacing issues with nested lists inside definition lists definition (dd) tags. Removed some indent when TOC follows n H1 header. Wrap search box on smaller screens so the search box doesn't overlap the jump link. Add back left margin to footer. Tried to prevent overlap with the prev/next/index submenu. It's better but still not good. |
| files |
| changeset | a3dbd44c3642 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | rejigger text and link colors to match WCAG AA. A little darker on text color and lighter on the visited and link colors. |
| files |
| changeset | 49bc6d66f536 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | correct fix for last change. |
| files |
| changeset | ed0285b8c9b4 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Override lobotmized owl for badge display |
| files |
| changeset | 2a78ade9a5eb |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Replace invlid none value for overflow-wrap. |
| files |
| changeset | a5dd4893d089 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Close spacing in the master TOC as well. |
| files |
| changeset | 7e25424e2169 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Fix spacing in TOC; Change pre blocks to scroll w/ scroll shadows The lists in a TOC have too much spacing after adding the lobotomized owl. Shrink it for desktop. The pre example code was getting wrapped and it was confusing. Some single lines looked like two etc. So change pre's to overflow with a scroll bar. To make the scroll section obvious (since scrollbars won't always be shown on mobile), add scroll shadows in direction of scrollability. I made arc shaped shadows rather than straight shadows as they look better. |
| files |
| changeset | 4917bb4b5eac |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Setup spacing with lobotmized owl; close space between dt/dd. Trying to establish a good spacing rhythm. Line height 1.5em inter-element 1.2em dt/dd spacing 0.25em to put dt further away from previous element and closer to its dd. |
| files |
| changeset | 1a221cf0758b |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Add line over footnotes Add a separator/break line above footnotes. |
| files |
| changeset | aa024cdf9ffb |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Correct formating of sidebar on mobile. Unset width. Let it go full screen width. Also use margin-inline-start in place of margin-left with fallback of margin-left. |
| files |
| changeset | 673d8e0d3abf |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Prevent examples from blowing outside the viewport. Overflow wasn't being triggered in multiple cases. Force break on whitespace and overflow-wrap anywhere. This seems to work from 350px mobile to desktop sizes. |
| files |
| changeset | 1ce75966d274 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Make examples scrollable if they overflow. |
| files |
| changeset | 7435320ea041 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Restyle html documentation Make doc look better. Try to reduce "wall of dense text" effect. 1) fluid type scale apply to headers along with change to line height 2) increase base line height to 1.5 3) increase proximity of header to the section it leads by reducing bottom margin. 4) add decoration for hovered link. Still have WCAG AA issue with contrast between links and base text 5) remove most pure white and pure black from document to reduce eye strain 6) in side nav reduce indent from 2em to 1em to better fit labels 7) use same styles for web site doc and release doc on local disk 8) a 'p' inside a 'table' now aligns with top of table cell by removing top margin. 9) in web doc, highlight the current section |
| files |
| changeset | 7820cc786b5e |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | style admonitions, reconcile tyles between website and release docs |
| files |
| changeset | 4553614a2b22 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | move For ... Impatient section up, add directions, style footnote Move the For the Really Impatient closer to the top. Where it was would never be read by the impatient. Add step by step directions for download/unpack and start. Format footnotes with smaller text. |
| files |
| changeset | b5b1f2830e23 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Remove duplicate h1 headers from website Each page has an H1 header in the main part of the page. The class=header block also had an H1 enclosing "Roundup". This isn't useful as an H1 header. The page title includes Roundup as well so I demoted the class=header H1 to a label but styled it the same. |
| files |
| changeset | ed2359dda3b9 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Remove focus outline around #main when skiplink is triggered. The page jumps to the new section. That's enough to determine the change. No need for the focus outline. |
| files |
| changeset | e7b4ad2c57ac |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | landmarks, skiplink, remove bad attrs, autocomplete search layout.html: Add main and nav landmarks to layout templte. Add skiplink to get to main. Remove Description meta tag from layout template in favor of description metadata in individual files. Remove obsolete border attribute from sourceforge logo. Add autocomplete="on" attribute for search input box. doc/*.txt Remove language attribute from description meta tags. These changes also occur for other files not in this commit. Thse other files have changes to files for the 2.2.0 release not yet tobe committed. |
| files |
| changeset | 339805c4a85b |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Pygments has poor code block contrast outout using sphinx style. Change to borland theme. This eliminated 68 poor contrast (< AA) examples on upgrading.html. Even more on other pages. axe DevTools is now happier. Borland theme/style doesn't color the bacground of the code blocks, so set to lightyellow in style.css. This still allows good contrast. |
| files |
| changeset | c645f51e9e8a |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Make links in a list 48px min-height. Include all lists. Also we have multiple TOC's in some docs. Change #contents to div.contents to get all the links resized for all TOC's. |
| files |
| changeset | 075555472536 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Handle viewport overflow for pre and long paths/url's. |
| files |
| changeset | d93b441ee778 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | 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. |
| files |
| changeset | 7849d8c7d917 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Improve accessibiity, SEO Set up standard html (html5) doctype to stop triggering quirks mode. Add viewport, description meta tags to head. Add aria-label to search box as button provides sighted label. Improve footer contrast. Need black forground. |
| files |
| changeset | c2fd254c9257 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | Doc updates/indexing. doc/admin_guide.txt, doc/customizing.txt, doc/features.txt, doc/installation.txt, doc/mysql.txt, doc/postgresql.txt: adding index entries doc/customizing.txt: reference schema changes later in document in addition to wiki. website/www/contents.txt: make wiki url https:.... Remove indices/tables as they don't show up in web interface. Put docs/announcement.txt into hidden toctree to silence warning from sphinx. Announcement.txt is referenced from index.txt so can't silence by adding to conf.py exclude_patern. website/www/index.txt: mention security and other improvements in jinja2 templates. website/www/conf.py: get rid of all warning by using exclude_patterns to ignore docs that aren't included. Remove exclude_trees using exclude_pattern instead. Make html_add_permalinks value acceptable so no warning reported. website/www/_static/style.css, website/www/_templtes/layout.html: add prev/next/index links for all doc pages. |
| files |
| changeset | c84dbc205b57 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | anatoly techtonik <techtonik@gmail.com> |
| description | website: Save some vertical space in footer |
| files |
| changeset | 2b7425b24243 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | anatoly techtonik <techtonik@gmail.com> |
| description | website: Revise contacts page, add links to archives and web IRC |
| files |
| changeset | 48296d636a40 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | anatoly techtonik <techtonik@gmail.com> |
| description | website: Align SourceForge logo in footer |
| files |
| changeset | 76533e846989 |
|---|---|
| branch | website |
| bookmark | |
| tag | |
| user | Stefan Seefeld <stefan@users.sourceforge.net> |
| description | Refine. |
| files |
| changeset | d62831da3941 |
|---|---|
| branch | website |
| bookmark | |
| tag | |
| user | Stefan Seefeld <stefan@users.sourceforge.net> |
| description | svn repository setup |
| files |