plugin:mermaid
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:mermaid [2023-07-17 14:22] – 45.9.85.254 | plugin:mermaid [2024-02-15 23:08] (current) – Update for version 10.8 robertweinmeister | ||
---|---|---|---|
Line 6: | Line 6: | ||
email : develop@weinmeister.org | email : develop@weinmeister.org | ||
type : syntax | type : syntax | ||
- | lastupdate : 2023-07-07 | + | lastupdate : 2024-02-15 |
- | compatible : !Greebo, Hogfather, Igor, Jack Jackrum+ | + | compatible : Greebo, Hogfather, Igor, Jack Jackrum, Kaos+ |
depends | depends | ||
conflicts | conflicts | ||
Line 13: | Line 13: | ||
tags : mermaid, diagram, flowchart, graph, sequence | tags : mermaid, diagram, flowchart, graph, sequence | ||
- | downloadurl: | + | downloadurl: |
bugtracker : https:// | bugtracker : https:// | ||
sourcerepo : https:// | sourcerepo : https:// | ||
Line 28: | Line 28: | ||
===== Examples/ | ===== Examples/ | ||
+ | |||
+ | Provide the Mermaid code enclosed by the ''< | ||
< | < | ||
< | < | ||
- | graph TD | + | |
- | A-->B | + | A(**mermaid**)-->B((__plugin__)) |
- | A-->C | + | A-->C(((// |
- | B-->D | + | B-->D[[" |
C-->D | C-->D | ||
</ | </ | ||
Line 64: | Line 66: | ||
''# | ''# | ||
- | For more examples and details on the mermaid | + | For more examples and details on the syntax, see [[https:// |
+ | |||
+ | ===== Raw Mode ===== | ||
+ | |||
+ | If needed, the Mermaid code can be passed on without any processing or rendering by DokuWiki. Insert a line containing only the word raw before the Mermaid code: | ||
+ | |||
+ | < | ||
+ | raw | ||
+ | graph TD | ||
+ | A(**mermaid**)--> | ||
+ | A--> | ||
+ | B--> | ||
+ | C-->D | ||
+ | </ | ||
+ | |||
+ | This allows to use the full feature set of Mermaid without interference from DokuWiki, albeit at the expanse of not being able to use any functionality provided by DokuWiki. | ||
===== Configuration and Settings ===== | ===== Configuration and Settings ===== | ||
- | There is only one setting. You can choose which Mermaid version you want to use: | + | No further configuration |
+ | |||
+ | ==== Version and Location ==== | ||
+ | |||
+ | You can choose which Mermaid version you want to use: | ||
* the locally hosted version | * the locally hosted version | ||
* the remotely hosted, currently available, latest version | * the remotely hosted, currently available, latest version | ||
* a remotely hosted specific version | * a remotely hosted specific version | ||
+ | |||
+ | ==== Default theme ==== | ||
+ | |||
+ | You can choose which Mermaid theme should be used as a default. The available themes are the five [[https:// | ||
+ | |||
+ | ===== Known Problems ===== | ||
+ | |||
+ | The syntax of Mermaid and DokuWiki can clash in rare cases. If you encounter problems, feel free to report them and open an issue. | ||
+ | |||
+ | You can sidestep these problems by using the [[plugin: | ||
+ | |||
+ | ==== Usage of Brackets ==== | ||
+ | |||
+ | Mermaid and DokuWiki both use brackets. If you need to use them both at the same time, make your intentions clear by using quotation marks like: | ||
+ | < | ||
+ | |||
+ | ==== Binding Click Events ==== | ||
+ | |||
+ | Mermaid supports the [[https:// | ||
+ | |||
+ | < | ||
+ | flowchart TD | ||
+ | A[Link] | ||
+ | click A " | ||
+ | </ | ||
+ | |||
+ | please use | ||
+ | |||
+ | < | ||
+ | flowchart TD | ||
+ | A[" | ||
+ | </ | ||
+ | |||
+ | ==== DokuWiki Search Highlight ==== | ||
+ | |||
+ | The search highlight of the DokuWiki search can prevent the proper parsing of the diagram, leading to an error. For that reason, it is disabled for the Mermaid diagrams. The search itself is not affected. | ||
===== Development ===== | ===== Development ===== | ||
In the file '' | In the file '' | ||
+ | |||
+ | ===== License ===== | ||
+ | |||
+ | This project is licensed under the GNU General Public License v2.0, included as LICENSE. | ||
+ | |||
+ | Mermaid is licensed under the MIT License, included as LICENSE Mermaid. | ||
===== Change Log ===== | ===== Change Log ===== | ||
+ | * **2024-02-15** | ||
+ | * Update to support the new Mermaid version 10.8 | ||
+ | * Adds option to set site-wide default theme | ||
+ | * Fixes a possible problem due to the DokuWiki search highlight | ||
+ | * **2023-11-17** | ||
+ | * Update to support the new Mermaid version 10.6 | ||
+ | * **2023-09-04** | ||
+ | * Added raw mode | ||
+ | * Update to support the new Mermaid version 10.4 | ||
+ | * **2023-07-21** | ||
+ | * Bug fix: Double brackets are now supported | ||
* **2023-07-07** | * **2023-07-07** | ||
- | * Bug fix | + | * Bug fix: Elk renderer now working for all versions |
* **2023-07-04** | * **2023-07-04** | ||
* Update to support the new Mermaid version 10.2 | * Update to support the new Mermaid version 10.2 |
plugin/mermaid.txt · Last modified: 2024-02-15 23:08 by robertweinmeister