Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aiboy996/mkdocs-ai-summary
A mkdocs plugin to generage summary with the help of AI.
https://github.com/aiboy996/mkdocs-ai-summary
chatgpt-api mkdocs mkdocs-plugin summarytools tongyiqianwen
Last synced: 27 days ago
JSON representation
A mkdocs plugin to generage summary with the help of AI.
- Host: GitHub
- URL: https://github.com/aiboy996/mkdocs-ai-summary
- Owner: AIboy996
- License: mit
- Created: 2024-05-22T14:11:24.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-05-22T15:12:27.000Z (6 months ago)
- Last Synced: 2024-05-22T15:17:34.258Z (6 months ago)
- Topics: chatgpt-api, mkdocs, mkdocs-plugin, summarytools, tongyiqianwen
- Language: HTML
- Homepage: https://aiboy996.github.io/mkdocs-ai-summary
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# mkdocs-ai-summary
[](https://pypi.org/project/mkdocs-ai-summary/)
Generage an **ai-summary** for the page:
Minimal demo: [aiboy996.github.io/mkdocs-ai-summary](https://aiboy996.github.io/mkdocs-ai-summary)
Live demo(my homepage): [yangzhang.site](https://yangzhang.site)
## Installation
You should install the package with pip:
```
pip install mkdocs-ai-summary[chatgpt]
```
or
```
pip install mkdocs-ai-summary[tongyi]
```
> ⚠️⚠️⚠️⚠️
>
> Only support [ChatGPT](https://chat.openai.com/) and [tongyi ai](https://tongyi.aliyun.com/) for now.
>
> To use **ChatGPT(default)**, you should set a Environmental Variable for **api key**:
> ```bash
> export OPENAI_API_KEY='sk-xxxxxxx'
> ```
> [how to get an OPENAI_API_KEY?](https://platform.openai.com/docs/quickstart)
>
> To use **tongyi ai**, you should set a Environmental Variable for **api key**:
> ```bash
> export DASHSCOPE_API_KEY='sk-xxxxxxx'
> ```
> [how to get an DASHSCOPE_API_KEY?](https://dashscope.console.aliyun.com/)
[optional] Then you can include the [ai-summary.css](./docs/ai-summary.css)(optional, this is for the **custom ai summary admonition style**) in the config file as below:
## Configuration
### Options can be set
name|type|default value| note
--|--|--|--
api|str|chatgpt| only support chatgpt or tongyi
model|str|gpt-3.5-turbo | -
ignore_code|bool|true| ignore code block in markdown
cache|bool|true| -
cache_dir|str|"./"| -
prompt|str|"Please help me summarize the following content into an abstract within 200 words: "| -
### For ChatGPT Summary
Setup `mkdocs.yml` like this:
```yml
site_name: mkdocs-ai-summary
theme:
name: material
plugins:
- ai-summary:
api: "chatgpt"
model: "gpt-3.5-turbo"
ignore_code: true
cache: true
cache_dir: "./"
prompt: "Please help me summarize the following content into an abstract within 200 words: "
- tags
markdown_extensions:
- admonition
- pymdownx.details
- pymdownx.superfences
- pymdownx.tabbed:
alternate_style: true
extra_css:
- ai-summary.css
```
Then for the page you want an ai-summary, just add a meta tag:
```markdown
---
include:
- ai-summary
---
# title
hello ai summary.
```
### For tongyi ai Summary
or you can use **tongyi ai** by setting:
```yml
plugins:
- ai-summary:
api: "tongyi"
model: "qwen-turbo"
ignore_code: true
cache: true
cache_dir: "./"
prompt: "Please help me summarize the following content into an abstract within 200 words: "
```
### Setup ai-summary for specific page
You can also setup ai summary for each page separately:
```markdown
---
include:
- ai-summary
ai-summary-config:
api: "tongyi"
model: "qwen-turbo"
prompt: "帮我把下面的内容总结为200字以内的摘要："
---
# title
hello ai summary.
```
all config options are available. **Page configuration will override unified configuration.**
## About Cache
Don't worry about duplicate api calls, we've made the cache function so that if you've done an ai-summary before and the content hasn't changed it will use the cache.
Enjoy it.