Marble/ServerUpload: Difference between revisions

    From KDE TechBase
    (Created page with "= Uploading the map theme to our KDE server = __TOC__ == Preparation == Create a zip file of your map theme. It's important that you create the map theme so that all sub...")
     
    Line 39: Line 39:


    == Adjusting the meta file  ==
    == Adjusting the meta file  ==
    Checkout the marble website sources:
    git clone [email protected]:websites/marble-kde-org
    then edit the file
    maps-v3.php      (newer marble versions since 2016)
    Copy one of the existing <stuff> tags as a template, e.g.:
      <stuff category="marble/data/maps">
        <name lang="en">Mars - 1886 - Schiaparelli.</name>
        <author>Giovanni Schiaparelli</author>
        <licence>Public domain</licence>
        <summary lang="en">A historical Mars map that shows the "mars canals" as seen by Giovanni Schiaparelli in 1886. Converted for use in Marble by Gábor Péterffy.</summary>
        <version>0.1</version>
        <releasedate>2012-1-13</releasedate>
        <preview lang="en">http://files.kde.org/marble/newstuff/maps/schiaparelli1886-preview.png</preview>
        <payload lang="en">http://files.kde.org/marble/newstuff/maps/schiaparelli1886-marblemap.zip</payload>
      </stuff> 
    or
      <stuff category="marble/data/maps">
        <name lang="en">OpenTopoMap</name>
        <author>OpenTopoMap</author>
        <licence>Creative Commons-by-SA 2.0</licence>
        <summary lang="en">A free topographic map which has been created from OpenStreetMap and SRTM data. The map style is inspired by official maps and focuses on legibility through high contrast and balanced signatures. Credits: Map data: © OpenStreetMap Contributors, SRTM | Map style: © OpenTopoMap.</summary>
        <version>0.2</version>
        <releasedate>2016-04-03</releasedate>
        <preview lang="en">http://files.kde.org/marble/newstuff/maps/opentopomap-preview.png</preview>
        <payload lang="en">http://files.kde.org/marble/newstuff/maps/opentopomap-marblemap.zip</payload>
      </stuff>
    Then commit and push your changes.

    Revision as of 08:42, 23 June 2016

    Uploading the map theme to our KDE server

    Preparation

    Create a zip file of your map theme. It's important that you create the map theme so that all subdirectories starting from the planet name (e.g. "earth") are included. So the directory structure inside your zip file should look like this:

    earth/schiaparelli1886/

    The directory name needs to match the id of the map theme file. The id of the map theme file should be lowercase. If the map theme refers to a historical map it should be named after the family name of the original creator of the map and the year in which it got created. For all other map themes go for a short and simple name that reflects the map well.

    Make sure that your zipped map theme file will then adhere to the following naming scheme:

    schiaparelli1886-marblemap.zip

    In addition to the zip file you also need the icon preview file. It should be named in the same way:

    schiaparelli1886-preview.png


    ssh into the server

    Initially you need to send your ssh public key to our sysadmins

    Once that is done you can

    ssh -l marble depot.kde.org

    Enter the directory

    ~/web/newstuff/maps

    and check the files inside using "ls" to get a better understanding of how the files are stored. Note that the .meta file is not needed anymore. Also recent Marble linux clients use the zip file instead of the tar-ball.

    Then log out again and copy your files directly:

    scp schiaparelli1886-* marble@depot:~/web/newstuff/maps

    Adjusting the meta file

    Checkout the marble website sources:

    git clone [email protected]:websites/marble-kde-org

    then edit the file

    maps-v3.php (newer marble versions since 2016)

    Copy one of the existing <stuff> tags as a template, e.g.:

     <stuff category="marble/data/maps">
       <name lang="en">Mars - 1886 - Schiaparelli.</name>
       <author>Giovanni Schiaparelli</author>
       <licence>Public domain</licence>
       <summary lang="en">A historical Mars map that shows the "mars canals" as seen by Giovanni Schiaparelli in 1886. Converted for use in Marble by Gábor Péterffy.</summary>
       <version>0.1</version>
       <releasedate>2012-1-13</releasedate>
       <preview lang="en">http://files.kde.org/marble/newstuff/maps/schiaparelli1886-preview.png</preview>
       <payload lang="en">http://files.kde.org/marble/newstuff/maps/schiaparelli1886-marblemap.zip</payload>
     </stuff>   
    

    or

     <stuff category="marble/data/maps">
       <name lang="en">OpenTopoMap</name>
       <author>OpenTopoMap</author>
       <licence>Creative Commons-by-SA 2.0</licence>
       <summary lang="en">A free topographic map which has been created from OpenStreetMap and SRTM data. The map style is inspired by official maps and focuses on legibility through high contrast and balanced signatures. Credits: Map data: © OpenStreetMap Contributors, SRTM | Map style: © OpenTopoMap.</summary>
       <version>0.2</version>
       <releasedate>2016-04-03</releasedate>
       <preview lang="en">http://files.kde.org/marble/newstuff/maps/opentopomap-preview.png</preview>
       <payload lang="en">http://files.kde.org/marble/newstuff/maps/opentopomap-marblemap.zip</payload>
     </stuff>
    

    Then commit and push your changes.