
內容簡介
這是長描述。 沒有限制,您可以使用 Markdown(以及以下部分)。
為了向後兼容,如果缺少此部分,將使用短描述的全長,並且Markdown已解析。
有關上面部分的幾點說明:
“貢獻者”是逗號分隔的 wordpress.org 用戶名列表
“標籤”是一個逗號分隔的適用於外掛程式的標籤列表
“至少需要”是外掛程式可以運行的最低版本
“已測試至”是您成功使用測試外掛程式的最高版本。 請注意,它可能適用於更高版本...... 這僅是您驗證的最高版本。
穩定標籤應該指示最新穩定版本的 Subversion “標籤”,或者如果您將 /trunk/ 用於穩定版本,則為 trunk。
請注意,穩定標籤的 readme.txt 被認為是外掛程式的定義之一,因此,如果 /trunk/readme.txt 文件說穩定標籤是 4.3,那麼就會使用 /tags/4.3/readme.txt 顯示關於外掛程式的信息。 在這種情況下,從樹幹的 readme.txt 中考慮的唯一事物是穩定標籤指針。 因此,如果您在樹幹中進行開發,可以更新樹幹中的 readme.txt 以反映您開發中版本的更改,而沒有將有關缺少這些更改的當前穩定版本的信息錯誤地披露-只要樹幹的 readme.txt 指向正確的穩定標籤即可。
如果未提供穩定標籤,則假定樹幹是穩定的,但如果您將穩定版本放置在該處,則應指定“樹幹”,以消除任何疑慮。
任意節
您可以以與上面相同的格式提供任意節。 這對於需要傳達更多信息但不適合“描述”或“安裝”類別的極其複雜的外掛程式可能有用。 任意部分將顯示在上述內置部分下方。
簡短的 Markdown 示例
有序列表:
某些功能
另一個功能
關於外掛程式的其他事情
無序列表:
某些東西
別的事情
第三件事
這裡有一個鏈接到 WordPress,以及一個到 Markdown 的語法文檔的鏈接。
自然地,標題是可選的。
Markdown使用電子郵件格式的標記引用,並且我被告知:
星號表示強調。 加倍以加強強度。
<?php代碼();//進入反引號 ?>
外掛標籤
開發者團隊
原文外掛簡介
This is the long description. No limit, and you can use Markdown (as well as in the following sections).
For backwards compatibility, if this section is missing, the full length of the short description will be used, and
Markdown parsed.
A few notes about the sections above:
“Contributors” is a comma separated list of wordpress.org usernames
“Tags” is a comma separated list of tags that apply to the plugin
“Requires at least” is the lowest version that the plugin will work on
“Tested up to” is the highest version that you’ve successfully used to test the plugin. Note that it might work on
higher versions… this is just the highest one you’ve verified.
Stable tag should indicate the Subversion “tag” of the latest stable version, or “trunk,” if you use /trunk/ for
stable.
Note that the readme.txt of the stable tag is the one that is considered the defining one for the plugin, so
if the /trunk/readme.txt file says that the stable tag is 4.3, then it is /tags/4.3/readme.txt that’ll be used
for displaying information about the plugin. In this situation, the only thing considered from the trunk readme.txt
is the stable tag pointer. Thus, if you develop in trunk, you can update the trunk readme.txt to reflect changes in
your in-development version, without having that information incorrectly disclosed about the current stable version
that lacks those changes — as long as the trunk’s readme.txt points to the correct stable tag.
If no stable tag is provided, it is assumed that trunk is stable, but you should specify “trunk” if that’s where
you put the stable version, in order to eliminate any doubt.
Arbitrary section
You may provide arbitrary sections, in the same format as the ones above. This may be of use for extremely complicated
plugins where more information needs to be conveyed that doesn’t fit into the categories of “description” or
“installation.” Arbitrary sections will be shown below the built-in sections outlined above.
A brief Markdown Example
Ordered list:
Some feature
Another feature
Something else about the plugin
Unordered list:
something
something else
third thing
Here’s a link to WordPress and one to Markdown’s Syntax Documentation.
Titles are optional, naturally.
Markdown uses email style notation for blockquotes and I’ve been told:
Asterisks for emphasis. Double it up for strong.
