update

Author: SilverRainZ

docs/api.rst

@@ -84,19 +84,19 @@ See :doc:`tmpl` for built-in extra-context names such as ``doc`` and
 .. autofunction:: sphinxnotes.render.extra_context
 
 .. autoclass:: sphinxnotes.render.ParsingPhaseExtraContext
-   :members: generate
+   :members: phase, generate
    :undoc-members:
 
 .. autoclass:: sphinxnotes.render.ParsedPhaseExtraContext
-   :members: generate
+   :members: phase, generate
    :undoc-members:
 
 .. autoclass:: sphinxnotes.render.ResolvingPhaseExtraContext
-   :members: generate
+   :members: phase, generate
    :undoc-members:
 
 .. autoclass:: sphinxnotes.render.GlobalExtraContext
-   :members: generate
+   :members: phase, generate
    :undoc-members:
 
 Base Roles and Directives

src/sphinxnotes/render/extractx.py

@@ -31,7 +31,6 @@ def generate(self, *args, **kwargs) -> Any: ...
 
 class ParsingPhaseExtraContext(_ExtraContext):
     """Extra context generated during the :py:data:`~Phase.Parsing` phase.
-
     The ``generate`` method receives the current directive or role being executed.
     """
 
@@ -43,7 +42,6 @@ def generate(self, directive: SphinxDirective | SphinxRole) -> Any: ...
 
 class ParsedPhaseExtraContext(_ExtraContext):
     """Extra context generated during the :py:data:`~Phase.Parsed` phase.
-
     The ``generate`` method receives the current Sphinx transform.
     """
 
@@ -55,7 +53,6 @@ def generate(self, transform: SphinxTransform) -> Any: ...
 
 class ResolvingPhaseExtraContext(_ExtraContext):
     """Extra context generated during the :py:data:`~Phase.Resolving` phase.
-
     The ``generate`` method receives the current Sphinx transform.
     """
 
@@ -67,10 +64,11 @@ def generate(self, transform: SphinxTransform) -> Any: ...
 
 class GlobalExtraContext(_ExtraContext):
     """Extra context available in all phases.
-
     The ``generate`` method receives the Sphinx build environment.
     """
 
+    phase = None
+
     @abstractmethod
     def generate(self, env: BuildEnvironment) -> Any: ...
 
@@ -177,8 +175,10 @@ def __init__(self, node: pending_node) -> None:
         if nonexist := requested - total:
             self.report.text(f'Extra contexts {nonexist} are non-exist.')
         if nonavail := requested - nonexist:
-            self.report.text(f'Extra contexts {nonavail} are not available '
-                             f'at pahse {node.template.phase}.')
+            self.report.text(
+                f'Extra contexts {nonavail} are not available '
+                f'at pahse {node.template.phase}.'
+            )
 
     def on_anytime(self, env: BuildEnvironment) -> None:
         self._generate(GlobalExtraContext, lambda ctx: ctx.generate(env))