Marble/GoMarble/JJ: Difference between revisions

    From KDE TechBase
    No edit summary
    (29 intermediate revisions by 6 users not shown)
    Line 1: Line 1:
    ==Marble Junior Jobs==
    If you are new to Marble then you want to check this page. We list a few things you can do which are easy tasks and introduce you to Marble development.
    You can possible find some Junior Jobs at [https://bugs.kde.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=marble&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=junior-jobs&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= KDE's Bugzilla].


    If you are new to Marble then you want to check this page. We list a few things you can do which are easy tasks and introduce you to Marble development.
    == Marble Marketing Junior Jobs ==
    Check
     
    [http://www.google.de/search?as_q=Marble+KDE&hl=de&num=100&btnG=Google-Suche&as_epq=&as_oq=&as_eq=&lr=&cr=&as_ft=i&as_filetype=&as_qdr=d&as_occt=any&as_dt=i&as_sitesearch=&as_rights=&safe=images "Marble KDE"] results of the last 24 hours
     
    for interesting news items related to Marble. Then post these news to our Marble [http://www.facebook.com/#!/group.php?gid=346064806033 "Marble Facebook group"]. In the next step update our [http://marble.kde.org "Marble Website"] accordingly.


    ===Quality Assurance / Documentation===
    == Quality Assurance / Documentation ==
    We want our <i>Marble source code to look good</i>. The <i>documentation should be concise and helpful</i> and the comments shouldn't have spelling errors. Also it shouldn't have any obvious "formal" bugs. Help us to improve our code quality. This is an easy job that helps you to get familiar with the source code. It's the first thing that absolute beginners usually want to look at. We list a few important issues that need to be checked for <i>regularly</i>:
    We want our <i>Marble source code to look good</i>. The <i>documentation should be concise and helpful</i> and the comments shouldn't have spelling errors. Also it shouldn't have any obvious "formal" bugs. Help us to improve our code quality. This is an easy job that helps you to get familiar with the source code. It's the first thing that absolute beginners usually want to look at. We list a few important issues that need to be checked for <i>regularly</i>:


    Line 12: Line 18:
    * <b>Add comments</b>. You don't understand some source code in Marble? Then probably other people won't either. Try to understand it and ask Marble developers. The add some comments so that the next person will be able to understand the source code much easier (MEDIUM).
    * <b>Add comments</b>. You don't understand some source code in Marble? Then probably other people won't either. Try to understand it and ask Marble developers. The add some comments so that the next person will be able to understand the source code much easier (MEDIUM).
    * Create <b>API-Documentation</b> (EASY).
    * Create <b>API-Documentation</b> (EASY).
    * <b>Review the API</b>. Make sure that the API is Qt-ish (MEDIUM). Read http://doc.trolltech.com/qq/qq13-apis.html and read the Marble source code. Try to find cases which seem to be non-standard. (MEDIUM)  
    * <b>Review the API</b>. Make sure that the API is Qt-ish (MEDIUM). Read http://qt.gitorious.org/qt/pages/ApiDesignPrinciples and read the Marble source code. Try to find cases which seem to be non-standard. (MEDIUM)  
    * Read our <b>Marble Coding Standards</b>: http://websvn.kde.org/trunk/KDE/kdeedu/marble/CODING?revision=700337&view=markup. Ensure that the Marble source code follows it (EASY).
    * Read our <b>Marble Coding Standards</b>: http://websvn.kde.org/trunk/KDE/kdeedu/marble/CODING?revision=700337&view=markup. Ensure that the Marble source code follows it (EASY).
    * Help to <b>translate Marble into your own language</b>. Try to find "weird" translations or translations that don't express things in words that a normal user would understand and correct/report them (MEDIUM).
    * Help to <b>translate Marble into your own language</b>. Try to find "weird" translations or translations that don't express things in words that a normal user would understand and correct/report them (MEDIUM).
    Line 22: Line 28:




    ===KML===
    == Programmer Junior Jobs ==
    This section deals with junior jobs that deal with Marble's data structure:
    This section deals with junior jobs that require basic C++ skills: See https://bugs.kde.org/buglist.cgi?keywords=junior-jobs&keywords_type=allwords&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=marble
     
    ====Implement a "simple" tag for KML support (e.g. LookAt)====
    The <LookAt> tag in KML should be quite easy to implement -- at least compared to the other tags. Alternatively you can try to find a different tag that looks like it would be easy to implement, however you need to check in the handler or data directory whether it is implemented already.
    * Have a look at the KML reference:
     
    http://code.google.com/apis/kml/documentation/kmlreference.html#lookat
     
    * Have a look at Marble's geodata source (in marble/src/lib/geodata).
    * Try to understand what the parser, the handler and the data stuff does.
    * Create a new handler (EASY)
    * Try to wire Marble's MarbleMap::centerOn() command in a way that it would do what the lookat tag specifies.
     
    ===Fix the "Earth at Night" map===
    The earth at night map still shows some shading, when sun shading is enabled.
    * Make sure that the sun shading doesn't get rendered if the map is not supposed to show shading (EASY).
     
    ===Create an "Open Recent ..." menu entry===
    In marble/src/KdeMainWindow.cpp use
     
    http://api.kde.org/4.x-api/kdelibs-apidocs/kdeui/html/classKRecentFilesAction.html
     
    to create an open recent menu entry for the KDE version of Marble.
    Adding the same functionality to the Qt version of Marble is a bonus task.
     
    ===Marble Qt-only Version===
    There is a Marble version that only depends on Qt. The KDE version of Marble is always a bit ahead of the Marble Qt version as KDE is a pretty powerful framework. Still not everybody can and wants to use KDE libraries. And especially for our Windows and Mac packages the Marble Qt version is a lot smaller. So help us to bring the Marble Qt version on par with the Marble KDE version in terms of features. You need to look into marble/src/qtmain.cpp and marble/src/QtMainWindow.{cpp,h}
     
    * Add an Online Manual action to "About->Handbook for Marble Desktop Globe". This action should start a browser pointing to http://docs.kde.org/stable/en/kdeedu/marble/index.html. You can use the Qt class QDesktopServices to start the browser. (EASY)
    * Add the "Lock Position" functionality for the Info Boxes into the "View->Info Boxes" menu. (EASY)
    * Try to find a workaround solution for the GHNS feature "Download Maps". (HARD)
     
    ===Displaying Debug Info on request===
    <b>Harshit</b> is working on this JJ already
     
    * Have a look at:
     
    http://doc.trolltech.com/4.5/qtglobal.html#qInstallMsgHandler
     
    It would be nice if Marble would switch off all debug info by default. Only when passing the command line parameter --debug-info it should display the debug text.
     
    * In a second step one could change the MarbleWidget::setTileId method to a
     
    MarbleWidget::setDebugInfo( DebugFlags )
     
    method where DebugFlags is using QFlags
     
    http://doc.trolltech.com/4.5/qflags.html
     
    One could then set enable the qDebug messages by e.g. setting
     
    m_widget->setDebugInfo( DebugText | ShowTileID );
     
     
    Level of difficulty: EASY/MEDIUM
     
    ===Adding a planet filter===
     
    In marble/src/lib/MarbleControlBox.cpp, line 107-109 there are the lines:
     
        d->uiWidget.celestialBodyLabel->setVisible( false );
        d->uiWidget.celestialBodyComboBox->setVisible( false );
     
    comment them out on your local checkout (but don't commit this change until you have finished the implementation of this feature).
    After recompiling you should see a "Celestial Body" combo box above the Map Theme selection list view.
    * This Celestial Body combobox should always show the celestial bodies for which a theme is available. So it should NOT show all possible celestial bodies. And it should also NOT show all the planets in the solar system. It should just show those celestial bodies for which themes are available. It should be possible to find this information by extending the MapThemeManager class (which is located inside marble/src/lib/MapThemeManager{.cpp,.h}.
     
    * The map theme list view should be changed so that it will only show those themes which are provided for the planet that has been currently chosen. If the selected planet is changed by the user then the map themes that are shown in the listview should be replaced by the available map themes for the selected planet. Also the currently selected map theme should be changed to the first map theme that is available in the listview.
     
    Level of difficulty: HARD
     
    ===Adding Bookmarks===
    <b>Gaurav</b> is already working on this one.
     
    * It would be nice if Marble had its own bookmark feature: Like in Konqueror you'd be able to click Bookmark->Add Bookmark and the current position and zoom value would get stored as a bookmark. Once the user would click the bookmark item the original coordinate and zoom value would get restored. You can use MarbleWidget::centerLongitude(), MarbleWidget::centerLatitude(), MarbleWidget::zoom() and the setters for the same properties to retrieve and set the coordinates.
     
    Level of difficulty: HARD

    Revision as of 21:01, 10 March 2016

    If you are new to Marble then you want to check this page. We list a few things you can do which are easy tasks and introduce you to Marble development. You can possible find some Junior Jobs at KDE's Bugzilla.

    Marble Marketing Junior Jobs

    Check

    "Marble KDE" results of the last 24 hours

    for interesting news items related to Marble. Then post these news to our Marble "Marble Facebook group". In the next step update our "Marble Website" accordingly.

    Quality Assurance / Documentation

    We want our Marble source code to look good. The documentation should be concise and helpful and the comments shouldn't have spelling errors. Also it shouldn't have any obvious "formal" bugs. Help us to improve our code quality. This is an easy job that helps you to get familiar with the source code. It's the first thing that absolute beginners usually want to look at. We list a few important issues that need to be checked for regularly:

    • Try to find spelling errors in the source code comments and in Marble UI strings. (EASY)
    • KDE Krazy check: Have a look at the results of the static code checker: http://www.englishbreakfastnetwork.org/krazy/reports/kde-4.x/kdeedu/marble/index.html. Try to understand possible problems and create a fix for them. (EASY/MEDIUM)
    • Get rid of compile warnings: Compile Marble from scratch and check all the warnings that possibly appear. Try to get rid of the warnings by adding fixes. If parameters are not used, examine why and either remove them or hide the warning or leave it as it is. (EASY-MEDIUM)
    • Compile marble with the cmake option -DPEDANTIC=ON. Fix all errors that come up until Marble compiles through (MEDIUM).
    • Add comments. You don't understand some source code in Marble? Then probably other people won't either. Try to understand it and ask Marble developers. The add some comments so that the next person will be able to understand the source code much easier (MEDIUM).
    • Create API-Documentation (EASY).
    • Review the API. Make sure that the API is Qt-ish (MEDIUM). Read http://qt.gitorious.org/qt/pages/ApiDesignPrinciples and read the Marble source code. Try to find cases which seem to be non-standard. (MEDIUM)
    • Read our Marble Coding Standards: http://websvn.kde.org/trunk/KDE/kdeedu/marble/CODING?revision=700337&view=markup. Ensure that the Marble source code follows it (EASY).
    • Help to translate Marble into your own language. Try to find "weird" translations or translations that don't express things in words that a normal user would understand and correct/report them (MEDIUM).
    • Check KDE's Bugzilla for any open Marble bugs: https://bugs.kde.org/buglist.cgi?quicksearch=Marble. Try to reproduce the bugs and check whether the bugs are still valid. Remove them if they're not valid anymore and seem to be fixed already (EASY). Try to fix them if they are still valid (MEDIUM/HARD).

    If you come across a problem don't hesitate to ask us (there are no stupid questions, just people who are afraid of asking for stupid reasons ;-) If you want to send in your patch for review, please send it to our mailing list [email protected].


    Programmer Junior Jobs

    This section deals with junior jobs that require basic C++ skills: See https://bugs.kde.org/buglist.cgi?keywords=junior-jobs&keywords_type=allwords&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=marble