Skip to content

Commit

Permalink
Update best-of list for version 2025.01.16-20.08 (#293)
Browse files Browse the repository at this point in the history 
Co-authored-by: pawamoy <[email protected]>
  • Loading branch information
@github-actions @pawamoy
github-actions[bot] and pawamoy authored Jan 16, 2025
1 parent 1a81cce commit dcb9637
Show file tree
Hide file tree
Showing 4 changed files with 314 additions and 308 deletions.
27 changes: 20 additions & 7 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ This list contains 280 awesome open-source projects grouped into 17 categories.
## Contents

- [🎨 Theming](#-theming) _30 projects_
- [💻 API documentation building](#-api-documentation-building) _19 projects_
- [💻 API documentation building](#-api-documentation-building) _20 projects_
- [💬 Blogging](#-blogging) _7 projects_
- [📊 Charts, Images, Tables & Graphs](#-charts-images-tables--graphs) _37 projects_
- [🤖 Code execution, variables & templating](#-code-execution-variables--templating) _20 projects_
Expand Down Expand Up @@ -607,7 +607,7 @@ This list contains 280 awesome open-source projects grouped into 17 categories.
pip install mkdocstrings-python
```
</details>
<details><summary><b><a href="https://github.com/JakubAndrysek/MkDoxy">mkdoxy</a></b> - 🥈22 · ⭐ 82 · 📈 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>Automatically generates API documentation for your project based on Doxygen comments and code snippets in your..</summary>
<details><summary><b><a href="https://github.com/JakubAndrysek/MkDoxy">mkdoxy</a></b> - 🥈22 · ⭐ 82 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>Automatically generates API documentation for your project based on Doxygen comments and code snippets in your..</summary>

- [GitHub](https://github.com/JakubAndrysek/MkDoxy) (👨‍💻 17 · 🔀 23 · 📦 29 · 📋 57 - 17% open · ⏱️ 15.01.2025)
- [PyPi](https://pypi.org/project/mkdoxy) (📥 12K / month):
Expand Down Expand Up @@ -639,7 +639,7 @@ This list contains 280 awesome open-source projects grouped into 17 categories.
- neoteroi.spantable
```
</details>
<details><summary><b><a href="https://github.com/daizutabi/mkapi">MkApi</a></b> - 🥈20 · ⭐ 100 · 📈 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>A plugin for MkDocs to generate API documentation.</summary>
<details><summary><b><a href="https://github.com/daizutabi/mkapi">MkApi</a></b> - 🥈20 · ⭐ 100 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>A plugin for MkDocs to generate API documentation.</summary>

- [GitHub](https://github.com/daizutabi/mkapi) (👨‍💻 5 · 🔀 17 · 📦 200 · 📋 130 - 3% open · ⏱️ 14.01.2025)
- [PyPi](https://pypi.org/project/mkapi) (📥 4.9K / month):
Expand Down Expand Up @@ -720,6 +720,19 @@ This list contains 280 awesome open-source projects grouped into 17 categories.
pip install mkdocstrings-vba
```
</details>
<details><summary><b><a href="https://github.com/Kl0ven/mkdocs-material-adr">mkdocs-material-adr</a></b> - 🥉10 · ⭐ 6 · ➕ · <code><a href="http://bit.ly/3nYMfla">Apache-2</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>ADR for MkDocss Material Theme.</summary>

- [GitHub](https://github.com/Kl0ven/mkdocs-material-adr) (👨‍💻 2 · 🔀 2 · 📦 8 · ⏱️ 14.01.2025)
- [PyPi](https://pypi.org/project/mkdocs-material-adr) (📥 880 / month):
```
pip install mkdocs-material-adr
```
- Add to [mkdocs.yml](https://www.mkdocs.org/user-guide/configuration/#plugins):
```yaml
plugins:
- mkdocs-material-adr/adr
```
</details>
<details><summary><b><a href="https://github.com/AlexandreKempf/automacdoc">automacdoc</a></b> - 🥉7 · ⭐ 43 · 💤 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code><br>Automatic generation of documentation for mkdocs.</summary>

- [GitHub](https://github.com/AlexandreKempf/automacdoc) (👨‍💻 6 · 🔀 10 · 📋 5 - 80% open · ⏱️ 29.12.2020)
Expand Down Expand Up @@ -1500,7 +1513,7 @@ This list contains 280 awesome open-source projects grouped into 17 categories.
- user-defined-values
```
</details>
<details><summary><b><a href="https://github.com/tanbro/mkdocs-nbconvert">nbconvert</a></b> - 🥉10 · ⭐ 9 · 📈 · <code><a href="http://bit.ly/3rqEWVr">BSD-2</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>A MkDocs plug-in provides a source parser for *.ipynb files.</summary>
<details><summary><b><a href="https://github.com/tanbro/mkdocs-nbconvert">nbconvert</a></b> - 🥉10 · ⭐ 9 · <code><a href="http://bit.ly/3rqEWVr">BSD-2</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>A MkDocs plug-in provides a source parser for *.ipynb files.</summary>

- [GitHub](https://github.com/tanbro/mkdocs-nbconvert) (👨‍💻 5 · 🔀 1 · 📦 5 · ⏱️ 16.01.2025)
- [PyPi](https://pypi.org/project/mkdocs-nbconvert) (📥 1.2K / month):
Expand Down Expand Up @@ -3483,7 +3496,7 @@ This list contains 280 awesome open-source projects grouped into 17 categories.
- mike
```
</details>
<details><summary><b><a href="https://github.com/jdoiro3/mkdocs-multirepo-plugin">mkdocs-multirepo-plugin</a></b> - 🥇23 · ⭐ 140 · 📈 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>Build documentation in multiple repos into one site.</summary>
<details><summary><b><a href="https://github.com/jdoiro3/mkdocs-multirepo-plugin">mkdocs-multirepo-plugin</a></b> - 🥇23 · ⭐ 140 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>Build documentation in multiple repos into one site.</summary>

- [GitHub](https://github.com/jdoiro3/mkdocs-multirepo-plugin) (👨‍💻 17 · 🔀 49 · 📦 170 · 📋 110 - 52% open · ⏱️ 15.01.2025)
- [PyPi](https://pypi.org/project/mkdocs-multirepo-plugin) (📥 69K / month):
Expand Down Expand Up @@ -3795,9 +3808,9 @@ This list contains 280 awesome open-source projects grouped into 17 categories.
- external-markdown
```
</details>
<details><summary><b><a href="https://github.com/glennmatthews/markdown-version-annotations">markdown-version-annotations</a></b> - 🥉11 · ⭐ 6 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1459/PNG/32/2799201-jigsaw-processing_99781.png" style="display:inline;" width="13" height="13"></code><br>MkDocs plugin to add custom admonitions for documenting version differences.</summary>
<details><summary><b><a href="https://github.com/glennmatthews/markdown-version-annotations">markdown-version-annotations</a></b> - 🥉12 · ⭐ 6 · 📈 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1459/PNG/32/2799201-jigsaw-processing_99781.png" style="display:inline;" width="13" height="13"></code><br>MkDocs plugin to add custom admonitions for documenting version differences.</summary>

- [GitHub](https://github.com/glennmatthews/markdown-version-annotations) (📥 26 · 📦 42 · ⏱️ 06.05.2024)
- [GitHub](https://github.com/glennmatthews/markdown-version-annotations) (📥 26 · 📦 43 · ⏱️ 06.05.2024)
- [PyPi](https://pypi.org/project/markdown-version-annotations) (📥 5.5K / month):
```
pip install markdown-version-annotations
Expand Down
12 changes: 4 additions & 8 deletions history/2025-01-16_changes.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,11 @@

_Projects that have a higher project-quality score compared to the last update. There might be a variety of reasons, such as increased downloads or code activity._

- <b><a href="https://github.com/jdoiro3/mkdocs-multirepo-plugin">mkdocs-multirepo-plugin</a></b> - 🥇23 · ⭐ 140 · 📈 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>Build documentation in multiple repos into one site.
- <b><a href="https://github.com/JakubAndrysek/MkDoxy">mkdoxy</a></b> - 🥈22 · ⭐ 82 · 📈 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>Automatically generates API documentation for your project based on Doxygen comments and code snippets in your..
- <b><a href="https://github.com/daizutabi/mkapi">MkApi</a></b> - 🥈20 · ⭐ 100 · 📈 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>A plugin for MkDocs to generate API documentation.
- <b><a href="https://github.com/fmaida/mkdocs-blog-plugin">Blogs for MkDocs</a></b> - 🥉12 · ⭐ 17 · 💤 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>This plugin for MkDocs allows to keeps a really simple blog section inside your documentation site.
- <b><a href="https://github.com/tanbro/mkdocs-nbconvert">nbconvert</a></b> - 🥉10 · ⭐ 9 · 📈 · <code><a href="http://bit.ly/3rqEWVr">BSD-2</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>A MkDocs plug-in provides a source parser for *.ipynb files.
- <b><a href="https://github.com/glennmatthews/markdown-version-annotations">markdown-version-annotations</a></b> - 🥉12 · ⭐ 6 · 📈 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1459/PNG/32/2799201-jigsaw-processing_99781.png" style="display:inline;" width="13" height="13"></code><br>MkDocs plugin to add custom admonitions for documenting version differences.

## 📉 Trending Down
## ➕ Added Projects

_Projects that have a lower project-quality score compared to the last update. There might be a variety of reasons such as decreased downloads or code activity._
_Projects that were recently added to this best-of list._

- <b><a href="https://github.com/mprivat/mkdocs-snippet-plugin">snippet</a></b> - 🥉9 · ⭐ 12 · 💤 · <code><a href="http://bit.ly/34MBwT8">MIT</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>An mkdocs plugin that injects snippets from a file in a git repository.
- <b><a href="https://github.com/Kl0ven/mkdocs-material-adr">mkdocs-material-adr</a></b> - 🥉10 · ⭐ 6 · ➕ · <code><a href="http://bit.ly/3nYMfla">Apache-2</a></code> · <code><img src="https://cdn.icon-icons.com/icons2/1465/PNG/32/701electricplug_100845.png" style="display:inline;" width="13" height="13"></code><br>ADR for MkDocss Material Theme.

Loading

0 comments on commit dcb9637

Please sign in to comment.