<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>TIL 學習筆記 on Tarragon</title><link>https://tarrragon.github.io/blog/til/</link><description>Recent content in TIL 學習筆記 on Tarragon</description><generator>Hugo -- gohugo.io</generator><language>zh-TW</language><copyright>Tarragon (CC BY 4.0)</copyright><lastBuildDate>Thu, 18 Jun 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://tarrragon.github.io/blog/til/index.xml" rel="self" type="application/rss+xml"/><item><title>Snippet、Template、Skeleton 的差別</title><link>https://tarrragon.github.io/blog/til/snippet_template_skeleton/</link><pubDate>Wed, 22 Apr 2026 00:00:00 +0000</pubDate><guid>https://tarrragon.github.io/blog/til/snippet_template_skeleton/</guid><description>&lt;p>這三個字都和「可重用的內容結構」有關，但重點不同。&lt;/p>
&lt;h2 id="一般英文中的意思">一般英文中的意思&lt;/h2>
&lt;p>&lt;code>snippet&lt;/code> 原本是「片段」或「摘錄」。&lt;/p>
&lt;ul>
&lt;li>可以是一小段文字&lt;/li>
&lt;li>也可以是程式碼、對話、影像或聲音的片段&lt;/li>
&lt;li>重點是它是從整體中切出來的一小部分&lt;/li>
&lt;/ul>
&lt;p>&lt;code>template&lt;/code> 是「模板」或「範本」。&lt;/p>
&lt;ul>
&lt;li>表示一個可以反覆套用的格式&lt;/li>
&lt;li>通常會保留一些空位，等人填入內容&lt;/li>
&lt;li>重點是「先有結構，再填資料」&lt;/li>
&lt;/ul>
&lt;p>&lt;code>skeleton&lt;/code> 是「骨架」。&lt;/p>
&lt;ul>
&lt;li>表示最基本、最少的框架&lt;/li>
&lt;li>還沒有完整細節&lt;/li>
&lt;li>重點是「先把架構立起來」&lt;/li>
&lt;/ul>
&lt;h2 id="技術寫作中的意思">技術寫作中的意思&lt;/h2>
&lt;p>在技術文件、程式開發、教學內容裡，這三個詞常常各自負責不同層級的重用。&lt;/p>
&lt;h3 id="snippet">&lt;code>snippet&lt;/code>&lt;/h3>
&lt;p>通常指短小、可直接插入的內容片段。&lt;/p>
&lt;ul>
&lt;li>一小段程式碼&lt;/li>
&lt;li>一小段設定&lt;/li>
&lt;li>一小段說明文字&lt;/li>
&lt;li>一小段固定格式的提醒&lt;/li>
&lt;/ul>
&lt;p>它的特徵是短、穩、可重複使用。&lt;/p>
&lt;h3 id="template">&lt;code>template&lt;/code>&lt;/h3>
&lt;p>通常指帶欄位的完整格式。&lt;/p>
&lt;ul>
&lt;li>有固定順序&lt;/li>
&lt;li>有需要填寫的位置&lt;/li>
&lt;li>適合反覆產生同類內容&lt;/li>
&lt;/ul>
&lt;p>它的特徵是完整、可套用、可替換變數。&lt;/p>
&lt;h3 id="skeleton">&lt;code>skeleton&lt;/code>&lt;/h3>
&lt;p>通常指最小可用的結構輪廓。&lt;/p>
&lt;ul>
&lt;li>先定大標題與章節&lt;/li>
&lt;li>細節之後再補&lt;/li>
&lt;li>常用在草稿、設計、規劃階段&lt;/li>
&lt;/ul>
&lt;p>它的特徵是先搭架構，再補內容。&lt;/p>
&lt;h2 id="情境式範例">情境式範例&lt;/h2>
&lt;h3 id="1-snippet-的例子">1. &lt;code>snippet&lt;/code> 的例子&lt;/h3>
&lt;p>你在寫信時，常常會重複用到一句固定話術，例如：&lt;/p>
&lt;blockquote>
&lt;p>請在方便時回覆。&lt;/p>&lt;/blockquote>
&lt;p>這句話就是一個 &lt;code>snippet&lt;/code>。它短、固定、可以直接貼上。&lt;/p>
&lt;p>如果你每次都要通知對方資料格式，也可以保留一小段固定內容，例如：&lt;/p>
&lt;blockquote>
&lt;p>姓名：___&lt;/p>
&lt;p>日期：___&lt;/p>&lt;/blockquote>
&lt;p>這種短段落也屬於 &lt;code>snippet&lt;/code> 的概念。&lt;/p>
&lt;h3 id="2-template-的例子">2. &lt;code>template&lt;/code> 的例子&lt;/h3>
&lt;p>如果你要寫一封活動通知，可以先準備一個模板：&lt;/p>





