{"_id":"hexo-shoka-swiper","_rev":"49-f6f0370a513f16497bb94a2c8d73c449","name":"hexo-shoka-swiper","dist-tags":{"latest":"0.1.18"},"versions":{"0.1.11":{"name":"hexo-shoka-swiper","version":"0.1.11","keywords":["hexo","renderer","swiper","Slideshow","shoka","theme-shoka","plugins"],"author":{},"license":"Apache-2.0","_id":"hexo-shoka-swiper@0.1.11","maintainers":[{"name":"llxlr","email":"yanghongday369@gmail.com"}],"homepage":"https://github.com/llxlr/hexo-shoka-swiper#readme","bugs":{"url":"https://github.com/llxlr/hexo-shoka-swiper/issues"},"dist":{"shasum":"7fb5e2f7d2008f138aa6cc62dd5d3b37f8f47b15","tarball":"https://registry.npmjs.org/hexo-shoka-swiper/-/hexo-shoka-swiper-0.1.11.tgz","fileCount":10,"integrity":"sha512-46MNPuUbf+mNenr6ShA7y5IYBQGQSZss709+yjCvrm873vLHr8WCEdMJD1VtkPN9u1Uc9gNR+lIncds327xtvA==","signatures":[{"sig":"MEUCIHBwHxSQi+2pLNu2UWRvW0f2TU36KnHoEp1GtU62fPNzAiEAqFZ6ZKw7gvV3Xrzzo5pGOMdzgbQK5pAcW0S3yERFyrI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":732435},"hexo":{"version":">=5"},"main":"index.js","engines":{"node":">=12"},"gitHead":"143f590f0d4a1beb466d375c869e2275e1493a53","scripts":{"eslint":"eslint ."},"_npmUser":{"name":"llxlr","email":"yanghongday369@gmail.com"},"repository":{"url":"git+https://github.com/llxlr/hexo-shoka-swiper.git","type":"git"},"_npmVersion":"10.9.8","description":"A Slideshow and Cardshow plugin for theme-shoka based on swiper","directories":{"lib":"./lib","images":"./images"},"_nodeVersion":"22.23.1","dependencies":{"nunjucks-date":"^1.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/hexo-shoka-swiper_0.1.11_1784559266092_0.5431513020441425","host":"s3://npm-registry-packages-npm-production"}},"0.1.12":{"name":"hexo-shoka-swiper","version":"0.1.12","keywords":["hexo","renderer","swiper","Slideshow","shoka","theme-shoka","plugins"],"author":{},"license":"Apache-2.0","_id":"hexo-shoka-swiper@0.1.12","maintainers":[{"name":"llxlr","email":"yanghongday369@gmail.com"}],"homepage":"https://github.com/llxlr/hexo-shoka-swiper#readme","bugs":{"url":"https://github.com/llxlr/hexo-shoka-swiper/issues"},"dist":{"shasum":"c6a3cab7d5636c9c0d4b24b295b7ae4ee599da90","tarball":"https://registry.npmjs.org/hexo-shoka-swiper/-/hexo-shoka-swiper-0.1.12.tgz","fileCount":10,"integrity":"sha512-IfJwpg1/+cV2nweqjOHUPf0EiLO5+FxfuNgagnTgByD2GYKOxrBBV5L0VrmN4sxkuKUOx0x+tYa+QFQfDP+Q2g==","signatures":[{"sig":"MEUCIQCXdPJaXoWo7Hbc0GofYr1hrdz/KtP8x9B2C7AmHm5lfgIgHi9GZBP9g3TG+ska3MwMACC2X6NDTsn3tssBSiEclcM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":735808},"hexo":{"version":">=5"},"main":"index.js","engines":{"node":">=22"},"gitHead":"3c1444779373817b44a28a454746325fe6653308","scripts":{"lint":"oxlint","prepare":"husky"},"_npmUser":{"name":"llxlr","email":"yanghongday369@gmail.com"},"repository":{"url":"git+https://github.com/llxlr/hexo-shoka-swiper.git","type":"git"},"_npmVersion":"10.9.8","description":"A Slideshow and Cardshow plugin for theme-shoka based on swiper","directories":{"lib":"./lib","images":"./images"},"_nodeVersion":"22.23.1","dependencies":{"nunjucks-date":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.7","oxlint":"^1.74.0"},"_npmOperationalInternal":{"tmp":"tmp/hexo-shoka-swiper_0.1.12_1785079456644_0.30272883211390167","host":"s3://npm-registry-packages-npm-production"}},"0.1.13":{"name":"hexo-shoka-swiper","version":"0.1.13","keywords":["hexo","renderer","swiper","Slideshow","shoka","theme-shoka","plugins"],"author":{},"license":"Apache-2.0","_id":"hexo-shoka-swiper@0.1.13","maintainers":[{"name":"llxlr","email":"yanghongday369@gmail.com"}],"homepage":"https://github.com/llxlr/hexo-shoka-swiper#readme","bugs":{"url":"https://github.com/llxlr/hexo-shoka-swiper/issues"},"dist":{"shasum":"caa26724fec08a1096685f51e66b5d3f124e15e1","tarball":"https://registry.npmjs.org/hexo-shoka-swiper/-/hexo-shoka-swiper-0.1.13.tgz","fileCount":10,"integrity":"sha512-6MGjM1lmaEvMELRFA1B96HQMRyY11uVM4rv/lrcUO60CdiD4EIEkeAi/SlGiddwd4FJ1TLR0WfRL4LjDv+5XQg==","signatures":[{"sig":"MEYCIQC3u6LHoOCgfSr5zjRkAOt2aF4AnBuBYh+43BhbBhyHCQIhALmkrmxeekQGsCxh7lm9dwthuQQ6ZZHtQI0PMhjuiTqQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":735889},"hexo":{"version":">=5"},"main":"index.js","engines":{"node":">=22"},"gitHead":"8a1687018c2e8b038579585ceb8c53183262d257","scripts":{"lint":"oxlint","prepare":"husky"},"_npmUser":{"name":"llxlr","email":"yanghongday369@gmail.com"},"repository":{"url":"git+https://github.com/llxlr/hexo-shoka-swiper.git","type":"git"},"_npmVersion":"10.9.8","description":"A Slideshow and Cardshow plugin for theme-shoka based on swiper","directories":{"lib":"./lib","images":"./images"},"_nodeVersion":"22.23.1","dependencies":{"nunjucks-date":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.7","oxlint":"^1.74.0"},"_npmOperationalInternal":{"tmp":"tmp/hexo-shoka-swiper_0.1.13_1785256486799_0.7146254336364026","host":"s3://npm-registry-packages-npm-production"}},"0.1.14":{"name":"hexo-shoka-swiper","version":"0.1.14","keywords":["hexo","renderer","swiper","Slideshow","shoka","theme-shoka","plugins"],"author":{},"license":"Apache-2.0","_id":"hexo-shoka-swiper@0.1.14","maintainers":[{"name":"llxlr","email":"yanghongday369@gmail.com"}],"homepage":"https://github.com/llxlr/hexo-shoka-swiper#readme","bugs":{"url":"https://github.com/llxlr/hexo-shoka-swiper/issues"},"dist":{"shasum":"041be2b28f5715b659040ef11eae4c3182e1f562","tarball":"https://registry.npmjs.org/hexo-shoka-swiper/-/hexo-shoka-swiper-0.1.14.tgz","fileCount":10,"integrity":"sha512-HdrJ3U0hUt4mgnphkLfiohwyHLgfEQ3bOMoIhs7kwj/W+zzQR96NSkx612yYB0x20fDBNszW1ScOsk+lpQx0Wg==","signatures":[{"sig":"MEUCIQDnyk7mQb+g9Xu8JDjnwDbzSTSWPwCX5mTiojgOkiwfgQIgAjQznIYyiI5JKIKhQ9/oONp1HorPcQkrtODCZThGDxk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":764334},"hexo":{"version":">=5"},"main":"index.js","engines":{"node":">=22"},"gitHead":"de472675a2aa7effda44a55a37fa8290d2e408e6","scripts":{"lint":"oxlint","prepare":"husky"},"_npmUser":{"name":"llxlr","email":"yanghongday369@gmail.com"},"repository":{"url":"git+https://github.com/llxlr/hexo-shoka-swiper.git","type":"git"},"_npmVersion":"10.9.8","description":"A Slideshow and Cardshow plugin for theme-shoka based on swiper","directories":{"lib":"./lib","images":"./images"},"_nodeVersion":"22.23.1","dependencies":{"nunjucks-date":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.7","oxlint":"^1.74.0"},"_npmOperationalInternal":{"tmp":"tmp/hexo-shoka-swiper_0.1.14_1785578802917_0.12218200570398774","host":"s3://npm-registry-packages-npm-production"}},"0.1.15":{"name":"hexo-shoka-swiper","version":"0.1.15","keywords":["hexo","renderer","swiper","Slideshow","shoka","theme-shoka","plugins"],"author":{},"license":"Apache-2.0","_id":"hexo-shoka-swiper@0.1.15","maintainers":[{"name":"llxlr","email":"yanghongday369@gmail.com"}],"homepage":"https://github.com/llxlr/hexo-shoka-swiper#readme","bugs":{"url":"https://github.com/llxlr/hexo-shoka-swiper/issues"},"dist":{"shasum":"83c1f29448b85c81ceb4973191b722688f107942","tarball":"https://registry.npmjs.org/hexo-shoka-swiper/-/hexo-shoka-swiper-0.1.15.tgz","fileCount":10,"integrity":"sha512-y7E+hZqDbeJ2u+/2eFE/xgni9thqk0l7Tz6AJCVpwnG6BDzbw8qkMl+AAIido566/x8dOQbs5CuyJ3kB3CFG4A==","signatures":[{"sig":"MEUCICGLFwqgoZGs+zdSu96iLArKcMsAtLg4e3nESs16GJ0uAiEAy7RSTb9YJf1ybj6GhHHuGnwvTwj/J92NdkGIz4XNoDc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":765256},"hexo":{"version":">=5"},"main":"index.js","engines":{"node":">=22"},"gitHead":"e52ab5c97e4b5337fd2487d2644734473921c925","scripts":{"lint":"oxlint","prepare":"husky"},"_npmUser":{"name":"llxlr","email":"yanghongday369@gmail.com"},"repository":{"url":"git+https://github.com/llxlr/hexo-shoka-swiper.git","type":"git"},"_npmVersion":"10.9.8","description":"A Slideshow and Cardshow plugin for theme-shoka based on swiper","directories":{"lib":"./lib","images":"./images"},"_nodeVersion":"22.23.1","dependencies":{"nunjucks-date":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.7","oxlint":"^1.74.0"},"_npmOperationalInternal":{"tmp":"tmp/hexo-shoka-swiper_0.1.15_1785774495808_0.8238828278233201","host":"s3://npm-registry-packages-npm-production"}},"0.1.16":{"name":"hexo-shoka-swiper","version":"0.1.16","keywords":["hexo","renderer","swiper","Slideshow","shoka","theme-shoka","plugins"],"author":{},"license":"Apache-2.0","_id":"hexo-shoka-swiper@0.1.16","maintainers":[{"name":"llxlr","email":"yanghongday369@gmail.com"}],"homepage":"https://github.com/llxlr/hexo-shoka-swiper#readme","bugs":{"url":"https://github.com/llxlr/hexo-shoka-swiper/issues"},"dist":{"shasum":"94db2a59252fe20b48e05598c3fc56ac5a87896a","tarball":"https://registry.npmjs.org/hexo-shoka-swiper/-/hexo-shoka-swiper-0.1.16.tgz","fileCount":10,"integrity":"sha512-BtLoKVkRh/AXOIluSI/ukQQzndtEvl/vInd3eviyEf043wRtwnUTBf4qz8VZuEigDUkWolHfrqU8+MfkSoZsWw==","signatures":[{"sig":"MEUCIQDeiVL86QhnScbKqUPX6DCFsrt6MBBwjWKxwqg9nILXFQIgIG56v3EoH9P1SGUpKR9nglmaayn4bV/foENXayQNpfk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIHh9mecivzEk8QACgF6BvuJVfqeg0NQ7MK1WKey3SBoQAiAis5iWnfaUSylID+kz7v63kcMUzQbKbvQpHWrBsdQJPA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":782900},"hexo":{"version":">=5"},"main":"index.js","engines":{"node":">=22"},"gitHead":"1301e4a0e93dc526215cd409d6409a9222a7f27e","scripts":{"lint":"oxlint","prepare":"husky"},"_npmUser":{"name":"llxlr","email":"yanghongday369@gmail.com"},"repository":{"url":"git+https://github.com/llxlr/hexo-shoka-swiper.git","type":"git"},"_npmVersion":"10.9.8","description":"A Slideshow and Cardshow plugin for theme-shoka based on swiper","directories":{"lib":"./lib","images":"./images"},"_nodeVersion":"22.23.2","dependencies":{"nunjucks-date":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.7","oxlint":"^1.74.0"},"_npmOperationalInternal":{"tmp":"tmp/hexo-shoka-swiper_0.1.16_1789752885252_0.855070885662349","host":"s3://npm-registry-packages-npm-production"}},"0.1.17":{"name":"hexo-shoka-swiper","version":"0.1.17","keywords":["hexo","renderer","swiper","Slideshow","shoka","theme-shoka","plugins"],"author":{},"license":"Apache-2.0","_id":"hexo-shoka-swiper@0.1.17","maintainers":[{"name":"llxlr","email":"yanghongday369@gmail.com"}],"homepage":"https://github.com/llxlr/hexo-shoka-swiper#readme","bugs":{"url":"https://github.com/llxlr/hexo-shoka-swiper/issues"},"dist":{"shasum":"adadccfe579262d9bac6cdeba97f23632b36f405","tarball":"https://registry.npmjs.org/hexo-shoka-swiper/-/hexo-shoka-swiper-0.1.17.tgz","fileCount":10,"integrity":"sha512-mtmLc+z5wUscwu+Hceh0I8TL1iIvrodg2AgiISg/m2LpHg+0QAHDI4C21LX2Tou6Qq26fr8WHyM26Q6gGKvsjg==","signatures":[{"sig":"MEUCIB68FxaYo/7lsvG1yK8DiU7WHP0upuhefqn+E7EE90BUAiEAmLrg1gz5m34EoR907qW7KzsqyMCiuyyTnh41JG7icTA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCICnGL0eh0/hx3bTxtXwecrcMVPLwkpLJXSwQIR1HVi6AAiAJ0bvWL8bDSwqDiho9X+UC5FOlvH3zlMa1196XrvhkFQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":787137},"hexo":{"version":">=5"},"main":"index.js","engines":{"node":">=22"},"gitHead":"0fba773d9ba5e43556744310f2c15e6cb3f7ecce","scripts":{"lint":"oxlint","prepare":"husky"},"_npmUser":{"name":"llxlr","email":"yanghongday369@gmail.com"},"repository":{"url":"git+https://github.com/llxlr/hexo-shoka-swiper.git","type":"git"},"_npmVersion":"10.9.8","description":"A Slideshow and Cardshow plugin for theme-shoka based on swiper","directories":{"lib":"./lib","images":"./images"},"_nodeVersion":"22.23.2","dependencies":{"nunjucks-date":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.7","oxlint":"^1.74.0"},"_npmOperationalInternal":{"tmp":"tmp/hexo-shoka-swiper_0.1.17_1789798460289_0.059017438730764926","host":"s3://npm-registry-packages-npm-production"}},"0.1.18":{"_id":"hexo-shoka-swiper@0.1.18","bugs":{"url":"https://github.com/llxlr/hexo-shoka-swiper/issues"},"dist":{"shasum":"1f11e5561692f6c2bcad670dffa946f290d6d5a0","tarball":"https://registry.npmjs.org/hexo-shoka-swiper/-/hexo-shoka-swiper-0.1.18.tgz","fileCount":10,"integrity":"sha512-otfUU7DHMc9K+cGtw6oXc41vvzbiyC06ldT9j+00D6a+xWFEXudkQM37n6ue9x0tHgEJNygbsOOsxHhlyF4Mhw==","signatures":[{"sig":"MEUCIQD/qCNskAlxv7pZ+e/zQQj2IaqNToXml9OYWTiqadqc5AIgd3MiR1pB2s8y1IYIEfIm+S/n0xcIBuAq1dpD3g5a/yM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFMnq0rObguca+pIibndiPu44C88nQSk6UFjWgzMiInWAiA92Tdi+e7jUV7vnQ7P6196vDeO9eOodd8O5ihmC7tCJw=="}],"unpackedSize":785051},"hexo":{"version":">=5"},"main":"index.js","name":"hexo-shoka-swiper","author":{},"engines":{"node":">=22"},"gitHead":"c349ade407e2b2b4c76b6421d4c216043ab4f31c","license":"Apache-2.0","scripts":{"lint":"oxlint","prepare":"husky"},"version":"0.1.18","_npmUser":{"name":"llxlr","email":"yanghongday369@gmail.com"},"homepage":"https://github.com/llxlr/hexo-shoka-swiper#readme","keywords":["hexo","renderer","swiper","Slideshow","shoka","theme-shoka","plugins"],"repository":{"url":"git+https://github.com/llxlr/hexo-shoka-swiper.git","type":"git"},"_npmVersion":"10.9.8","description":"A Slideshow and Cardshow plugin for theme-shoka based on swiper","directories":{"lib":"./lib","images":"./images"},"maintainers":[{"name":"llxlr","email":"yanghongday369@gmail.com"}],"_nodeVersion":"22.23.2","dependencies":{"nunjucks-date":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.7","oxlint":"^1.74.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/hexo-shoka-swiper_0.1.18_1789814854000_0.6079452684607805"}}},"time":{"created":"2022-04-01T17:56:49.907Z","modified":"2026-09-19T10:47:34.295Z","0.0.1":"2022-03-31T16:34:11.191Z","0.0.2":"2022-04-01T17:56:50.178Z","0.0.3":"2022-04-01T18:22:40.965Z","0.0.4":"2022-04-02T13:43:37.441Z","0.0.5":"2022-04-02T15:37:26.003Z","0.0.6":"2022-04-02T16:35:28.812Z","0.0.7":"2022-04-02T16:46:12.059Z","0.0.8":"2022-04-02T17:49:40.926Z","0.0.9":"2022-04-02T18:39:00.555Z","0.1.0":"2022-04-03T09:09:44.495Z","0.1.1":"2022-04-03T16:10:18.646Z","0.1.2":"2022-05-19T11:18:12.323Z","0.1.3":"2022-07-22T12:46:34.802Z","0.1.4":"2022-07-22T15:42:15.838Z","0.1.5":"2022-07-29T15:44:13.513Z","0.1.6":"2026-05-17T10:07:41.766Z","0.1.7":"2026-05-17T10:59:33.976Z","0.1.8":"2026-05-24T05:19:57.568Z","0.1.9":"2026-06-18T15:44:02.007Z","0.1.10":"2026-06-25T09:17:14.707Z","0.1.11":"2026-07-20T14:54:26.305Z","0.1.12":"2026-07-26T15:24:16.879Z","0.1.13":"2026-07-28T16:34:47.028Z","0.1.14":"2026-08-01T10:06:43.085Z","0.1.15":"2026-08-03T16:28:16.030Z","0.1.16":"2026-09-18T17:34:45.465Z","0.1.17":"2026-09-19T06:14:20.386Z","0.1.18":"2026-09-19T10:47:34.122Z"},"bugs":{"url":"https://github.com/llxlr/hexo-shoka-swiper/issues"},"author":{},"license":"Apache-2.0","homepage":"https://github.com/llxlr/hexo-shoka-swiper#readme","keywords":["hexo","renderer","swiper","Slideshow","shoka","theme-shoka","plugins"],"repository":{"url":"git+https://github.com/llxlr/hexo-shoka-swiper.git","type":"git"},"description":"A Slideshow and Cardshow plugin for theme-shoka based on swiper","maintainers":[{"name":"llxlr","email":"yanghongday369@gmail.com"}],"readme":"# hexo-shoka-swiper\n\n给`hexo-theme-shoka`添加 [首页轮播图](https://akilar.top/posts/8e1264d1/)\n\n## 安装\n\n1. 安装插件,在博客`根目录`下打开终端，运行以下指令：\n  ```bash\n  npm install hexo-shoka-swiper --save\n  ```\n\n2. 添加配置信息，以下为写法示例\n  在站点配置文件`_config.yml`或者主题配置文件`_config.shoka.yml`中添加\n\n  ```yaml\n    # hexo-shoka-swiper\n    # 首页轮播图\n    swiper:\n      enable: true # 开关\n      priority: 5 # 过滤器优先权\n      enable_page: / # 应用页面\n      exclude: # 屏蔽页面\n        # - /posts/\n        # - /about/\n      timemode: date # date/updated\n      layout: # 挂载容器类型\n        type: class\n        name: 'index wrap'\n        index: 0\n      error_img: /images/loading.gif # 封面图片加载失败的默认封面\n      insertposition: afterbegin\n      default_descr: 再怎么看我也不知道怎么描述它的啦！\n      swiper_css: https://cdn.jsdelivr.net/npm/hexo-shoka-swiper/lib/swiper.min.css # swiper css 依赖\n      swiper_js: https://cdn.jsdelivr.net/npm/hexo-shoka-swiper/lib/swiper.min.js # swiper js 依赖\n      custom_css: https://cdn.jsdelivr.net/npm/hexo-shoka-swiper/lib/swiperstyle.css # 适配主题样式补丁\n      custom_js: https://cdn.jsdelivr.net/npm/hexo-shoka-swiper/lib/swiper_init.js # swiper 初始化方法\n  ```\n3. 参数释义\n\n  |参数|备选值/类型|释义|\n  |:--|:--|:--|\n  |priority|number|【可选】过滤器优先级，数值越小，执行越早，默认为10，选填|\n  |enable|true/false|【必选】控制开关|\n  |enable_page|path/all|【可选】填写想要应用的页面的相对路径（即路由地址）,如根目录就填'/',分类页面就填'/categories/'。若要应用于所有页面，就填'all'，默认为all|\n  |exclude|path|【可选】填写想要屏蔽的页面，可以多个。仅当enable_page为'all'时生效。写法见示例。原理是将屏蔽项的内容逐个放到当前路径去匹配，若当前路径包含任一屏蔽项，则不会挂载。|\n  |timemode|date/updated|【可选】时间显示，date为显示创建日期，updated为显示更新日期,默认为date|\n  |layout.type|id/class|【可选】挂载容器类型，填写id或class，不填则默认为id|\n  |layout.name|text|【必选】挂载容器名称|\n  |layout.index|0和正整数|【可选】前提是layout.type为class，因为同一页面可能有多个class，此项用来确认究竟排在第几个顺位|\n  |error_img|url|封面图片加载失败时的替换图片|\n  |insertposition|text|'beforebegin'：元素自身的前面。'afterbegin'：插入元素内部的第一个子节点之前。'beforeend'：插入元素内部的最后一个子节点之后。'afterend'：插入元素自身的后面。|\n  |default_descr|text|【可选】默认文章描述|\n  |swiper_css|url|【可选】自定义的swiper依赖项css链接|\n  |swiper_js|url|【可选】自定义的swiper依赖项加js链接|\n  |custom_css|url|【可选】适配主题样式补丁|\n  |custom_js|url|【可选】swiper初始化方法|\n  |gk_slides|true/false|【可选】`{% swiper %}` 是否把 gk 卡片拆成 slide，默认 false；tag 参数 `gk:true/false` 可覆盖|\n  |gk_carousel|true/false|【可选】gk 卡片内的多图是否用轮播展示，默认 true；条目中用 `carousel: true/false` 覆盖|\n  |gk_autoplay|number|【可选】gk 卡片多图轮播的自动播放间隔（毫秒），默认 0 表示不自动播放|\n\n4. 使用方法\n  在文章的`front_matter`中添加`swiper_index`配置项即可。\n  ```markdown\n  ---\n  title: 文章标题\n  date: 创建日期\n  updated: 更新日期\n  cover: 文章封面\n  description: 文章描述\n  swiper_index: 1 # 置顶轮播图顺序，需填非负整数，数字越大越靠前\n  ---\n  ```\n\n  > 如果你的博客安装了 [hexo-hide-posts](https://github.com/prinsss/hexo-hide-posts)（0.4.x），被隐藏的文章（front_matter 中 `hidden: true`）默认不会出现在任何列表中，包括本插件的轮播。若希望某篇隐藏文章也进入轮播，只需在它的 front_matter 中同时设置 `swiper_index` 即可，插件会自动读取 `hexo-hide-posts` 提供的 `hidden_posts` 变量。\n\n  如需使用**视频卡片**，增加以下 front_matter 配置：\n\n  ```markdown\n  ---\n  title: 文章标题\n  date: 创建日期\n  cover: 视频封面图（可选）\n  description: 文章描述\n  swiper_index: 1\n  swiper_type: video           # 卡片类型：video\n  swiper_video: https://...    # 自托管视频直链（mp4/webm），与 swiper_video_embed 二选一\n  swiper_video_poster: /images/poster.jpg  # 视频封面图（可选，仅自托管视频）\n  # swiper_video_embed: <iframe ...></iframe>  # 平台嵌入代码，与 swiper_video 二选一\n  ---\n  ```\n\n  **视频卡片参数说明：**\n\n  |参数|必选|释义|\n  |:--|:--|:--|\n  |swiper_type|【必选】|填 `video` 启用视频卡片 |\n  |swiper_video|【二选一】|自托管视频文件直链（mp4、webm 等），使用 `<video>` 标签播放 |\n  |swiper_video_embed|【二选一】|平台嵌入 iframe 代码，如 B站、YouTube 的分享嵌入 HTML |\n  |swiper_video_poster|【可选】|视频加载前显示的封面图，仅对 `swiper_video` 生效 |\n\n  **B站嵌入示例：**\n  ```markdown\n  swiper_type: video\n  swiper_video_embed: <iframe src=\"//player.bilibili.com/player.html?bvid=BV1xx411c7mD\" scrolling=\"no\" border=\"0\" frameborder=\"no\" framespacing=\"0\" allowfullscreen=\"true\" width=\"100%\" height=\"100%\"></iframe>\n  ```\n\n  **YouTube 嵌入示例：**\n  ```markdown\n  swiper_type: video\n  swiper_video_embed: <iframe src=\"https://www.youtube.com/embed/VIDEO_ID\" frameborder=\"0\" allowfullscreen width=\"100%\" height=\"100%\"></iframe>\n  ```\n\n  不指定 `swiper_type` 或留空则默认使用图片卡片，不影响已有文章。\n\n5. 文章内轮播（Tag 插件）\n\n  在文章 Markdown 中使用 `{% swiper %}` 标签插入轮播。\n\n  **图库式（gallery）** — 适合图片集、教程截图、作品展示：\n\n  ```markdown\n  {% swiper style:gallery, ratio:16:9 %}\n    {% slide cover:/images/photo1.jpg %}\n      ### 图片标题\n      图片描述文字（支持 Markdown）\n    {% endslide %}\n    {% slide cover:/images/photo2.jpg %}\n    {% endslide %}\n    {% slide video:/videos/demo.mp4, poster:/images/cover.jpg %}\n      视频说明\n    {% endslide %}\n    {% slide embed:\"<iframe src=\\\"//player.bilibili.com/player.html?bvid=xxx\\\" allowfullscreen></iframe>\" %}\n      B站嵌入示例\n    {% endslide %}\n  {% endswiper %}\n  ```\n\n  **迷你卡片式（card）** — 适合文章内嵌推荐内容，fade 切换：\n\n  ```markdown\n  {% swiper style:card %}\n    {% slide cover:/images/post1.jpg, link:/posts/hello/ %}\n      推荐文章标题\n    {% endslide %}\n    {% slide cover:/images/post2.jpg %}\n      另一篇文章描述\n    {% endslide %}\n  {% endswiper %}\n  ```\n\n  **swiper 参数：**\n\n  |参数|默认值|释义|\n  |:--|:--|:--|\n  |style|gallery|布局风格：`gallery` 图库式 / `card` 迷你卡片式 / `gk` gk 卡片式|\n  |ratio|16:9|gallery 模式下媒体宽高比：`16:9` / `4:3` / `1:1`|\n  |autoplay|3000|自动播放间隔（毫秒），`false` 关闭自动播放|\n  |mousewheel|true|鼠标滚轮翻页开关，`false` 关闭|\n\n  **slide 参数：**\n\n  |参数|释义|\n  |:--|:--|\n  |cover|图片 URL|\n  |link|点击跳转链接|\n  |video|自托管视频直链（mp4/webm）|\n  |poster|视频封面图|\n  |embed|平台嵌入 iframe 代码|\n  |type|`image` / `video`（通常自动检测，可不填）|\n\n  **兼容 Shoka 主题 gk 卡片（`{% gk %}` / `{% gkfile %}`）**\n\n  在 `{% swiper %}` 里放 gk 卡片时，每张 `.gk-item` 可以成为一张 slide（容器风格自动用 `gk`）。该行为**默认关闭**，按需打开：\n\n  ```yml\n  # _config.yml 或 _config.shoka.yml\n  swiper:\n    gk_slides: true     # 默认 false：不把 gk 卡片拆成 slide\n  ```\n\n  ```markdown\n  {% swiper gk:true, autoplay:false %}\n    {% gkfile \"toys/_data.yml\" %}\n  {% endswiper %}\n  ```\n\n  开关优先级：tag 参数 `gk:true` / `gk:false` > 显式 `style:gk` > 配置 `swiper.gk_slides`（默认 `false`）。\n\n  |写法|含义|\n  |:--|:--|\n  |`{% swiper gk:true %}`|本次把 gk 卡片拆成 slide（无视配置）|\n  |`{% swiper gk:false %}`|本次不拆，gk 卡片原样落入容器（可自己用 `{% slide %}` 包裹）|\n  |`{% swiper style:gk %}`|显式声明 gk 风格，等价于开启|\n  |配置 `gk_slides: true`|全局默认开启，标签里可省略 `gk:true`|\n\n  也可以把 gk 卡片写进单个 `{% slide %}`（用 `type:gk` 显式声明，或全局开启后自动识别），此时卡片本体即 slide 内容（不再生成封面图与描述浮层）：\n\n  ```markdown\n  {% swiper %}\n    {% slide type:gk %}\n      {% gk \"figure\" %}\n      - name: 初音未来\n        price: ¥4,800\n        release: 2023-03\n      {% endgk %}\n    {% endslide %}\n  {% endswiper %}\n  ```\n\n  gk 卡片的图片使用 `data-src` 懒加载，插件会在初始化时补全 `src`，避免非当前 slide 的图片一直空白；`{% gkfile %}` 是异步标签，插件已将 `swiper` / `slide` 注册为异步标签以支持嵌套。\n\n  **gk 卡片多图自动轮播**\n\n  主题 gk 卡片在条目包含多张图片时会输出 `.gk-img > .gallery` 的纵向堆叠。插件在**构建期**把这种多图区域转换成 `.gk-swiper` 轮播结构（桌面端圆点 + 左右箭头，移动端滑动 + 圆点），运行时由 `swiper_init.js` 初始化实例，同时注入所需资源：\n\n  ```yaml\n  - name: 示例手办\n    carousel: true      # 可选：该条目是否轮播，见下方「开关」\n    images:\n      - url: /images/a.jpg\n      - url: /images/b.jpg\n      - url: /images/c.jpg\n  ```\n\n  **开关**\n\n  |位置|写法|说明|\n  |:--|:--|:--|\n  |站点/主题配置|`swiper.gk_carousel: true`|总开关，默认值：多图条目默认使用轮播|\n  |站点/主题配置|`swiper.gk_carousel: false`|总开关关闭：多图条目保持原来的纵向堆叠|\n  |gk 条目|`carousel: false`|该条目不做轮播（总开关开启时用来排除）|\n  |gk 条目|`carousel: true`|该条目单独开启轮播（总开关关闭时用来挑选）|\n\n  条目级的 `carousel` 由主题 gk 标签渲染成 `.gk-img[data-gk-carousel=\"on|off\"]`，插件读取后决定该条目是否轮播；没写 `carousel` 的条目跟随总开关。\n\n  - 单图卡片保持原样，不会被改写；\n  - 轮播默认不自动播放，可用配置 `swiper.gk_autoplay`（毫秒）打开，例如 `gk_autoplay: 4000`；\n  - 图片仍走主题的 `data-src` 懒加载：初始化时只加载当前与下一张，切换时继续补充；\n  - 轮播内会忽略 gk 数据里为纵向堆叠写的 `style: zoom:50%` 缩放，保证与同页单图卡片的图片尺寸一致（需要保留可在自定义 CSS 中覆盖）；\n  - 仅当页面确实存在需要轮播的多图 gk 卡片时才注入 Swiper 资源，已加载过资源的页面不会重复注入。\n\n  slide 的内容会作为描述文本渲染（支持 Markdown）。即使首页 swiper 关闭，文章内 tag 也能独立工作，且适配 Shoka PJAX。\n\n  三种风格（`gallery` / `card` / `gk`）均默认开启**自动播放**（3s 间隔）、**鼠标滚轮翻页**和**循环轮播**（滚到最后自动回到第一张）。可通过参数关闭：\n\n  ```markdown\n  {% swiper style:gallery, autoplay:false, mousewheel:false %}\n  ```\n\n  自定义自动播放间隔（毫秒）：\n\n  ```markdown\n  {% swiper style:gallery, autoplay:5000 %}\n  ```\n","readmeFilename":"README.md"}