|
1 | 1 | # Usage
|
2 | 2 |
|
3 |
| -TIP: **This is the documentation for the NEW Python handler.** |
| 3 | +TIP: **This is the documentation for the NEW Python handler.** |
4 | 4 | To read the documentation for the LEGACY handler,
|
5 | 5 | go to the [legacy handler documentation](https://mkdocstrings.github.io/python-legacy).
|
6 | 6 |
|
@@ -34,7 +34,7 @@ Some options are **global only**, and go directly under the handler's name.
|
34 | 34 | to other documentation sites like the standard library docs
|
35 | 35 | or any third-party package docs. Typically, you want to import
|
36 | 36 | the inventories of your project's dependencies, at least those
|
37 |
| - that are used in the public API. |
| 37 | + that are used in the public API. |
38 | 38 |
|
39 | 39 | NOTE: This global option is common to *all* handlers, however
|
40 | 40 | they might implement it differently (or not even implement it).
|
@@ -115,11 +115,11 @@ For example:
|
115 | 115 | This admonition has a custom title!
|
116 | 116 | """
|
117 | 117 | ```
|
118 |
| - |
| 118 | + |
119 | 119 | === "Result"
|
120 | 120 | NOTE: It looks like a section, but it will be rendered as an admonition.
|
121 | 121 |
|
122 |
| - TIP: **You can even choose a title.** |
| 122 | + TIP: **You can even choose a title.** |
123 | 123 | This admonition has a custom title!
|
124 | 124 |
|
125 | 125 | ## Finding modules
|
@@ -208,7 +208,7 @@ to make sure anyone can build your docs from any location on their filesystem.
|
208 | 208 |
|
209 | 209 | ### Using the PYTHONPATH environment variable
|
210 | 210 |
|
211 |
| -WARNING: **This method has limitations.** |
| 211 | +WARNING: **This method has limitations.** |
212 | 212 | This method might work for you, with your current setup,
|
213 | 213 | but not for others trying your build your docs with their own setup/environment.
|
214 | 214 | We recommend to use the [`paths` method](#using-the-paths-option) instead.
|
@@ -264,10 +264,10 @@ In Bash and other shells, you can run your command like this
|
264 | 264 | ```bash
|
265 | 265 | PYTHONPATH=src mkdocs build -f docs/mkdocs.yml
|
266 | 266 | ```
|
267 |
| - |
| 267 | + |
268 | 268 | ### Installing your package in the current Python environment
|
269 | 269 |
|
270 |
| -WARNING: **This method has limitations.** |
| 270 | +WARNING: **This method has limitations.** |
271 | 271 | This method might work for you, with your current setup,
|
272 | 272 | but not for others trying your build your docs with their own setup/environment.
|
273 | 273 | We recommend to use the [`paths` method](#using-the-paths-option) instead.
|
|
0 commit comments