&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-markdown" data-lang="markdown">&lt;span class="line">&lt;span class="ln">1&lt;/span>&lt;span class="cl">標題：{活動名稱}
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">2&lt;/span>&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">3&lt;/span>&lt;span class="cl">時間：{日期}
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">4&lt;/span>&lt;span class="cl">地點：{地點}
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">5&lt;/span>&lt;span class="cl">對象：{受邀者}
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">6&lt;/span>&lt;span class="cl">說明：{補充內容}&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>這就是 &lt;code>template&lt;/code>。&lt;/p>
&lt;ul>
&lt;li>結構先固定&lt;/li>
&lt;li>需要的資料留空&lt;/li>
&lt;li>每次只要填入不同內容就能使用&lt;/li>
&lt;/ul>
&lt;h3 id="3-skeleton-的例子">3. &lt;code>skeleton&lt;/code> 的例子&lt;/h3>
&lt;p>如果你要先寫一篇文章，但還沒想好內容，可以先畫出骨架：&lt;/p>





&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-markdown" data-lang="markdown">&lt;span class="line">&lt;span class="ln">1&lt;/span>&lt;span class="cl">&lt;span class="gh"># 主題
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">2&lt;/span>&lt;span class="cl">&lt;span class="gh">&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">3&lt;/span>&lt;span class="cl">&lt;span class="gu">## 背景
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">4&lt;/span>&lt;span class="cl">&lt;span class="gu">&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">5&lt;/span>&lt;span class="cl">&lt;span class="gu">## 問題
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">6&lt;/span>&lt;span class="cl">&lt;span class="gu">&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">7&lt;/span>&lt;span class="cl">&lt;span class="gu">## 方法
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">8&lt;/span>&lt;span class="cl">&lt;span class="gu">&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="ln">9&lt;/span>&lt;span class="cl">## 結論&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>這就是 &lt;code>skeleton&lt;/code>。&lt;/p>
&lt;ul>
&lt;li>只有章節&lt;/li>
&lt;li>沒有細節&lt;/li>
&lt;li>目的是先把文章的基本輪廓立起來&lt;/li>
&lt;/ul>
&lt;h2 id="三者比較">三者比較&lt;/h2>
&lt;table>
 &lt;thead>
 &lt;tr>
 &lt;th>詞&lt;/th>
 &lt;th>核心意思&lt;/th>
 &lt;th>常見用途&lt;/th>
 &lt;th>完整度&lt;/th>
 &lt;/tr>
 &lt;/thead>
 &lt;tbody>
 &lt;tr>
 &lt;td>&lt;code>snippet&lt;/code>&lt;/td>
 &lt;td>片段&lt;/td>
 &lt;td>重用短句、固定段落、常用設定&lt;/td>
 &lt;td>最短&lt;/td>
 &lt;/tr>
 &lt;tr>
 &lt;td>&lt;code>template&lt;/code>&lt;/td>
 &lt;td>模板&lt;/td>
 &lt;td>固定格式、帶欄位的可套用結構&lt;/td>
 &lt;td>中等&lt;/td>
 &lt;/tr>
 &lt;tr>
 &lt;td>&lt;code>skeleton&lt;/code>&lt;/td>
 &lt;td>骨架&lt;/td>
 &lt;td>先建立框架，之後再補內容&lt;/td>
 &lt;td>最初步&lt;/td>
 &lt;/tr>
 &lt;/tbody>
