Skip to content

Commit e2bd9bf

Browse files
committed
Add documentation for source code linking
1 parent 4ce9222 commit e2bd9bf

File tree

2 files changed

+6
-5
lines changed

2 files changed

+6
-5
lines changed

README.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -76,21 +76,22 @@ This project is maintained by [Benjamin Räthlein](https://twitter.com/raethlein
7676
<a href="#source-code-linking">Source Code Linking</a> •
7777
<a href="#api-overview">API Overview</a> •
7878
<a href="#mkdocs-integration">MKDocs Integration</a> •
79-
<a href="#docstyle-validation">Docstyle Validation</a>
79+
<a href="#docstyle-validation">Docstyle Validation</a> •
80+
<a href="#console-output">Console Output</a>
8081
</p>
8182

8283
### Source Code Linking
8384

84-
Lazydocs tries to automatically
85+
<img style="width: 100%" src="./docs/images/source-linking.png"/>
8586

86-
87-
88-
This is
87+
Lazydocs is capable to insert a badge on the right side of every module, class, method or function with a link the correct source-code file and line number. The default configuration will create relative paths to navigate within the Github Repo. This is useful if the documentation is hosted within the same repository as the source-code. If, the documentation is hosted outside of the Github Repository, it is recommended to set the `src-base-url`:
8988

9089
```bash
9190
lazydocs --src-base-url="https://github.com/example/my-project/blob/main/" my_package
9291
```
9392

93+
The `src-base-url` is used as a prefix for all source-code linkings in the documentation.
94+
9495
### API Overview
9596

9697
<img style="width: 100%" src="./docs/images/api-overview.png"/>

docs/images/source-linking.png

129 KB
Loading

0 commit comments

Comments
 (0)