<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>文檔 on Hugo 主題 Stack</title>
        <link>https://yanyanliu.com/zh-hant-tw/categories/documentation/</link>
        <description>Recent content in 文檔 on Hugo 主題 Stack</description>
        <generator>Hugo -- gohugo.io</generator>
        <language>zh-hant-tw</language>
        <lastBuildDate>Mon, 26 Jan 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://yanyanliu.com/zh-hant-tw/categories/documentation/index.xml" rel="self" type="application/rss+xml" /><item>
            <title>相簿</title>
            <link>https://yanyanliu.com/zh-hant-tw/p/image-gallery/</link>
            <pubDate>Mon, 26 Jan 2026 00:00:00 +0000</pubDate>
            <guid>https://yanyanliu.com/zh-hant-tw/p/image-gallery/</guid>
            <description>&lt;img src=&#34;https://yanyanliu.com/&#34; alt=&#34;Featured image of post 相簿&#34; /&gt;&lt;p&gt;Stack 主題內置了對相簿的支持。你只需要簡單地將多張圖片並排放置，就可以創建一個精美的相簿。&lt;/p&gt;&#xA;&lt;h2 id=&#34;示例相簿&#34;&gt;示例相簿&#xA;&lt;/h2&gt;&lt;p&gt;&lt;img alt=&#34;Photo by Florian Klauer on Unsplash&#34; class=&#34;gallery-image&#34; data-flex-basis=&#34;160px&#34; data-flex-grow=&#34;66&#34; height=&#34;1000&#34; loading=&#34;lazy&#34; sizes=&#34;(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px&#34; src=&#34;https://yanyanliu.com/p/image-gallery/florian-klauer-nptLmg6jqDo-unsplash.jpg&#34; width=&#34;667&#34;&gt;  &lt;img alt=&#34;Photo by Luca Bravo on Unsplash&#34; class=&#34;gallery-image&#34; data-flex-basis=&#34;359px&#34; data-flex-grow=&#34;149&#34; height=&#34;667&#34; loading=&#34;lazy&#34; sizes=&#34;(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px&#34; src=&#34;https://yanyanliu.com/p/image-gallery/luca-bravo-alS7ewQ41M8-unsplash.jpg&#34; srcset=&#34;https://yanyanliu.com/p/image-gallery/luca-bravo-alS7ewQ41M8-unsplash_hu_33106cec50e27d6d.jpg 800w, https://yanyanliu.com/p/image-gallery/luca-bravo-alS7ewQ41M8-unsplash.jpg 1000w&#34; width=&#34;1000&#34;&gt;&lt;/p&gt;&#xA;&lt;p&gt;&lt;img alt=&#34;Photo by Helena Hertz on Unsplash&#34; class=&#34;gallery-image&#34; data-flex-basis=&#34;320px&#34; data-flex-grow=&#34;133&#34; height=&#34;750&#34; loading=&#34;lazy&#34; sizes=&#34;(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px&#34; src=&#34;https://yanyanliu.com/p/image-gallery/helena-hertz-wWZzXlDpMog-unsplash.jpg&#34; srcset=&#34;https://yanyanliu.com/p/image-gallery/helena-hertz-wWZzXlDpMog-unsplash_hu_6c237bc498d55aea.jpg 800w, https://yanyanliu.com/p/image-gallery/helena-hertz-wWZzXlDpMog-unsplash.jpg 1000w&#34; width=&#34;1000&#34;&gt;  &lt;img alt=&#34;Photo by Hudai Gayiran on Unsplash&#34; class=&#34;gallery-image&#34; data-flex-basis=&#34;160px&#34; data-flex-grow=&#34;66&#34; height=&#34;1000&#34; loading=&#34;lazy&#34; sizes=&#34;(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px&#34; src=&#34;https://yanyanliu.com/p/image-gallery/hudai-gayiran-3Od_VKcDEAA-unsplash.jpg&#34; width=&#34;667&#34;&gt;&lt;/p&gt;&#xA;&lt;h2 id=&#34;它是如何工作的&#34;&gt;它是如何工作的&#xA;&lt;/h2&gt;&lt;p&gt;相簿由 &lt;strong&gt;Photoswipe&lt;/strong&gt; 和一個自定義的內部腳本驅動。它會根據圖片的寬高比自動計算出最佳佈局。&lt;/p&gt;&#xA;&lt;p&gt;要創建一個相簿，你只需要將多張圖片放在同一行（或同一個段落）中。&lt;/p&gt;&#xA;&lt;h3 id=&#34;語法&#34;&gt;語法&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;![&lt;span class=&#34;nt&#34;&gt;圖片 1&lt;/span&gt;](&lt;span class=&#34;na&#34;&gt;image1.jpg&lt;/span&gt;)  ![&lt;span class=&#34;nt&#34;&gt;圖片 2&lt;/span&gt;](&lt;span class=&#34;na&#34;&gt;image2.jpg&lt;/span&gt;) &#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;![&lt;span class=&#34;nt&#34;&gt;圖片 3&lt;/span&gt;](&lt;span class=&#34;na&#34;&gt;image3.jpg&lt;/span&gt;)  ![&lt;span class=&#34;nt&#34;&gt;圖片 4&lt;/span&gt;](&lt;span class=&#34;na&#34;&gt;image4.jpg&lt;/span&gt;)&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;&lt;strong&gt;注意&lt;/strong&gt;: 圖片之間應該有兩個空格，以確保它們在 Markdown 中保持在同一行。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;hr&gt;&#xA;&lt;p&gt;相簿語法啟發自 &lt;a class=&#34;link&#34; href=&#34;https://typlog.com/&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;Typlog&lt;/a&gt;&lt;/p&gt;&#xA;</description>
        </item><item>
            <title>短代碼</title>
            <link>https://yanyanliu.com/zh-hant-tw/p/%E7%9F%AD%E4%BB%A3%E7%A2%BC/</link>
            <pubDate>Mon, 26 Jan 2026 00:00:00 +0000</pubDate>
            <guid>https://yanyanliu.com/zh-hant-tw/p/%E7%9F%AD%E4%BB%A3%E7%A2%BC/</guid>
            <description>&lt;p&gt;Stack 主題還提供了一些自定義短代碼來增強你的內容。&lt;/p&gt;&#xA;&lt;h2 id=&#34;引用-quote&#34;&gt;引用 (Quote)&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;quote&lt;/code&gt; 短代碼允許你顯示帶有作者、來源和 URL 的引用。&lt;/p&gt;&#xA;&lt;blockquote&gt;&#xA;    &lt;p&gt;Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.&lt;/p&gt;&lt;span class=&#34;cite&#34;&gt;&lt;span&gt;― &lt;/span&gt;&lt;span&gt;一位名人, &lt;/span&gt;&lt;a href=&#34;https://zh.wikipedia.org/wiki/Book&#34;&gt;&lt;cite&gt;他們寫的書&lt;/cite&gt;&lt;/a&gt;&lt;/span&gt;&lt;/blockquote&gt;&#xA;&lt;h3 id=&#34;用法&#34;&gt;用法&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;{{&amp;lt; quote author=&amp;#34;作者名字&amp;#34; source=&amp;#34;文章標題&amp;#34; url=&amp;#34;https://example.com&amp;#34; &amp;gt;}}&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;這裡是引用內容。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;{{&amp;lt; /quote &amp;gt;}}&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h2 id=&#34;視頻-video&#34;&gt;視頻 (Video)&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;video&lt;/code&gt; 短代碼允許你嵌入自託管或遠程視頻文件。&lt;/p&gt;&#xA;&lt;div class=&#34;video-wrapper&#34;&gt;&#xA;    &lt;video&#xA;        controls&#xA;        src=&#34;https://www.w3schools.com/html/mov_bbb.mp4&#34;&#xA;        &#xA;        &#xA;        &#xA;    &gt;&#xA;        &lt;p&gt;&#xA;            Your browser doesn&#39;t support HTML5 video. Here is a&#xA;            &lt;a href=&#34;https://www.w3schools.com/html/mov_bbb.mp4&#34;&gt;link to the video&lt;/a&gt; instead.&#xA;        &lt;/p&gt;&#xA;    &lt;/video&gt;&#xA;&lt;/div&gt;&#xA;&#xA;&lt;h3 id=&#34;用法-1&#34;&gt;用法&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;{{&amp;lt; video src=&amp;#34;https://example.com/video.mp4&amp;#34; &amp;gt;}}&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h2 id=&#34;bilibili&#34;&gt;Bilibili&#xA;&lt;/h2&gt;&lt;p&gt;嵌入來自 Bilibili 的視頻。支持 &lt;code&gt;av&lt;/code&gt; 和 &lt;code&gt;bv&lt;/code&gt; 號。&lt;/p&gt;&#xA;&#xD;&#xA;&#xD;&#xA;&#xD;&#xA;&#xD;&#xA;&#xD;&#xA;&#xD;&#xA;    &#xD;&#xA;&#xD;&#xA;&#xD;&#xA;&lt;div class=&#34;video-wrapper&#34;&gt;&#xD;&#xA;    &lt;iframe src=&#34;https://player.bilibili.com/player.html?as_wide=1&amp;amp;high_quality=1&amp;amp;page=1&amp;bvid=BV1634y1t7xR&#34;&#xD;&#xA;            scrolling=&#34;no&#34;&#xD;&#xA;            frameborder=&#34;no&#34;&#xD;&#xA;            framespacing=&#34;0&#34;&#xD;&#xA;            allowfullscreen=&#34;true&#34;&#xD;&#xA;    &gt;&#xD;&#xA;    &lt;/iframe&gt;&#xD;&#xA;&lt;/div&gt;&#xD;&#xA;&#xA;&lt;h3 id=&#34;用法-2&#34;&gt;用法&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;{{&amp;lt; bilibili &amp;#34;BV1634y1t7xR&amp;#34; &amp;gt;}}&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h2 id=&#34;youtube&#34;&gt;YouTube&#xA;&lt;/h2&gt;&lt;p&gt;Hugo 內置的 YouTube 短代碼。&lt;/p&gt;&#xA;&lt;div class=&#34;video-wrapper&#34;&gt;&#xA;    &lt;iframe loading=&#34;lazy&#34; &#xA;            src=&#34;https://www.youtube.com/embed/ZJthWmvUzzc&#34; &#xA;            allowfullscreen &#xA;            title=&#34;YouTube Video&#34;&#xA;    &gt;&#xA;    &lt;/iframe&gt;&#xA;&lt;/div&gt;&#xA;&#xA;&lt;h3 id=&#34;用法-3&#34;&gt;用法&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;{{&amp;lt; youtube ZJthWmvUzzc &amp;gt;}}&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h2 id=&#34;騰訊視頻-tencent-video&#34;&gt;騰訊視頻 (Tencent Video)&#xA;&lt;/h2&gt;&lt;p&gt;嵌入來自騰訊視頻的視頻。&lt;/p&gt;&#xA;&#xD;&#xA;&lt;div class=&#34;video-wrapper&#34;&gt;&#xD;&#xA;    &lt;iframe src=&#34;https://v.qq.com/txp/iframe/player.html?vid=u00306ng962&amp;auto=0&#34; &#xD;&#xA;            scrolling=&#34;no&#34; &#xD;&#xA;            frameborder=&#34;no&#34;&#xD;&#xA;            framespacing=&#34;0&#34; &#xD;&#xA;            allowfullscreen=&#34;true&#34;&#xD;&#xA;    &gt;&#xD;&#xA;    &lt;/iframe&gt;&#xD;&#xA;&lt;/div&gt;&#xA;&lt;h3 id=&#34;用法-4&#34;&gt;用法&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;{{&amp;lt; tencent &amp;#34;u00306ng962&amp;#34; &amp;gt;}}&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h2 id=&#34;gitlab-snippet&#34;&gt;GitLab Snippet&#xA;&lt;/h2&gt;&lt;p&gt;嵌入來自 GitLab 的代碼片段。&lt;/p&gt;&#xA;&lt;script&#xA;    type=&#34;application/javascript&#34;&#xA;    src=&#34;https://gitlab.com/-/snippets/2349278.js&#34;&#xA;&gt;&lt;/script&gt;&#xA;&lt;h3 id=&#34;用法-5&#34;&gt;用法&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;{{&amp;lt; gitlab 2349278 &amp;gt;}}&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h2 id=&#34;圖表-diagrams&#34;&gt;圖表 (Diagrams)&#xA;&lt;/h2&gt;&lt;p&gt;Stack 出箱即用地支持 &lt;a class=&#34;link&#34; href=&#34;https://mermaid.js.org/&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;Mermaid&lt;/a&gt; 圖表。&lt;/p&gt;&#xA;&lt;pre class=&#34;mermaid&#34; style=&#34;visibility:hidden&#34;&gt;graph TD;&#xA;    A--&gt;B;&#xA;    A--&gt;C;&#xA;    B--&gt;D;&#xA;    C--&gt;D;&lt;/pre&gt;&lt;h3 id=&#34;用法-6&#34;&gt;用法&#xA;&lt;/h3&gt;&lt;p&gt;將你的 Mermaid 代碼包裹在語言設置為 &lt;code&gt;mermaid&lt;/code&gt; 的代碼塊中。&lt;/p&gt;&#xA;&lt;pre&gt;&lt;code&gt;```mermaid&#xA;graph TD;&#xA;    A--&gt;B;&#xA;    A--&gt;C;&#xA;    B--&gt;D;&#xA;    C--&gt;D;&#xA;```&lt;/code&gt;&lt;/pre&gt;</description>
        </item></channel>
</rss>
