Difference between revisions of "Developer's corner"

From GCompris
Jump to: navigation, search
(Branches)
(Design)
(108 intermediate revisions by 12 users not shown)
Line 1: Line 1:
== Branches ==
+
{{TOCright}}
 +
= Contact =
  
We use subversion for our development. Currently, the active branches are:
+
This page is about the '''Qt version'''. Follow there for the [[Developer's corner Gtk|Gtk+ legacy version]].
  
* 8.4.1 (svn trunk): The stable version.
+
== How to report a bug ==
* 8.3.4 (svn branches/GCOMPRIS_8_3): The stable version for Windows. This version exist only because I have not yet updated my build environment on Windows to support the gstreamer audio backend. Until I can build the 8.4 on Windows, I backport the main fixes and features from 8.4 in this branch.
 
* 8.5 (svn branches/gcomprixo): This is the current OLPC XO branch. It's a major refactoring to allow us to provide independent activities to the OLPC project, and others.
 
  
Technology test:
+
To fill a bug report for GCompris:
* svn branches/gcomprixogoo, based on gcomprixo branch, port of GCompris to use the [http://sourceforge.net/projects/goocanvas goocanvas] instead of the gnomecanvas+libart. Read the [http://library.gnome.org/devel/goocanvas/unstable/ API here].
 
  
To get GCompris from subversion:
+
* Legacy Gtk+ Version: [http://bugzilla.gnome.org/query.cgi gnome bugzilla] and select GCompris in the product list.
<code><pre>
+
* New Qt Quick version: [https://bugs.kde.org KDE bug tracker] and select GCompris in the product list or for [https://phabricator.kde.org/maniphest/query/0Xc51jhWJnw0/#R internal development we use Phabricator]
svn co http://svn.gnome.org/svn/gcompris/trunk gcompris
 
</pre></code>
 
  
== Documentation ==
+
== Mailing list ==
* [[GCompris internals]] gives an overview of the design of GCompris. It is a good starting point for anybody willing to contribute code.
 
* [[Adding an activity]]
 
  
== The Drawing board ==
+
You can join and browse the [https://mail.kde.org/mailman/listinfo/gcompris-devel GCompris mailing list].
 +
 
 +
This mailing list is used by the developers and users willing to stay aware of what’s going on. You will get new release announcements. Users can join the list and report bugs, discuss feature they would like to have, ...
 +
 
 +
The language is English. There is also a user mailing list in [https://mail.kde.org/mailman/listinfo/gcompris-france French] and in [https://lists.sourceforge.net/lists/listinfo/gcompris-portugues Portuguese]. If you want to create a user list in your language, please contact me (bruno.coudoin@gcompris.net).
 +
 
 +
== Chat ==
 +
 
 +
You can enter in contact with the users and developers of [http://en.wikipedia.org/wiki/IRC GCompris on IRC]. The server is irc.freenode.net on the channel #gcompris.
 +
 
 +
To join an IRC server, you can use the [https://hexchat.github.io excellent hexchat software] or [http://webchat.freenode.net/ directly in your browser].
 +
 
 +
= Development =
 +
 
 +
== Documentation of the Qt Quick Version (Under development) ==
 +
 
 +
This is a new version of GCompris based on the [http://doc.qt.io/qt-5/qtquick-index.html Qt Quick] technology. Our users expect us to deliver a version that runs on Desktop and on Tablets. Sadly with the Gtk+ version these was no easy way to achieve this. The decision has been taken to rewrite completely GCompris on a new framework. This is a departure from the Gtk+ development framework that was based on the C and the Python language. Now the development will be done with a mix of QML, JavaScript and C++.
 +
 
 +
The rewrite will not happen overnight and we need your help. If you are interesting in discovering the Qt Quick technology while doing something useful, you can do the port of a GCompris activity.
 +
 
 +
* Qt Quick [https://cgit.kde.org/gcompris.git/ official repository] or [https://github.com/gcompris/GCompris-qt GitHub mirror]
 +
* [[Qt Quick development process]]
 +
* [[Qt Quick Migration status]]
 +
* [[Contribution process]]
 +
* [[New contributor]]
 +
 
 +
=== Design ===
  
These are pages to hold the different discussion for thinks we are working on:
+
* [[Administration design]]
 +
* [[Dataset handling]]
 +
* [[Artwork guidelines]]
  
* [[Ideas of activities]]
+
=== Translation ===
* [[Star system review]]
 
* [[Requested Features]]
 
* [[GCompris work in progress]]
 
* [[Todo for 8.3]]
 
* [[Todo for 8.4]]
 
* [[Todo for 8.5]] (Also known as gcomprixo)
 
* [[Todo for OLPC]]/sugar future ? Review of sugar/OLPC activities and way to integrate.
 
* [[Notes on OSX port]]
 
* [[Tuxdroid]] is a little robot from [http://www.kysoh.com/ Kysoh] that would be fun to integrate with GCompris.
 
  
== Translations ==
+
Translations are managed by the [http://l10n.kde.org/ KDE translation teams]. If you would like to participate in the translation of GCompris you must contact the KDE translation team you want to participate in.
  
* GCompris translations are managed by the [http://l10n.gnome.org/teams/ Gnome translation teams].
+
* [http://l10n.kde.org/stats/gui/stable-kf5/po/gcompris_qt.po/ Translation status for the stable version]
* [[Voices translation]].
+
* [http://l10n.kde.org/stats/gui/trunk-kf5/po/gcompris_qt.po/ Translation status for the development version]
 +
* [http://websvn.kde.org/trunk/l10n-kf5/ To get the po file to translate], navigate in the subversion from the previous link, select your locale then go to the subdirectory messages/extragear-edu/.
 +
* [http://gcompris.net/voicestats Voice recording status] for each locale.
 +
* [[Word Lists Qt|Additional localized list of words]]
 +
* [[Advanced color translation]]
 +
* [[Voice translation Qt|Voice translation]]
 
* [[Web site translation]] is managed by volunteers.
 
* [[Web site translation]] is managed by volunteers.
  
 +
== The Drawing board ==
 +
 +
These are pages to hold the different discussion for things we are working on:
 +
 +
* [[Ideas for activities]]
 +
* [[Star system review]]
 +
* [[Language Learning]]
  
 
[[Category:Developer]]
 
[[Category:Developer]]
 +
[[Category:English]]

Revision as of 17:03, 21 August 2017

Contact

This page is about the Qt version. Follow there for the Gtk+ legacy version.

How to report a bug

To fill a bug report for GCompris:

Mailing list

You can join and browse the GCompris mailing list.

This mailing list is used by the developers and users willing to stay aware of what’s going on. You will get new release announcements. Users can join the list and report bugs, discuss feature they would like to have, ...

The language is English. There is also a user mailing list in French and in Portuguese. If you want to create a user list in your language, please contact me (bruno.coudoin@gcompris.net).

Chat

You can enter in contact with the users and developers of GCompris on IRC. The server is irc.freenode.net on the channel #gcompris.

To join an IRC server, you can use the excellent hexchat software or directly in your browser.

Development

Documentation of the Qt Quick Version (Under development)

This is a new version of GCompris based on the Qt Quick technology. Our users expect us to deliver a version that runs on Desktop and on Tablets. Sadly with the Gtk+ version these was no easy way to achieve this. The decision has been taken to rewrite completely GCompris on a new framework. This is a departure from the Gtk+ development framework that was based on the C and the Python language. Now the development will be done with a mix of QML, JavaScript and C++.

The rewrite will not happen overnight and we need your help. If you are interesting in discovering the Qt Quick technology while doing something useful, you can do the port of a GCompris activity.

Design

Translation

Translations are managed by the KDE translation teams. If you would like to participate in the translation of GCompris you must contact the KDE translation team you want to participate in.

The Drawing board

These are pages to hold the different discussion for things we are working on: