April 2021 - petsc-dev - mailman3.cels.anl.gov

Re: [petsc-dev] empty space on left side of website pages
by Jacob Faibussowitsch 27 Apr '21

27 Apr '21

One of the primary goals of the new documentation was that maintenance of docs be as streamlined as possible, i.e. through a single API/language/interface. A new dev should have to learn the absolute bare minimum possible to be able to make changes to documentation, so while CSS add-ons is on face less code diff and simpler to implement right now, it doesn’t fit with the single API doctrine. Best regards, Jacob Faibussowitsch (Jacob Fai - booss - oh - vitch) > On Apr 27, 2021, at 09:33, Karl Rupp <rupp(a)iue.tuwien.ac.at> wrote: > > Hi, > > such adjustments should not need a direct modification of the theme. One can just override the CSS settings in custom CSS files instead: > https://docs.readthedocs.io/en/stable/guides/adding-custom-css.html > > The benefit of such an approach is that all future updates of the theme will continue to work. Plus, one has all CSS-tweaks neatly collected in a small file (ideally just a few lines). > > Best regards, > Karli > > On 4/26/21 8:58 AM, Patrick Sanan wrote: >> As far as I know (which isn't very far, with web stuff), changing things on that level requires somehow getting into CSS. >> For instance, you can see what it looks like with other widths directly from Firefox (fun, didn't know you could do this): >> - go to the page >> - hit F12 >> - click around on the left to find the <div> that corresponds to the part you care about >> - look in the middle column to find the piece of CSS that's controlling things (here, something called .col-md-3) >> - edit the CSS - in attached screenshot I change the max width of that sidebar to 5%. >> But, I want to avoid having to do things on the level of CSS and HTML - I think that should be done as a collective effort in maintaining the theme (and Sphinx itself). >> If we really care enough about the width of that sidebar, we'll create a fork of the theme, add a setting for it, and try to get it merged to the theme's release branch. >>> Am 23.04.2021 um 23:12 schrieb Barry Smith <bsmith(a)petsc.dev <mailto:[email protected]>>: >>> >>> >>> Thanks. Even if we just leave it is there a way to make it a little "skinnier", it seems very wide in my default browser. >>> >>> >>> >>>> On Apr 23, 2021, at 1:08 PM, Patrick Sanan <patrick.sanan(a)gmail.com <mailto:[email protected]>> wrote: >>>> >>>> It is possible to put things there, as in this link which is both documentation and example: >>>> https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht… <https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht…> >>>> >>>> Other projects using this theme have the mostly-empty left sidebar: >>>> https://numpy.org/doc/stable/ <https://numpy.org/doc/stable/> >>>> https://jupyter.readthedocs.io/en/latest/ <https://jupyter.readthedocs.io/en/latest/> >>>> >>>> (They also have fancier landing pages, though, which we have been discussing). >>>> >>>> >>>> It goes away on mobile devices or small windows, at least. >>>> >>>> >>>>> Am 23.04.2021 um 19:21 schrieb Barry Smith <bsmith(a)petsc.dev <mailto:[email protected]>>: >>>>> >>>>> >>>>> There is a lot of empty space on the left side of the website pages; under the Search slot. Does this empty left side need to be so large, seems to waste a lot of the screen? >>>>> >>>>> Barry >>>>> >>>> >>>

1 0

Re: [petsc-dev] empty space on left side of website pages
by Karl Rupp 27 Apr '21

27 Apr '21

