Marble/ServerUpload: Difference between revisions
*>Tackat phab |
m (10 revisions imported) |
||
| (8 intermediate revisions by one other user not shown) | |||
| Line 7: | Line 7: | ||
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: | 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/ | earth/opentopomap/ | ||
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. | 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. | ||
| Line 13: | Line 13: | ||
Make sure that your zipped map theme file will then adhere to the following naming scheme: | Make sure that your zipped map theme file will then adhere to the following naming scheme: | ||
opentopomap-marblemap.zip | |||
In addition to the zip file you also need the icon preview file. It should be named in the same way: | In addition to the zip file you also need the icon preview file. It should be named in the same way: | ||
opentopomap-preview.png | |||
'''When you UPDATE files later on''' make sure that you use a different file name for the new version, e.g.: | |||
opentopomap-marblemap-20160621.zip | |||
Otherwise the mirroring system will not propagate the changes to the file! | |||
== ssh into the server == | == ssh into the server == | ||
| Line 36: | Line 41: | ||
Then log out again and copy your files directly: | Then log out again and copy your files directly: | ||
scp | scp opentopomap-* marble@depot:~/web/newstuff/maps | ||
== Adjusting the meta file == | == Adjusting the meta file == | ||
| Line 45: | Line 50: | ||
then edit the file | then edit the file | ||
maps-v3. | maps-v3.xml | ||
Copy one of the existing <stuff> tags as a template, e.g.: | Copy one of the existing <stuff> tags as a template, e.g.: | ||
<stuff category="marble/data/maps"> | <stuff category="marble/data/maps"> | ||
| Line 73: | Line 65: | ||
</stuff> | </stuff> | ||
Then commit and push your changes. | Then commit and push your changes. The author should always reflect the original author (in case of historical maps e.g. the medieval person who drew the map). The person who created the map theme can be mentioned in the description (e.g. "Ported to Marble by Max Mapper.") | ||
Latest revision as of 08:05, 21 October 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/opentopomap/
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:
opentopomap-marblemap.zip
In addition to the zip file you also need the icon preview file. It should be named in the same way:
opentopomap-preview.png
When you UPDATE files later on make sure that you use a different file name for the new version, e.g.:
opentopomap-marblemap-20160621.zip
Otherwise the mirroring system will not propagate the changes to the file!
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 opentopomap-* 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.xml
Copy one of the existing <stuff> tags as a template, e.g.:
<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"></preview> <payload lang="en">http://files.kde.org/marble/newstuff/maps/opentopomap-marblemap.zip</payload> </stuff>
Then commit and push your changes. The author should always reflect the original author (in case of historical maps e.g. the medieval person who drew the map). The person who created the map theme can be mentioned in the description (e.g. "Ported to Marble by Max Mapper.")