fix nav and website

Author: LennartPurucker

examples/introduction.py

@@ -12,4 +12,11 @@
 # 4. [Working with collections of tasks](../Basics/simple_suites_tutorial/)
 #
 # ## Advanced
-# 1 .
+# 1. [Getting splits for datasets from tasks](../Advanced/task_manual_iteration_tutorial/)
+# 2. [Creating and uploading datasets](../Advanced/create_upload_tutorial/)
+# 3. [Searching and editing datasets](../Advanced/datasets_tutorial/)
+# 4. [Searching and creating tasks](../Advanced/task_tutorial/)
+# 5. [Listing, downloading, and uploading suites](../Advanced/suites_tutorial/)
+# 6. [Listing, downloading, and uploading studies](../Advanced/study_tutorial/)
+# 7. [Downloading evaluation results](../Advanced/fetch_evaluations_tutorial/)
+# 8. [Configuring logging](../Advanced/configure_logging/)

scripts/gen_ref_pages.py

@@ -5,8 +5,9 @@
 
 """
 
+from __future__ import annotations
+
 from pathlib import Path
-import shutil
 
 import mkdocs_gen_files
 
@@ -44,6 +45,8 @@
 examples_dir = root / "examples"
 examples_doc_dir = root / "docs" / "examples"
 for path in sorted(examples_dir.rglob("*.py")):
+    if "_external_or_deprecated" in path.parts:
+        continue
     dest_path = Path("examples") / path.relative_to(examples_dir)
     with mkdocs_gen_files.open(dest_path, "w") as dest_file:
         print(path.read_text(), file=dest_file)