> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 從 Quip 匯入

> 無需匯出檔案，直接把 Quip 的文件、試算表與資料夾匯入 Craft。

## 如何開始匯入

在瀏覽器中開啟 [docs.craft.do/import/quip](https://docs.craft.do/import/quip)，如果尚未登入，請登入你的 Craft 帳戶。

## 取得你的 Quip 存取權杖

Craft 透過你自行產生的個人存取權杖連接 Quip。

<Steps>
  <Step title="開啟 Quip 的權杖頁面">
    在登入你要匯入內容的那個 Quip 帳戶後，前往 [quip.com/dev/token](https://quip.com/dev/token)。
  </Step>

  <Step title="產生並複製權杖">
    點擊 **Get Personal Access Token**，然後複製顯示出來的權杖。

    <Warning title="請像對待密碼一樣對待權杖">
      存取權杖擁有你 Quip 帳戶中所有內容的完整權限。請勿分享，也不要張貼到任何公開場合。
    </Warning>
  </Step>
</Steps>

<Info title="哪些文件會被匯入">
  該權杖讓 Craft 能夠存取你的 Quip 帳戶可見的全部內容——你的私人文件，以及你參與的共用資料夾和群組資料夾。你不需要逐份文件授權。
</Info>

## 匯入你的文件

<Steps>
  <Step title="貼上存取權杖">
    把權杖貼到匯入頁面的輸入欄位中。
  </Step>

  <Step title="選擇目標位置">
    選擇你希望 Quip 文件出現的 **Craft Space**。你也可以選擇一個**目標資料夾**，把匯入的內容集中放在一起。
  </Step>

  <Step title="設定選項">
    如有需要，可開啟**包含留言**，把 Quip 的留言與文件一起匯入。
  </Step>

  <Step title="開始匯入">
    點擊 **Import**。匯入過程中會顯示進度列。你可以隨時關閉頁面——匯入會在背景繼續進行。
  </Step>
</Steps>

<Tip title="帳戶較大時需要一些時間">
  Quip 會限制讀取資料的速度。如果你的帳戶較大，匯入會自動暫停並繼續，直到全部內容傳輸完畢——幾百份文件可能需要十五分鐘甚至更久。你不需要一直開著頁面。
</Tip>

## 匯入完成後

完成後你會看到一則確認訊息，其中的按鈕可以帶你進入 Craft，在那裡找到匯入的文件。

## Craft 未能帶過來的內容

Quip 中有些內容在 Craft 裡沒有對應形式，偶爾也會有檔案下載不成功。為了不讓你自己去察覺這些情況，Craft 會在匯入結束後列出所有未能完整帶過來的內容，並附上受影響的文件，方便你逐一查看。

你可能會看到以下幾類：

* **未能匯入的文件**——聊天與簡報，或 Quip 未回傳的文件。
* **未能下載的圖片或附件**——文件已匯入，但不包含這些內容。
* **以表格形式匯入的 Live App**——內容仍在，但不再能互動。
* **未能匯入的留言**——文件匯入時不包含留言。
* **留言中的附件**——留言內文已帶過來，附加的檔案沒有。
* **失去位置的留言**——它們關聯到整份文件，而不是原本所指的那段文字。

<Check title="這並不表示匯入失敗">
  出現這樣的摘要是正常的，帳戶較大時尤其如此，而且你的文件已經在 Craft 中了。它的作用是告訴你需要查看哪些內容，而不是提示出了問題。
</Check>

<Info title="列出的內容並非都能開啟">
  未被匯入的聊天或簡報在 Craft 中沒有對應文件可開啟，因此只會顯示名稱。其餘項目都會直接連結到匯入後的文件。
</Info>

## 會被帶過來的內容

<AccordionGroup>
  <Accordion title="文件與格式">
    標題、粗體、斜體、刪除線、行內程式碼、連結、螢光標示、項目符號與編號清單、待辦清單、表格、程式碼區塊、分隔線與引用。

    Quip 有底線而 Craft 沒有，因此帶底線的文字會以淺灰色螢光標示的形式匯入——強調效果得以保留，儘管樣式並不完全相同。
  </Accordion>

  <Accordion title="資料夾與加星號的文件">
    你的資料夾結構會在 Craft 中重建，你在 Quip 中加過星號的文件匯入後同樣帶有星號。

    在 Quip 中，一份文件可以同時位於多個資料夾。Craft 會把每份文件放進其中一個，因此匯入的文件會落在最先找到它的那個資料夾裡。空資料夾不會被重建。
  </Accordion>

  <Accordion title="圖片與附件">
    圖片和附件會被下載並重新上傳到 Craft，因此匯入後仍可正常使用——它們不是指回 Quip 的連結。
  </Accordion>

  <Accordion title="試算表">
    Quip 試算表會轉換為 Craft 表格，可以直接檢視與編輯。原始的 `.xlsx` 檔案也會作為附件附在文件上，因此原件的內容不會有任何損失。
  </Accordion>

  <Accordion title="看板與 Project Tracker">
    它們會轉換為 Craft 集合，你的欄位會成為狀態屬性，每張卡片保留各自的狀態。欄位顏色也會一併保留。
  </Accordion>

  <Accordion title="文件之間的連結">
    指向其他 Quip 文件與資料夾的連結和提及，會被改寫為指向匯入後的 Craft 版本，因此內部連結仍然有效。指向未包含在這次匯入中的文件的連結，仍會指向 Quip。
  </Accordion>

  <Accordion title="日期">
    Quip 中的日期提及會轉換為真正的 Craft 日期，而不是純文字。
  </Accordion>

  <Accordion title="留言">
    如果啟用**包含留言**，留言及其回覆會連同原始作者名稱與時間一起匯入，並錨定在其所針對的文字上。
  </Accordion>
</AccordionGroup>

## 限制

以下大多數情況會在匯入後的摘要中列出，讓你知道哪些文件受到影響。下方標註的兩項不會提示，因為對 Craft 來說並沒有缺少任何內容。

* **聊天與簡報不會被匯入。** Craft 對這兩者都沒有對應形式，因此 Quip 的對話與簡報會被略過。文件與試算表會被匯入。
* **除看板與 Project Tracker 之外的 Live App**（例如行事曆）會以呈現其內容的一般表格形式匯入。資訊仍在，但不再能互動。
* **留言中的附件不會被匯入。** 留言內文仍會帶過來，附加的檔案不會。
* **部分留言可能失去位置。** 如果某則留言所針對的文字在 Quip 的匯出內容中已不存在，該留言會錨定到整份文件，而不是那段文字。內容不會遺失，但可能不在你預期的位置。
* **範本會作為一般文件匯入**（*不會提示*）。Quip 範本會成為一般的 Craft 文件，而不是 Craft 範本。全部內容都在，只是沒有被設定為範本。
* **Quip 垃圾桶中的文件不會被匯入**（*不會提示*）。Craft 只能看到你的 Quip 帳戶中位於垃圾桶之外的文件。

<Info title="你的 Quip 帳戶不會被更動">
  匯入只會從 Quip 讀取資料。你 Quip 帳戶中的任何內容都不會被移動、編輯或刪除，因此你可以照常使用，並在需要時重新匯入。
</Info>

## 疑難排解

<AccordionGroup>
  <Accordion title="Quip 存取權杖無效">
    請確認你從 [quip.com/dev/token](https://quip.com/dev/token) 完整複製了整個權杖。如果你不確定貼上的權杖是否為目前的權杖，請重新開啟該頁面並複製上面顯示的權杖。
  </Accordion>

  <Accordion title="找不到任何文件">
    這表示權杖本身有效，但 Craft 透過它沒有看到任何文件。請確認你是在登入正確的 Quip 帳戶時產生權杖的——如果你有多個帳戶，很容易為錯誤的帳戶建立權杖。
  </Accordion>

  <Accordion title="匯入耗時很久">
    這通常是 Quip 的速率限制所致，而不是出了問題。匯入會自動暫停並繼續，關閉頁面後也會繼續執行。帳戶較大時可能需要一段時間。
  </Accordion>

  <Accordion title="某份文件遺失或位於錯誤的資料夾">
    位於多個 Quip 資料夾中的文件會被放入最先找到的那個資料夾，因此可能不在你預期的位置。如果某份文件完全找不到，請確認它是否是不會被匯入的聊天或簡報，以及它是否在 Quip 的垃圾桶中。
  </Accordion>

  <Accordion title="匯入失敗">
    請嘗試重新開始匯入。已經匯入的文件不會重複。如果問題仍然存在，請聯絡支援團隊。
  </Accordion>
</AccordionGroup>