There are no approved versions of this page.
You are viewing an old version of this page. Return to the latest version.
Difference between revisions of "Manual:Extension/Blog"
| [unchecked revision] | [unchecked revision] |
(→What is Blog?) |
m (Text replacement - "<bs:bookshelf src="Book:User manual" />" to "") |
/tmp/bshtmldiff/helpdesk_en-hw_/4753.html (Datei oder Verzeichnis nicht gefunden)
__HIDETITLE__ <bs:bookshelf src="Book:User manual" /> __TOC__ ==What is Blog?== ''' ''' Blog''' extension allows creating news feeds on the wiki. These news feeds can be shown on any page, and users can be allowed to add their own news. ==Where can I find the blog function?== In the TopMenuBar, at the very top of any page Blog by default== By default, there is a link to the Blog special pagepage in the TopMenuBar, which then opens the blog, a page containing a form for writing a new blog entry and a list of previous entries. ::: [[File:Blg1.jpg|500x304px]] Blog ===Display Blog on any wiki page=== This blog news feed can be displayed on any wiki page by adding the blog tag to the page . ::: [[File:Blg2.jpg|500x309px]] ::: [[File:Blg3.jpg|500x308px]] ::: [[File:Blg4.jpg|500x309px]] ::: [[File:Blg5.jpg|500x306px]] This will also display displays a "Create new blog" entry"-form on the page, unless its it is disabled using to use blog tag [[Extensions/Blog#Blog tags|attibutes]]attributes]]. A blog entry consists of a title, revision information (date and author of first revision), the entry itself and possibly links for comments and a permalink.<br /><br />If a blog entry is too long, the link "continue reading" will be is displayed ===Write an entry or create a new entry=== As described above, new blog entries can be created through the form on the page containing blog tag, on Blog special page (Special:Blog), or by directly creating new pages in Blog namespace. ==Blog tags== . ==Blog tags== Blog extension offers several tags. These tags can be added to a page using InsertMagic functionality, or writing tag syntax directly to wiki code editor. {| class="contenttable" border="0" cellspacing="0" cellpadding="0" |- !|'''Wiki tag''' !|'''Description''' |- ||<nowiki><bs:blog /></nowiki> ||Displays blog news feed on the page. It can be extended with multiple attributes. For more on attubutes read section "Blog tag attibutes" below. |- ||<nowiki><bs:blog:more /></nowiki> ||This tag should be placed inside the content of a blog entry (pages in Blog namespace) to define at which point in text "continue reading" link should be placed. This will override default cut-off length of an entry. |- ||<nowiki><bs:blog:time time="YYYYMMDDHHmm" /></nowiki> || This tag also should be placed inside the content of a blog entry. It allows manually defining timestamp for that particular blog entry. Timestamp is used in sorting and displaying blog entries. |} ===Write an entry or create a new entry=== New blog entries can be created through the form on the page containing a blog tag, on Blog special page (Special:Blog), or by directly creating new pages in the Blog namespace. ===Creating a second blog=== As described, the default blog feed is consisted consists of pages in "normal" wiki pages stored in the Blog namespace. Other blog feeds can exist in addition to this feed, and they can be defined by category of namespace.<br />For example, the category "Company news" can be designated for a second blog. In that case all pages in this category will be considered entries of this blog and will be displayed on page as blog entries. In this case, when By adding <nowiki><bs:blog /></nowiki> tag to the page, attribute "cat" must be set to "Company news", like so: like <nowiki><bs:blog cat="Company news" /></nowiki> OtherAnother option is to designate a namespace for this purpose. Using example from above, namespace "Company news" must be created and all pages inside this namespace (Company news:News1, Company news:News2) will be considered blog entries. Syntax The syntax that should be used for the blog tag in this case is: <nowiki><bs:blog ns="Company news" /></nowiki><br /><br />Keep in mind that when blog tags with "cat" or "ns" are used, all pages from that category/namespace will be shown, so those categories/namespaces should be used for that purpose only. ===<nowiki><bs:blog /></nowiki> attributes=== The following tag arguments can be used with the tag <nowiki><bs:blog /></nowiki>: {| class="contenttable" style="width: 784px; height: 297px;" border="0" |- !|'''Attribute''' !|'''Description''' !|Value |- ||count ||Number of blog entries to be displayed. ||number |- ||cat ||Category from which to show pages as blog entries ||Categorycategory name |- ||ns ||Namespace from which to show pages as blog entries ||Namespacenamespace name or ID |- ||newentryfield ||Should "Create new blog entry" be shown? ||0 or 1 |- ||newentryfieldposition ||Position of the "Create new blog entry" form. ||"bottom" or "top" |- ||renderimages ||Should images be displayed ||0 or 1 |- ||maxchars ||Number of characters that should be shown before the "Continue reading" link is shown. ||number |} Default values for these attributes for the whole wiki can be set in the global BlueSpice preferences. See section "Configuration" below ==Configuration== Many default parameters for this extension can be configured on [[Special:BlueSpicePreferences]], under section "Blog". {| class="contenttable sortable bs-exportable" style="width: 889px;" |- style="height: 44px;" ! style="width: 176px; height: 44px;"|Setting ! style="width: 620px; height: 44px;"|Description ! style="width: 66px; height: 44px;"|Default value |- style="height: 44px;" | style="width: 176px; height: 44px;"|Display pictures as | style="width: 620px; height: 44px;"|Defines how should images in blog entries be handled. There are three options: full (image will be shown in full size), thumb (image will be shown as a thumb) and none | style="width: 66px; height: 44px;"|thumb |- style="height: 22px;" | style="width: 176px; height: 22px;"|Number of words per entry | style="width: 620px; height: 22px;"|How many words to allow in the blog post before "continue reading" is shown | style="width: 66px; height: 22px;"|1000 |- style="height: 45.1719px;" | style="width: 176px; height: 45.1719px;"|Open new window for read more | style="width: 620px; height: 45.1719px;"|Should full version of the blog entry, once "continue reading" is clicked, be opened in same or new tab/window | style="width: 66px; height: 45.1719px;"|false |- style="height: 22px;" | style="width: 176px; height: 22px;"|Position for the new blog entry form | style="width: 620px; height: 22px;"|Whether to show create new form on top or bottom of the page | style="width: 66px; height: 22px;"| |- style="height: 22px;" | style="width: 176px; height: 22px;"|Show all entries link | style="width: 620px; height: 22px;"| | style="width: 66px; height: 22px;"|true |- style="height: 22px;" | style="width: 176px; height: 22px;"|Show information about the entry | style="width: 620px; height: 22px;"| | style="width: 66px; height: 22px;"|true |- style="height: 22px;" | style="width: 176px; height: 22px;"|Number of blog entries | style="width: 620px; height: 22px;"|Number of blog entries to show per page | style="width: 66px; height: 22px;"|10 |- style="height: 22px;" | style="width: 176px; height: 22px;"|Show new blog entry form | style="width: 620px; height: 22px;"|Should "Create new blog entry" form be shown | style="width: 66px; height: 22px;"|true |- style="height: 22px;" | style="width: 176px; height: 22px;"|Show permalink link | style="width: 620px; height: 22px;"|Should permanent link to blog entry be shown | style="width: 66px; height: 22px;"| true |- style="height: 22px;" | style="width: 176px; height: 22px;"|Sort by | style="width: 620px; height: 22px;"|Should blog entries be sorted by creation time or by title | style="width: 66px; height: 22px;"| creation |- style="height: 22px;" | style="width: 176px; height: 22px;"|Text flow: Image position | style="width: 620px; height: 22px;"|Position of the image in the blog entry, right, left or none | style="width: 66px; height: 22px;"| right |} ===Rights (permissions)=== This extension introduces new permission "blog-viewspecialpage" that allows users who have it to access [[Special:Blog]] ==Requirements== Blog requires BlueSpice Foundation. ==[https://en.wiki.bluespice.com/wiki/Blog Reference page.] ==Tips for working with blogs== Put a link to the blog in the left hand navigation menu. Then your colleagues will be able to find the blog whenever they want. ==See also== Our [[Blog|reference page.]]
| (25 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | ||
| − | |||
__TOC__ | __TOC__ | ||
==What is Blog?== | ==What is Blog?== | ||
| − | |||
| − | == | + | ''' Blog''' extension allows creating news feeds on the wiki. These news feeds can be shown on any page, and users can be allowed to add their own news. |
| − | + | ||
| + | ==Blog by default== | ||
| + | |||
| + | By default, there is a link to the Blog page in the TopMenuBar, which then opens the blog, a page containing a form for writing a new blog entry and a list of previous entries. | ||
| + | |||
::: [[File:Blg1.jpg|500x304px]] | ::: [[File:Blg1.jpg|500x304px]] | ||
| − | Blog news feed can be displayed on any page by adding blog tag to the page | + | |
| + | |||
| + | |||
| + | ===Display Blog on any wiki page=== | ||
| + | |||
| + | |||
| + | This blog news feed can be displayed on any wiki page by adding the blog tag to the page. | ||
| + | |||
::: [[File:Blg2.jpg|500x309px]] | ::: [[File:Blg2.jpg|500x309px]] | ||
| + | |||
| + | |||
::: [[File:Blg3.jpg|500x308px]] | ::: [[File:Blg3.jpg|500x308px]] | ||
| + | |||
| + | |||
::: [[File:Blg4.jpg|500x309px]] | ::: [[File:Blg4.jpg|500x309px]] | ||
| − | |||
| − | |||
| − | |||
| + | ::: [[File:Blg5.jpg|500x306px]] | ||
| − | + | This also displays a "Create new blog entry"-form on the page, unless it is disabled to use blog tag [[Extensions/Blog#Blog tags|attributes]]. | |
| − | |||
| + | A blog entry consists of a title, revision information (date and author of first revision), the entry itself and possibly links for comments and a permalink.<br /><br />If a blog entry is too long, the link "continue reading" is displayed. | ||
==Blog tags== | ==Blog tags== | ||
| + | |||
Blog extension offers several tags. These tags can be added to a page using InsertMagic functionality, or writing tag syntax directly to wiki code editor. | Blog extension offers several tags. These tags can be added to a page using InsertMagic functionality, or writing tag syntax directly to wiki code editor. | ||
| Line 47: | Line 59: | ||
|} | |} | ||
| + | |||
| + | ===Write an entry or create a new entry=== | ||
| + | |||
| + | New blog entries can be created through the form on the page containing a blog tag, on Blog special page (Special:Blog), or by directly creating new pages in the Blog namespace. | ||
===Creating a second blog=== | ===Creating a second blog=== | ||
| − | |||
| − | Other option is to designate a namespace for this purpose. Using example from above, namespace "Company news" must be created and all pages inside this namespace (Company news:News1, Company news:News2) will be considered blog entries. | + | As described the default blog feed consists of "normal" wiki pages stored in the Blog namespace. Other blog feeds can exist in addition to this feed, and they can be defined by category.<br />For example, the category "Company news" can be designated for a second blog. In that case all pages in this category will be considered entries of this blog and will be displayed on page as blog entries. By adding <nowiki><bs:blog /></nowiki> tag to the page, attribute "cat" must be set to "Company news" like <nowiki><bs:blog cat="Company news" /></nowiki> |
| + | |||
| + | Another option is to designate a namespace for this purpose. Using example from above, namespace "Company news" must be created and all pages inside this namespace (Company news:News1, Company news:News2) will be considered blog entries. The syntax that should be used for the blog tag in this case is: <nowiki><bs:blog ns="Company news" /></nowiki><br /><br />Keep in mind that when blog tags with "cat" or "ns" are used, all pages from that category/namespace will be shown, so those categories/namespaces should be used for that purpose only. | ||
===<nowiki><bs:blog /></nowiki> attributes=== | ===<nowiki><bs:blog /></nowiki> attributes=== | ||
| + | |||
The following tag arguments can be used with the tag <nowiki><bs:blog /></nowiki>: | The following tag arguments can be used with the tag <nowiki><bs:blog /></nowiki>: | ||
| Line 68: | Line 86: | ||
||cat | ||cat | ||
||Category from which to show pages as blog entries | ||Category from which to show pages as blog entries | ||
| − | || | + | ||category name |
|- | |- | ||
||ns | ||ns | ||
||Namespace from which to show pages as blog entries | ||Namespace from which to show pages as blog entries | ||
| − | || | + | ||namespace name or ID |
|- | |- | ||
||newentryfield | ||newentryfield | ||
| Line 91: | Line 109: | ||
|} | |} | ||
| − | Default values for these attributes can be set in global BlueSpice preferences. See | + | Default values for these attributes for the whole wiki can be set in the global BlueSpice preferences. See [https://en.wiki.bluespice.com/wiki/Blog Reference page.] |
| − | == | + | ==Tips for working with blogs== |
| − | |||
| − | + | Put a link to the blog in the left hand navigation menu. Then your colleagues will be able to find the blog whenever they want. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | == | + | ==See also== |
| − | + | Our [[Blog|reference page.]] | |