| Index: trunk/extensions/Wikilog/documentation/Wikilog_summary_delim.png |
| Cannot display: file marked as a binary type. |
| svn:mime-type = image/png |
| Property changes on: trunk/extensions/Wikilog/documentation/Wikilog_summary_delim.png |
| ___________________________________________________________________ |
| Added: svn:mime-type |
| 1 | 1 | + image/png |
| Index: trunk/extensions/Wikilog/documentation/Wikilog_side_column_example.png |
| Cannot display: file marked as a binary type. |
| svn:mime-type = image/png |
| Property changes on: trunk/extensions/Wikilog/documentation/Wikilog_side_column_example.png |
| ___________________________________________________________________ |
| Added: svn:mime-type |
| 2 | 2 | + image/png |
| Index: trunk/extensions/Wikilog/documentation/lorem-ipsum.txt |
| — | — | @@ -0,0 +1,34 @@ |
| | 2 | +'''Lorem ipsum''' dolor sit amet, consectetur adipiscing elit. |
| | 3 | +Duis nec diam sed velit interdum accumsan et eget metus. Etiam |
| | 4 | +tortor nisl, molestie ac egestas nec, dignissim quis purus. |
| | 5 | + |
| | 6 | +Sed erat nunc, condimentum ac consectetur rutrum, blandit id mi. |
| | 7 | +In hac habitasse platea dictumst. [[Sed risus]] lorem, suscipit |
| | 8 | +sed pharetra sed, ultrices eu lectus. ''Nullam ut vulputate |
| | 9 | +urna.'' Nulla facilisi. |
| | 10 | + |
| | 11 | +== Mauris felis == |
| | 12 | + |
| | 13 | +Curabitur metus purus, suscipit ac mollis nec, volutpat non |
| | 14 | +purus. Proin placerat fermentum justo ut molestie. Nulla eu |
| | 15 | +nulla erat, non vehicula nulla. Proin faucibus erat nibh, eget |
| | 16 | +dapibus enim. Maecenas semper gravida [[ligula ut cursus]] |
| | 17 | + |
| | 18 | +Ouisque luctus elit id purus lobortis semper. Nam tempor |
| | 19 | +faucibus dictum. Suspendisse sallicitudin vestibulum tellus id |
| | 20 | +hendrerit. Cras posuere tellus est. |
| | 21 | + |
| | 22 | +=== Nisi sed === |
| | 23 | + |
| | 24 | +Sed hendrerit lacinia nisl quis interdum. Donec fermentum |
| | 25 | +tincidunt mauris nec suscipit. Suspendisse justo sapien, iaculis |
| | 26 | +congue viverra nec, rutrum vitae turpis. Nulla eu ligula massa. |
| | 27 | +In hac habitasse platea dictumst. Integer at dui nunc. |
| | 28 | + |
| | 29 | +Nulla eu quam eu lorem suscipit fermentum ac a felis. Curabitur |
| | 30 | +eleifend augue quis nibh porta mollis. Nam tristique tincidunt |
| | 31 | +tincidunt. |
| | 32 | + |
| | 33 | +== Duis vel nulla == |
| | 34 | + |
| | 35 | +Aliquam tincidunt aliquet mauris, sed aliquam risus auctor in. |
| Property changes on: trunk/extensions/Wikilog/documentation/lorem-ipsum.txt |
| ___________________________________________________________________ |
| Added: svn:eol-style |
| 1 | 36 | + native |
| Index: trunk/extensions/Wikilog/documentation/Wikilog_summary_auto.xcf |
| Cannot display: file marked as a binary type. |
| svn:mime-type = image/x-xcf |
| Property changes on: trunk/extensions/Wikilog/documentation/Wikilog_summary_auto.xcf |
| ___________________________________________________________________ |
| Added: svn:mime-type |
| 2 | 37 | + image/x-xcf |
| Index: trunk/extensions/Wikilog/documentation/Wikilog_summary_auto.png |
| Cannot display: file marked as a binary type. |
| svn:mime-type = image/png |
| Index: trunk/extensions/Wikilog/documentation/documentation-pagelist.txt |
| — | — | @@ -1,6 +1,7 @@ |
| 2 | 2 | Category:Wikilog manual |
| 3 | 3 | Template:Wikilog user manual header |
| 4 | 4 | Template:Wikilog user manual footer |
| | 5 | +Template:Wikilog user manual index |
| 5 | 6 | Help:Wikilog |
| 6 | 7 | Help:Embedding wikilogs |
| 7 | 8 | Help:Overview of wikilogs |
| — | — | @@ -13,6 +14,7 @@ |
| 14 | 15 | File:Wikilog CC-BY-SA 88x31.png |
| 15 | 16 | File:Wikilog SpecialWikilog query form.png |
| 16 | 17 | File:Wikilog summary auto.png |
| | 18 | +File:Wikilog summary delim.png |
| 17 | 19 | File:Wikilog summary manual.png |
| 18 | 20 | File:Wikilog tab.png |
| 19 | 21 | File:Wikilog template example 1.png |
| Index: trunk/extensions/Wikilog/documentation/Wikilog_summary_manual.xcf |
| Cannot display: file marked as a binary type. |
| svn:mime-type = image/x-xcf |
| Property changes on: trunk/extensions/Wikilog/documentation/Wikilog_summary_manual.xcf |
| ___________________________________________________________________ |
| Added: svn:mime-type |
| 20 | 22 | + image/x-xcf |
| Index: trunk/extensions/Wikilog/documentation/Wikilog_summary_manual.png |
| Cannot display: file marked as a binary type. |
| svn:mime-type = image/png |
| Index: trunk/extensions/Wikilog/documentation/documentation.xml |
| — | — | @@ -53,65 +53,47 @@ |
| 54 | 54 | <title>Template:Wikilog user manual header</title> |
| 55 | 55 | <id>90</id> |
| 56 | 56 | <revision> |
| 57 | | - <id>238</id> |
| 58 | | - <timestamp>2009-09-07T18:44:35Z</timestamp> |
| | 57 | + <id>306</id> |
| | 58 | + <timestamp>2010-08-08T02:49:54Z</timestamp> |
| 59 | 59 | <contributor> |
| 60 | 60 | <username>Juliano</username> |
| 61 | 61 | <id>1</id> |
| 62 | 62 | </contributor> |
| 63 | | - <text xml:space="preserve">This template creates a navigation bar at the top of [[Help:Wikilog|Wikilog]] manual articles. |
| | 63 | + <text xml:space="preserve">== Summary == |
| 64 | 64 | |
| | 65 | +This template creates a navigation bar at the top of [[Help:Wikilog|Wikilog]] manual articles. |
| | 66 | + |
| 65 | 67 | == Parameters == |
| 66 | 68 | |
| 67 | 69 | ; 1 |
| 68 | 70 | : Manual chapter: "intro", "wikilog", "article" or "advanced". |
| 69 | 71 | |
| 70 | | -== Example == |
| | 72 | +== Template == |
| 71 | 73 | |
| 72 | 74 | <onlyinclude><!-- |
| | 75 | +--><table border="1" cellspacing="0" style="background: #F6F6F6; border: 1px solid #A7D9F9; |
| | 76 | + border-collapse: collapse; width: 100%; margin: 6pt 0pt 0pt;"><!-- |
| 73 | 77 | --><tr><!-- |
| 74 | | - --><td style="background:#DDDDDD;text-align:center;width:10%;padding:3pt 6pt;" rowspan="2"><!-- |
| 75 | | - -->[[Image:Wikilog.png|80px|link=Help:Wikilog]]<!-- |
| | 78 | + --><td style="background: #F6F6F6; text-align: center; width: 15%; padding: 0 6pt;"><!-- |
| | 79 | + -->[[Image:Wikilog.png|80px|text-bottom|link=Help:Wikilog]]<!-- |
| 76 | 80 | --></td><!-- |
| 77 | | - --><td style="padding:1pt 6pt;background:#DDDDDD;"><!-- |
| 78 | | - --><span style="font-weight:bold;margin:0 1em;">Wikilog user manual</span><!-- |
| 79 | | - --> • {{#ifeq: {{{1}}} | intro |
| 80 | | - | <span style="font-weight:bold;background:#EEEEEE;margin:1pt 0 -2pt;padding:0 1em 2pt">Introduction</span> |
| 81 | | - | [[Help:Wikilog|Introduction]] |
| 82 | | - }}<!-- |
| 83 | | - --> • {{#ifeq: {{{1}}} | wikilog |
| 84 | | - | <span style="font-weight:bold;background:#EEEEEE;margin:1pt 0 -2pt;padding:0 1em 2pt">Wikilogs</span> |
| 85 | | - | [[Help:Overview of wikilogs|Wikilogs]] |
| 86 | | - }}<!-- |
| 87 | | - --> • {{#ifeq: {{{1}}} | article |
| 88 | | - | <span style="font-weight:bold;background:#EEEEEE;margin:1pt 0 -2pt;padding:0 1em 2pt">Articles</span> |
| 89 | | - | [[Help:Overview of wikilog articles|Articles]] |
| 90 | | - }}<!-- |
| 91 | | - --> • {{#ifeq: {{{1}}} | advanced |
| 92 | | - | <span style="font-weight:bold;background:#EEEEEE;margin:1pt 0 -2pt;padding:0 1em 2pt">Advanced</span> |
| 93 | | - | [[Help:Special:Wikilog|Advanced]] |
| 94 | | - }} • <!-- |
| | 81 | + --><td style="background: #F6F6F6; text-align: left; padding: 0 6pt;"><!-- |
| | 82 | + --><span style="font-family: Times, serif; font-size: 110%; font-weight: bold; |
| | 83 | + font-style: italic;">User Manual</span><!-- |
| 95 | 84 | --></td><!-- |
| 96 | 85 | --></tr><!-- |
| | 86 | +--></table><!-- |
| | 87 | + |
| | 88 | +--><table border="1" cellspacing="0" style="background: #F6F6F6; border: 1px solid #A7D9F9; |
| | 89 | + border-top: 0px; border-collapse: collapse; margin: 0pt 0pt 6pt 6pt; width: 15em; |
| | 90 | + float: right;"><!-- |
| 97 | 91 | --><tr><!-- |
| 98 | | - --><td style="padding:1pt 6pt;"> • <!-- |
| 99 | | - -->{{#ifeq: {{{1}}} | intro |
| 100 | | - | [[Help:Wikilog|Overview]] |
| 101 | | - }}<!-- |
| 102 | | - -->{{#ifeq: {{{1}}} | wikilog |
| 103 | | - | [[Help:Overview of wikilogs|Overview]] • [[Help:Wikilog settings|Settings]] |
| 104 | | - }}<!-- |
| 105 | | - -->{{#ifeq: {{{1}}} | article |
| 106 | | - | [[Help:Overview of wikilog articles|Overview]] • [[Help:Writing a wikilog article|Writing]] |
| 107 | | - }}<!-- |
| 108 | | - -->{{#ifeq: {{{1}}} | advanced |
| 109 | | - | [[Help:Special:Wikilog|Special:Wikilog]] • [[Help:Embedding wikilogs|Embedding]] • [[Help:Wikilog styling|Styling]] |
| 110 | | - }}<!-- |
| 111 | | - --> • <!-- |
| | 92 | + --><td><!-- |
| | 93 | + -->{{Wikilog user manual index}}<!-- |
| 112 | 94 | --></td><!-- |
| 113 | 95 | --></tr><!-- |
| 114 | 96 | --></table><!-- |
| | 97 | + |
| 115 | 98 | -->[[{{ns:Category}}:Wikilog manual|{{{title|{{SUBPAGENAME}}}}}]]<!-- |
| 116 | 99 | --></onlyinclude> |
| 117 | 100 | |
| — | — | @@ -138,15 +120,44 @@ |
| 139 | 121 | </revision> |
| 140 | 122 | </page> |
| 141 | 123 | <page> |
| | 124 | + <title>Template:Wikilog user manual index</title> |
| | 125 | + <id>128</id> |
| | 126 | + <revision> |
| | 127 | + <id>305</id> |
| | 128 | + <timestamp>2010-08-08T02:35:39Z</timestamp> |
| | 129 | + <contributor> |
| | 130 | + <username>Juliano</username> |
| | 131 | + <id>1</id> |
| | 132 | + </contributor> |
| | 133 | + <comment>Created page with '<onlyinclude> * [[Help:Wikilog|Introduction]] * Wikilogs ** [[Help:Overview of wikilogs|Overview of wikilogs]] ** [[Help:Wikilog settings|Wikilog settings]] * Wikilog articles **…'</comment> |
| | 134 | + <text xml:space="preserve"><onlyinclude> |
| | 135 | +* [[Help:Wikilog|Introduction]] |
| | 136 | +* Wikilogs |
| | 137 | +** [[Help:Overview of wikilogs|Overview of wikilogs]] |
| | 138 | +** [[Help:Wikilog settings|Wikilog settings]] |
| | 139 | +* Wikilog articles |
| | 140 | +** [[Help:Overview of wikilog articles|Overview of wikilog articles]] |
| | 141 | +** [[Help:Writing a wikilog article|Writing a wikilog article]] |
| | 142 | +* Advanced |
| | 143 | +** [[Help:Special:Wikilog|Special:Wikilog]] |
| | 144 | +** [[Help:Embedding wikilogs|Embedding wikilogs]] |
| | 145 | +** [[Help:Wikilog styling|Styling]] |
| | 146 | +</onlyinclude> |
| | 147 | + |
| | 148 | +[[{{ns:Category}}:Wikilog manual]]</text> |
| | 149 | + </revision> |
| | 150 | + </page> |
| | 151 | + <page> |
| 142 | 152 | <title>Help:Wikilog</title> |
| 143 | 153 | <id>58</id> |
| 144 | 154 | <revision> |
| 145 | | - <id>265</id> |
| 146 | | - <timestamp>2009-09-13T01:29:43Z</timestamp> |
| | 155 | + <id>309</id> |
| | 156 | + <timestamp>2010-08-08T02:53:20Z</timestamp> |
| 147 | 157 | <contributor> |
| 148 | 158 | <username>Juliano</username> |
| 149 | 159 | <id>1</id> |
| 150 | 160 | </contributor> |
| | 161 | + <comment>/* User manual */</comment> |
| 151 | 162 | <text xml:space="preserve">{{Wikilog user manual header|intro}} |
| 152 | 163 | |
| 153 | 164 | '''Wikilog''' is a [http://www.mediawiki.org/ MediaWiki] extension that enhances the wiki software with some common blogging features, making it a wiki-blog hybrid. |
| — | — | @@ -159,16 +170,7 @@ |
| 160 | 171 | |
| 161 | 172 | == User manual == |
| 162 | 173 | |
| 163 | | -* Wikilogs |
| 164 | | -** [[Help:Overview of wikilogs|Overview of wikilogs]] |
| 165 | | -** [[Help:Wikilog settings|Wikilog settings]] |
| 166 | | -* Wikilog articles |
| 167 | | -** [[Help:Overview of wikilog articles|Overview of wikilog articles]] |
| 168 | | -** [[Help:Writing a wikilog article|Writing a wikilog article]] |
| 169 | | -* Advanced |
| 170 | | -** [[Help:Special:Wikilog|Special:Wikilog]] |
| 171 | | -** [[Help:Embedding wikilogs|Embedding wikilogs]] |
| 172 | | -** [[Help:Wikilog styling|Styling]] |
| | 174 | +{{Wikilog user manual index}} |
| 173 | 175 | |
| 174 | 176 | == External links == |
| 175 | 177 | |
| — | — | @@ -390,12 +392,13 @@ |
| 391 | 393 | <title>Help:Special:Wikilog</title> |
| 392 | 394 | <id>107</id> |
| 393 | 395 | <revision> |
| 394 | | - <id>246</id> |
| 395 | | - <timestamp>2009-09-07T22:10:48Z</timestamp> |
| | 396 | + <id>318</id> |
| | 397 | + <timestamp>2010-08-08T04:46:56Z</timestamp> |
| 396 | 398 | <contributor> |
| 397 | 399 | <username>Juliano</username> |
| 398 | 400 | <id>1</id> |
| 399 | 401 | </contributor> |
| | 402 | + <comment>/* Parameters */</comment> |
| 400 | 403 | <text xml:space="preserve">{{Wikilog user manual header|advanced}} |
| 401 | 404 | |
| 402 | 405 | The '''[[Special:Wikilog]]''' special page is a central query page for wikilog listings. By default, it displays a list of all articles in all wikilogs, like an aggregator for all hosted wikilogs. It also allows queries based on categories, authors, tags, status, etc. This special page can be included in other pages, so you can embed lists or summaries of wikilog posts anywhere in the wiki. For more information, see [[Help:Embedding wikilogs|embedding wikilogs]]. |
| — | — | @@ -430,10 +433,12 @@ |
| 431 | 434 | ! Inline syntax |
| 432 | 435 | ! Description |
| 433 | 436 | |- style="vertical-align: top;" |
| 434 | | - | '''wikilog='''''wikilog-title'' |
| 435 | | - | ''wikilog-title'' |
| | 437 | + |rowspan=2| '''wikilog='''''wikilog-title'' |
| | 438 | + |rowspan=2| ''wikilog-title'' |
| 436 | 439 | | Display only articles from the given wikilog. In both cases, ''wikilog-title'' is the wikilog page title including the namespace, since multiple namespaces can be configured to have wikilogs. Example: ''"{{wl-info:namespace-by-index}}:General rants"''. |
| 437 | 440 | |- style="vertical-align: top;" |
| | 441 | + | It is also possible to display all articles in a given namespace by using an asterisk as the page title. Example: ''"{{wl-info:namespace-by-index}}:*"'' |
| | 442 | + |- style="vertical-align: top;" |
| 438 | 443 | | '''category='''''category-name'' |
| 439 | 444 | | '''{{ns:Category}}:'''''category-name'' |
| 440 | 445 | | Display only articles in the given category. Example: ''"{{ns:Category}}:Communication"''. |
| — | — | @@ -503,18 +508,17 @@ |
| 504 | 509 | <title>Help:Wikilog settings</title> |
| 505 | 510 | <id>93</id> |
| 506 | 511 | <revision> |
| 507 | | - <id>222</id> |
| 508 | | - <timestamp>2009-09-07T02:12:57Z</timestamp> |
| | 512 | + <id>308</id> |
| | 513 | + <timestamp>2010-08-08T02:52:11Z</timestamp> |
| 509 | 514 | <contributor> |
| 510 | 515 | <username>Juliano</username> |
| 511 | 516 | <id>1</id> |
| 512 | 517 | </contributor> |
| | 518 | + <minor/> |
| | 519 | + <comment>fix for new header style</comment> |
| 513 | 520 | <text xml:space="preserve">{{Wikilog user manual header|wikilog}} |
| 514 | 521 | |
| 515 | | -<div style="float:right;">__TOC__</div> |
| 516 | | - |
| 517 | 522 | 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. |
| 518 | | -<div style="clear:both;"></div> |
| 519 | 523 | |
| 520 | 524 | == Icon, logo and subtitle == |
| 521 | 525 | |
| — | — | @@ -587,13 +591,13 @@ |
| 588 | 592 | <title>Help:Wikilog styling</title> |
| 589 | 593 | <id>88</id> |
| 590 | 594 | <revision> |
| 591 | | - <id>283</id> |
| 592 | | - <timestamp>2009-11-05T03:52:11Z</timestamp> |
| | 595 | + <id>316</id> |
| | 596 | + <timestamp>2010-08-08T04:39:51Z</timestamp> |
| 593 | 597 | <contributor> |
| 594 | 598 | <username>Juliano</username> |
| 595 | 599 | <id>1</id> |
| 596 | 600 | </contributor> |
| 597 | | - <comment>/* Summary pager */</comment> |
| | 601 | + <comment>new comments page</comment> |
| 598 | 602 | <text xml:space="preserve">{{Wikilog user manual header|advanced}} |
| 599 | 603 | |
| 600 | 604 | This page shows topographic diagrams of HTML blocks that may be useful in order to customize the appearance of the content generated by the Wikilog extension. The extension can be customized by adding CSS rules to [[MediaWiki:Common.css]]. |
| — | — | @@ -630,23 +634,24 @@ |
| 631 | 635 | The title of the wikilog article. |
| 632 | 636 | </div> |
| 633 | 637 | |
| 634 | | - <div style=""> |
| 635 | | -''([[MediaWiki:Wikilog-item-brief-header|wikilog-item-brief-header]] -- customizable)'' |
| | 638 | + <div style="background:#BBB; border:1px dashed gray; padding:3pt; margin:3pt;"> |
| | 639 | +'''.wl-summary-header'''<br/> |
| | 640 | +Optional. Contains the header of the summary entry, with authors, date, time, comments link, etc.<br/> |
| | 641 | +''([[MediaWiki:Wikilog-summary-header|wikilog-summary-header]] -- customizable)'' |
| 636 | 642 | </div> |
| 637 | 643 | |
| 638 | 644 | <div style="background:#BBB; border:1px dashed gray; padding:3pt; margin:3pt;"> |
| 639 | 645 | '''.wl-summary'''<br/> |
| 640 | | -The summary text of the wikilog article. |
| | 646 | +The summary text of the wikilog article.<br/> |
| | 647 | +''([[MediaWiki:Wikilog-summary-more|wikilog-summary-more]] -- customizable, conditional)'' |
| 641 | 648 | </div> |
| 642 | 649 | |
| 643 | | - <div style=""> |
| 644 | | -''([[MediaWiki:Wikilog-item-more|wikilog-item-more]] -- customizable, conditional)'' |
| | 650 | + <div style="background:#BBB; border:1px dashed gray; padding:3pt; margin:3pt;"> |
| | 651 | +'''.wl-summary-footer'''<br/> |
| | 652 | +Optional. Contains the header of the summary entry, with authors, date, time, comments link, etc.<br/> |
| | 653 | +''([[MediaWiki:Wikilog-summary-footer|wikilog-summary-footer]] -- customizable)'' |
| 645 | 654 | </div> |
| 646 | 655 | |
| 647 | | - <div style=""> |
| 648 | | -''([[MediaWiki:Wikilog-item-brief-footer|wikilog-item-brief-footer]] -- customizable)'' |
| 649 | | - </div> |
| 650 | | - |
| 651 | 656 | </div> |
| 652 | 657 | |
| 653 | 658 | <div style="background:#CCC; border:1px dashed gray; padding:3pt; margin:3pt;">'''.wl-entry''' [ ''.wl-draft'' ] ...</div> |
| — | — | @@ -706,16 +711,26 @@ |
| 707 | 712 | |
| 708 | 713 | <div style="background:#DDD; border:1px dashed gray; padding:3pt; margin:3pt;"> |
| 709 | 714 | '''.wl-comment''' [ ''.wl-comment-pending'' | ''.wl-comment-deleted'' ] [ ''.wl-comment-by-anon'' | ''.wl-comment-by-user'' [ ''.wl-comment-by-author'' ] ]<br/> |
| 710 | | -Contains the visible comment and its metadata. |
| | 715 | +Contains the visible comment. |
| 711 | 716 | |
| 712 | 717 | <div style="background:#CCC; border:1px dashed gray; padding:3pt; margin:3pt;"> |
| 713 | | -'''.wl-comment-meta'''<br/> |
| 714 | | -The user name, timestamp, status and actions on the comment. |
| | 718 | +'''.wl-comment-header'''<br/> |
| | 719 | +Optional. Contains the header of the comment, with author, date, time, etc.<br/> |
| | 720 | +''([[MediaWiki:Wikilog-comment-header|wikilog-comment-header]] -- customizable)'' |
| 715 | 721 | </div> |
| 716 | 722 | <div style="background:#CCC; border:1px dashed gray; padding:3pt; margin:3pt;"> |
| 717 | 723 | '''.wl-comment-text'''<br/> |
| 718 | 724 | The comment text itself. |
| 719 | 725 | </div> |
| | 726 | + <div style="background:#CCC; border:1px dashed gray; padding:3pt; margin:3pt;"> |
| | 727 | +'''.wl-comment-footer'''<br/> |
| | 728 | +Optional. Contains the footer of the comment, with author, date, time, etc.<br/> |
| | 729 | +''([[MediaWiki:Wikilog-comment-footer|wikilog-comment-footer]] -- customizable)'' |
| | 730 | + </div> |
| | 731 | + <div style="background:#CCC; border:1px dashed gray; padding:3pt; margin:3pt;"> |
| | 732 | +'''.wl-comment-tools'''<br/> |
| | 733 | +Contains links related to the comment, like reply, page, edit, etc. |
| | 734 | + </div> |
| 720 | 735 | </div> |
| 721 | 736 | |
| 722 | 737 | <div style="background:#DDD; border:1px dashed gray; padding:3pt; margin:3pt;">'''.wl-thread''' ... (recursive)</div> |
| — | — | @@ -753,12 +768,14 @@ |
| 754 | 769 | <title>Help:Writing a wikilog article</title> |
| 755 | 770 | <id>101</id> |
| 756 | 771 | <revision> |
| 757 | | - <id>225</id> |
| 758 | | - <timestamp>2009-09-07T02:13:52Z</timestamp> |
| | 772 | + <id>315</id> |
| | 773 | + <timestamp>2010-08-08T04:25:29Z</timestamp> |
| 759 | 774 | <contributor> |
| 760 | 775 | <username>Juliano</username> |
| 761 | 776 | <id>1</id> |
| 762 | 777 | </contributor> |
| | 778 | + <minor/> |
| | 779 | + <comment>/* Article summary */</comment> |
| 763 | 780 | <text xml:space="preserve">{{Wikilog user manual header|article}} |
| 764 | 781 | |
| 765 | 782 | In order to create a new wikilog article, a new wiki page must be created as a subpage of the wikilog page. The wikilog article title is the subpage part of the page title. For example, a wikilog article ''"The brown fox"'' in the ''"{{wl-info:namespace-by-index}}:General Rants"'' wikilog must have the full page title ''"{{wl-info:namespace-by-index}}:General Rants/The brown fox"''. |
| — | — | @@ -801,17 +818,29 @@ |
| 802 | 819 | |
| 803 | 820 | == Article summary == |
| 804 | 821 | |
| 805 | | -[[Image:Wikilog summary auto.png|thumb|right|Example of text selected as automatic summary.]] |
| 806 | | -[[Image:Wikilog summary manual.png|thumb|right|Example of text manually defined as summary.]] |
| | 822 | +<div class="thumb"><div class="thumbinner"> |
| | 823 | +[[Image:Wikilog summary auto.png|frameless|border]] |
| | 824 | +[[Image:Wikilog summary delim.png|frameless|border]] |
| | 825 | +[[Image:Wikilog summary manual.png|frameless|border]] |
| | 826 | +<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> |
| | 827 | +</div></div> |
| 807 | 828 | |
| 808 | | -Wikilog articles, like any wiki page, can be quite long. Wikilog pages list many 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 show click the article title or a "continue reading..." link to read the full article in its own page. |
| | 829 | +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. |
| 809 | 830 | |
| 810 | | -Summaries are either inferred automatically by Wikilog, or defined explicitly by article authors. |
| | 831 | +Summaries are either inferred automatically by Wikilog or defined explicitly by article authors. |
| 811 | 832 | |
| 812 | 833 | 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. |
| 813 | 834 | |
| 814 | | -Manual summaries are defined by surrounding part of the article text with the <code><nowiki><summary>...</summary></nowiki></code> markup. Only the text between these tags will be shown as a summary of the article in the main page of the wikilog and other listings. The summary is also normally shown as part of the article text. |
| | 835 | +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. |
| 815 | 836 | |
| | 837 | +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. |
| | 838 | + |
| | 839 | + ''summary text'' |
| | 840 | + '''--more--''' |
| | 841 | + ''rest of article text'' |
| | 842 | + |
| | 843 | +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. |
| | 844 | + |
| 816 | 845 | 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. |
| 817 | 846 | |
| 818 | 847 | The general syntax of the summary tag is: |
| — | — | @@ -820,8 +849,6 @@ |
| 821 | 850 | ''summary text'' |
| 822 | 851 | '''<nowiki></summary></nowiki>''' |
| 823 | 852 | |
| 824 | | - |
| 825 | | - |
| 826 | 853 | {{Wikilog user manual footer}}</text> |
| 827 | 854 | </revision> |
| 828 | 855 | </page> |
| — | — | @@ -888,12 +915,13 @@ |
| 889 | 916 | <title>File:Wikilog summary auto.png</title> |
| 890 | 917 | <id>102</id> |
| 891 | 918 | <revision> |
| 892 | | - <id>260</id> |
| 893 | | - <timestamp>2009-09-12T04:49:27Z</timestamp> |
| | 919 | + <id>313</id> |
| | 920 | + <timestamp>2010-08-08T04:10:28Z</timestamp> |
| 894 | 921 | <contributor> |
| 895 | 922 | <username>Juliano</username> |
| 896 | 923 | <id>1</id> |
| 897 | 924 | </contributor> |
| | 925 | + <comment>uploaded a new version of "[[File:Wikilog summary auto.png]]"</comment> |
| 898 | 926 | <text xml:space="preserve">== Summary == |
| 899 | 927 | Wikilog automatic summary example. |
| 900 | 928 | |
| — | — | @@ -906,15 +934,45 @@ |
| 907 | 935 | </revision> |
| 908 | 936 | </page> |
| 909 | 937 | <page> |
| | 938 | + <title>File:Wikilog summary delim.png</title> |
| | 939 | + <id>129</id> |
| | 940 | + <revision> |
| | 941 | + <id>312</id> |
| | 942 | + <timestamp>2010-08-08T04:07:58Z</timestamp> |
| | 943 | + <contributor> |
| | 944 | + <username>Juliano</username> |
| | 945 | + <id>1</id> |
| | 946 | + </contributor> |
| | 947 | + <comment>== Summary == |
| | 948 | +Wikilog manual summary example. |
| | 949 | + |
| | 950 | +== License == |
| | 951 | +* '''Author:''' [http://juliano.info/ Juliano F. Ravasi] |
| | 952 | +* '''License:''' [http://creativecommons.org/licenses/by-sa/3.0/ Creative Commons Attribution-Share Alike 3.0 Unported License] |
| | 953 | + |
| | 954 | +{{Wikilo</comment> |
| | 955 | + <text xml:space="preserve">== Summary == |
| | 956 | +Wikilog manual summary example. |
| | 957 | + |
| | 958 | +== License == |
| | 959 | +* '''Author:''' [http://juliano.info/ Juliano F. Ravasi] |
| | 960 | +* '''License:''' [http://creativecommons.org/licenses/by-sa/3.0/ Creative Commons Attribution-Share Alike 3.0 Unported License] |
| | 961 | + |
| | 962 | +{{Wikilog user manual footer|kind=image}} |
| | 963 | +[[Category:Wikilog manual]]</text> |
| | 964 | + </revision> |
| | 965 | + </page> |
| | 966 | + <page> |
| 910 | 967 | <title>File:Wikilog summary manual.png</title> |
| 911 | 968 | <id>103</id> |
| 912 | 969 | <revision> |
| 913 | | - <id>261</id> |
| 914 | | - <timestamp>2009-09-12T04:49:57Z</timestamp> |
| | 970 | + <id>311</id> |
| | 971 | + <timestamp>2010-08-08T04:07:15Z</timestamp> |
| 915 | 972 | <contributor> |
| 916 | 973 | <username>Juliano</username> |
| 917 | 974 | <id>1</id> |
| 918 | 975 | </contributor> |
| | 976 | + <comment>uploaded a new version of "[[File:Wikilog summary manual.png]]"</comment> |
| 919 | 977 | <text xml:space="preserve">== Summary == |
| 920 | 978 | Wikilog manual summary example. |
| 921 | 979 | |
| Index: trunk/extensions/Wikilog/documentation/Wikilog_summary_delim.xcf |
| Cannot display: file marked as a binary type. |
| svn:mime-type = image/x-xcf |
| Property changes on: trunk/extensions/Wikilog/documentation/Wikilog_summary_delim.xcf |
| ___________________________________________________________________ |
| Added: svn:mime-type |
| 922 | 980 | + image/x-xcf |