Myst compat

[stevepiercy]

This PR provides MyST compatibility and cleans up English grammar, syntax, and spelling for the Mastering Plone training only. I did not do any other trainings, as this is for a POC. See also #508, #507, and #506.

[spereverde]

I tested it locally, LGTM

[stevepiercy]

Excellent. I'd like @pbauer and @ksuess to also test and review.

I still have to share the workflow I used to create this PR. I'll share during our sprint tomorrow.

[pbauer]

I tested it locally and converted transmogrifier as described in myst-parser.md and it worked great.

[stevepiercy]

DO NOT MERGE! I want to discuss how to migrate all the trainings, not just this one.

[ksuess]

Sorry for responding so late.
The converted mastering chapters already look great. Special elements could be fixed manually. I would volonteer.
I converted locally the /voltoaddons training. Also fine; just the glossary needs some manual fix, as the directive 'glossary' seems to be not available.

That's what I checked:

• code block, line numbers
• collapsed blocks
• footnote
• highlighted blocks (note, see also,..)
• strange conversion, but OK: images. see
  /mastering-plone-myst/volto_addon.html

:::{figure} _static/volto-columns-block.png
:alt: The eea volto-columns-block package gives you a block with columns. Each column
:  is its own separate blocks container.
:::

[ksuess]

I wonder if it would be easier to document what's going on, if we separate four pull requests for:

• first: conversion to myst (markdown)
  • if possible remove explicit line breaks with pipes, as @stevepiercy suggests, and similar not conversables
• second (or third): clean up English grammar, syntax, and spelling (in already converted markdown files)
• third (or second:) fix some things that must be fixed manually and cannot be automated. I am curious on your script, @stevepiercy.
• fourth: new theme Sphinx book theme: https://sphinx-book-theme.readthedocs.io/en/latest/
  (Theme sphinx-book-theme #507)

[stevepiercy]

Aim to complete the following PRs by Thu, Sep 2, 7pm CEST/10am Pacific, when we next meet.

1. Agree upon the process to convert all trainings from reST to MyST. @stevepiercy
2. Convert all the files per the process. @stevepiercy
3. Technical corrections. @spereverde @ksuess
4. English language fixes, grammar, spelling. @stevepiercy
5. Apply sphinxbook theme. @spereverde @ksuess
6. Merge all individual trainings' conf.pys and glossary into a single conf.py and glossary at the root level. @stevepiercy

[stevepiercy]

I converted locally the /voltoaddons training. Also fine; just the glossary needs some manual fix, as the directive 'glossary' seems to be not available.

Try:

:term:`myterm`

I think the original should move the alt text into the caption.

.. figure:: _static/volto-columns-block.png
    :alt: Default layout options for eea.volto-columns-block

    The `eea.volto-columns-block` package gives you a block with columns.
    Each column is its own separate blocks container.

There was a somewhat related issue that was resolved. It would be good to file a report.

[stevepiercy]

This PR is superseded by PR #511.

One commit 869c3e7 is useful when updating the source .rst files. It should be cherry picked into a separate PR, either one that is part of the rst2myst conversion or before that process begins. I would vote for the latter to keep the steps distinct.

[ksuess]

This PR is superseded by PR #511.

One commit 869c3e7 is useful when updating the source .rst files. It should be cherry picked into a separate PR, either one that is part of the rst2myst conversion or before that process begins. I would vote for the latter to keep the steps distinct.

hi @stevepiercy, this is superseeded, as you mentioned. Would you update your thoughts about this in "relaunch" milestone, tahnks.

[stevepiercy]

Closing in favor of #511,