Hi, such adjustments should not need a direct modification of the theme. One can just override the CSS settings in custom CSS files instead: https://docs.readthedocs.io/en/stable/guides/adding-custom-css.html The benefit of such an approach is that all future updates of the theme will continue to work. Plus, one has all CSS-tweaks neatly collected in a small file (ideally just a few lines). Best regards, Karli On 4/26/21 8:58 AM, Patrick Sanan wrote: > As far as I know (which isn't very far, with web stuff), changing things > on that level requires somehow getting into CSS. > > For instance, you can see what it looks like with other widths directly > from Firefox (fun, didn't know you could do this): > - go to the page > - hit F12 > - click around on the left to find the <div> that corresponds to the > part you care about > - look in the middle column to find the piece of CSS that's controlling > things (here, something called .col-md-3) > - edit the CSS - in attached screenshot I change the max width of that > sidebar to 5%. > > But, I want to avoid having to do things on the level of CSS and HTML - > I think that should be done as a collective effort in maintaining the > theme (and Sphinx itself). > If we really care enough about the width of that sidebar, we'll create a > fork of the theme, add a setting for it, and try to get it merged to the > theme's release branch. > >> Am 23.04.2021 um 23:12 schrieb Barry Smith <bsmith(a)petsc.dev >> <mailto:[email protected]>>: >> >> >> ï¿½ ï¿½Thanks. Even if we just leave it is there a way to make it a little >> "skinnier", it seems very wide in my default browser. >> >> >> >>> On Apr 23, 2021, at 1:08 PM, Patrick Sanan <patrick.sanan(a)gmail.com >>> <mailto:[email protected]>> wrote: >>> >>> It is possible to put things there, as in this link which is both >>> documentation and example: >>> https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht… >>> <https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht…> >>> >>> Other projects using this theme have the mostly-empty left sidebar: >>> https://numpy.org/doc/stable/ <https://numpy.org/doc/stable/> >>> https://jupyter.readthedocs.io/en/latest/ >>> <https://jupyter.readthedocs.io/en/latest/> >>> >>> (They also have fancier landing pages, though, which we have been >>> discussing). >>> >>> >>> It goes away on mobile devices or small windows, at least. >>> >>> >>>> Am 23.04.2021 um 19:21 schrieb Barry Smith <bsmith(a)petsc.dev >>>> <mailto:[email protected]>>: >>>> >>>> >>>> ï¿½ï¿½There is a lot of empty space on the left side of the website >>>> pages; under the Search slot. ï¿½Does this empty left side need to be >>>> so large, seems to waste a lot of the screen? >>>> >>>> ï¿½ï¿½Barry >>>> >>> >> >

1 0

Re: [petsc-dev] empty space on left side of website pages
by Jed Brown 26 Apr '21

26 Apr '21

Generic use of sphinx-panels doesn't spread out into the sidebar, but panels with some diagrams/figures would still improve the landing page. https://pandas.pydata.org/docs/index.html Patrick Sanan <patrick.sanan(a)gmail.com> writes: > Part of the reason that the huge, empty sidebar looks so bad is that it's on the front page - in the interests of simplicity and focusing on getting the build stable, I haven't been focusing on it, but there is still discussion to be had about whether and how to make a prettier front/landing page. > >> Am 26.04.2021 um 21:05 schrieb Jed Brown <jed(a)jedbrown.org>: >> >> The sphinx-pydata-theme has great mobile support and lots of development energy behind it. I don't want to switch themes again based on a sidebar sizing concern. If the sidebar width is super important, we can adjust the CSS. The standard CSS has this, which I think is what we'd want to adjust. >> >> .container-xl { >> max-width: 1400px >> } >> >> Scott Kruger <kruger(a)txcorp.com> writes: >> >>> Rather than have us edit the CSS, perhaps just getting people to agree >>> to a different theme: >>> https://sphinx-themes.org/ >>> >>> I think alabaster, aiohttp, cloud_sptheme, ... meet Barry's complaint. >>> >>> There is a lot to like on the kotti_docs_theme for example although the >>> bar is on the right instead of the left. >>> >>> Scott >>> >>> On 2021-04-26 08:58, Patrick Sanan did write: >>>> As far as I know (which isn't very far, with web stuff), changing things on that level requires somehow getting into CSS. >>>> >>>> For instance, you can see what it looks like with other widths directly from Firefox (fun, didn't know you could do this): >>>> - go to the page >>>> - hit F12 >>>> - click around on the left to find the <div> that corresponds to the part you care about >>>> - look in the middle column to find the piece of CSS that's controlling things (here, something called .col-md-3) >>>> - edit the CSS - in attached screenshot I change the max width of that sidebar to 5%. >>>> >>>> But, I want to avoid having to do things on the level of CSS and HTML - I think that should be done as a collective effort in maintaining the theme (and Sphinx itself). >>>> If we really care enough about the width of that sidebar, we'll create a fork of the theme, add a setting for it, and try to get it merged to the theme's release branch. >>>> >>>> >>>>> Am 23.04.2021 um 23:12 schrieb Barry Smith <bsmith(a)petsc.dev>: >>>>> >>>>> >>>>> Thanks. Even if we just leave it is there a way to make it a little "skinnier", it seems very wide in my default browser. >>>>> >>>>> >>>>> >>>>>> On Apr 23, 2021, at 1:08 PM, Patrick Sanan <patrick.sanan(a)gmail.com <mailto:[email protected]>> wrote: >>>>>> >>>>>> It is possible to put things there, as in this link which is both documentation and example: >>>>>> https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht… <https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht…> >>>>>> >>>>>> Other projects using this theme have the mostly-empty left sidebar: >>>>>> https://numpy.org/doc/stable/ <https://numpy.org/doc/stable/> >>>>>> https://jupyter.readthedocs.io/en/latest/ <https://jupyter.readthedocs.io/en/latest/> >>>>>> >>>>>> (They also have fancier landing pages, though, which we have been discussing). >>>>>> >>>>>> >>>>>> It goes away on mobile devices or small windows, at least. >>>>>> >>>>>> >>>>>>> Am 23.04.2021 um 19:21 schrieb Barry Smith <bsmith(a)petsc.dev <mailto:[email protected]>>: >>>>>>> >>>>>>> >>>>>>> There is a lot of empty space on the left side of the website pages; under the Search slot. Does this empty left side need to be so large, seems to waste a lot of the screen? >>>>>>> >>>>>>> Barry >>>>>>> >>>>>> >>>>> >>>> >>> >>> -- >>> Scott Kruger >>> Tech-X Corporation kruger(a)txcorp.com >>> 5621 Arapahoe Ave, Suite A Phone: (720) 466-3196 >>> Boulder, CO 80303 Fax: (303) 448-7756

