Changes for page Templates

Last modified by Leon Poon on 2022/06/05 09:12
From version 5.1
edited by Leon Poon
on 2022/06/05 09:12
Change comment: Install extension [org.xwiki.platform:xwiki-platform-help-ui/13.10.6]
To version 1.1
edited by Leon Poon
on 2018/12/16 14:34
Change comment: Install extension [org.xwiki.contrib:application-help-center/1.3]

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -$services.localization.render('help.templates.title')
1 +Templates
Content
... ... @@ -1,16 +1,13 @@
1 1  {{include reference="Help.Code.VelocityMacros" /}}
2 2  
3 3  {{velocity output="false"}}
4 -#set ($featuresPrefix = 'https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features')
5 -#set ($exoPrefix = 'https://extensions.xwiki.org/xwiki/bin/view/Extension')
6 6  #set ($actionCards = [{
7 - 'title': $services.localization.render('help.templates.useTemplates.title'),
8 - 'description': $services.localization.render('help.templates.useTemplates.description'),
9 - 'tip': $services.localization.render('help.templates.useTemplates.tip',
10 - ["<a href='$featuresPrefix/DocumentLifecycle#HCreate' class='wikiexternallink'>",'</a>']),
5 + 'title': 'Use templates',
6 + 'description': 'Templates are predefined pages that can be copied when creating a new page.',
7 + 'tip': "<a href=""http://platform.xwiki.org/xwiki/bin/view/Features/DocumentLifecycle#HCreate"" class=""wikiexternallink"">Creating pages</a> based on templates makes it faster to adapt predefined content to your needs.",
11 11   'thumbnail': 'Template',
12 12   'actions': [{
13 - 'label': $services.localization.render('help.try.label'),
10 + 'label': 'Try it!',
14 14   'type': 'success',
15 15   'url': $xwiki.getURL('Sandbox.WebHome', 'create', $escapetool.url({
16 16   'title': "New Page $datetool.get('dd MMM yyyy, HH:mm')"
... ... @@ -17,63 +17,43 @@
17 17   }))
18 18   }]
19 19  }, {
20 - 'title': $services.localization.render('help.templates.create.title'),
21 - 'description': $services.localization.render('help.templates.create.description'),
22 - 'tip': $services.localization.render('help.templates.create.tip',
23 - ["<a href='$exoPrefix/Administration+Application#HCreatetheTemplateProvider' class='wikiexternallink'>",'</a>']),
17 + 'title': 'Create your template',
18 + 'description': 'Integrate structure and macros in an existing page, and transform it in a template.',
19 + 'tip': "<a href=""http://extensions.xwiki.org/xwiki/bin/view/Extension/Administration+Application#HCreatetheTemplateProvider"" class=""wikiexternallink"">Template Providers</a> expose templates on the Create Page dialog so that the users can use them.",
24 24   'thumbnail': 'Administration',
25 25   'actions': [{
26 - 'label': $services.localization.render('help.more.label'),
27 - 'url': "$exoPrefix/Administration+Application#HCreatetheTemplateProvider"
22 + 'label': 'Learn more',
23 + 'url': 'http://extensions.xwiki.org/xwiki/bin/view/Extension/Administration+Application#HCreatetheTemplateProvider'
28 28   }]
29 29  }])
30 30  
31 31  #if ($hasAdmin)
32 32   #set ($discard = $actionCards[1].actions.add(0, {
33 - 'label': $services.localization.render('help.browse.label'),
29 + 'label': 'Browse',
34 34   'url': $xwiki.getURL('XWiki.XWikiPreferences', 'admin', 'editor=globaladmin&section=Templates')
35 35   }))
36 36  #end
37 37  
38 -#macro (getTemplateExample $inputCard $outputCard)
39 - #set ($templateReference = $services.model.resolveDocument($inputCard.templateReference))
40 - #if ($xwiki.getDocument($templateReference).isNew())
41 - #set ($outputCard = {
42 - 'title': $inputCard.title,
43 - 'description': $inputCard.description,
44 - 'documentation': "$exoPrefix/Templates+Application/",
45 - 'thumbnail': $inputCard.thumbnail
46 - })
47 - #else
48 - #set ($outputCard = {
49 - 'title': $inputCard.title,
50 - 'description': $inputCard.description,
51 - 'examples': $inputCard.templateReference,
52 - 'thumbnail': $inputCard.thumbnail
53 - })
54 - #end
55 -#end
56 -
57 57  #set ($exampleCards = [{
58 - 'title': $services.localization.render('help.templates.article.title'),
59 - 'description':$services.localization.render('help.templates.article.description'),
60 - 'templateReference': 'Templates.Article.Template.WebHome',
61 - 'thumbnail': 'Help.Templates.WebHome@article.png'
35 + 'title': 'Article',
36 + 'description': 'Article page',
37 + 'examples': 'Help.Templates.Article.WebHome',
38 + 'thumbnail': 'Help.Templates.Article.WebHome@article.png'
62 62  }, {
63 - 'title': $services.localization.render('help.templates.encyclopedia.title'),
64 - 'description': $services.localization.render('help.templates.encyclopedia.description'),
65 - 'templateReference': 'Templates.Encyclopedia.Template.WebHome',
66 - 'thumbnail': 'Help.Templates.WebHome@encyclopedia.png'
40 + 'title': 'Encyclopedia',
41 + 'description': 'Encyclopedia page',
42 + 'examples': 'Help.Templates.Encyclopedia.WebHome',
43 + 'thumbnail': 'Help.Templates.Encyclopedia.WebHome@encyclopedia.png'
67 67  }, {
68 - 'title': $services.localization.render('help.templates.meeting.title'),
69 - 'description': $services.localization.render('help.templates.meeting.description'),
70 - 'templateReference': 'Templates.Meeting.Template.WebHome',
71 - 'thumbnail': 'Help.Templates.WebHome@meeting.png'
45 + 'title': 'Meeting Report',
46 + 'description': 'Agenda and notes',
47 + 'examples': 'Help.Templates.Meeting.WebHome',
48 + 'thumbnail': 'Help.Templates.Meeting.WebHome@meeting.png'
72 72  }, {
73 - 'title': $services.localization.render('help.templates.simple.title'),
74 - 'description': $services.localization.render('help.templates.simple.description'),
75 - 'templateReference': 'Templates.SimplePage.Template.WebHome',
76 - 'thumbnail': 'Help.Templates.WebHome@simple.png'
50 + 'title': 'Simple Page',
51 + 'description': 'With table of contents',
52 + 'examples': 'Help.Templates.Simple.WebHome',
53 + 'thumbnail': 'Help.Templates.Simple.WebHome@simple.png'
77 77  }])
78 78  {{/velocity}}
79 79  
... ... @@ -90,8 +90,8 @@
90 90   </div>
91 91   #end
92 92  </div>
93 -<h3 id="HExamples">$services.localization.render('help.templates.examples.title')</h3>
94 -<p>$services.localization.render('help.templates.examples.description')</p>
70 +<h3 id="HExamples">Examples</h3>
71 +<p>Want to start from a predefined template? Here are some examples of available templates inside XWiki.</p>
95 95  <div class="row">
96 96   #foreach ($card in $exampleCards)
97 97   ## See http://getbootstrap.com/css/#grid-responsive-resets .
... ... @@ -105,12 +105,10 @@
105 105   <div class="clearfix visible-lg-block"></div>
106 106   #end
107 107   <div class="col-xs-12 col-sm-6 col-md-4 col-lg-3">
108 - #set ($outputCard = {})
109 - #getTemplateExample($card $outputCard)
110 - #helpExampleCard($outputCard)
85 + #helpExampleCard($card)
111 111   </div>
112 112   #end
113 113  </div>
114 -<p><a href="$exoPrefix/Templates+Application/" class="wikiexternallink">$services.localization.render('help.templates.more')</a></p>
89 +<p><a href="http://extensions.xwiki.org/xwiki/bin/view/Extension/Templates+Application/" class="wikiexternallink">View more templates</a></p>
115 115  {{/html}}
116 116  {{/velocity}}
article.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.CodePowered
Size
... ... @@ -1,1 +1,0 @@
1 -376.1 KB
Content
encyclopedia.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.CodePowered
Size
... ... @@ -1,1 +1,0 @@
1 -331.5 KB
Content
meeting.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.CodePowered
Size
... ... @@ -1,1 +1,0 @@
1 -83.5 KB
Content
simple.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.CodePowered
Size
... ... @@ -1,1 +1,0 @@
1 -180.8 KB
Content