[WordPress] 外掛分享： DocumentCloud

前言介紹

• 這款 WordPress 外掛「DocumentCloud」是 2015-04-29 上架。
• 目前有 1000 個安裝啟用數。
• 上一次更新是 2021-04-02，距離現在已有 1493 天。超過一年沒更新，安裝要確認版本是否可用。以及後續維護問題！
• 外掛最低要求 WordPress 3.5 以上版本才可以安裝。
• 有 1 人給過評分。
• 還沒有人在論壇上發問，可能目前使用數不多，還沒有什麼大問題。

外掛協作開發者

reefdog | freedmand | chrisamico |

外掛標籤

research | documents | reporting | journalism | documentcloud |

內容簡介

DocumentCloud 是一項由 Investigative Reporters & Editors 主辦的服務，允許記者分析、註解和發布文件。此外掛最初的開發得到了 NPR 的支持，作為 StateImpact 專案的一部分。

這個外掛允許您使用單獨一行的原始 URL 或自定義的簡碼來嵌入 DocumentCloud 資源：

這是您應該要查看的東西：

https://www.documentcloud.org/documents/282753-lefler-thesis.html

是不是有趣呢？

[documentcloud url="https://www.documentcloud.org/documents/282753-lefler-thesis.html"]

當您儲存時，WordPress 會使用 oEmbed 從 DocumentCloud 伺服器中抓取並儲存實際的嵌入程式碼 HTML。您可以自由地在視覺和 HTML 模式之間切換而不會破壞嵌入程式碼，您的嵌入永遠都是最新的。

預設情況下，文件的寬度會響應（根據可用內容區域自動縮小和擴大），並使用主題的預設高度。如果您要覆寫這個設定，您可以設置 responsive="false" 或明確設置 width：

[documentcloud url="https://www.documentcloud.org/documents/282753-lefler-thesis.html" width="600"]

您可以在「設置 > DocumentCloud」中設置您自己的預設值，但預設寬度將被忽略，除非禁用 responsive：

[documentcloud url="https://www.documentcloud.org/documents/282753-lefler-thesis.html" responsive="false"]

要嵌入單個頁面，使用任何具體頁面的 URL。頁面會忽略 width/height，並始終以反應靈敏地互動：

[documentcloud url="https://www.documentcloud.org/documents/282753-lefler-thesis.html#document/p1"]

要嵌入註釋，使用任何具體註釋的 URL。註釋會忽略 width/height，並始終以反應靈敏地互動：

[documentcloud url="https://www.documentcloud.org/documents/282753-lefler-thesis.html#document/p1/a53674"]

以下是您可以通過簡碼屬性傳遞的嵌入選項的完整列表；有些選項對於您嵌入的資源類型是特定的：

所有資源：

url (必填，字串): DocumentCloud 資源的完整 URL。
container (字串): 要插入嵌入程式碼的元素的 ID；如果省略，嵌入程式碼會創建自己的容器。

僅限文件：

height (整數): 嵌入程式碼的高度（以像素為單位）。
width (整數): 嵌入程式碼的寬度（以像素為單位）。如果使用，將隱含設置 responsive="false"。
responsive (布林值): 使用反應靈敏的佈局，動態調整寬度以填滿內容區域。預設值為 true。
responsive_offset (整數): 某些反應靈敏的嵌入程式碼的垂直偏移距離（以像素為單位）。
page (整數): 文件預設捲動到的頁面編號。
note (整數): 文件應突顯的註釋 ID。
notes (布林值): 隱藏或顯示註釋。
search (布林值): 隱藏或顯示搜尋表單。
sidebar (布林值): 隱藏或顯示側邊欄。
pdf (布林值): 隱藏或顯示下載原始 PDF 的鏈接。
text (布林值): 隱藏或顯示文字選項卡。

原文外掛簡介

DocumentCloud is a service that allows journalists to analyze, annotate and publish documents, hosted by Investigative Reporters & Editors. Initial development of this plugin supported by NPR as part of the StateImpact project.
This plugin allows you to embed DocumentCloud resources using either the raw URL on its own line:
Here's something you should really take a look at:

https://www.documentcloud.org/documents/282753-lefler-thesis.html

Isn't that interesting?