1 0

Re: [petsc-dev] empty space on left side of website pages
by Patrick Sanan 26 Apr '21

26 Apr '21

Part of the reason that the huge, empty sidebar looks so bad is that it's on the front page - in the interests of simplicity and focusing on getting the build stable, I haven't been focusing on it, but there is still discussion to be had about whether and how to make a prettier front/landing page. > Am 26.04.2021 um 21:05 schrieb Jed Brown <jed(a)jedbrown.org>: > > The sphinx-pydata-theme has great mobile support and lots of development energy behind it. I don't want to switch themes again based on a sidebar sizing concern. If the sidebar width is super important, we can adjust the CSS. The standard CSS has this, which I think is what we'd want to adjust. > > .container-xl { > max-width: 1400px > } > > Scott Kruger <kruger(a)txcorp.com> writes: > >> Rather than have us edit the CSS, perhaps just getting people to agree >> to a different theme: >> https://sphinx-themes.org/ >> >> I think alabaster, aiohttp, cloud_sptheme, ... meet Barry's complaint. >> >> There is a lot to like on the kotti_docs_theme for example although the >> bar is on the right instead of the left. >> >> Scott >> >> On 2021-04-26 08:58, Patrick Sanan did write: >>> As far as I know (which isn't very far, with web stuff), changing things on that level requires somehow getting into CSS. >>> >>> For instance, you can see what it looks like with other widths directly from Firefox (fun, didn't know you could do this): >>> - go to the page >>> - hit F12 >>> - click around on the left to find the <div> that corresponds to the part you care about >>> - look in the middle column to find the piece of CSS that's controlling things (here, something called .col-md-3) >>> - edit the CSS - in attached screenshot I change the max width of that sidebar to 5%. >>> >>> But, I want to avoid having to do things on the level of CSS and HTML - I think that should be done as a collective effort in maintaining the theme (and Sphinx itself). >>> If we really care enough about the width of that sidebar, we'll create a fork of the theme, add a setting for it, and try to get it merged to the theme's release branch. >>> >>> >>>> Am 23.04.2021 um 23:12 schrieb Barry Smith <bsmith(a)petsc.dev>: >>>> >>>> >>>> Thanks. Even if we just leave it is there a way to make it a little "skinnier", it seems very wide in my default browser. >>>> >>>> >>>> >>>>> On Apr 23, 2021, at 1:08 PM, Patrick Sanan <patrick.sanan(a)gmail.com <mailto:[email protected]>> wrote: >>>>> >>>>> It is possible to put things there, as in this link which is both documentation and example: >>>>> https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht… <https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht…> >>>>> >>>>> Other projects using this theme have the mostly-empty left sidebar: >>>>> https://numpy.org/doc/stable/ <https://numpy.org/doc/stable/> >>>>> https://jupyter.readthedocs.io/en/latest/ <https://jupyter.readthedocs.io/en/latest/> >>>>> >>>>> (They also have fancier landing pages, though, which we have been discussing). >>>>> >>>>> >>>>> It goes away on mobile devices or small windows, at least. >>>>> >>>>> >>>>>> Am 23.04.2021 um 19:21 schrieb Barry Smith <bsmith(a)petsc.dev <mailto:[email protected]>>: >>>>>> >>>>>> >>>>>> There is a lot of empty space on the left side of the website pages; under the Search slot. Does this empty left side need to be so large, seems to waste a lot of the screen? >>>>>> >>>>>> Barry >>>>>> >>>>> >>>> >>> >> >> -- >> Scott Kruger >> Tech-X Corporation kruger(a)txcorp.com >> 5621 Arapahoe Ave, Suite A Phone: (720) 466-3196 >> Boulder, CO 80303 Fax: (303) 448-7756

