add black and pymdownx.magiclink to dependencies,

increase line length in docstring generation, update
api_reference

.github/workflows/mkdocs_material.yml

@@ -28,4 +28,5 @@ jobs:
           mkdocstrings \
           mkdocstrings-python \
           pymdown-extensions \
+          black \
       - run: mkdocs gh-deploy --force

docs/gen_ref_pages.py

@@ -12,7 +12,7 @@
 
     module_path = path.relative_to("hadal").with_suffix("")
     doc_path = path.relative_to("hadal").with_suffix(".md")
-    full_doc_path = Path("reference", doc_path)
+    full_doc_path = Path("api_reference", doc_path)
 
     parts = tuple(module_path.parts)
 
@@ -34,5 +34,5 @@
 
     mkdocs_gen_files.set_edit_path(full_doc_path, path)
 
-with mkdocs_gen_files.open("reference/SUMMARY.md", "w") as nav_file:
+with mkdocs_gen_files.open("api_reference/SUMMARY.md", "w") as nav_file:
     nav_file.writelines(nav.build_literate_nav())

mkdocs.yml

@@ -64,6 +64,7 @@ markdown_extensions:
   - markdown.extensions.tables:
   - markdown.extensions.toc:
       permalink: true
+  - pymdownx.magiclink
   - attr_list
   - md_in_html
   - pymdownx.superfences
@@ -97,7 +98,7 @@ plugins:
             docstring_section_style: list
             annotations_path: source
             separate_signature: true
-            line_length: 60
+            line_length: 80
             show_signature: true
             show_signature_annotations: true
             members_order: source
@@ -111,7 +112,7 @@ nav:
       - parallel_text.md
       - parallel_sentence_mining/margin_based.md
   - API reference:
-      - hadal: reference/
+      - hadal: api_reference/
 
 extra_css:
   - stylesheets/extra.css