<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>指南 on 当以读书通世事</title><link>https://www.sakaay.com/guide/</link><description>Recent content in 指南 on 当以读书通世事</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Fri, 26 Dec 2025 21:30:10 +0800</lastBuildDate><atom:link href="https://www.sakaay.com/guide/index.xml" rel="self" type="application/rss+xml"/><item><title>google-adsense</title><link>https://www.sakaay.com/guide/google-adsense/</link><pubDate>Fri, 26 Dec 2025 21:30:10 +0800</pubDate><guid>https://www.sakaay.com/guide/google-adsense/</guid><description>&lt;h1 id="google-adsense-广告使用指南"&gt;Google AdSense 广告使用指南&lt;/h1&gt;&#10;&lt;p&gt;本文档将详细介绍如何在 Markdown 文件中集成 Google AdSense 广告。&lt;/p&gt;&#10;&lt;h2 id="基本使用方法"&gt;基本使用方法&lt;/h2&gt;&#10;&lt;p&gt;要在 Markdown 文件中添加广告单元，只需使用已经注册的 &lt;code&gt;GoogleAd&lt;/code&gt; 组件即可。最简单的使用方式如下：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-html" data-lang="html"&gt;&lt;span class="line"&gt;&lt;span class="ln"&gt;1&lt;/span&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;GoogleAd&lt;/span&gt; &lt;span class="na"&gt;ad-slot&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;1234567890&amp;#34;&lt;/span&gt; &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="自定义广告配置"&gt;自定义广告配置&lt;/h2&gt;&#10;&lt;p&gt;您可以根据需要自定义广告单元的各种参数：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-html" data-lang="html"&gt;&lt;span class="line"&gt;&lt;span class="ln"&gt;1&lt;/span&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;GoogleAd&lt;/span&gt; &#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="ln"&gt;2&lt;/span&gt;&lt;span class="cl"&gt; &lt;span class="na"&gt;ad-slot&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;1234567890&amp;#34;&lt;/span&gt; &#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="ln"&gt;3&lt;/span&gt;&lt;span class="cl"&gt; &lt;span class="na"&gt;ad-format&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;fluid&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="ln"&gt;4&lt;/span&gt;&lt;span class="cl"&gt; &lt;span class="na"&gt;width&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;300&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="ln"&gt;5&lt;/span&gt;&lt;span class="cl"&gt; &lt;span class="na"&gt;height&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;250&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="ln"&gt;6&lt;/span&gt;&lt;span class="cl"&gt; &lt;span class="na"&gt;ad-client&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;ca-pub-您的发布者ID&amp;#34;&lt;/span&gt; &#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="ln"&gt;7&lt;/span&gt;&lt;span class="cl"&gt; &lt;span class="na"&gt;debug&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;false&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="ln"&gt;8&lt;/span&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="参数说明"&gt;参数说明&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;参数&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;类型&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;默认值&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;说明&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ad-slot&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;String&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;必填&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;广告单元ID，在AdSense控制台中创建&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ad-client&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;String&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;ca-pub-2897720906666216&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;发布者ID，默认为测试ID&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ad-format&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;String&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;fluid&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;广告格式，如 'fluid', 'auto', 'rectangle', 'leaderboard' 等&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ad-layout-key&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;String&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;-ii+7-14-2d+99&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;广告布局键，可在AdSense获取&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;width&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;String/Number&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;undefined&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;广告宽度&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;height&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;String/Number&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;undefined&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;广告高度&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;style&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Object&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;{}&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;额外的CSS样式&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;debug&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Boolean&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;false&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;是否启用调试模式，启用后会显示占位符&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;display&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Boolean&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;true&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;是否显示广告&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;h2 id="注意事项"&gt;注意事项&lt;/h2&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;strong&gt;广告脚本自动加载&lt;/strong&gt;：组件会自动处理 Google AdSense 脚本的加载，无需在页面其他位置手动引入。&lt;/p&gt;</description></item><item><title>friends-links</title><link>https://www.sakaay.com/guide/friends-links/</link><pubDate>Wed, 22 Oct 2025 23:10:31 +0800</pubDate><guid>https://www.sakaay.com/guide/friends-links/</guid><description>&lt;h1 id="实现友链页面功能"&gt;实现友链页面功能&lt;/h1&gt;&#10;&lt;p&gt;本教程将指导你如何在 VitePress 主题中实现一个功能丰富的友链页面，包括随机访问、申请友链、头像滚动等功能，并集成 Twikoo 评论系统。&lt;/p&gt;&#10;&lt;h2 id="1-准备工作"&gt;1. 准备工作&lt;/h2&gt;&#10;&lt;p&gt;确保你已经完成以下步骤：&lt;/p&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;安装 VitePress 主题并配置好基础项目。&lt;/li&gt;&#10;&lt;li&gt;注册 Twikoo 服务并获取 &lt;code&gt;envId&lt;/code&gt;（环境 ID）。&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;h2 id="2-创建友链组件"&gt;2. 创建友链组件&lt;/h2&gt;&#10;&lt;p&gt;在主题的组件目录中创建一个 Vue 文件（如 &lt;code&gt;SLink/index.vue&lt;/code&gt;），并添加以下代码：&lt;/p&gt;</description></item></channel></rss>