
內容簡介
這是長描述。沒有限制,您可以使用 Markdown (就像以下部分一樣)。
出於向後相容性的考慮,如果沒有此部分,將使用簡短描述的全部長度,並進行
Markdown 解析。
關於上面的幾點說明:
“Contributors”是一個逗號分隔的WordPress.org 用戶名列表
“Tags”是應用於外掛的逗號分隔標籤列表
“Requires at least”是插件可以運行的最低版本
“Tested up to”是您已經成功用來測試插件的最高版本。請注意,它也可能適用於
更高版本......這只是您已經驗證的最高版本。
Stable tag 應該指的是最新穩定版本的 Subversion「tag」,或者如果您使用 /trunk/ 作為
穩定版本,則指向「trunk」。
請注意,穩定版本的 readme.txt 才是被認為是插件的定義文件,所以
如果 /trunk/readme.txt 文件說穩定標籤是 4.3,那麼就是使用 /tags/4.3/readme.txt
來顯示關於插件的信息。在這種情況下,唯一從 trunk 中考慮的 readme.txt
是穩定標記指針。因此,如果您在 trunk 中開發,可以更新 trunk 的 readme.txt,以反映在
正在開發的版本中的更改,而沒有將缺少這些更改的信息錯誤地披露給當前的穩定版本
- 只要 trunk 的 readme.txt 指向正確的穩定標籤即可。
如果沒有提供穩定的標籤,則假定 trunk 是穩定的,但如果您放置了穩定的版本,
則應該指定「trunk」,以消除任何疑慮。
任意部分
您可以提供任意部分,格式與上面的部分相同,這可能對於非常複雜的插件
有用,需要傳達更多的信息,其中不適合「描述」或
「安裝」的分類。任意部分將顯示在上面概述的內置部分下面。
簡短的 Markdown 範例
有序列表:
某些功能
另一個功能
關於外掛的其他內容
無序列表:
某些東西
其他事物
第三件事
這裡有一個到WordPress的鏈接,以及一個到Markdown 的語法文檔的鏈接。
標題是可選的,自然地。
Markdown 使用電子郵件樣式的標記來處理引用,我已經聽說過:
用星號強調。加倍為強調。
<?php code(); // goes in backticks ?>
外掛標籤
開發者團隊
原文外掛簡介
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.
