Phoenix icon indicating copy to clipboard operation
Phoenix copied to clipboard

Formatting of online documentation home page for 4.2.2 is a bit compact.

Open reticulatus opened this issue 1 year ago • 6 comments

Looking at https://docs.wxpython.org/ the layout of the home page looks a bit scrunched up compared to 4.2.1.

Docs_4 2 2

Docs_4 2 1

I get similar results in Firefox, Waterfox and Chromium browsers.

reticulatus avatar Sep 12 '24 15:09 reticulatus

Also, in the Inheritance diagrams, some of the text in some of the boxes is cropped at the top, as shown in the bottom two boxes in the example below:

TopLevelWindow diagram

ghost avatar Sep 12 '24 16:09 ghost

Sigh, yeah I ran into lots of issues trying to build the documentation - mostly related to sphinx dependencies that have been updated but no longer work with old sphinx (2.2.0). The first issue you noted seems to be a bug in the generation.

I might just try updating to the latest sphinx (and unpin all its dependencies) and see how things look.

swt2c avatar Sep 12 '24 17:09 swt2c

I see that there are non-dev tar.gz files of the demo (wxPython-demo-4.2.2.tar.gz), docs (wxPython-docs-4.2.2.tar.gz) and docset (wxPython-docset-4.2.2.tar.gz) in https://wxpython.org/Phoenix/snapshot-builds/

Should they be in a new folder: https://extras.wxpython.org/wxPython4/extras/4.2.2/ ?

ghost avatar Sep 12 '24 19:09 ghost

I see that there are non-dev tar.gz files of the demo (wxPython-demo-4.2.2.tar.gz), docs (wxPython-docs-4.2.2.tar.gz) and docset (wxPython-docset-4.2.2.tar.gz) in https://wxpython.org/Phoenix/snapshot-builds/

Should they be in a new folder: https://extras.wxpython.org/wxPython4/extras/4.2.2/ ?

Yes, I fixed that manually for now. I didn't automate that part yet. I also am not sure about those pdb files.

swt2c avatar Sep 12 '24 23:09 swt2c

I noticed in line 95 of the index.html file in 4.2.2, there is an </aside> tag. When I replaced that tag with </div> (like there was in the 4.2.1 version), the formatting of the page appeared to be fixed.

It might be worth considering this as a temporary fix while you investigate the issue.

ghost avatar Sep 13 '24 10:09 ghost

Thanks! I made that change by hand. That definitely seems to have been the bug caused by .

Meanwhile, that bug doesn't exist when I build with the latest sphinx (but others do, sigh) so...

swt2c avatar Sep 13 '24 22:09 swt2c