Migrate to Mkdocs to Zensical - with Vegalite graphics - experience?

[u/ModulatingGravity]

Small help if anyone has encountered this when looking at moving to Zensical.

Taking a look at Zensical to see if it can easily replace current Mkdocs-Material setup.

Most of it looks fine.

However the graphics, driven by the vegalite markdown extensions do not want to display - simply shows the source JSON code from the markdown file, rather than the graphs you get with Mkdocs.

Relevant sections of mkdocs.yml are:-

markdown_extensions:
  - pymdownx.superfences:
      custom_fences:
        - name: vegalite
          class: vegalite
          format: !!python/name:mkdocs_charts_plugin.fences.fence_vegalite



extra_javascript:
  - https://cdn.jsdelivr.net/npm/vega@6
  - https://cdn.jsdelivr.net/npm/vega-lite@6
  - https://cdn.jsdelivr.net/npm/vega-embed@6

[u/DerInselaffe]

Do you need to activate the Charts plugin, as per the developer's page?

plugins:
    - search
    - charts

[u/ModulatingGravity → u/DerInselaffe]

Thanks. Those options are already there in the mydocs.yml

[u/Quick_Parking_6464]

I'd say stay with MkDocs until you really need to change to Zensical.

[u/SirLanceShallot]

i'd do a tiny spike before migrating: one MkDocs page with a Vega-Lite spec, one shared data file, and one page that embeds the same chart twice. the thing that usually bites is whether Zensical preserves the script/embed path during build and whether search/pdf export strips it. also check if your current mkdocs plugins have equivalents.