feat: added mkdocs infra

Author: ntamas

doc/NOTES.md docs/NOTES.mddoc/NOTES.md renamed to docs/NOTES.md

@@ -1,5 +1,8 @@
 # Open questions
 
+Open questions to be discussed regarding the design of the new igraph
+Python interface:
+
 - Shall we allow string representations of enums to be resolved to their
   corresponding enum values? This would make it possible to write something
   like `"directed"` instead of `Adjacency.DIRECTED`.

doc/fragments/igraph_create.txt docs/fragments/igraph_create.txtdoc/fragments/igraph_create.txt renamed to docs/fragments/igraph_create.txt

@@ -0,0 +1 @@
+../README.md

doc/fragments/igraph_empty.txt docs/fragments/igraph_empty.txtdoc/fragments/igraph_empty.txt renamed to docs/fragments/igraph_empty.txt

@@ -0,0 +1,48 @@
+site_name: igraph ctypes interface for Python
+repo_url: https://github.com/igraph/python-igraph-ctypes
+# repo_name: igraph/python-igraph-ctypes
+
+theme:
+  name: material
+
+  features:
+    - content.action.edit
+    - navigation.instant
+    - navigation.tracking
+    - navigation.footer
+
+  palette:
+    # Palette toggle for light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: red
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+
+    # Palette toggle for dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: red
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+
+extra:
+  consent:
+    title: Cookie consent
+    description: >-
+      We use cookies to recognize your repeated visits and preferences, as well
+      as to measure the effectiveness of our documentation and whether users
+      find what they're searching for. With your consent, you're helping us to
+      make our documentation better.
+
+  social:
+    - icon: fontawesome/brands/twitter
+      link: https://twitter.com/igraph2
+    - icon: fontawesome/brands/mastodon
+      link: https://fosstodon.org/@igraph
+
+copyright: >
+  Copyright © 2003 - 2023 The igraph core team –
+  <a href="#__consent">Change cookie settings</a>

doc/fragments/igraph_famous.txt docs/fragments/igraph_famous.txtdoc/fragments/igraph_famous.txt renamed to docs/fragments/igraph_famous.txt

@@ -17,6 +17,9 @@ richbench = "^1.0.3"
 igraph = "^0.10.6"
 stimulus = { git = "https://github.com/igraph/stimulus.git", tag = "0.14.1" }
 
+[tool.poetry.group.doc.dependencies]
+mkdocs-material = "^9.1.21"
+
 [tool.poetry-dynamic-versioning]
 enable = true
 

docs/index.md

@@ -274,7 +274,7 @@ def main():
         "-t",
         str(SOURCE_FOLDER / "codegen" / "types.yaml"),
         "-D",
-        str(SOURCE_FOLDER.parent / "doc" / "fragments"),
+        str(SOURCE_FOLDER.parent / "docs" / "fragments"),
     ]
 
     args = [