&lt;/table>
&lt;h2 id="直覺分辨法">直覺分辨法&lt;/h2>
&lt;p>如果要用最簡單的方式分辨：&lt;/p>
&lt;ul>
&lt;li>&lt;code>snippet&lt;/code> 是「拿來貼的短段」&lt;/li>
&lt;li>&lt;code>template&lt;/code> 是「拿來填的格式」&lt;/li>
&lt;li>&lt;code>skeleton&lt;/code> 是「拿來搭的骨架」&lt;/li>
&lt;/ul>
&lt;p>也可以這樣記：&lt;/p>
&lt;ul>
&lt;li>&lt;code>snippet&lt;/code> 解決「每次都要重寫同一句」&lt;/li>
&lt;li>&lt;code>template&lt;/code> 解決「每次都要重建同一種格式」&lt;/li>
&lt;li>&lt;code>skeleton&lt;/code> 解決「先把架構搭起來，再慢慢補細節」&lt;/li>
&lt;/ul>
&lt;h2 id="什麼時候用哪一個">什麼時候用哪一個&lt;/h2>
&lt;ul>
&lt;li>想重用短句或固定提醒時，用 &lt;code>snippet&lt;/code>&lt;/li>
&lt;li>想重複產生同類文件或表單時，用 &lt;code>template&lt;/code>&lt;/li>
&lt;li>想先把內容架構起來、還沒準備好細節時，用 &lt;code>skeleton&lt;/code>&lt;/li>
&lt;/ul>
&lt;h2 id="結論">結論&lt;/h2>
&lt;p>這三個詞都可以翻成「片段」或「範本」的近義概念，但在技術寫作裡，它們的分工很清楚：&lt;/p>
&lt;ul>
&lt;li>&lt;code>snippet&lt;/code> 偏短，重點是可直接重用&lt;/li>
&lt;li>&lt;code>template&lt;/code> 偏完整，重點是可套用的格式&lt;/li>
&lt;li>&lt;code>skeleton&lt;/code> 偏框架，重點是先有架構再補細節&lt;/li>
&lt;/ul></description><content:encoded><![CDATA[<p>這三個字都和「可重用的內容結構」有關，但重點不同。</p>
<h2 id="一般英文中的意思">一般英文中的意思</h2>
<p><code>snippet</code> 原本是「片段」或「摘錄」。</p>
<ul>
<li>可以是一小段文字</li>
<li>也可以是程式碼、對話、影像或聲音的片段</li>
<li>重點是它是從整體中切出來的一小部分</li>
</ul>
<p><code>template</code> 是「模板」或「範本」。</p>
<ul>
<li>表示一個可以反覆套用的格式</li>
<li>通常會保留一些空位，等人填入內容</li>
<li>重點是「先有結構，再填資料」</li>
</ul>
<p><code>skeleton</code> 是「骨架」。</p>
<ul>
<li>表示最基本、最少的框架</li>
<li>還沒有完整細節</li>
<li>重點是「先把架構立起來」</li>
</ul>
<h2 id="技術寫作中的意思">技術寫作中的意思</h2>
<p>在技術文件、程式開發、教學內容裡，這三個詞常常各自負責不同層級的重用。</p>
<h3 id="snippet"><code>snippet</code></h3>
<p>通常指短小、可直接插入的內容片段。</p>
<ul>
<li>一小段程式碼</li>
<li>一小段設定</li>
<li>一小段說明文字</li>
<li>一小段固定格式的提醒</li>
</ul>
<p>它的特徵是短、穩、可重複使用。</p>
<h3 id="template"><code>template</code></h3>
<p>通常指帶欄位的完整格式。</p>
<ul>
<li>有固定順序</li>
<li>有需要填寫的位置</li>
<li>適合反覆產生同類內容</li>
</ul>
<p>它的特徵是完整、可套用、可替換變數。</p>
<h3 id="skeleton"><code>skeleton</code></h3>
<p>通常指最小可用的結構輪廓。</p>
<ul>
<li>先定大標題與章節</li>
<li>細節之後再補</li>
<li>常用在草稿、設計、規劃階段</li>
</ul>
<p>它的特徵是先搭架構，再補內容。</p>
<h2 id="情境式範例">情境式範例</h2>
<h3 id="1-snippet-的例子">1. <code>snippet</code> 的例子</h3>
<p>你在寫信時，常常會重複用到一句固定話術，例如：</p>
<blockquote>
<p>請在方便時回覆。</p></blockquote>
<p>這句話就是一個 <code>snippet</code>。它短、固定、可以直接貼上。</p>
<p>如果你每次都要通知對方資料格式，也可以保留一小段固定內容，例如：</p>
<blockquote>
<p>姓名：___</p>
<p>日期：___</p></blockquote>
<p>這種短段落也屬於 <code>snippet</code> 的概念。</p>
<h3 id="2-template-的例子">2. <code>template</code> 的例子</h3>
<p>如果你要寫一封活動通知，可以先準備一個模板：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="ln">1</span><span class="cl">標題：{活動名稱}
</span></span><span class="line"><span class="ln">2</span><span class="cl">
</span></span><span class="line"><span class="ln">3</span><span class="cl">時間：{日期}
</span></span><span class="line"><span class="ln">4</span><span class="cl">地點：{地點}
</span></span><span class="line"><span class="ln">5</span><span class="cl">對象：{受邀者}
</span></span><span class="line"><span class="ln">6</span><span class="cl">說明：{補充內容}</span></span></code></pre></div><p>這就是 <code>template</code>。</p>
<ul>
<li>結構先固定</li>
<li>需要的資料留空</li>
<li>每次只要填入不同內容就能使用</li>
</ul>
<h3 id="3-skeleton-的例子">3. <code>skeleton</code> 的例子</h3>
<p>如果你要先寫一篇文章，但還沒想好內容，可以先畫出骨架：</p>





<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="ln">1</span><span class="cl"><span class="gh"># 主題
</span></span></span><span class="line"><span class="ln">2</span><span class="cl"><span class="gh"></span>
</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="gu">## 背景
</span></span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="gu"></span>
</span></span><span class="line"><span class="ln">5</span><span class="cl"><span class="gu">## 問題
</span></span></span><span class="line"><span class="ln">6</span><span class="cl"><span class="gu"></span>
</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="gu">## 方法
</span></span></span><span class="line"><span class="ln">8</span><span class="cl"><span class="gu"></span>
</span></span><span class="line"><span class="ln">9</span><span class="cl">## 結論</span></span></code></pre></div><p>這就是 <code>skeleton</code>。</p>
<ul>
<li>只有章節</li>
<li>沒有細節</li>
<li>目的是先把文章的基本輪廓立起來</li>
</ul>
<h2 id="三者比較">三者比較</h2>
<table>
  <thead>
      <tr>
          <th>詞</th>
          <th>核心意思</th>
          <th>常見用途</th>
          <th>完整度</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>snippet</code></td>
          <td>片段</td>
          <td>重用短句、固定段落、常用設定</td>
          <td>最短</td>
      </tr>
      <tr>
          <td><code>template</code></td>
          <td>模板</td>
          <td>固定格式、帶欄位的可套用結構</td>
          <td>中等</td>
      </tr>
      <tr>
          <td><code>skeleton</code></td>
          <td>骨架</td>
          <td>先建立框架，之後再補內容</td>
          <td>最初步</td>
      </tr>
  </tbody>
</table>
<h2 id="直覺分辨法">直覺分辨法</h2>
<p>如果要用最簡單的方式分辨：</p>
<ul>
<li><code>snippet</code> 是「拿來貼的短段」</li>
<li><code>template</code> 是「拿來填的格式」</li>
<li><code>skeleton</code> 是「拿來搭的骨架」</li>
</ul>
<p>也可以這樣記：</p>
<ul>
<li><code>snippet</code> 解決「每次都要重寫同一句」</li>
<li><code>template</code> 解決「每次都要重建同一種格式」</li>
<li><code>skeleton</code> 解決「先把架構搭起來，再慢慢補細節」</li>
</ul>
<h2 id="什麼時候用哪一個">什麼時候用哪一個</h2>
<ul>
<li>想重用短句或固定提醒時，用 <code>snippet</code></li>
<li>想重複產生同類文件或表單時，用 <code>template</code></li>
<li>想先把內容架構起來、還沒準備好細節時，用 <code>skeleton</code></li>
</ul>
<h2 id="結論">結論</h2>
<p>這三個詞都可以翻成「片段」或「範本」的近義概念，但在技術寫作裡，它們的分工很清楚：</p>
<ul>
<li><code>snippet</code> 偏短，重點是可直接重用</li>
<li><code>template</code> 偏完整，重點是可套用的格式</li>
<li><code>skeleton</code> 偏框架，重點是先有架構再補細節</li>
</ul>
]]></content:encoded></item></channel></rss>