202404082252 docsify 打造自动生成和自动收缩的 sidebar

<a href="https://github.com/if-nil/docsify-file-catalog-action">docsify-file-catalog-action</a> 利用 Github actions 自动生成 _sidebar.md #

首先在仓库目录新建 .github/workflows/main.yml,粘贴以下脚本。

on: [push]

jobs:
  add_sidebar_job:
    runs-on: ubuntu-latest
    name: job to add _sidebar.md
    steps:
      - uses: actions/checkout@v4
      - uses: if-nil/docsify-file-catalog-action@main
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          include: '.*\.md'

然后进入 Github -> Actions -> Gernal,修改 Workflow permissions 权限为 Read and write permissions

最后执行代码推送项目到 Github,即可看到 _sidebar.md 已生成。

git add .github\workflows\main.yaml
git commit -m 'Add workflow'
git push origin main

<a href="https://github.com/iPeng6/docsify-sidebar-collapse">docsify-sidebar-collapse</a> 自动收缩的 sidebar #

确保 loadSidebar: true 后,在 index.html<body> 标签中加入以下代码。

<script src="//cdn.jsdelivr.net/npm/docsify-sidebar-collapse/dist/docsify-sidebar-collapse.min.js"></script>

该项目还提供了两种 sidebar 样式。

箭头风格。

<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify-sidebar-collapse/dist/sidebar.min.css" />

文件夹风格

<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify-sidebar-collapse/dist/sidebar-folder.min.css" />

https://juejin.cn/post/7309921542384992266