1 0

Re: [petsc-dev] empty space on left side of website pages
by Jed Brown 26 Apr '21

26 Apr '21

The sphinx-pydata-theme has great mobile support and lots of development energy behind it. I don't want to switch themes again based on a sidebar sizing concern. If the sidebar width is super important, we can adjust the CSS. The standard CSS has this, which I think is what we'd want to adjust. .container-xl { max-width: 1400px } Scott Kruger <kruger(a)txcorp.com> writes: > Rather than have us edit the CSS, perhaps just getting people to agree > to a different theme: > https://sphinx-themes.org/ > > I think alabaster, aiohttp, cloud_sptheme, ... meet Barry's complaint. > > There is a lot to like on the kotti_docs_theme for example although the > bar is on the right instead of the left. > > Scott > > On 2021-04-26 08:58, Patrick Sanan did write: >> As far as I know (which isn't very far, with web stuff), changing things on that level requires somehow getting into CSS. >> >> For instance, you can see what it looks like with other widths directly from Firefox (fun, didn't know you could do this): >> - go to the page >> - hit F12 >> - click around on the left to find the <div> that corresponds to the part you care about >> - look in the middle column to find the piece of CSS that's controlling things (here, something called .col-md-3) >> - edit the CSS - in attached screenshot I change the max width of that sidebar to 5%. >> >> But, I want to avoid having to do things on the level of CSS and HTML - I think that should be done as a collective effort in maintaining the theme (and Sphinx itself). >> If we really care enough about the width of that sidebar, we'll create a fork of the theme, add a setting for it, and try to get it merged to the theme's release branch. >> >> >> > Am 23.04.2021 um 23:12 schrieb Barry Smith <bsmith(a)petsc.dev>: >> > >> > >> > Thanks. Even if we just leave it is there a way to make it a little "skinnier", it seems very wide in my default browser. >> > >> > >> > >> >> On Apr 23, 2021, at 1:08 PM, Patrick Sanan <patrick.sanan(a)gmail.com <mailto:[email protected]>> wrote: >> >> >> >> It is possible to put things there, as in this link which is both documentation and example: >> >> https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht… <https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht…> >> >> >> >> Other projects using this theme have the mostly-empty left sidebar: >> >> https://numpy.org/doc/stable/ <https://numpy.org/doc/stable/> >> >> https://jupyter.readthedocs.io/en/latest/ <https://jupyter.readthedocs.io/en/latest/> >> >> >> >> (They also have fancier landing pages, though, which we have been discussing). >> >> >> >> >> >> It goes away on mobile devices or small windows, at least. >> >> >> >> >> >>> Am 23.04.2021 um 19:21 schrieb Barry Smith <bsmith(a)petsc.dev <mailto:[email protected]>>: >> >>> >> >>> >> >>> There is a lot of empty space on the left side of the website pages; under the Search slot. Does this empty left side need to be so large, seems to waste a lot of the screen? >> >>> >> >>> Barry >> >>> >> >> >> > >> > > -- > Scott Kruger > Tech-X Corporation kruger(a)txcorp.com > 5621 Arapahoe Ave, Suite A Phone: (720) 466-3196 > Boulder, CO 80303 Fax: (303) 448-7756

