[{"content":"这是一个用 Hugo + PaperMod 搭的静态博客，没有后台，写 Markdown 文件就是发文。\n发文三步 在 content/posts/ 里新建一个 .md 文件 顶部 front matter 填标题、日期、标签 存盘 → 本地预览确认 → 构建发布 文章头部长这样：\n--- title: \u0026#34;文章标题\u0026#34; date: 2026-09-10T23:10:00+08:00 draft: false tags: [\u0026#34;标签1\u0026#34;, \u0026#34;标签2\u0026#34;] categories: [\u0026#34;分类\u0026#34;] summary: \u0026#34;列表页显示的摘要\u0026#34; --- draft: true 是草稿，只在本地预览时可见（hugo server -D），不会进正式站点。\n常用命令 # 本地预览（含草稿），改文件自动刷新 hugo server -D # 新建文章 hugo new content posts/文章名.md # 生成静态文件到 public/ hugo --gc --minify 浏览器打开 http://localhost:1313 就能看。\n有哪些页面 页面 路径 首页 / 文章列表 /posts/ 归档 /archives/ 标签 /tags/ 搜索 /search/ 搜索是纯前端的，不需要服务器，输入关键词即可。\n下一篇讲怎么在文章里放 B站视频：这是用短代码上色的示例 。\n","permalink":"https://a19dc1e7.blog-hugo-2f2.pages.dev/posts/welcome/","summary":"这个博客怎么发文、怎么本地预览、怎么生成静态文件。","title":"开始写第一篇文章"},{"content":"B站官方的嵌入代码又长又难记，这个站点配了一个短代码，一行就够了。\n最快用法 把下面这行写进 Markdown（BV 号换成你自己的）：\n{{\u0026lt; bilibili BV1GJ411x7h7 \u0026gt;}} 渲染出来是这样：\nBV 号在视频页地址栏里，形如 https://www.bilibili.com/video/BV1GJ411x7h7/， 也可以直接写 av 号：{{\u0026lt; bilibili av170001 \u0026gt;}}。\n⚠️ 位置写法只能单独用。一旦要带其它参数，就必须写成 id=\u0026quot;BV...\u0026quot; —— 这是 Hugo 的规则，不允许位置参数和命名参数混用。\n参数 参数 说明 默认值 id BV 号或 av 号，也可以直接写在第一个位置 必填 page 分P，第几个 P 1 danmaku 弹幕开关，1 开 0 关 0 autoplay 自动播放，1 开 0 muted 静音，默认跟随 autoplay 自动 ratio 画面比例 16/9 title iframe 的无障碍标题 哔哩哔哩视频 几个组合（下面是示例代码，不会真的插入视频）：\n{{\u0026lt; bilibili id=\u0026#34;BV1GJ411x7h7\u0026#34; page=2 \u0026gt;}} {{\u0026lt; bilibili id=\u0026#34;BV1GJ411x7h7\u0026#34; danmaku=1 autoplay=1 muted=1 \u0026gt;}} {{\u0026lt; bilibili id=\u0026#34;BV1GJ411x7h7\u0026#34; ratio=\u0026#34;4/3\u0026#34; title=\u0026#34;课程讲解\u0026#34; \u0026gt;}} 想开弹幕看看实际效果：\n写文档时的一个坑 Hugo 对代码块里的 shortcode 也会执行，所以上面那些示例必须写成转义形式， 否则会真的插进去一个播放器：\n{{\u0026lt; bilibili BV1xx \u0026gt;}} 看到的那对 /* */ 就是转义标记，页面上会显示成正常的短代码写法，方便复制。\n几个必须知道的点 未登录访客大概率只能看 360P / 480P。这是 B站对嵌入播放器的限制，不是配置错了。想要高清得在 B站点登录账号，但访客看不到你的登录态。 播放器右上角会有\u0026quot;去B站看\u0026quot;和推荐浮层，官方嵌入代码去不掉。 autoplay 在手机上基本会被浏览器拦掉，这是浏览器的自动播放策略，不是代码问题。 视频必须用 https 播放器地址，本站已经写死了 https://，不要手动改成 // 或 http，否则在 https 站点上会被浏览器拦成混合内容，白屏。 如果 shortcode 不好使 也可以用主题自带的 rawhtml 短代码直接贴官方嵌入代码：\n{{\u0026lt; rawhtml \u0026gt;}} \u0026lt;iframe src=\u0026#34;https://player.bilibili.com/player.html?bvid=BV1GJ411x7h7\u0026amp;page=1\u0026amp;high_quality=1\u0026amp;danmaku=0\u0026#34; width=\u0026#34;100%\u0026#34; height=\u0026#34;500\u0026#34; scrolling=\u0026#34;no\u0026#34; frameborder=\u0026#34;0\u0026#34; allowfullscreen=\u0026#34;true\u0026#34;\u0026gt;\u0026lt;/iframe\u0026gt; {{\u0026lt; /rawhtml \u0026gt;}} 这样写不会有自适应比例，手机上可能变形，所以还是推荐上面的 bilibili 短代码。\n","permalink":"https://a19dc1e7.blog-hugo-2f2.pages.dev/posts/bilibili-video-guide/","summary":"一行短代码把 B站视频放进文章，支持分P、弹幕开关、自定义比例，手机上自适应不变形。","title":"在文章里嵌入 B站视频"}]