Hi,
(please send mails directly to the list, not to individuals)
As you can see from our documentation [1], XWiki uses maven [2][3] to build
its code. You can build the code using maven alone (run "mvn clean install"
[4]), so Eclipse or any other IDE is optional. If you want to import
*individual modules* in your IDE so that you can extend or fix them, you
can do so and then you can build that individual module. There is no point
in importing *all* the modules in your IDE since that would only use up
your computer`s memory. Even from the IDE, to build XWiki, you need to
import the correct module (e.g. xwiki-enterprise-jetty-hsqldb) and build
*only that* in order to get the built package.
The missing files you are referring to are not part of XWiki, but probably
come from a 3rd party dependency.
Also, make sure you get the correct sources, depending on what you want
(the latest development sources, the stable sources, the LTS sources,
version X sources, etc.). As Ecaterina mentioned, 8.2.2 is not an XWiki
released version, but is an in-development bugfix version. Another good
idea is to get the sources using git ("git clone ...") instead of getting a
sources zip file which will lose the ability to update to the latest
changes (i.e. versioning).
Make sure you get up to speed with how maven and git work and that you
understand what you want to achieve, since otherwise you might be wasting
time in the wrong direction, trying to do something unnecessarily complex
for the task you want to achieve.
Hope this helps and feel free to ask for help if you get stuck.
Thanks,
Eduard
----------
[1] http://dev.xwiki.org/xwiki/bin/view/Community/Building
[2] https://maven.apache.org/what-is-maven.html
[3] https://en.wikipedia.org/wiki/Apache_Maven
[4]
https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html
On Fri, Aug 26, 2016 at 6:07 PM, 既然 M.A.R.S <464503882(a)qq.com> wrote:
> I am a new XWiki developer and found XWiki just a few
> days ago. I downloaded the installer for windows,
> installed it in my computer and then start the XWiki
> using the start icon.After i try the demo, i think XWiki
> is awesome, So i want to learn and develop it .I want
> to know how the XWiki works, and i want to build the all
> source code myself and publish it to a server just
> like the same result as the installer.So, i referred the
> document from the site,followed the instruction step
> by step.Step ONE,I configured the JDK,Maven,Repository.Step
> TWO,I downloaded all the souce code,including common,
> platform,tools,enterprise.Step THREE, I unzip the
> archive and import them as maven project.The problem
> occurred in Step THREE, there are some files missing in
> some project(xwiki-platform-query-jpql-parser-8.2.2 ,etc),
> i searched the whole repository and found no result.Import everything is
> not recommended,but i want try to completely build xwiki
> myself,if not import enough source code,how could to
> build and generate a complete war file and publish to server?
>
> ---原始邮件---
> *发件人:* "Eduard Moraru"<enygma2002(a)gmail.com>
> *发送时间:* 2016年8月26日 18:06:45
> *收件人:* "XWiki Developers"<devs(a)xwiki.org>;
> *主题:* Re: [xwiki-devs]回复: XWiki-8.2.2 XWiki-8.2.2
>
> Hi,
>
> Please take the time to better explain your problem (how you got to that
> point, step by step, what errors did you get, what is your goal and why do
> you think it should be done like that, etc.), otherwise we can not
> understand how to help you.
>
> Also, please avoid sending the same message multiple times.
>
> Thanks,
> Eduard
>
> On Fri, Aug 26, 2016 at 12:07 PM, 既然 M.A.R.S <464503882(a)qq.com> wrote:
>
> > but some file i can't find in the source code, especially in the
> > xwiki-platform-query
> >
> >
> >
> >
> > ------------------ 原始邮件 ------------------
> > 发件人: "Ecaterina Moraru (Valica)";<valicac(a)gmail.com>;
> > 发送时间: 2016年8月26日(星期五) 下午5:03
> > 收件人: "XWiki Developers"<devs(a)xwiki.org>;
> >
> > 主题: Re: [xwiki-devs] XWiki-8.2.2 XWiki-8.2.2
> >
> >
> >
> > 8.2.2 is not released yet and not even sure we are going to release it.
> > http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/
> >
> > Thanks,
> > Caty
> >
> > On Fri, Aug 26, 2016 at 3:55 AM, 既然 M.A.R.S <464503882(a)qq.com> wrote:
> >
> > > i can't find a file named DepthFirstAdapter in this release version of
> > > 8.2.2
> > > _______________________________________________
> > > devs mailing list
> > > devs(a)xwiki.org
> > > http://lists.xwiki.org/mailman/listinfo/devs
> > >
> > >
> > _______________________________________________
> > devs mailing list
> > devs(a)xwiki.org
> > http://lists.xwiki.org/mailman/listinfo/devs
> > _______________________________________________
> > devs mailing list
> > devs(a)xwiki.org
> > http://lists.xwiki.org/mailman/listinfo/devs
> >
> _______________________________________________
> devs mailing list
> devs(a)xwiki.org
> http://lists.xwiki.org/mailman/listinfo/devs
>
Hi devs,
We have a known issue with users starting with XWiki and reading documentation on xwiki.org and trying out stuff. Like yesterday morning someone was following the SSX tutorial and couldn’t make it work. The issue was that the page he was creating to put his SSX xobject in, had been created as a non terminal page (our default) and the tutorial was telling him to do: $xwiki.jsx.use(‘XWiki.SkinExt”)…
We’ll have this issue everywhere and starting with XWiki 7.4+ we’ve made it very hard for users to start using the programming features of XWiki because of this (without mentioning that having to suffix with “WebHome” is not nice and natural).
So I was wondering if we could help our users with this. Here’s one idea:
* At the store API level (or just above in XWiki.getDocument()) do the following:
** try to load the passed reference as is and if it exists return it
** if it doesn’t exist and the passed reference doesn’t end with “WebHome", try to load the reference by adding “WebHome” to it
** if it doesn’t exist, return an empty doc (isNew = true) for the original reference asked (to be as backward compatible as possible)
What this means is that if a WebHome page exists it won’t be possible to create a terminal page of the same name as its space by using getDocument().
There won’t be problems for existing duplicates (ie a space and a terminal page named the same).
To solve this we could either introduce a new signature for getDocument() or introduce a TerminalDocumentReference class (that extends DocumentReference) and that the current getDocument() would understand as wanting a terminal document (we could use another name).
And thus we could use the new TerminalDocumentReference class for example in the Create Page UI when the “terminal” checkbox is checked, thus allowing users to be able to create both types for the same name.
I have the feeling that the small downside is really small compared to the advantages it would offer. For example it would solve the issue we have now with using a reference in macro. For example: {{include reference=“A.B.C.Mypage”/}} would work when MyPage is a NestedPage (i.e. A.B.C.MyPage.WebHome).
WDYT?
Thanks
-Vincent
PS: Related to this is http://design.xwiki.org/xwiki/bin/view/Proposal/DeprecatingSpaceAndSpaceRef… but that’s a lot more complex to implement and not for just now. The goal of this mail is to brainstorm about what we can do now.
I am a new XWiki developer and found XWiki just a few days ago. I downloaded the installer for windows,installed it in my computer and then start the XWiki using the start icon.After i try the demo, i think XWiki is awesome, So i want to learn and develop it .I want to know how the XWiki works, and i want to build the all source code myself and publish it to a server just like the same result as the installer.So, i referred the document from the site,followed the instruction step by step.Step ONE,I configured the JDK,Maven,Repository.Step TWO,I downloaded all the souce code,including common,platform,tools,enterprise.Step THREE, I unzip the archive and import them as maven project.The problem occurred in Step THREE, there are some files missing in some project(xwiki-platform-query-jpql-parser-8.2.2 ,etc),i searched the whole repository and found no result.Import everything is not recommended,but i want try to completely build xwiki myself,if not import enough source code,how could to build and generate a complete war file and publish to server?
Hello fellow developers,
many of you are developing XAR-packaged resources. The exchangeability
of these archives is one of the precious aspects of XWiki, I believe.
However, if one see all the many GitHub-contributed xar packages, the
source is not there: it's in a Wiki with which one would "open it". A
pity since much of the content is code.
I'd like to propose to allow XARs to be built form source code which is
true source that one edits.
Code files with their proper syntax coloring, editors, auto-completion,
search. Media-files that are edited with our tool of choice by a simple
double-click and not a complex pull, edit, and replace.
Thus, my proposal is to allow inclusions within the XML files.
Inclusions should be of type:
- text to include page content or object properties (e.g. css of cssx
objects)
- attachments to include attached objects
My current setup is documented here:http://jira.xwiki.org/browse/XWIKI-13643
It does binaryInclude to generate base64 and textInclude to generate
XML-text.
Thus, I can advertise a github project which is a macro and whose
complex function is in a velocity file that is in a .vm file. However, I
do not need to explode everything, e.g. the text-content describing the
macro or (in this case too small) translation set.
What do you think?
Should I rather generate complete attachment elements (name, length,
modif date, ...) instead of doing a binaryInclude that just generates
base64 ?
Is fetching files for inclusion beyond the boundaries of the project of
any use? (it is currently prohibited for safety)
thanks in advance.
Paul
Hi devs,
I’ve briefly looked at the source code of the XFF module (sources at https://github.com/xwiki-contrib/api-xff) and here’s what I think the status is.
Current Status
============
* A Maven plugin exists to package the sources in the XFF format into a XFF zip (.xff file). See http://extensions.xwiki.org/xwiki/bin/view/Extension/XFF+Maven+Plugin
* A Filter Stream filter exists (see http://extensions.xwiki.org/xwiki/bin/view/Extension/XFF+filter) for importing a XFF file (.xff file) into a running XWiki. You need to install the Filter Stream application to use it: http://extensions.xwiki.org/xwiki/bin/view/Extension/Filter+Application (input = the XFF filter, output = http://extensions.xwiki.org/xwiki/bin/view/Extension/Filter+XWiki+Instance+…).
Note: Since there exists a XAR Filter streams input/output filter already, we can convert a XFF zip (.xff file) into a XAR file (.xar file).
* A XFF REST API also exists to push a XFF file into a running XWiki. Apparently it uses the Filter Stream API to read the XFF file using the input filter and it uses the XWiki filter output filter as the output. However this REST API has to be used manually (curl)… So it’s a shortcut from having to install the Filter Streams Application in your wiki for importing an XFF file.
To summarize, right now you should be able to have an XFF structure in your maven project and import it into a running XWiki (either using curl or through the Filter Streams Application in your wiki).
What’s missing
============
* Lot of code cleanup ;)
* There doesn’t seem to be a XFF output filter so we cannot take as input an xwiki instance and as output a XFF file (nor convert from XAR to XFF). Thus, right now I don’t think we can do round-tripping
* The XFF format needs to be reviewed and discussed on the list for improving it. Apparently it’s possible to have content specified outside of the page.xml file (see https://github.com/xwiki-contrib/api-xff/blob/f0e32aae3e852e966b0d2bf6648c9…) but I’m not sure how this is working. In this example there’s both content defined in page.xml and in content.xwiki21. Not sure which one wins… It’s possible that this wasn’t fully implemented yet.
* I think it would be nice to have an XFF mojo to generate a XAR file (using the existing XAR Filter Stream filter).
* It would also be nice to have a mojo to publish directly the source content to a running XWiki instance, using the provided REST API. Instead of having to use curl manually to do that. Similarly, once a XFF output filter is coded, it would be nice to have a mojo to automatically retrieve the data from a running XWiki instance and save them in the sources.
Please correct me if I’m wrong!
Thanks
-Vincent
but some file i can't find in the source code, especially in the xwiki-platform-query
------------------ 原始邮件 ------------------
发件人: "Ecaterina Moraru (Valica)";<valicac(a)gmail.com>;
发送时间: 2016年8月26日(星期五) 下午5:03
收件人: "XWiki Developers"<devs(a)xwiki.org>;
主题: Re: [xwiki-devs] XWiki-8.2.2 XWiki-8.2.2
8.2.2 is not released yet and not even sure we are going to release it.
http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/
Thanks,
Caty
On Fri, Aug 26, 2016 at 3:55 AM, 既然 M.A.R.S <464503882(a)qq.com> wrote:
> i can't find a file named DepthFirstAdapter in this release version of
> 8.2.2
> _______________________________________________
> devs mailing list
> devs(a)xwiki.org
> http://lists.xwiki.org/mailman/listinfo/devs
>
>
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs