settingsLogin | Registersettings

[openstack-dev] [docs] [training-guides] Moving from Hieroglyph for rendering slides

0 votes

Hi all,

Andreas filed a bug report [1] that can impact what will we use to render slides for Upstream University and other training related slide material in the future. We’ve already had many discussions at Training guides meetings about moving to some other more actively maintained/developed framework for slides.

We were leaning towards adopting a widely popular Reveal.js [2]. On the downside, that probably also means that we will have to convert slide material from RST to MD, as RST is not directly supported. With a shrinking (Docs&Training guides) contributors, that could be a problem.

Any other ideas or preferences?

Cheers,
Matjaz

[1] https://bugs.launchpad.net/openstack-training-guides/+bug/1708240
[2] https://github.com/hakimel/reveal.js/


OpenStack Development Mailing List (not for usage questions)
Unsubscribe: OpenStack-dev-request@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
asked Aug 3, 2017 in openstack-docs by Pančur,_Matjaž (200 points)   1

2 Responses

0 votes

On Thursday, 3 August 2017 18:18:31 CEST Pančur, Matjaž wrote:
Hi all,

Andreas filed a bug report [1] that can impact what will we use to render
slides for Upstream University and other training related slide material in
the future. We’ve already had many discussions at Training guides meetings
about moving to some other more actively maintained/developed framework for
slides.

We were leaning towards adopting a widely popular Reveal.js [2]. On the
downside, that probably also means that we will have to convert slide
material from RST to MD, as RST is not directly supported. With a shrinking
(Docs&Training guides) contributors, that could be a problem.

Maybe you already discussed it, but can't you use pandoc to convert from rst
to reveal.js?

Ciao
--
Luigi


OpenStack Development Mailing List (not for usage questions)
Unsubscribe: OpenStack-dev-request@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
responded Aug 3, 2017 by Luigi_Toscano (1,700 points)   2
0 votes

On 2017-08-03 16:18:31 +0000 (+0000), Pančur, Matjaž wrote:
[...]
We were leaning towards adopting a widely popular Reveal.js [2].
On the downside, that probably also means that we will have to
convert slide material from RST to MD, as RST is not directly
supported. With a shrinking (Docs&Training guides) contributors,
that could be a problem.
[...]

===============================
Have your cake and eat it too
===============================

rst2html5_ usage example to generate a set of slides using
reveal.js::

rst2html5 --jquery --reveal-js --pretty-print-code \
    examples/slides.rst > reveal.html

.. _rst2html5: https://pypi.org/project/rst2html5-tools/

--
Jeremy Stanley


OpenStack Development Mailing List (not for usage questions)
Unsubscribe: OpenStack-dev-request@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

responded Aug 3, 2017 by Jeremy_Stanley (56,700 points)   3 5 7
...