1 0

Re: [petsc-dev] empty space on left side of website pages
by Scott Kruger 26 Apr '21

26 Apr '21

Rather than have us edit the CSS, perhaps just getting people to agree to a different theme: https://sphinx-themes.org/ I think alabaster, aiohttp, cloud_sptheme, ... meet Barry's complaint. There is a lot to like on the kotti_docs_theme for example although the bar is on the right instead of the left. Scott On 2021-04-26 08:58, Patrick Sanan did write: > As far as I know (which isn't very far, with web stuff), changing things on that level requires somehow getting into CSS. > > For instance, you can see what it looks like with other widths directly from Firefox (fun, didn't know you could do this): > - go to the page > - hit F12 > - click around on the left to find the <div> that corresponds to the part you care about > - look in the middle column to find the piece of CSS that's controlling things (here, something called .col-md-3) > - edit the CSS - in attached screenshot I change the max width of that sidebar to 5%. > > But, I want to avoid having to do things on the level of CSS and HTML - I think that should be done as a collective effort in maintaining the theme (and Sphinx itself). > If we really care enough about the width of that sidebar, we'll create a fork of the theme, add a setting for it, and try to get it merged to the theme's release branch. > > > > Am 23.04.2021 um 23:12 schrieb Barry Smith <bsmith(a)petsc.dev>: > > > > > > Thanks. Even if we just leave it is there a way to make it a little "skinnier", it seems very wide in my default browser. > > > > > > > >> On Apr 23, 2021, at 1:08 PM, Patrick Sanan <patrick.sanan(a)gmail.com <mailto:[email protected]>> wrote: > >> > >> It is possible to put things there, as in this link which is both documentation and example: > >> https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht… <https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht…> > >> > >> Other projects using this theme have the mostly-empty left sidebar: > >> https://numpy.org/doc/stable/ <https://numpy.org/doc/stable/> > >> https://jupyter.readthedocs.io/en/latest/ <https://jupyter.readthedocs.io/en/latest/> > >> > >> (They also have fancier landing pages, though, which we have been discussing). > >> > >> > >> It goes away on mobile devices or small windows, at least. > >> > >> > >>> Am 23.04.2021 um 19:21 schrieb Barry Smith <bsmith(a)petsc.dev <mailto:[email protected]>>: > >>> > >>> > >>> There is a lot of empty space on the left side of the website pages; under the Search slot. Does this empty left side need to be so large, seems to waste a lot of the screen? > >>> > >>> Barry > >>> > >> > > > -- Scott Kruger Tech-X Corporation kruger(a)txcorp.com 5621 Arapahoe Ave, Suite A Phone: (720) 466-3196 Boulder, CO 80303 Fax: (303) 448-7756

1 0

Re: [petsc-dev] empty space on left side of website pages
by Patrick Sanan 26 Apr '21

26 Apr '21

As far as I know (which isn't very far, with web stuff), changing things on that level requires somehow getting into CSS. For instance, you can see what it looks like with other widths directly from Firefox (fun, didn't know you could do this): - go to the page - hit F12 - click around on the left to find the <div> that corresponds to the part you care about - look in the middle column to find the piece of CSS that's controlling things (here, something called .col-md-3) - edit the CSS - in attached screenshot I change the max width of that sidebar to 5%. But, I want to avoid having to do things on the level of CSS and HTML - I think that should be done as a collective effort in maintaining the theme (and Sphinx itself). If we really care enough about the width of that sidebar, we'll create a fork of the theme, add a setting for it, and try to get it merged to the theme's release branch. > Am 23.04.2021 um 23:12 schrieb Barry Smith <bsmith(a)petsc.dev>: > > > Thanks. Even if we just leave it is there a way to make it a little "skinnier", it seems very wide in my default browser. > > > >> On Apr 23, 2021, at 1:08 PM, Patrick Sanan <patrick.sanan(a)gmail.com <mailto:[email protected]>> wrote: >> >> It is possible to put things there, as in this link which is both documentation and example: >> https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht… <https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht…> >> >> Other projects using this theme have the mostly-empty left sidebar: >> https://numpy.org/doc/stable/ <https://numpy.org/doc/stable/> >> https://jupyter.readthedocs.io/en/latest/ <https://jupyter.readthedocs.io/en/latest/> >> >> (They also have fancier landing pages, though, which we have been discussing). >> >> >> It goes away on mobile devices or small windows, at least. >> >> >>> Am 23.04.2021 um 19:21 schrieb Barry Smith <bsmith(a)petsc.dev <mailto:[email protected]>>: >>> >>> >>> There is a lot of empty space on the left side of the website pages; under the Search slot. Does this empty left side need to be so large, seems to waste a lot of the screen? >>> >>> Barry >>> >> >

