Last modified by Vincent Massol on 2024/02/26 17:57

Hide last authors
Ecaterina Moraru (Valica) 1.1 1 {{velocity}}
2 $xwiki.ssx.use('Proposal.Flavors.TechnicalDocumentationFlavor.WebHome')
3 {{/velocity}}
4
Ecaterina Moraru (Valica) 5.4 5 (% class="container-fluid" %)
6 (((
7 (% class="row" %)
8 (((
9 (% class="col-xs-12 col-md-4" %)
10 (((
Ecaterina Moraru (Valica) 1.1 11 {{box title="Content"}}
12 {{toc start="2" /}}
13 {{/box}}
14 )))
15
Ecaterina Moraru (Valica) 5.4 16 (% class="col-xs-12 col-md-8" %)
17 (((
Ecaterina Moraru (Valica) 1.1 18 {{gallery class="pull-right"}}
19 image:Proposal.Flavors.TechnicalDocumentationFlavor.ExampleDefault.WebHome@default_homepage.png
20 image:Proposal.Flavors.TechnicalDocumentationFlavor.ExampleXWiki.WebHome@xwiki_doc_partial.png
21 image:Proposal.Flavors.TechnicalDocumentationFlavor.ExampleMaven.WebHome@maven_doc_partial.png
22 image:Proposal.Flavors.TechnicalDocumentationFlavor.ExampleMaven.WebHome@maven_homepage_partial.png
23 image:Proposal.Flavors.TechnicalDocumentationFlavor.ExampleXWiki.WebHome@xwiki_homepage_partial.png
24 {{/gallery}}
25 )))
26 )))
27
28
Ecaterina Moraru (Valica) 5.4 29 (% class="row" %)
30 (((
31 (% class="col-xs-12 col-md-4" %)
32 (((
33 (% class="row" %)
34 (((
35 (% class="col-xs-12" %)
36 (((
Ecaterina Moraru (Valica) 1.1 37 == Purpose ==
38
39 Create a flavor that allows easy creation of XWiki instances suited for writing technical documentation.
40
41 The instance will contain documentation for a specific project, from user guides to API references and FAQs. Pages will contain from simple content like images and code samples, to macros and applications targeted towards software development.
42
43 Can be used by people wanting to provide support for a particular software or by developers that maintain and develop one.
44 )))
45
Ecaterina Moraru (Valica) 5.4 46 (% class="col-xs-12" %)
47 (((
Ecaterina Moraru (Valica) 1.1 48 Allows easy:
49 - customisation of the appearance (colors, logo, header);
50 - customisation of navigation links from menu and footer;
51 - and also allows creating a landing page with a specific layout in addition to the documentation layout.
52
53 Just like any XWiki instance, it is very extensible by supporting applications related to software development like Release Notes, IRC Archives, GitHub Stats, Dashboards, etc.
54 )))
55 )))
56 )))
57
Ecaterina Moraru (Valica) 5.4 58 (% class="col-xs-12 col-md-8" %)
59 (((
Ecaterina Moraru (Valica) 1.1 60 == Features ==
61
Ecaterina Moraru (Valica) 5.4 62 (% class="table-hover table" %)
63 (% class="active" %)|=(% colspan="100" %) Basic
64 |=(% rowspan="5" %)Features |(% colspan="4" %) Pages Basic: Create, Edit, etc.
65 |(% colspan="4" %) Versioning, History, Changes, Blame
66 |(% colspan="4" %) Export to PDF, XAR, Backup
67 |(% colspan="4" %) Administration, Rights (Open / Public Website) + Private / Internal Pages
68 |(% colspan="2" %) Search + Quick Search | Livetable | Profile
69 |= Macros |(% colspan="2" %) Box, Info, etc.|(% colspan="3" %) Code, Tree, Gallery, Toc, etc.
70 (% class="active" %)|=(% colspan="100" %) Advanced / Thematic / Optional
Ecaterina Moraru (Valica) 1.1 71 |= Configuration | Custom Domain | Subdomains | HTTPS support | Hosting
72 |= Templates | Roadmap | Download, Installation | Contribute | 404
73 |= Macros | Jira | Chart | Twitter | Google (YouTube, Maps, Calendar)
Ecaterina Moraru (Valica) 5.4 74 |=(% rowspan="2" %) Apps | FAQ, Forum | Blog | Dashboard | Stats
Ecaterina Moraru (Valica) 1.1 75 | Release Notes | GitHub Stats | Flash messages | Version archive
76 |= Extra | Workflow | Internationalization | Spam Protection | IRC Bot
Ecaterina Moraru (Valica) 5.4 77 |= Integrations| GitHub | Markdown | Google Analytics |\\
Ecaterina Moraru (Valica) 1.1 78 )))
79 )))
80
Ecaterina Moraru (Valica) 5.4 81 (% class="row" %)
82 (((
83 (% class="col-xs-12" %)
84 (((
85 ----
Ecaterina Moraru (Valica) 1.1 86
87 == Skin: Dove ==
88
Ecaterina Moraru (Valica) 3.2 89 {{display reference=".ExampleDefault.WebHome" section="HContent"/}}
Ecaterina Moraru (Valica) 1.1 90 )))
91 )))
92
Ecaterina Moraru (Valica) 5.4 93 ----
Ecaterina Moraru (Valica) 1.1 94
Ecaterina Moraru (Valica) 5.4 95 (% class="row" %)
96 (((
97 (% class="col-xs-12" %)
98 (((
Ecaterina Moraru (Valica) 1.1 99 == Examples ==
100 )))
101
Ecaterina Moraru (Valica) 5.4 102 (% class="col-xs-12 col-md-6" %)
103 (((
Ecaterina Moraru (Valica) 1.1 104 === Project: XWiki ===
105
Ecaterina Moraru (Valica) 3.3 106 {{display reference=".ExampleXWiki.WebHome" section="HContent"/}}
Ecaterina Moraru (Valica) 1.1 107 )))
108
Ecaterina Moraru (Valica) 5.4 109 (% class="col-xs-12 col-md-6" %)
110 (((
Ecaterina Moraru (Valica) 1.1 111 === Project: Apache Maven ===
112
Ecaterina Moraru (Valica) 3.3 113 {{display reference=".ExampleMaven.WebHome" section="HContent"/}}
Ecaterina Moraru (Valica) 1.1 114 )))
115 )))
116
Ecaterina Moraru (Valica) 5.4 117 ----
Ecaterina Moraru (Valica) 1.1 118
Ecaterina Moraru (Valica) 5.4 119 (% class="row" %)
120 (((
121 (% class="col-xs-12" %)
122 (((
Ecaterina Moraru (Valica) 1.1 123 == Implementation ==
124 )))
125
Ecaterina Moraru (Valica) 5.4 126 (% class="col-xs-12 col-md-6" %)
127 (((
Ecaterina Moraru (Valica) 1.1 128 === Differences ===
129
130 * Flavor
131 ** Removed Help, Sandbox application
132 ** Remove all macros or applications not needed by the use case
133 ** Marked as hidden some XWiki pages
134
Ecaterina Moraru (Valica) 5.4 135 * Skin
Ecaterina Moraru (Valica) 1.1 136 ** Different fonts for text and code
137 ** Hidden tags, last modified, created area
138 ** Removal of #docextra from WebPreferences
139 ** Display viewers in the "More actions" menu even if #docextra is hidden
140 ** New save buttons layout
141
142 * Menu
143 ** Fixed top menu
144 ** Menu integrated inside primary navbar (#menuview)
145 ** Removal of avatar and notification UIX
146 ** Style adjustments (text-transform, etc.)
147 ** Drawer should simply entries
148
149 * Panels
150 ** WebPreferences using a left only panels layout + large panels width
151 ** Navigation panel using document reference to display children
152 ** Panel header style adjustments
153 ** Edit mode using large panels width
154 ** Adjust width for large panels width on big resolutions
155
Ecaterina Moraru (Valica) 5.4 156 * Custom
Ecaterina Moraru (Valica) 1.1 157 ** Header is displayed only on Main.WebHome (custom velocity + ssx; careful on edit mode)
158 )))
159
Ecaterina Moraru (Valica) 5.4 160 (% class="col-xs-12 col-md-6" %)
161 (((
Ecaterina Moraru (Valica) 1.1 162 === Issues ===
163
164 * Needing UIX points or default pages that are included in the Header, Menu, Footer area
165 * Providing default templates for Header, Menu and Footer
166 * Provide Administration area to modify the Header, Menu and Footer
167 * Provide the font also locally or make a call to Google Fonts for online instances
168 * Menu: reordering pages (non alphabetical order)
169
170 === Additional ===
171
172 * Provide alternative templates for Header
173 * Provide 3 tested ColorThemes for the skin (see how to separate from the default ones - maybe not install them by default)
174 )))
175 )))
176
Ecaterina Moraru (Valica) 5.4 177 (% class="row" %)
178 (((
179 (% class="col-xs-12 col-md-6" %)
180 (((
Ecaterina Moraru (Valica) 1.1 181
182 )))
183
Ecaterina Moraru (Valica) 5.4 184 (% class="col-xs-12 col-md-6" %)
185 (((
186
Ecaterina Moraru (Valica) 1.1 187 )))
188 )))
189
190
191 )))

Get Connected