这里会显示出您选择的修订版和当前版本之间的差别。
— |
blog98889 [2019/12/07 21:07] (当前版本) |
||
---|---|---|---|
行 1: | 行 1: | ||
+ | ====== Blog Plugin ====== | ||
+ | |||
+ | ---- plugin ---- | ||
+ | description: | ||
+ | author | ||
+ | email : freaks@dokuwiki.org | ||
+ | type : syntax, action, helper | ||
+ | lastupdate : 2018-09-03 | ||
+ | compatible : 2008-05-05, 2009-02-14, Detritus, Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, " | ||
+ | depends | ||
+ | conflicts | ||
+ | similar | ||
+ | tags : blog, news | ||
+ | |||
+ | downloadurl: | ||
+ | bugtracker : https:// | ||
+ | sourcerepo : https:// | ||
+ | ---- | ||
+ | |||
+ | ===== Description ===== | ||
+ | |||
+ | The Blog Plugin makes blogs in your wiki easily possible. The [[#blog]] component shows the latest entries (pages) from a namespace in reverse chronological order. In this new version, the creation date is the sort key -- no longer the date of the last non-minor modification as in previous versions. The [[# | ||
+ | ===== Installation ===== | ||
+ | |||
+ | ^ Download | ||
+ | ^ BundleHub | ||
+ | ^ Tips | If you intend to use this plugin be sure to take a look at the [[tips: | ||
+ | |||
+ | ===== Syntax ===== | ||
+ | |||
+ | === Blog === | ||
+ | |||
+ | {{blog> | ||
+ | |||
+ | ^ [namespace] | namespace for the blog; subspaces will be searched as well; '' | ||
+ | ^ [number] | number of entries to show per page | optional; default is 5 | | ||
+ | ^ [flags] | flags are delimited by ''&'' | ||
+ | ^ ::: | all [[include# | ||
+ | ^ ::: | Form placement: '' | ||
+ | ^ ::: | Custom new-entry form title: '' | ||
+ | ^ ::: | Hide paging controls: '' | ||
+ | |||
+ | This includes a specified number of most recent blog entries from the given namespace into the current page. Below the entries a link to the page (permalink), | ||
+ | |||
+ | Note that when the page with the blog syntax is in the specified namespace, content my be shown twice. At some point, the loop will be detected and stopped. You should therefore make sure that either the page with the listing is in a different namespace or use the '' | ||
+ | |||
+ | |||
+ | === Archive === | ||
+ | |||
+ | {{archive> | ||
+ | |||
+ | ^ [namespace] | the namespace for which you want an archive list; '' | ||
+ | ^ [month] | the month for the archive list in YYYY-MM format; '' | ||
+ | ^ [flags] | pagelist flags delimited by ''&'', | ||
+ | ^ [username] | username of an author | optional | | ||
+ | |||
+ | |||
+ | Shows a table with all pages of the given namespace that were created in the specified month. | ||
+ | |||
+ | {{autoarchive> | ||
+ | |||
+ | Creates an automatic archive. | ||
+ | |||
+ | ===== Configuration and Settings ===== | ||
+ | The blog plugin can be configured using the DokuWiki configuration manager available in the admin menu. | ||
+ | |||
+ | ^ '' | ||
+ | ^ '' | ||
+ | ^ '' | ||
+ | ^ '' | ||
+ | ^ '' | ||
+ | ^ '' | ||
+ | ^ '' | ||
+ | ^ '' | ||
+ | ^ '' | ||
+ | ^ '' | ||
+ | |||
+ | ===== Changes ===== | ||
+ | |||
+ | * **2013-10-20**: | ||
+ | * **2013-03-27**: | ||
+ | * the syntax that lists everything till now correctly updates the cache now whenever a page is changed or a comment or linkback is added. | ||
+ | * the cache is not used anymore when it contains an archive listing with a page that the current user can't access. The excluded pages won't be included again automatically unless the cache expires for other reasons, the '' | ||
+ | |||
+ | |||
+ | ===== Development ===== | ||
+ | |||
+ | === Change Log === | ||
+ | |||
+ | {{rss> | ||
+ | |||
+ | === Bugs / Feature Requests === | ||
+ | Please report bugs or feature requests at the [[https:// | ||
+ | |||
+ | |||
+ | ===== FAQ ===== | ||
+ | Please also have a look at the [[tips: | ||
+ | |||
+ | === My dates are shown wrong. What can I do? === | ||
+ | Make sure you run the latest version of all required plugins and DokuWiki. | ||
+ | |||
+ | === Is it possible to change the way the date is displayed? === | ||
+ | Yes, the plugin uses the [[config: | ||
+ | |||
+ | === How can I alter the date of a blog post? === | ||
+ | You can use the [[plugin: | ||
+ | |||
+ | === Is it possible to show table of contents? === | ||
+ | The table of contents is shown automatically (depending on the settings in DokuWiki itself) from version 2013-02-07 on. | ||
+ | |||
+ | === The header is always a link to the page even though it's disabled in the include plugin settings === | ||
+ | |||
+ | The blog plugin assumes that in the context of a blog the header should be a link. However from version 2013-02-26 on it is possible to disable this behavior by using the '' | ||
+ | |||
+ | === Is it possible to show just the first lines of each post with a 'Read more' link to view the full post? === | ||
+ | |||
+ | I think I solved myself. | ||
+ | In the blog mark, use the following flags | ||
+ | |||
+ | {{blog>? | ||
+ | |||
+ | This will work if you add an H2 header (in the full post) where you want to make appear the 'Read more' link. | ||
+ | If you don't need or want an H2 header in your post, you can add a empty H2 header, just as a delimiter for the text you want to show in the Blog's headlines | ||
+ | |||
+ | |||
+ | === the excluded_pages does not work === | ||
+ | |||
+ | In the blog mark ,use the following flags | ||
+ | {{blog> | ||
+ | or | ||
+ | {{blog> | ||
+ | |||
+ | all above flags does not work, the index pages in sub namespace is still included . | ||
+ | |||
+ | |||
+ | ===== Discussion ===== | ||
+ | |||
+ | Please report bugs or feature requests at the [[https:// | ||
+ | |||
+ | Is it possible to make a blog in one namespace be in ascending order, and a blog in a different namespace to be in descending order? | ||