my_graph{};
```
-Implementations for common [graph algorithms](#algorithms) are provided under the `algorithm` namespace. Combining this with built-in `dot` format support allows us to do things like visualizing the shortest path between two vertices:
+Implementations for common [graph algorithms](#algorithms) are provided under the `algorithm` namespace. Combining this
+with built-in `dot` format support allows us to do things like visualizing the shortest path between two vertices:
@@ -57,22 +66,30 @@ Implementations for common [graph algorithms](#algorithms) are provided under th
To get started, take a look at our [quickstart guide](https://bobluppes.github.io/graaf/docs/quickstart/intro).
# Installation
-The most straightforward way to use the Graaf in your project is to include it as a header-only library. Please take a look at the [installation guide](https://bobluppes.github.io/graaf/docs/quickstart/installation) for alternative installation methods.
+
+The most straightforward way to use the Graaf in your project is to include it as a header-only library. Please take a
+look at the [installation guide](https://bobluppes.github.io/graaf/docs/quickstart/installation) for alternative
+installation methods.
## Header-Only Library
+
The Graaf libary can be included as a header-only library. All it requires is a compiler with C++ 20 support.
-Download the `header-only` library from our [release page](https://github.com/bobluppes/graaf/releases) and add the `include/graaflib` directory to your include path. You can now use Graaf in your source files:
+Download the `header-only` library from our [release page](https://github.com/bobluppes/graaf/releases) and add
+the `include/graaflib` directory to your include path. You can now use Graaf in your source files:
```c++
// main.cpp
#include
```
-For more details or alternative installation methods, see the [installation guide](https://bobluppes.github.io/graaf/docs/quickstart/installation).
+For more details or alternative installation methods, see
+the [installation guide](https://bobluppes.github.io/graaf/docs/quickstart/installation).
# Algorithms
-Algorithms implemented in the Graaf library include the following. For more information on individual algorithms please take a look at the [docs](https://bobluppes.github.io/graaf/docs/algorithms/intro).
+
+Algorithms implemented in the Graaf library include the following. For more information on individual algorithms please
+take a look at the [docs](https://bobluppes.github.io/graaf/docs/algorithms/intro).
1. [**Traversal Algorithms**](https://bobluppes.github.io/graaf/docs/category/traversal-algorithms):
- Breadth-First Search (BFS)
@@ -86,13 +103,19 @@ Algorithms implemented in the Graaf library include the following. For more info
- DFS-Based Cycle Detection
4. **Minimum Spanning Tree (MST) Algorithms**
- Kruskal's Algorithm
-5. [**Strongly Connected Components Algorithms**](https://bobluppes.github.io/graaf/docs/category/strongly-connected-components):
- - Tarjan's Strongly Connected Components
+5. [**Strongly Connected Components Algorithms
+ **](https://bobluppes.github.io/graaf/docs/category/strongly-connected-components):
+ - Tarjan's Strongly Connected Components
# Contributing
-The Graaf library welcomes contributions 🎊
-If you're interested in improving, fixing bugs, or adding features, please refer to the [wiki](https://github.com/bobluppes/graaf/wiki) for guidelines. Check out our roadmap on [YouTrack](https://graaf.youtrack.cloud/agiles/147-2/current) to stay up to date on planned features and improvements. We also have an [issue tracker](https://github.com/bobluppes/graaf/issues) for bug reports and feature requests.
+The Graaf library welcomes contributions 🎊
+
+If you're interested in improving, fixing bugs, or adding features, please refer to
+the [wiki](https://github.com/bobluppes/graaf/wiki) for guidelines. Check out our roadmap
+on [YouTrack](https://graaf.youtrack.cloud/agiles/147-2/current) to stay up to date on planned features and
+improvements. We also have an [issue tracker](https://github.com/bobluppes/graaf/issues) for bug reports and feature
+requests.
Feel free to join our [Discord](https://discord.gg/cGczwRHJ9K) for assistance and a smooth contribution experience.
@@ -108,4 +131,5 @@ Special thanks to [JetBrains](https://www.jetbrains.com/community/opensource/) f
project.
# License
+
This project is licensed under the [MIT license](LICENSE.md).
diff --git a/docs/static/img/hacktoberfest-logo.png b/docs/static/img/hacktoberfest-logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..20ef9d443dd49501684055f8bb58538dc51271b3
GIT binary patch
literal 104950
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