Site for researching all meanings of Hebrew Bible.

Changes

Jump to: navigation, search

Help:Wikilog settings

4,403 bytes added, 18:28, 5 November 2014
m
Imported Wikilog documentation
{{Wikilog user manual header|wikilog}}

Each wikilog has a few settings that can be set by adding some special markup to the wikilog page. These settings are more relevant to the syndication feeds (Atom and RSS) that are automatically generated by Wikilog.

== Icon, logo and subtitle ==

In order to adjust the icon, logo and subtitle of the wikilog, the <code><nowiki>{{wl-settings:...}}</nowiki></code> parser function should be added to the text of the wikilog page. This parser function has the following format (bolds are fixed text, italics are variable text):

'''<nowiki>{{wl-settings:</nowiki>'''
''' | icon =''' ''icon file''
''' | logo =''' ''logo file''
''' | subtitle =''' ''subtitle message''
'''}}'''

The three middle lines (''icon'', ''logo'' and ''subtitle'') are all optional, and should only be provided if that information is to be set.

=== Icon ===

The ''icon'' parameter to the <code><nowiki>{{wl-settings:...}}</nowiki></code> parser function provides an iconic identification for the wikilog. The icon should be a small square image and has the same principle as [http://en.wikipedia.org/wiki/Favicon website favicons]. Icons are used only in Atom feeds [http://tools.ietf.org/html/rfc4287#section-4.2.5].

The ''icon file'' argument should consist of a simple image wikilink to the file that contains the icon. The file must have been uploaded and be accessible from the wiki.

For example, the following block of text defines the icon of the wikilog to be ''ExampleIcon.png'':

'''<nowiki>{{wl-settings:</nowiki>'''
''' | icon =''' <nowiki>[[Image:ExampleIcon.png]]</nowiki>
'''}}'''

Many syndication feed readers don't support feed icons.

=== Logo ===

The ''logo'' parameter to the <code><nowiki>{{wl-settings:...}}</nowiki></code> parser function provides a visual identification for the wikilog. Logos are used in both Atom and RSS feeds, but has different restrictions. The Atom specification recommends that the image have a landscape orientation with 2 to 1 aspect ratio [http://tools.ietf.org/html/rfc4287#section-4.2.8], while the RSS specification restricts the image size to 144×400 pixels maximum [http://www.rssboard.org/rss-specification#ltimagegtSubelementOfLtchannelgt]. A good compromise between both specifications is a logo with dimensions of 144×72 pixels.

The ''logo file'' argument in the above example should consist of a simple image wikilink to the file that contains the logo. The file must have been uploaded and be accessible from the wiki. For example, the following block of text defines the logo of the wikilog to be ''ExampleLogo.png'':

'''<nowiki>{{wl-settings:</nowiki>'''
''' | logo =''' <nowiki>[[Image:ExampleLogo.png]]</nowiki>
'''}}'''

Many syndication feed readers don't support feed logos.

=== Subtitle ===

The ''subtitle'' parameter to the <code><nowiki>{{wl-settings:...}}</nowiki></code> parser function provides a short description about the wikilog. It is used in both Atom and RSS feeds. Wiki markup is allowed, but only possible in Atom feeds (RSS feeds will have only text).

For example, the following block of text defines the subtitle of the wikilog to be ''Random rants'':

'''<nowiki>{{wl-settings:</nowiki>'''
''' | subtitle =''' Random rants
'''}}'''

== Authors ==

It is possible to globally define the authors of a wikilog through the <code><nowiki>{{wl-author:...}}</nowiki></code> parser function. Many authors can be provided, separated by pipe ("<code>|</code>") characters. The markup can also appear many times in the contents of wikilog page. In both cases, multiple authors are defined.

'''<nowiki>{{wl-author:</nowiki>''' ''author name'' '''}}'''
'''<nowiki>{{wl-author:</nowiki>''' ''first author'' | ''second author'' | ''...'' '''}}'''

The author name should be the name of the user in the wiki. The wiki user page is linked back from the syndication feeds.

'''Note:''' This feature is provided only for completeness and its usage is not recommended. The expected usage is to provide authors individually for each wikilog article published in the wikilog, through the <code><nowiki>{{wl-publish:...}}</nowiki></code> parser function in the wikilog article page.

== References ==

* [http://tools.ietf.org/html/rfc4287 RFC 4287 - The Atom Syndication Format]
* [http://www.rssboard.org/rss-specification RSS 2.0 Specification]

{{Wikilog user manual footer}}
Anonymous user

Navigation menu