13:03:07 <matjazp> #startmeeting training-guides
13:03:08 <openstack> Meeting started Tue Aug 22 13:03:07 2017 UTC and is due to finish in 60 minutes.  The chair is matjazp. Information about MeetBot at http://wiki.debian.org/MeetBot.
13:03:09 <openstack> Useful Commands: #action #agreed #help #info #idea #link #topic #startvote.
13:03:11 <openstack> The meeting name has been set to 'training_guides'
13:03:15 <ianychoi> matjazp, Hello :)
13:03:23 <matjazp> hey in
13:03:26 <matjazp> ianychoi
13:03:37 <ianychoi> :)
13:03:43 <matjazp> how are you?
13:03:58 <matjazp> #link Agenda at https://etherpad.openstack.org/p/training-guides-meeting-agenda
13:04:06 <ianychoi> I'm good - although I am busy with my lots of work unfortunately
13:04:11 <ianychoi> How about u?
13:04:38 <matjazp> fine. Still in Ireland, though.
13:05:04 <matjazp> we don't have anything special on the Agenda
13:05:10 <ianychoi> Aha
13:05:21 <matjazp> hey ildikov, you here?
13:05:25 <ildikov> hi
13:05:33 <ildikov> sorry, on a call in parallel
13:05:43 <matjazp> np
13:05:55 <ianychoi> ildikov, hello - fine :)
13:06:11 <matjazp> I was just wondering, if you had any time to investigate that Hieroglyph issue from the last meeting?
13:06:11 <ildikov> I started to look into the slide build, but didn't get lucky so far
13:06:37 <ianychoi> Hmm, not yet - but it is on my to-do list
13:06:47 <matjazp> ildikov: what was the blocker?
13:06:52 <ildikov> tried to find something that's more out of the box and is also maintained, but not much is out there
13:07:00 <ildikov> basically my laptop... :)
13:07:17 <matjazp> ildikov: for converting from RST, right?
13:07:27 <ildikov> I have a VM I play with things in and VirtualBox kills my laptop time to time for some reason
13:07:51 <ianychoi> Hmm..
13:07:55 <ildikov> yeah, I tried to replace hieroglyph with something else
13:08:06 <matjazp> hmmm.. you use the last version? on Windows?
13:08:10 <ildikov> but couldn't really get it work
13:08:12 <ildikov> Mac
13:08:18 <ildikov> and yeah, I updated it
13:08:47 <matjazp> you could switch to Docker for this
13:08:49 <ildikov> I also had some coding to do, so it might be that as the temperature was also a bit higher around here my laptop just got too hot...
13:09:06 <matjazp> and use that embedded hypervisor
13:09:09 <ianychoi> ildikov, oh you might need to replace with a new laptop?
13:09:22 <ildikov> nah, my Mac is not that old
13:09:24 <ianychoi> How old your laptop is?
13:09:49 <ianychoi> Not old.. fan might not work well
13:09:50 <ildikov> I just don't really turn it off and I think there's also some dust in it, so I should get it cleaned
13:10:06 <ildikov> anyway, we're not here to fix my laptop :)
13:10:16 <ianychoi> :)
13:10:20 <ildikov> I don't have too much experience with these tools, so it might take a while
13:10:39 <ildikov> if either of you have time to also check on it, feel free to jump in and keep me posted where you got
13:10:43 <matjazp> hehe, but all geeks like to throw in their expertise on how to fix a laptop ;)
13:10:47 <ianychoi> matjazp, would you happily share your experience with rst2html5 previously?
13:10:51 <ildikov> :)
13:11:41 <ianychoi> Actually, my desktop PC in my home does not work. I need to fix it, but fortunately my laptop works well :)
13:11:55 <matjazp> ianychoi: I would, if I could remember the details - but I don't unfortunately. I just remember that the conversion was not good and then we just stayed on Hieroglyph
13:12:20 <ianychoi> I got it :) thanks!
13:15:13 <matjazp> but we did agreed to switch to reveal.js, right? or is that still tentative?
13:16:20 <matjazp> I would hate to make a lot of effort to switch to something that is not actively maintained
13:18:42 <ianychoi> reveal.js is not maintained anymore?
13:18:49 <matjazp> no, it is
13:19:18 <ildikov> I think it is maintained
13:20:13 <matjazp> I was just thinking out loud that reveal.js is the obvious choice, but I don't mind if we use something else. We just have to be careful to not choose a project with a small community
13:20:21 <matjazp> like Hieroglyph
13:21:57 <ildikov> I didn't really find maintained alternatives
13:22:16 <ildikov> although I'm sure I could've done a more thorough search...
13:25:21 <matjazp> ok, so we all try the conversion and report back in 2 weeks
13:26:40 <matjazp> is there anything else that we need to discuss?
13:27:10 <ildikov> not from me
13:27:17 <ianychoi> I have simply tested with rst2html5-tools but I cannot do with reveal.js now
13:27:53 <matjazp> ianychoi: ok
13:28:06 <ianychoi> https://github.com/marianoguerra/rst2html5/issues/88
13:28:40 <ianychoi> #link http://paste.openstack.org/show/619035/
13:28:50 <ianychoi> matjazp, did you see the same error message?
13:29:52 <ianychoi> #link https://pypi.python.org/pypi/rst2html5-tools/0.5.3
13:30:15 <ianychoi> I downloaded rst2html5-tools sources from the link but there is no league.css file. Hmm
13:30:58 <ianychoi> Using deck.js is fine but we might see how to apply theme
13:31:28 <ildikov> I finally didn't play with this, wasn't sure how much more it's maintained compared to the current tool we're using
13:31:48 <matjazp> hmm.. but isn't that fixed? from that bug report it looks like it
13:33:11 <ianychoi> Yep the bug report definitely looks like it but it does not work now from my trial.
13:33:33 <matjazp> ildikov: true
13:33:51 <matjazp> maybe this is, or will be in near future, a dead end like Hieroglyph
13:34:18 <ildikov> ianychoi: they might not released the fix as of yet :/
13:34:25 <matjazp> just a couple of commits per year
13:35:01 <matjazp> ianychoi: looks like you have to use it from the repo, not pypi
13:36:20 <ianychoi> Hmm, I will try to do that, but I prefer to use pip and using pip is what OpenStack repos do
13:36:54 <ildikov> yeah, pip would be better, I agree
13:36:56 <ianychoi> I do not have more topics, except "open reviews"
13:36:58 <ianychoi> #link https://review.openstack.org/#/q/project:openstack/training-guides+status:open
13:37:37 <ildikov> the current link redirects automatically
13:37:56 <matjazp> yes, isnt that changed automatically
13:38:07 <matjazp> so I would prefer to not manually change it
13:38:09 <ildikov> and the image is rendered there too
13:38:31 <ildikov> matjazp: I had the same thought, but wasn't sure about the background of the update
13:39:00 <matjazp> hmm.. we should check with Infra guys
13:39:00 <ildikov> maybe we would need to change this eventually anyway?
13:39:39 <kmARC> (would make sense, this hieroglyph is very painful)
13:40:19 <ianychoi> #link https://review.openstack.org/#/c/493725/
13:40:33 <ildikov> kmARC: do you have any other tool in mind?
13:40:48 <ianychoi> Since there is a similar patch, it would be fine I think.
13:40:48 <matjazp> kmARC: READme.rst in this patch is not rendered into slides
13:41:52 <matjazp> ianychoi: ok, I agree. It is not a complex patch anyway
13:42:09 <ildikov> matjazp: +1
13:42:15 <kmARC> I worked with reveal.js (painful too), however I'd just do some PoC and evaluation with the current most(TM) hipster(TM) tools(TM). I think what's important is that we have rst/markdown -> html conversion and _REAL_ working full screen.
13:42:44 <ildikov> kmARC: not that many options are out there as I saw
13:43:02 <ianychoi> matjazp, +1
13:43:03 <ildikov> kmARC: but I think we're open for suggestions :)
13:43:28 <matjazp> reveal.js is probably the safest option - a large community, lots of options
13:44:39 <matjazp> kmARC: and reveal.js does have a full screen presentation ;)
13:45:02 <kmARC> I know, I used it
13:47:17 <matjazp> ok, let's just wrap this for today
13:47:50 <matjazp> is that ok for all?
13:48:17 <ianychoi> Yep.. I think so
13:48:38 <ildikov> yep
13:49:27 <matjazp> thanks for your time
13:49:34 <matjazp> see you all in 2 weeks
13:49:54 <ianychoi> Hmm
13:49:58 <matjazp> in the mean time, we can try a few conversions and report back the results
13:49:59 <ianychoi> matjazp, one question
13:50:03 <ianychoi> #link https://github.com/nyergler/hieroglyph/issues/124
13:50:03 <matjazp> oh
13:50:25 <matjazp> yes?
13:50:29 <ianychoi> According to this, the main reason why hieroglyph does not work is related with https://github.com/sphinx-doc/sphinx/pull/3648
13:51:08 <ianychoi> Would it be nice if I write a comment on this pull request? As far as I know, some sphinx themes also do not work well.
13:51:27 <matjazp> as I see it, even if we fix this upstream, there is still so many issues with hieroglyph, that we need to change it anyway
13:52:40 <ianychoi> Hmm, okay - let's think about more with longer term maintenance perspective :)
13:52:47 <matjazp> exactly
13:53:19 <matjazp> so see you all in 2 weeks
13:53:21 <matjazp> bye
13:53:25 <ianychoi> Bye!
13:53:56 <matjazp> #endmeeting