1 0

Re: [petsc-dev] -info from just one process?
by Mark Adams 24 Apr '21

24 Apr '21

I did not know about -log_trace. Good to know, Thanks On Fri, Apr 23, 2021 at 8:19 AM Stefano Zampini <stefano.zampini(a)gmail.com> wrote: > > > >> I'm not talking about timings, I am talking about seeing where a code >> dies. >> > > When codes die within the MPI implementation is basically impossible to > provide a backtrace from PETSc, but the MPI implementation may offer some > verbose messaging. > If this happens quite early in the code (and I presume here we are failing > somewhere in the 1-to-all pattern when distributing the plex data > structure) running with -log_trace may get you some insight on where this > is happening (provided that the offending PETSc routine calls > LogEventBegin/End) > > In my experience, the sad story is that when there are software > vendor failures with a large number of processes, I haven't found anything > more efficient than a few bisection steps with good old printfs.... > > >> >> >>> As a side note, one would expect that this kind of behavior is >>> consistent across the library. >>> But in fact, it isn’t. If you do something like -sub_ksp_view_pmat file >>> with, for example, DD preconditioners, you end up with a single file with >>> all local matrices scrambled in. >>> It would be nice to have the same logic, i.e., file.%p, and be able to >>> filter ranks that actually print to file like you suggest. >>> These kind of options are less critical than -info so I can just insert >>> them in the option database after initialization, if rank == view_this_rank >>> PetscOptionsInsertString(), but doing that using command line arguments >>> would be easier and more elegant, IMO. >>> >>> Thanks, >>> Pierre >>> >>> Barry >>> >>> On Apr 22, 2021, at 11:14 AM, Mark Adams <mfadams(a)lbl.gov> wrote: >>> >>> OK, so -info out.%p would do what I asked. Alas, what I really need it >>> to reduce the output with 128K processes. >>> Thanks, >>> >>> On Thu, Apr 22, 2021 at 11:54 AM Pierre Jolivet <pierre(a)joliv.et> wrote: >>> >>>> >>>> >>>> On 22 Apr 2021, at 5:33 PM, Jacob Faibussowitsch <jacob.fai(a)gmail.com> >>>> wrote: >>>> >>>> Not out of the box no. There is -info ::self which makes info only >>>> print from calls made on PETSC_COMM_SELF, but I don’t think that’s what you >>>> want. Best advice would be to print to a file and grep the file for any >>>> lines starting with the rank number you want. >>>> >>>> >>>> There is no need for grep, IMHO, just do -info file and then open >>>> file.%p >>>> >>>> Thanks, >>>> Pierre >>>> >>>> Best regards, >>>> >>>> Jacob Faibussowitsch >>>> (Jacob Fai - booss - oh - vitch) >>>> >>>> On Apr 22, 2021, at 10:16, Mark Adams <mfadams(a)lbl.gov> wrote: >>>> >>>> Can I make -info only print from one process? >>>> Mark >>>> >>>> >>>> >>>> >>> >>> > > -- > Stefano >

1 0

Re: [petsc-dev] commenting on/asking questions on documentation pages
by Barry Smith 23 Apr '21

23 Apr '21

