Просмотр исходного текста страницы Справка:Writing a wikilog article

== Article summary ==

<div class="thumb"><div class="thumbinner">
[[Image:Wikilog summary auto.png|frameless|border]]
[[Image:Wikilog summary delim.png|frameless|border]]
[[Image:Wikilog summary manual.png|frameless|border]]
<div class="thumbcaption">Examples of article summary text automatically selected by Wikilog and summary defined by the author using the <code>--more--</code> delimiter and using the <code><nowiki><summary></nowiki></code> tag.</div>
</div></div>

Wikilog articles, like any wiki page, can be very long.  Wikilog pages list several articles at a time, and visitors may not be interested in reading entire articles when casually visiting the wikilog.  Instead, wikilog pages shows only article summaries.  Visitors click the article title or a "continue reading..." link to read the full article in its own page.

Summaries are either inferred automatically by Wikilog or defined explicitly by article authors.

Automatic summaries are used when no indication is explicitly provided.  The algorithm is very simple: all the text from the beginning up to the first page heading is used as a summary of the article.  In other words, the zeroth section of the page is its summary.  This usually leads to good results: short articles usually have only a single section and no headings, so the whole article is its own summary; long articles, on the other hand, are usually divided in many sections, and only the leading section is used.  But this implementation will give really bad results for a long article with no headings.  In this case, a summary should be manually defined.

Manual summaries can be defined by using specific delimiters in the article text. There are two methods to define a manual summary for an article.

The first method is to place the <code>--more--</code> delimiter in a line by itself.  Everything before the delimiter is used as the article summary.  The full article includes all the text before the delimiter (the summary) and the text after the delimiter.  The delimiter itself is invisible.  Due to the nature of this method, only the beginning of the article can be used as a summary.

 ''summary text''
 '''--more--'''
 ''rest of article text''

The second method is to surround part of the article text with the <code><nowiki><summary>...</summary></nowiki></code> markup.  Only the text between these tags will be used as the summary of the article.  The summary is also normally shown as part of the article text.

It is possible to define a summary that will only be used in wikilog listings, and not appear in the article page itself.  This can be useful in order to display a slightly different text in wikilog listings, perhaps with different formatting or with a thumbnail of an image of the article.  In this case, the <code>hidden</code> parameter must be passed in the opening summary tag.  The text between the summary tags will not appear in the article page.

The general syntax of the summary tag is:

 '''<nowiki><summary</nowiki>''' [ hidden ]'''>'''
 ''summary text''
 '''<nowiki></summary></nowiki>'''

{{Wikilog user manual footer}}