Wiki source code of XWiki Contrib

Version 20.1 by Thomas Mortagne on 2012/09/07 17:27

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 The **XWiki Contrib Project** provides hosting for projects related to XWiki. These projects are not part of the official XWiki distributions and are not maintained by the XWiki development team.
6
7 = Contrib Project List =
8
9 The full list projects is available on the [[##xwiki-contrib## user on GitHub>>https://github.com/organizations/xwiki-contrib]].
10
11 |=Project Name|=What is it?
12 |[[Curriki>>http://www.curriki.org]]|Open Source Curriculum Sharing and Editing based on the XWiki Platform.
13
14 = Hosting tools =
15
16 The project hosting forge can provide contributors with some or all of the following tools :
17
18 * A **GitHub repository**, under http://github.com/xwiki-contrib
19 * A **JIRA project** for tracking bugs and feature requests, at http://jira.xwiki.org/ and under the "XWiki Contributed projects" category. Note that there will be a generic JIRA project to be used by all projects till they achieve a first release or till they grow to a size significant enough to warrant a dedicated JIRA project
20 * A generic **maven groupId**: ##org.xwiki.contrib.<module name>## (until the project reaches a certain size and visibility, in which case it can have its own maven group id). For example: ##org.xwiki.contrib.mailarchive##.
21 * **Project pages** on extensions.xwiki.org to describe and document the project. When the project reaches a certain visibility and size it can have its own wiki on xwiki.org.
22
23 = Requesting a project =
24
25 The contrib project is open for anyone with a project that request it. Simply send us an email at **##devs AT xwiki.org##** using "**[Contrib]**" at the beginning of your email's subject. Let us know the name and a short description of your project. If your project has already been made available for download on extensions.xwiki.org, please precise it and point us to its page (If it is not, then no need to hurry, you will make it available once it's ready). Finally, let us know which of the listed tools you need. For GitHub access, you will need to register a user on http://github.com and let us know about it (a best practice is to have a username composed of the first letter of your first name immediately followed by your last name, the whole with no capital letter, for example **jdoe** if your name is John Doe).
26
27 = Requesting snapshost builds for your project =
28
29 XWiki.org has a [[continuous build>>http://dev.xwiki.org/xwiki/bin/view/Community/ContinuousBuild]] which builds maven projects each time they are modified on GitHub and put the resulting artifact in our [[snapshots repository>>http://maven.xwiki.org/snapshots/]]. This is useful when you want people using your project as a dependency to continuously benefit from the improvements.
30
31 Your can ask for your project to be added to the continuous build:
32
33 * First you need to use the xwiki parent pom to have the correct distribution management information:(((
34 {{code language="xml"}}
35 <project>
36 ...
37 <parent>
38 <groupId>org.xwiki.commons</groupId>
39 <artifactId>xwiki-commons-pom</artifactId>
40 <version>See https://github.com/xwiki/xwiki-commons/blob/master/pom.xml</version>
41 </parent>
42 ...
43 </project>
44 {{/code}}
45 )))
46 * Send a [[vote>>http://dev.xwiki.org/xwiki/bin/view/Community/Committership#HVoting]] on the [email protected] mailing list to discuss the addition of your project in the continuous build(((
47 {{code language="none"}}
48 [VOTE] Add myproject to the continuous build
49
50 Hi XWikiers,
51
52 I'm working on myproject and since it's used as a
53 dependency by someotherproject it'd be convenient
54 if it was built continuously.
55
56 Here's my +1.
57
58 Thanks,
59 Me.
60 {{/code}}
61 )))
62
63 = Release the project =
64
65 XWiki.org allows you to release your project on its maven repository as long as you follow the following steps:
66
67 * Use org.xwiki.contrib as groupId in your maven module
68 * Request for an account on http://nexus.xwiki.org on [email protected]
69 * Once you've received your credentials put them in ~~/.m2/settings.xml(((
70 {{code language="xml"}}
71 <settings>
72 ...
73 <servers>
74 ...
75 <server>
76 <id>xwiki-staging</id>
77 <username>username</username>
78 <password>********</password>
79 </server>
80 ...
81 </servers>
82 ...
83 </settings>
84 {{/code}}
85 )))
86 * Put the following configuration in your project pom.xml(((
87 {{code language="xml"}}
88 <project>
89 ...
90 <scm>
91 <connection>scm:git:git://github.com/xwiki-contrib/{extensionrepository}.git</connection>
92 <developerConnection>scm:git:[email protected]:xwiki-contrib/{extensionrepository}.git</developerConnection>
93 <url>https://github.com/xwiki-contrib/{extensionrepository}</url>
94 </scm>
95 ...
96 <distributionManagement>
97 <repository>
98 <id>xwiki-staging</id>
99 <name>XWiki Staging Repository</name>
100 <url>http://nexus.xwiki.org/nexus/service/local/staging/deploy/maven2/</url>
101 </repository>
102 </distributionManagement>
103 ...
104 </project>
105 {{/code}}
106
107 Where ##{extensionrepository}## is the name of the repository in https://github.com/xwiki-contrib/.
108 )))
109 * Release the project with the maven release plugin(((
110 {{code language="none"}}
111 mvn release:prepare
112 mvn release:perform
113 {{/code}}
114 )))
115 * Ask for someone to promote your release (ie. make it available on maven.xwiki.org) in the thread you've created earlier
116 * After that your release will be available for download on maven.xwiki.org and anyone will be able to use it as a dependency for his own project

Get Connected