|
2 | 2 |
|
3 | 3 |     
|
4 | 4 |
|
5 |
| -The [Directed Graph Markup Language (dgml)](https://en.wikipedia.org/wiki/DGML) can be used to visualize things like processes, hierarchies flows and many other things. |
| 5 | +The [Directed Graph Markup Language (dgml)](https://en.wikipedia.org/wiki/DGML) can be used to visualize things like processes, hierarchies, flows and many other things. |
6 | 6 |
|
7 | 7 | This extension for Visual Studio Code can be used to render a *.dgml file into a graphical representation of the graph. Find it on the [Visual Studio Code marketplace](https://marketplace.visualstudio.com/items?itemName=coderAllan.vscode-dgmlviewer).
|
8 | 8 |
|
9 | 9 | ## Visualize DGML files
|
10 | 10 |
|
11 |
| -To visualize a dgml file i Visual Studio code you click on the file to open it, then you select the DGML Viewer command from the command pallette to render the graph into a graphical representation. |
| 11 | +To visualize a dgml file in Visual Studio Code you click on the file to open it, then you select the "DGMLViewer: Render the dgml graph" command from the command pallette to render the graph. |
12 | 12 |
|
13 |
| -When the dgml file has been rendered you can save the representation into a PNG file. |
| 13 | +When the dgml file has been rendered you can save the representation as a PNG file. |
14 | 14 |
|
15 | 15 | 
|
16 | 16 |
|
17 |
| -You can also choose to only save a selected part of the graph. |
18 |
| - |
19 |
| -You do this by clicking the 'Save selection as png' button, then right-click and drag to select the area you want to save. The selection is saved when you let go of the mouse button. |
| 17 | +You can also choose to only save part of the graph. You do this by clicking the 'Save selection as png' button, then right-click and drag to select the area you want to save. The selection is saved when you let go of the mouse button. |
20 | 18 |
|
21 | 19 | 
|
22 | 20 |
|
23 | 21 | In a DirectedGraph file you can [link a node to an external file](https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2015/modeling/customize-code-maps-by-editing-the-dgml-files?view=vs-2015#to-link-a-document-or-url-to-a-code-element"). DGMLViewer will determine if the file is accessible on the disk and if it is then the node is clickable and will open the file in vscode when the node is clicked.
|
24 | 22 |
|
25 | 23 | 
|
26 | 24 |
|
27 |
| -By default if the DirectedGraph element of the dgml file has a GraphDirection attribute, then this value is used to layout the graph. But by clicking the 'Change layout' checkbox you can change the layout of the graph. It will not change the dgml file itself, it will only change the rendering of the file. |
| 25 | +You can change the rendered layout of the directed graph by clicking the 'Change layout' checkbox and the choose a layout in the dropdown box. It will not change the dgml file itself, it will only change the rendering of the graph. |
28 | 26 |
|
29 | 27 | 
|
30 | 28 |
|
@@ -57,3 +55,7 @@ See the full list of settings below the screenshot.
|
57 | 55 | ## Known Issues
|
58 | 56 |
|
59 | 57 | The [Directed Graph Markup Language (dgml)](https://en.wikipedia.org/wiki/DGML) has the ability to specify conditional rendering of the graph. This is done by using the Style elements in the specification. In the current version of this DGMLViewer extension for Visual Studio code this conditional rendering is very limited. Only the 'HasCategory(...)' condition is evaluated.
|
| 58 | + |
| 59 | +## Third party components and resources |
| 60 | + |
| 61 | +* [Cytoscape.js](https://js.cytoscape.org/) - Used for rendering the directed graph. |
0 commit comments