dosubot[bot] commented on issue #408:
URL:
https://github.com/apache/incubator-hugegraph-doc/issues/408#issuecomment-3027063842
<!-- Answer -->
The Docsy bug described in google/docsy#1882 (where Mermaid rendering fails
if `[params.mermaid]` is missing) does not affect HugeGraph docs as
implemented. The theme logic in this repo only loads Mermaid scripts if
`.Site.Params.mermaid.enable` is set, so the specific `var params = null`
TypeError cannot occur here. Your Mermaid diagrams are not rendering because
the required config is missing, not due to the upstream bug.
To fix Mermaid rendering, add this to your `config.toml`:
```toml
[params.mermaid]
enable = true
[markup]
[markup.highlight]
guessSyntax = false
```
This will enable Mermaid support and ensure diagrams render as expected. For
future troubleshooting, consider tracking the Docsy theme version or commit in
your repo for clarity on upstream changes and bug status.
[Reference: scripts.html
logic](https://github.com/apache/incubator-hugegraph-doc/blob/48ff6f261c634e8d8ae9c4fac9e21524f67424b5/themes/docsy/layouts/partials/scripts.html)
<!-- Dosu Comment Footer -->
*To reply, just mention [@dosu](https://go.dosu.dev/dosubot).*
---
<sup>How did I do?
[Good](https://app.dosu.dev/response-feedback/c62e15d2-8a33-48d5-868e-faabff410479?feedback_type=great_response)
|
[Irrelevant](https://app.dosu.dev/response-feedback/c62e15d2-8a33-48d5-868e-faabff410479?feedback_type=irrelevant_answer)
|
[Incorrect](https://app.dosu.dev/response-feedback/c62e15d2-8a33-48d5-868e-faabff410479?feedback_type=incorrect_sources)
|
[Verbose](https://app.dosu.dev/response-feedback/c62e15d2-8a33-48d5-868e-faabff410479?feedback_type=too_verbose)
|
[Hallucination](https://app.dosu.dev/response-feedback/c62e15d2-8a33-48d5-868e-faabff410479?feedback_type=hallucination)
| [Report
🐛](https://app.dosu.dev/response-feedback/c62e15d2-8a33-48d5-868e-faabff410479?feedback_type=bug_report)
|
[Other](https://app.dosu.dev/response-feedback/c62e15d2-8a33-48d5-868e-faabff410479?feedback_type=other)</sup> [](https://go.dosu.dev/discord-bot) [!
[Share on
X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/apache/incubator-hugegraph-doc/issues/408)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