Or a custom shortcode:
[documentcloud url="https://www.documentcloud.org/documents/282753-lefler-thesis.html"]

When you save, WordPress fetches and stores the actual embed code HTML from the DocumentCloud servers using oEmbed. You can freely toggle between visual and HTML mode without mangling embed code, and your embed will always be up to date with the latest embed code.
By default, documents will have a responsive width (it will narrow and widen as necessary to fill available content area) and use the theme’s default height. If you want to override this, you can either set responsive="false" or explicitly set a width:
[documentcloud url="https://www.documentcloud.org/documents/282753-lefler-thesis.html" width="600"]

You can set your own defaults in Settings > DocumentCloud, but default widths will be ignored unless responsive is disabled:
[documentcloud url="https://www.documentcloud.org/documents/282753-lefler-thesis.html" responsive="false"]

To embed a single page, use any page-specific URL. Pages ignore width/height and always act responsively:
[documentcloud url="https://www.documentcloud.org/documents/282753-lefler-thesis.html#document/p1"]

To embed a note, use any note-specific URL. Notes ignore width/height and always act responsively:
[documentcloud url="https://www.documentcloud.org/documents/282753-lefler-thesis.html#document/p1/a53674"]

Here’s the full list of embed options you can pass via shortcode attributes; some are specific to the type of resource you’re embedding.
All resources:

url (required, string): Full URL of the DocumentCloud resource.
container (string): ID of element to insert the embed into; if excluded, embedder will create its own container.

Documents only:

height (integer): Height (in pixels) of the embed.
width (integer): Width (in pixels) of the embed. If used, will implicitly set responsive="false".
responsive (boolean): Use responsive layout, which dynamically adjusts width to fill content area. Defaults true.
responsive_offset (integer): Distance (in pixels) to vertically offset the viewer for some responsive embeds.
page (integer): Page number to have the document scroll to by default.
note (integer): ID of the note that the document should highlight by default.
notes (boolean): Hide or show notes.
search (boolean): Hide or show search form.
sidebar (boolean): Hide or show sidebar.
pdf (boolean): Hide or show link to download original PDF.
text (boolean): Hide or show text tab.
zoom (boolean): Hide or show zoom slider.
format (string): Indicate to the theme that this is a wide asset by setting this to wide. Defaults normal.

You can read more about publishing and embedding DocumentCloud resources on https://www.documentcloud.org/help/publishing.

各版本下載點

• 方法一：點下方版本號的連結下載 ZIP 檔案後，登入網站後台左側選單「外掛」的「安裝外掛」，然後選擇上方的「上傳外掛」，把下載回去的 ZIP 外掛打包檔案上傳上去安裝與啟用。
• 方法二：透過「安裝外掛」的畫面右方搜尋功能，搜尋外掛名稱「DocumentCloud」來進行安裝。

（建議使用方法二，確保安裝的版本符合當前運作的 WordPress 環境。

---

0.5.0 | 0.5.1 |

延伸相關外掛（你可能也想知道）

• Printable PDF Newspaper 》此外掛可從文章內容生成可打印的 PDF 報紙，非常適合為離線讀者分發文章和帖子以印刷格式呈現。, 使用此外掛，從您的網站管理區中選擇要包含的內容（支持文章...。
• Snowball 》Snowball 是一個強大的外掛程式，它可以讓記者和博客作者輕鬆創建現代化、沉浸式文章，就像世界一流新聞機構所見。, Snowball 的用戶友好介面可讓您一次建立...。
• Pressroom 》PressRoom 支援子緻出版模型，內容結構是建立在「編輯專案」概念上的。一個編輯專案可以包含無限數量的版本，而版本則可以是文章、頁面或自訂文章類型的集合...。
• Paperlit 》「Paperlit WordPress Plugin」會將您的文章集合轉換成 HPub 檔案，與 Paperlit 平台兼容。您可以使用 WordPress 作為 CMS，創建互動式數位雜誌！, 使用 Pape...。
• Interactive Longform Articles 》互動式長文章，具有淡化滾動效果。, 範例, https://www.theversed.com/90435/life-preserver-meet-the-navy-airr-who-is-dedicating-his-life-to-helping-oth...。
• Qurio 》, , , ,