| 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 | 85aae98b8c82 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | John Rouillard <rouilj@ieee.org> |
| description | docs: bold summary lines in update list; fix formatting issue. When scanning the document, the summary lines in the list didn't standout. Also the spacing before and after the summary line were equal. The spacing under the line should be less to tie it to the following paragraph. Not sure I like the bolded summary lines, it's a little too much emphasis. I think the css tweak works though. |
| 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 | 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 | 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 | 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 | 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 | 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 | 515ab1749b14 |
|---|---|
| branch | |
| bookmark | |
| tag | 1.5.1 |
| user | anatoly techtonik <techtonik@gmail.com> |
| description | Preparing 1.5.1 steps 7/16 7. python setup.py build_doc * fix include of basic.css for rendering permalink anchors * make anchors less obtrusive |
| files |
| changeset | 7cf0468a9fa4 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | anatoly techtonik <techtonik@gmail.com> |
| description | Remove duplicated link to page source from doc footer |
| files |
| changeset | bca7c59ac400 |
|---|---|
| branch | |
| bookmark | |
| tag | |
| user | Stefan Seefeld <stefan@seefeld.name> |
| description | Enhance documentation generation. |
| files |