Wiki source code of Getting Started

Version 54.1 by Silvia Macovei on 2018/09/26

Hide last authors
Ecaterina Moraru (Valica) 48.2 1 {{velocity output="false"}}
Ecaterina Moraru (Valica) 49.1 2 $xwiki.ssx.use('Documentation.UserGuide.GettingStarted.WebHome')
Ecaterina Moraru (Valica) 48.2 3 {{/velocity}}
4
Vincent Massol 49.2 5 Welcome to the XWiki "Get Started" page. This guide provides basic information on how to set up and use XWiki. Start by learning more about [[wikis>>Documentation.UserGuide.GettingStarted.WhatIsAWiki]].
Guillaume Lerouge 1.1 6
Vincent Massol 50.1 7 XWiki's use cases are diverse: collaborative intranet, knowledge base, CMS, competitive intelligence, public debate, collaborative creation of school courses, web site creation, etc. Read more on [[what wikis can be used for>>Documentation.UserGuide.GettingStarted.WhatCanAWikiBeUsedFor]], [[what makes XWiki special>>Documentation.UserGuide.GettingStarted.WhatsSpecialAboutXWiki.WebHome]] and a [[second generation wiki>>platform:Main.SecondGenerationWiki]].
Silvia Macovei 9.1 8
Vincent Massol 52.1 9 You can visit the [[references page>>xwiki:References.WebHome]] to see a list of varied projects based on XWiki. You can add your own project to the same page by filling in a short form. You can also go to the [[XWiki project homepage>>xwiki:Main.WebHome]] to see some of the companies that use XWiki or check out the [[testimonials page>>Main.Feedback.Testimonials]] to view what our users have to say.
Silvia Macovei 9.1 10
Ecaterina Moraru (Valica) 33.1 11 = Basic information =
Silvia Macovei 28.1 12
Vincent Massol 51.1 13 The first thing you want to do is [[download>>xwiki:Download.WebHome]] and [[install XWiki>>platform:AdminGuide.Installation]]. For first time XWiki users and for users who wish to quickly try out XWiki we recommend installing the [[standalone distribution>>platform:AdminGuide.InstallationStandalone]]. You can also [[try it online>>doc:Hosted.WebHome]] if you're not looking to install XWiki from scratch.
Silvia Macovei 9.1 14
Ecaterina Moraru (Valica) 33.1 15 (% class="row" %)
16 (((
17 (% class="col-xs-12 col-md-6" %)
18 (((
Eduard Moraru 30.2 19 Then, as you log in to your wiki, the first thing you see is the wiki homepage.
Silvia Macovei 30.1 20
Ecaterina Moraru (Valica) 48.2 21 [[image:1.png||class="image-label"]] XWiki is divided into Wikis and Pages. Inside a wiki, you can create a hierarchy of pages, by creating pages inside other pages. This feature is called [[Nested Pages>>platform:Features.ContentOrganization]]. From this area you can [[add new pages>>platform:Features.DocumentLifecycle]] by clicking the "+" button.
Ecaterina Moraru (Valica) 33.3 22
Vincent Massol 51.1 23 [[image:2.png||class="image-label"]] Whenever you want to [[modify a page>>platform:Features.PageEditing]], click on the pen edit button, make your changes and save the page. The modified page now replaces the previous version. Each version of the page is stored in the [[page history>>platform:Features.VersionControl]] and can be reverted to, if needed. More page actions, such as Administer, Copy, Rename, Delete, Export, are also available from the last two menus on the right.
Silvia Macovei 9.1 24
Ecaterina Moraru (Valica) 48.2 25 [[image:3.png||class="image-label"]] From the upper right corner you may click on your [[profile>>extensions:Extension.User Profile Application]], or the notifications menu.
Silvia Macovei 9.1 26
Vincent Massol 51.1 27 [[image:4.png||class="image-label"]] By expanding the drawer menu on the right you can log in, register, access you profile or go to the [[wiki administration>>extensions:Extension.Administration Application]]. You can also access the wiki, page or user [[indexes>>extensions:Extension.Index Application]], as well as add a new wiki.
Silvia Macovei 9.1 28
Ecaterina Moraru (Valica) 48.7 29 [[image:5.png||class="image-label"]] You can easily edit/modify the content of the first page to replace it with your own content.
Silvia Macovei 9.1 30
Vincent Massol 51.1 31 [[image:6.png||class="image-label"]] Lateral menus are handled using panels. A [[panel>>Documentation.UserGuide.GettingStarted.ChangingTheLogoAndThePanels]] is a widget you can see on the left and/or right of every page of your wiki in the standard version of XWiki. By default you will see a small sized Applications and Navigation panels on the left and medium sized panels on the right.
Silvia Macovei 9.1 32
Vincent Massol 51.1 33 [[image:7.png||class="image-label"]] The tabbed area at the bottom of the page features by default [[comments>>platform:Features.DocumentLifecycle||anchor="HComments"]], [[attachments>>platform:Features.Attachments]], [[page history>>platform:Features.VersionControl]] and page information.
Ecaterina Moraru (Valica) 33.1 34 )))
Silvia Macovei 18.1 35
Ecaterina Moraru (Valica) 33.1 36 (% class="col-xs-12 col-md-6" %)
37 (((
Ecaterina Moraru (Valica) 48.2 38 {{comment}}
39 READ ME: No change needed, just update Homepage.png with a new screenshot
40 {{/comment}}
41
42 (% class="image-container" %)
43 (((
44 image:Homepage.png
45
46 (% class="image-overlay" %)
47 (((
48 image:Homepage.png
Ecaterina Moraru (Valica) 33.1 49 )))
50 )))
Ecaterina Moraru (Valica) 48.2 51 )))
52 )))
Silvia Macovei 18.1 53
Silvia Macovei 54.1 54 You can check the [[complete list of features>>Documentation.UserGuide.Features.WebHome]]. You can also [[get started with the first steps>>FirstStepsWithXWiki]].
Silvia Macovei 9.1 55
Ecaterina Moraru (Valica) 35.1 56 {{warning}}
Ecaterina Moraru (Valica) 33.1 57 If you need more help with your wiki or you'd like to get in touch with the community please visit the [[support page>>xwiki:Main.Support]]. There you'll find more information on:
Vincent Massol 52.1 58
Ecaterina Moraru (Valica) 33.1 59 * [[Community support>>xwiki:Main.Support||anchor="HCommunitySupport"]]
60 * [[Professional support>>xwiki:Main.Support||anchor="HProfessionalSupport"]]
Ecaterina Moraru (Valica) 35.1 61 {{/warning}}
Ecaterina Moraru (Valica) 33.1 62
63 (% class="row cards" %)
64 (((
65 (% class="col-xs-12 col-md-6 cards-container" %)
66 (((
67 {{html clean="false"}}
68 <div class="card card2" style="border: 0;">
69 <div class="card-body">
70 {{/html}}
71
72 (% style="margin-top: 0" %)
73 == If you're an Administrator ==
74
Silvia Macovei 31.1 75 If you're using the Jetty/HSQLDB package, before you perform admin actions, you will need to log in using the following credentials:
Silvia Macovei 9.1 76 {{code}}Username: Admin
77 Password: admin{{/code}}
Thibaut Camberlin 12.1 78 We strongly recommend you change the Admin's password to a secret one as soon as you can.
Silvia Macovei 31.1 79 Otherwise, when you install XWiki from scratch, you are asked to register your own user which will be the owner of the wiki.
Silvia Macovei 9.1 80
Vincent Massol 51.1 81 The [[Administrator's Guide>>Documentation.AdminGuide.WebHome]] provides general information for admins who need to customize their wiki (authentication, DB, performance tuning, etc.), and more generally everything you want to know about administrating XWiki, from installation to backups.
Silvia Macovei 9.1 82
Ecaterina Moraru (Valica) 33.1 83 * Discover how to [[create users and groups>>platform:Features.UsersAndGroupsManagement]] and [[handle rights on your wiki>>platform:Features.RightsManagement]].
84 * Learn how to customize the look and feel of the wiki ([[skin>>platform:AdminGuide.Skins]], [[color themes>>extensions:Extension.Color Theme Application]], [[panels>>extensions:Extension.Panels Application]], etc.)
Silvia Macovei 9.1 85 * See how you can backup your wiki, import XAR files to the wiki and much more.
Ecaterina Moraru (Valica) 33.1 86 {{html clean="false"}}
87 </div>
88 </div>{{/html}}
89 )))
Silvia Macovei 9.1 90
Ecaterina Moraru (Valica) 48.4 91 (% class="col-xs-12 col-md-6 cards-container" %)
Ecaterina Moraru (Valica) 33.1 92 (((
93 {{html clean="false"}}
94 <div class="card card2" style="border: 0;">
95 <div class="card-body">
96 {{/html}}
Silvia Macovei 9.1 97
Ecaterina Moraru (Valica) 33.1 98 (% style="margin-top: 0" %)
99 == If you're a Developer ==
Silvia Macovei 9.1 100
Ecaterina Moraru (Valica) 33.1 101 XWiki is also a second generation wiki. You can build simple applications, extend the platform with custom plugins, or even build complex Web applications.
102
Vincent Massol 51.1 103 XWiki's powerful programming features are documented in the [[Developer's Guide>>platform:DevGuide.WebHome]]. A number of applications are pre-installed but additional applications, macros and other extensions are available on the [[Extensions wiki>>extensions:Main.WebHome]]. The documentation for the [[XWiki Rendering>>rendering:Main.WebHome]] has a [[dedicated wiki>>rendering:Main.WebHome]].
Ecaterina Moraru (Valica) 33.1 104
Vincent Massol 51.1 105 For documentation related to the development of XWiki itself, visit the [[XWiki Development Zone>>dev:Main.WebHome]].
Ecaterina Moraru (Valica) 33.1 106
107 {{html clean="false"}}
108 </div>
109 </div>
110 {{/html}}
111 )))
112 )))

Get Connected