| *** rcernin has joined #openstack-doc | 00:00 | |
| *** rcernin has quit IRC | 03:06 | |
| *** rcernin has joined #openstack-doc | 03:11 | |
| *** dmacpher has quit IRC | 04:41 | |
| *** miloa has joined #openstack-doc | 06:04 | |
| *** miloa has quit IRC | 06:38 | |
| *** rcernin has quit IRC | 07:29 | |
| *** tosky has joined #openstack-doc | 08:28 | |
| *** rcernin has joined #openstack-doc | 08:48 | |
| *** rcernin has quit IRC | 09:00 | |
| *** rcernin has joined #openstack-doc | 09:52 | |
| *** rcernin has quit IRC | 10:07 | |
| *** rcernin has joined #openstack-doc | 10:07 | |
| *** rcernin has quit IRC | 10:20 | |
| *** rcernin has joined #openstack-doc | 10:27 | |
| *** rcernin has quit IRC | 10:38 | |
| *** rcernin has joined #openstack-doc | 10:51 | |
| *** rcernin has quit IRC | 11:05 | |
| *** dmacpher has joined #openstack-doc | 12:10 | |
| *** pcaruana has quit IRC | 12:30 | |
| *** pcaruana has joined #openstack-doc | 12:39 | |
| *** rcernin has joined #openstack-doc | 14:01 | |
| *** rcernin has quit IRC | 14:06 | |
| *** diablo_rojo has joined #openstack-doc | 15:09 | |
| *** openstackgerrit has joined #openstack-doc | 15:26 | |
| openstackgerrit | Ghanshyam Mann proposed openstack/openstack-manuals master: Update site for deprecated monasca-transform & monasca-analytics https://review.opendev.org/c/openstack/openstack-manuals/+/783670 | 15:26 |
|---|---|---|
| openstackgerrit | Ghanshyam Mann proposed openstack/openstack-manuals master: Update site for deprecated monasca-transform & monasca-analytics https://review.opendev.org/c/openstack/openstack-manuals/+/783670 | 15:27 |
| pmatulis | johnsom, good afternoon. i'm pleased to report that my pdf-generation troubles boil down to a handful of blocks where latex nomenclature is utilised to print math formulas [1]. since these are very rare for me i can just make images out of them but do you see any easy clear way forward? | 17:24 |
| pmatulis | [1]: https://pastebin.ubuntu.com/p/Cp93ZRmdTC/ | 17:24 |
| johnsom | Hmm, does the process error out with those today? | 17:25 |
| johnsom | I think I had one, but I think I got it to render correctly. Let me look | 17:25 |
| pmatulis | yeah, it hangs on many steps. i press any key to get to the next, etc. this is what it looks like: https://paste.ubuntu.com/p/K9pGhXcfb6/ | 17:29 |
| johnsom | pmatulis So my guess is there is a missing latex preampble in the conf.py. | 17:32 |
| johnsom | https://github.com/openstack/octavia/blob/master/doc/source/conf.py#L212 | 17:33 |
| johnsom | you may need some math related packages. | 17:33 |
| johnsom | Total guess: | 17:33 |
| johnsom | https://www.irccloud.com/pastebin/MKdv2fRZ/ | 17:33 |
| pmatulis | so those would be part of bindep.txt? | 17:35 |
| johnsom | I don't think so. At least on Ubuntu most of those are already bundled in the texlive-* packages that are already in the bindep.txt | 17:37 |
| johnsom | https://packages.ubuntu.com/focal/all/texlive-latex-extra/filelist | 17:38 |
| johnsom | Though it's a bit of trial and error usually for me when I need to find what package has which latex bits in it. | 17:39 |
| johnsom | Hmm, the middle example you pasted doesn't use the asmmath module.... | 17:43 |
| pmatulis | johnsom, after adding your preamble i'm getting: | 17:52 |
| pmatulis | py.error.ENOENT: [No such file or directory]: getcwd() | 17:52 |
| johnsom | typo? | 17:52 |
| pmatulis | looking | 17:53 |
| johnsom | I'm trying to setup a test environment here to try out those math blocks | 17:54 |
| pmatulis | this is my PR. i removed the math blocks to get it to build. but now i'm getting the above errors after adding to conf.py: | 18:01 |
| pmatulis | https://review.opendev.org/c/openstack/charm-deployment-guide/+/782581 | 18:01 |
| pmatulis | (blocks removed from keystone.rst) | 18:01 |
| pmatulis | errors: https://paste.ubuntu.com/p/hQhty85Hwc/ | 18:07 |
| johnsom | I see you changed the profile in bindep from doc to pdf, does that zuul job use pdf? | 18:08 |
| johnsom | https://zuul.opendev.org/t/openstack/build/d79a1cac44b24ed68fab91b9f668f34b/log/zuul-info/inventory.yaml#24 | 18:10 |
| johnsom | That path thing just looks like a filesystem path changed. I would cd / and then back into the directory | 18:12 |
| pmatulis | ok, cd stuff works now. thanks | 18:14 |
| pmatulis | as for zuul job and 'doc/pdf', i'm not sure | 18:14 |
| johnsom | I think it has to be "doc" for the bindep profile | 18:15 |
| pmatulis | will change it. i admit to not knowing how to verify | 18:16 |
| pmatulis | i put the math blocks back and no progress... | 18:17 |
| johnsom | pmatulis I have it figured out for you | 18:35 |
| johnsom | https://www.irccloud.com/pastebin/nNodxlEX/ | 18:35 |
| johnsom | Anywhere you have a begin/end wrapper, you need to add :nowarp: | 18:35 |
| johnsom | sphinx does some automatic wrapping of the formula and that conflicts with the explicit begin/end | 18:37 |
| pmatulis | \o/ | 18:39 |
| pmatulis | so should i remove the additions to conf.py? it builds and looks good on first inspection | 18:39 |
| johnsom | Yeah, turns out you don't need that as you are not using the asmmath equivalent functions. | 18:40 |
| pmatulis | what does that give me again? maybe i should keep it | 18:41 |
| johnsom | It's an alternate library for doing math formulas. It's considered more modern from what little I know. However, if this works for you, there is no point in reworking all of your formulas into asmmath | 18:41 |
| johnsom | http://www.texfaq.org/FAQ-eqnarray | 18:43 |
| johnsom | I am far from a latex expert, so... Don't quote me. grin | 18:43 |
| pmatulis | well this is literally all i have: https://pastebin.ubuntu.com/p/Cp93ZRmdTC/ | 18:44 |
| pmatulis | so maybe i will remove the extra conf.py stuff for now | 18:45 |
| johnsom | Yeah, just leave that and add the ":nowrap:" and you should be good. Though you will have to find all instances of the begin/end and do the same | 18:45 |
| johnsom | Yeah, I would | 18:45 |
| pmatulis | thanks a lot for this | 18:46 |
| johnsom | NP, this is the benefit of a community process! | 18:46 |
| pmatulis | do i need to do something special to get the PDF download icon thingy? | 18:47 |
| pmatulis | i don't see it on my HTML docs | 18:47 |
| johnsom | https://github.com/openstack/octavia/blob/master/doc/source/conf.py#L344 | 18:48 |
| johnsom | If that is set and you don't get it, you might check the version of the openstack theme module is up to date. | 18:48 |
| johnsom | I have this in the doc/requirements.txt | 18:49 |
| johnsom | openstackdocstheme>=2.2.1 # Apache-2.0 | 18:49 |
| pmatulis | yeah, that's what i got. lemme see if this works! | 18:50 |
| pmatulis | nope :( | 18:51 |
| johnsom | I don't see it in the conf.py in the patch. | 18:53 |
| pmatulis | no, i didn't push it yet | 18:55 |
| pmatulis | k, there now | 19:00 |
| johnsom | Oh, in that tox there are not non-pdf docs jobs. I think that pdf link tag only matters for the "normal" doc build job.... | 19:03 |
| johnsom | Hmmm, it's deploy-guid. | 19:04 |
| johnsom | pmatulis I see the link there, but the PDF job didn't run | 19:09 |
| johnsom | It looks like the zuul job template deploy-guide-jobs doesn't run the PDF generation. For that, you need to find someone that is more familiar with the "deploy-guide-jobs" zuul template than I am. | 19:11 |
| pmatulis | alrighty. i will send an email to the list. prolly continue the initial thread i started | 19:13 |
| johnsom | Yep, sounds like a plan. Maybe the deploy-guide jobs were not updated for pdf... Not sure, we use a different template | 19:14 |
| johnsom | At least you have everything working, it's just getting them to publish correctly now. | 19:14 |
| pmatulis | yep, thanks again. i'm starting to find little things here and there in the PDF that i'll like to improve | 19:15 |
| pmatulis | like an image that doesn't get printed where it should. it gets put at the top of the very next page | 19:16 |
| pmatulis | and i was sure i had a multi-level TOC but now i only get top-level headers | 19:16 |
| pmatulis | k, got the TOC going | 19:24 |
| *** diablo_rojo has quit IRC | 20:35 | |
| *** kopecmartin has quit IRC | 20:56 | |
| *** kopecmartin has joined #openstack-doc | 21:01 | |
| *** dasp has quit IRC | 22:13 | |
| *** dasp has joined #openstack-doc | 22:19 | |
| *** rcernin has joined #openstack-doc | 22:24 | |
| *** rcernin has quit IRC | 22:24 | |
| *** rcernin has joined #openstack-doc | 22:24 | |
Generated by irclog2html.py 2.17.2 by Marius Gedminas - find it at https://mg.pov.lt/irclog2html/!