Fix links in documentations

* The main change (in term of importance) is the fix of two broken links that were
pointing to outdated sections ids.
* Added a link to mermaidCLI in the sequenceDiagram section, to reflect the one in
the gantt section.

* Converted some links to https.
This commit is contained in:
Antoine Bolvy 2017-03-23 20:17:01 -04:00
parent 96be32225e
commit b50c15e278
3 changed files with 32 additions and 38 deletions

View File

@ -62,8 +62,8 @@ gantt
section Last section section Last section
Describe gantt syntax :after doc1, 3d Describe gantt syntax :after doc1, 3d
Add gantt diagram to demo page : 20h Add gantt diagram to demo page :20h
Add another diagram to demo page : 48h Add another diagram to demo page :48h
``` ```
Renders like below: Renders like below:
@ -94,10 +94,10 @@ gantt
section Last section section Last section
Describe gantt syntax :after doc1, 3d Describe gantt syntax :after doc1, 3d
Add gantt diagram to demo page : 20h Add gantt diagram to demo page :20h
Add another diagram to demo page : 48h Add another diagram to demo page :48h
``` ```
### title ### Title
Tbd Tbd
@ -109,7 +109,6 @@ Tbd
Tbd Tbd
### Date format ### Date format
Tbd Tbd
@ -251,5 +250,5 @@ noteText | Styles for the text on in the note boxes.
Is it possible to adjust the margins for rendering the sequence diagram. Is it possible to adjust the margins for rendering the sequence diagram.
This is done by defining the **sequenceConfig** part of the configuration object. Read more about it [here](http://knsv.github.io/mermaid/index.html#configuration28). How to use This is done by defining the **sequenceConfig** part of the configuration object. Read more about it [here](#configuration35).
the CLI is described in the [mermaidCLI]((http://knsv.github.io/mermaid/index.html#mermaidCLI) page. How to use the CLI is described in the [mermaidCLI](#mermaid-cli8) page.

View File

@ -4,15 +4,13 @@ order: 0
mermaid mermaid
======= =======
![Alt text](images/header.png) ![Header Image](images/header.png)
>Generation of diagrams and flowcharts from text in a similar manner as markdown. >Generation of diagrams and flowcharts from text in a similar manner as markdown.
Ever wanted to simplify documentation and avoid heavy tools like Visio when explaining your code? Ever wanted to simplify documentation and avoid heavy tools like Visio when explaining your code?
This is why mermaid was born, a simple markdown-like script language for generating charts from text via javascript. [Try it using our editor][live_editor].
This is why mermaid was born, a simple markdown-like script language for generating charts from text via javascript. [Try it using our editor](http://knsv.github.io/mermaid/live_editor).
Code examples below: Code examples below:
@ -59,13 +57,11 @@ gantt
Add to mermaid :1d Add to mermaid :1d
``` ```
Play with mermaid using this [editor](http://danielmschmidt.github.io/mermaid-demo/) or this [live editor](live_editor). Play with mermaid using this [editor](https://danielmschmidt.github.io/mermaid-demo/) or this [live editor][live_editor].
## Credits ## Credits
Many thanks to the [d3](http://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing Many thanks to the [d3](https://d3js.org/) and [dagre-d3](https://github.com/cpettitt/dagre-d3) projects for providing the graphical layout and drawing libraries!
the graphical layout and drawing libraries! Thanks also to the Thanks also to the [js-sequence-diagram](https://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the sequence diagrams.
[js-sequence-diagram](http://bramp.github.io/js-sequence-diagrams) project for usage of the grammar for the
sequence diagrams.
*Mermaid was created by Knut Sveidqvist for easier documentation.* *Mermaid was created by Knut Sveidqvist for easier documentation.*
@ -84,7 +80,7 @@ Mermaid is supported in a number of publishing systems and editors. Please repor
* [Using mermaid via Octopress](http://mostlyblather.com/blog/2015/05/23/mermaid-jekyll-octopress/) * [Using mermaid via Octopress](http://mostlyblather.com/blog/2015/05/23/mermaid-jekyll-octopress/)
* [Mardown editor Haroopad](http://pad.haroopress.com/user.html) * [Mardown editor Haroopad](http://pad.haroopress.com/user.html)
* [Plugin for atom](https://atom.io/packages/atom-mermaid) * [Plugin for atom](https://atom.io/packages/atom-mermaid)
* [Markdown Plus](http://mdp.tylingsoft.com/) * [Markdown Plus](https://mdp.tylingsoft.com/)
* [Vim Plugin](https://github.com/kannokanno/previm) * [Vim Plugin](https://github.com/kannokanno/previm)
* [Sphinx extension](https://github.com/mgaitan/sphinxcontrib-mermaid) * [Sphinx extension](https://github.com/mgaitan/sphinxcontrib-mermaid)
* [Pandoc filter](https://github.com/raghur/mermaid-filter) * [Pandoc filter](https://github.com/raghur/mermaid-filter)
@ -98,4 +94,6 @@ An editor is available for creating diagrams. With it you can quickly start writ
* get a link to a viewer of the diagram * get a link to a viewer of the diagram
* get a link to edit of the diagram to share a diagram so that someone else can tweak it and send a new link back * get a link to edit of the diagram to share a diagram so that someone else can tweak it and send a new link back
* [Editor](http://knsv.github.io/mermaid/live_editor) * [Editor][live_editor]
[live_editor]: https://knsv.github.io/mermaid/live_editor/

View File

@ -59,17 +59,14 @@ Messages can be of two displayed either solid or with a dotted line.
There are six types of arrows currently supported: There are six types of arrows currently supported:
-> which will render a solid line without arrow Type | Description
--- | ---
--> which will render a dotted line without arrow -> | Solid line without arrow
--> | Dotted line without arrow
->> which will render a solid line with arrowhead ->> | Solid line with arrowhead
-->> | Dotted line with arrowhead
-->> which will render a dotted line with arrowhead -x | Solid line with a cross at the end (async)
--x | Dotted line with a cross at the end (async)
-x which will render a solid line with a cross at the end (async)
--x which will render a dotted line with a cross at the end (async)
## Activations ## Activations
@ -337,9 +334,9 @@ text.actor {
Is it possible to adjust the margins for rendering the sequence diagram. Is it possible to adjust the margins for rendering the sequence diagram.
This is done by defining **mermaid.sequenceConfig** or by the CLI to use a json file with the configuration. How to use This is done by defining **mermaid.sequenceConfig** or by the CLI to use a json file with the configuration.
the CLI is described in the mermaidCLI page. How to use the CLI is described in the [mermaidCLI](#mermaid-cli8) page.
mermaid.sequenceConfig can be set to a JSON string with config parameters or the corresponding object. **mermaid.sequenceConfig** can be set to a JSON string with config parameters or the corresponding object.
``` ```
mermaid.sequenceConfig = { mermaid.sequenceConfig = {
@ -356,5 +353,5 @@ mermaid.sequenceConfig = {
Param | Descriotion | Default value Param | Descriotion | Default value
--- | --- | --- --- | --- | ---
mirrorActor|Turns on/off the rendering of actors below the diagram as well as above it|false mirrorActor | Turns on/off the rendering of actors below the diagram as well as above it | false
bottomMarginAdj|Adjusts how far down the graph ended. Wide borders styles with css could generate unwantewd clipping which is why this config param exists.|1 bottomMarginAdj | Adjusts how far down the graph ended. Wide borders styles with css could generate unwantewd clipping which is why this config param exists. | 1