Add note about Django ASGI into the documentation (#630)

Author: Kludex

docs/integrations/django.md

@@ -8,6 +8,12 @@ Install `logfire` with the `django` extra:
 
 {{ install_logfire(extras=['django']) }}
 
+!!! info
+    If you use are using the **[Asynchronous support]** of Django, you'll also need to
+    install the `asgi` extra:
+
+    {{ install_logfire(extras=['django,asgi']) }}
+
 ## Usage
 
 In the `settings.py` file, add the following lines:
@@ -41,3 +47,4 @@ which you can find more information about [here][opentelemetry-django].
 [django]: https://www.djangoproject.com/
 [opentelemetry-django]: https://opentelemetry-python-contrib.readthedocs.io/en/latest/instrumentation/django/django.html
 [django-instrumentor]: https://opentelemetry-python-contrib.readthedocs.io/en/latest/instrumentation/django/django.html#opentelemetry.instrumentation.django.DjangoInstrumentor
+[Asynchronous support]: https://docs.djangoproject.com/en/dev/topics/async/#asynchronous-support

docs/plugins/main.py

@@ -135,37 +135,34 @@ def install_logfire(markdown: str, page: Page) -> str:
         extras = [arg.strip('\'"') for arg in arguments[1].strip('[]').split(',')] if len(arguments) > 1 else []
         package = 'logfire' if not extras else f"'logfire[{','.join(extras)}]'"
         extras_arg = ' '.join(f'-E {extra}' for extra in extras)
-        instructions = f"""
-=== "pip"
-    ```bash
-    pip install {package}
-    ```
-
-=== "uv"
-    ```bash
-    uv add {package}
-    ```
-
-=== "rye"
-    ```bash
-    rye add logfire {extras_arg}
-    ```
-
-=== "poetry"
-    ```bash
-    poetry add {package}
-    ```
+        instructions = [
+            '=== "pip"',
+            '    ```bash',
+            f'    pip install {package}',
+            '    ```',
+            '=== "uv"',
+            '    ```bash',
+            f'    uv add {package}',
+            '    ```',
+            '=== "rye"',
+            '    ```bash',
+            f'    rye add logfire {extras_arg}',
+            '    ```',
+            '=== "poetry"',
+            '    ```bash',
+            f'    poetry add {package}',
+            '    ```',
+        ]
 
-"""
         if not extras:
-            instructions += """
+            instructions.extend(['=== "conda"', '    ```bash', '    conda install -c conda-forge logfire', '    ```'])
+        instructions_str = '\n'.join(instructions)
 
-=== "conda"
-    ```bash
-    conda install -c conda-forge logfire
-    ```
-"""
-        markdown = re.sub(r'{{ *install_logfire\(.*\) *}}', instructions, markdown, count=1)
+        def replace_match(match: re.Match[str]) -> str:
+            indent = match.group('indent')
+            return indent + instructions_str.replace('\n', '\n' + indent)
+
+        markdown = re.sub(r'(?P<indent> *){{ *install_logfire\(.*\) *}}', replace_match, markdown, count=1)
     return markdown