Scott, Great discovery. We should evaluate these from several points of view and maybe end up supporting all of them :-) since each has its strengths and weaknesses. > On Apr 23, 2021, at 12:33 PM, Scott Kruger <kruger(a)txcorp.com> wrote: > > > > I do not know much about these: > https://sphinx-comments.readthedocs.io/en/latest/ > > I'm still not sure a link to a gitlab "New Issue" wouldn't be superior > however. > > Scott > > On 2021-04-23 12:16, Barry Smith did write: >> >> Maybe the "edit" code could be copied and modified to go to a new issue window (and stick the URL into the issue) and then let people type. Could it even be clever enough to stick the issue number into the displayed webpage as clickable. Not perfect, but at least we would get notifications for each comment. >> >> Then the page might have a sidebar like >> >> Edit this page >> Comment, ask question on page >> >> Comment !2345 >> Comment !4555 >> >> Shouldn't Sphinx have such a beast? >> >> >> Barry >> >> >> >>> On Apr 23, 2021, at 8:50 AM, Patrick Sanan <patrick.sanan(a)gmail.com> wrote: >>> >>> >>> >>>> Am 23.04.2021 um 04:45 schrieb Barry Smith <bsmith(a)petsc.dev <mailto:[email protected]>>: >>>> >>>> >>>> I can edit documentation pages directly from the page now, this is totally awesome but I see no button to comment or ask questions on a page. >>>> >>>> I think every page should, by the edit button, have a "Comment, ask questions" button that anyone can click on to make a comment or ask a question about the page. It would be super fantastic if they could refer to particular people in their comments but perhaps that is too difficult. >>> >>> >>>> For example I am looking at https://petsc.gitlab.io/-/petsc/-/jobs/1204309863/artifacts/public/overview… <https://petsc.gitlab.io/-/petsc/-/jobs/1204309863/artifacts/public/overview…> and I immediately want to ask >>>> >>>> Where is the TS solver table in the list of solver tables? >>>> >>>> Barry >>>> >>>> Note the pre-historic PETSc html manual pages which everyone despises have a button in the upper right hand corner to report problems/ask questions so what I am asking for is not unprecedented. Our old code uses email which is not ideal but not ideal is better than not. Surely modern systems like Sphinx have this support built in? >>>> >>> >>> I think the intended way to do this with our Sphinx template would be to add custom HTML templates, which can then be added to the sidebar. >>> https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht… <https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht…> >>> >>> I'm worried that this involves too much scripting and customization, though. For example here's the way the "edit this page" link is done: >>> https://github.com/pydata/pydata-sphinx-theme/blob/master/pydata_sphinx_the… <https://github.com/pydata/pydata-sphinx-theme/blob/master/pydata_sphinx_the…> >>> >>> Doesn't seem too bad but it relies on a pretty big chunk of Python as well: >>> https://github.com/pydata/pydata-sphinx-theme/blob/master/pydata_sphinx_the… <https://github.com/pydata/pydata-sphinx-theme/blob/master/pydata_sphinx_the…> >>> >>> >>> >>> I'll open an issue on this, though, since it's entirely possible that someone else (or me, later) will think of a simple way to make this work, as it would indeed be a great feature. >> > > -- > Scott Kruger > Tech-X Corporation kruger(a)txcorp.com > 5621 Arapahoe Ave, Suite A Phone: (720) 466-3196 > Boulder, CO 80303 Fax: (303) 448-7756

1 0

Re: [petsc-dev] empty space on left side of website pages
by Barry Smith 23 Apr '21

23 Apr '21

Thanks. Even if we just leave it is there a way to make it a little "skinnier", it seems very wide in my default browser. > On Apr 23, 2021, at 1:08 PM, Patrick Sanan <patrick.sanan(a)gmail.com> wrote: > > It is possible to put things there, as in this link which is both documentation and example: > https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht… <https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/sections.ht…> > > Other projects using this theme have the mostly-empty left sidebar: > https://numpy.org/doc/stable/ <https://numpy.org/doc/stable/> > https://jupyter.readthedocs.io/en/latest/ <https://jupyter.readthedocs.io/en/latest/> > > (They also have fancier landing pages, though, which we have been discussing). > > > It goes away on mobile devices or small windows, at least. > > >> Am 23.04.2021 um 19:21 schrieb Barry Smith <bsmith(a)petsc.dev <mailto:[email protected]>>: >> >> >> There is a lot of empty space on the left side of the website pages; under the Search slot. Does this empty left side need to be so large, seems to waste a lot of the screen? >> >> Barry >> >

1 0