Skip to content

Commit 533b142

Browse files
committed
Update readme
1 parent 0a6cf86 commit 533b142

3 files changed

Lines changed: 29 additions & 6 deletions

File tree

README-src.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,20 @@ Graphviz.NetWrapper
55

66
## Supported platforms
77

8+
### Windows
89
At the moment, `Rubjerg.Graphviz` ships with a bunch of precompiled Graphviz dlls built for 64 bit Windows.
910
This library is compatible with .NET Standard 2.0.
1011
The unit tests run against .NET Framework 4.8 and .NET 8.0.
11-
In the future support may be extended to other platforms.
12+
13+
### Linux (Experimental)
14+
We do have experimental support for Linux.
15+
In the same vein as our windows build, we ship precompiled binaries to make sure that this library is deployed with the same binaries as we've tested it.
16+
However, we do not ship graphviz dependencies, you will have to installed those yourself, if you need them.
17+
[Here is a list of all the graphviz dependencies.](https://packages.fedoraproject.org/pkgs/graphviz/graphviz/fedora-rawhide.html#dependencies)
18+
In practice you may not need all of those.
19+
In particular, if you only want to read graphs and e.g. run the DOT algorithm, libc and libz are enough.
20+
To run our tests successfully you will also need libgts and libpcre2 (for the neato algorithm).
21+
For more details, check the dependencies of any graphviz binaries with `ldd`.
1222

1323
## Contributing
1424

@@ -24,7 +34,6 @@ You can either add this library as a nuget package to project, or include the so
2434
project reference.
2535

2636
### Adding as a Nuget package
27-
2837
Add the [Rubjerg.Graphviz nuget package](https://www.nuget.org/packages/Rubjerg.Graphviz/) to
2938
your project.
3039

README.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,20 @@ Graphviz.NetWrapper
55

66
## Supported platforms
77

8+
### Windows
89
At the moment, `Rubjerg.Graphviz` ships with a bunch of precompiled Graphviz dlls built for 64 bit Windows.
910
This library is compatible with .NET Standard 2.0.
1011
The unit tests run against .NET Framework 4.8 and .NET 8.0.
11-
In the future support may be extended to other platforms.
12+
13+
### Linux (Experimental)
14+
We do have experimental support for Linux.
15+
In the same vein as our windows build, we ship precompiled binaries to make sure that this library is deployed with the same binaries as we've tested it.
16+
However, we do not ship graphviz dependencies, you will have to installed those yourself, if you need them.
17+
[Here is a list of all the graphviz dependencies.](https://packages.fedoraproject.org/pkgs/graphviz/graphviz/fedora-rawhide.html#dependencies)
18+
In practice you may not need all of those.
19+
In particular, if you only want to read graphs and e.g. run the DOT algorithm, libc and libz are enough.
20+
To run our tests successfully you will also need libgts and libpcre2 (for the neato algorithm).
21+
For more details, check the dependencies of any graphviz binaries with `ldd`.
1222

1323
## Contributing
1424

@@ -24,7 +34,6 @@ You can either add this library as a nuget package to project, or include the so
2434
project reference.
2535

2636
### Adding as a Nuget package
27-
2837
Add the [Rubjerg.Graphviz nuget package](https://www.nuget.org/packages/Rubjerg.Graphviz/) to
2938
your project.
3039

@@ -48,7 +57,7 @@ documents presented at the [Graphviz documentation page](https://graphviz.org/do
4857

4958
## Tutorial
5059

51-
```cs
60+
```cs
5261
using NUnit.Framework;
5362
using System.Linq;
5463

@@ -267,4 +276,4 @@ public class Tutorial
267276
Assert.AreNotEqual(Edge.ConvertUidToPortName(":"), Edge.ConvertUidToPortName("|"));
268277
}
269278
}
270-
```
279+
```
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
echo Generating README.md
2+
cat ../README-src.md > ../README.md
3+
printf '```cs\n' >> ../README.md
4+
cat Tutorial.cs >> ../README.md
5+
printf '```' >> ../README.md

0 commit comments

Comments
 (0)