Edycja

Z UMP

(Różnice między wersjami)
d (hinty na swojej stronie (już była))
Aktualna wersja (10:39, 14 sty 2016) (edytuj) (anuluj zmianę)
d (Jak już dostaniesz hasło do cvs)
 
(Nie pokazano 28 wersji pośrednich.)
Linia 1: Linia 1:
-
draft!!
+
Rzeczy potrzebne raczej dopiero edytorom z prawem zapisu w cvs.
-
 
+
-
 
+
-
Źródła map trzymane są w wielu różnych plikach, aby było nimi łatwiej zarządzać, a także by można pracować na mniejszych fragmentach danych, "odfiltrowując sobie te, które chwilowo nie są potrzebne.
+
-
Z tego względu zanim rozpoczniesz edycję wybranego fragmentu mapy z jej jednego lub kilku interesujących obszarów, konieczne jest użycie odpowiednich narzędzi, które posklejają odpowiednie pliki źródłowe w całość nadającą się do edycji, a po jej zakończeniu - rozłożą poprawioną mapę z powrotem na poszczególne pliki źródłowe i dostarczą raport o tym, co się zmieniło, aby można było zmienione pliki wysłać do repozytorium CVS.
+
-
 
+
-
Najbardziej podstawowym programem do montowania/demontowania map jest program mont-demont-multi2.pl lub jego uboższa awk-owa wersja.
+
-
Programów tych nie musisz jednak wołać "ręcznie" - w systemie Windows służą do tego odpowiednie skrypty w plikach .bat, natomiast w uniksach - odpowiednie opcje dla programu <code>make</code> zapisane w pliku Makefile.common ("make help" pokaże wszystkie dostępne).
+
-
We wszystkich systemach (unix & windows) dostępny jest także perlowy skrypt mdm-gui.pl będący okienkowym interfejsem do montowania/demontażu źródeł.
+
-
 
+
-
==Jak dodać lub usunąć plik?==
+
-
Jak dodać: stwórz pusty plik (o nazwie zgodnej z [[Znaczenie_plików_w_projekcie_UMP|konwencją]]), wydaj polecenia ''cvs add nazwapliku; cvs commit'' (plik binarny: dodaj ''-kb''). Wrzucaj zawartość, commituj.
+
-
 
+
-
Jak usunąć: skasuj plik z dysku, wydaj polecenia ''cvs remove nazwapliku; cvs commit''.
+
-
Użytkownik nie może kasować katalogów.
+
-
 
+
-
== Perl ==
+
-
Po pierwsze musisz sobie zainstalować perla ([[Perl|Perl w UMP]])
+
-
A potem wystarczy zamiast mont-demont.bat używać mont-demont.perl.bat
+
== Edycja kilku obszarów naraz ==
== Edycja kilku obszarów naraz ==
Linia 42: Linia 24:
* W systemie UNIX - ustaw zmienną "DIR" tak, aby zawierała nazwy kilku regionów, na przykład:
* W systemie UNIX - ustaw zmienną "DIR" tak, aby zawierała nazwy kilku regionów, na przykład:
-
export DIR="UMP-JeleniaGora UMP-GorzowWlkp UMP-Szczecin"
+
export DIR="UMP-PL-JeleniaGora UMP-PL-GorzowWlkp UMP-PL-Szczecin"
a następnie dokonuj montowania/demontowania tak jak normalnie ("make mont", edycja, "make demont", "make commit").
a następnie dokonuj montowania/demontowania tak jak normalnie ("make mont", edycja, "make demont", "make commit").
-
Możesz też użyć mdm-gui.pl opisanego powyżej.
+
Możesz też użyć mdm-gui.pl opisanego powyżej. Jeśli rysujesz drogi, które przechodzą przez granice obszaru z jednego na drugi, koniecznie przeczytaj [[Rysowanie_poza_obszar]], żeby się dowiedzieć jak to robić poprawnie, a także [[Międzymapowy_routing_w_GARMIN-ie]], by się dowiedzieć jak to działa.
 +
 
 +
== Sprawdzanie ogólnej kondycji regionu ==
 +
Służy do tego skrypt "sprawdz_bledy.bat" - dwukliknij i czytaj.
 +
Pod uniksem, analogiczny <code>make sprawdz</code>.
 +
A więcej opisów jest [[Sprawdz_bledy|tam]].
 +
 
 +
==Jak już dostaniesz hasło do cvs==
 +
...to jeszcze tylko kilka drobiazgów, z którymi mogłeś się nie spotkać:
 +
 
 +
* Ściągnięcie źródeł jako nazwany użytkownik, a nie gość bez praw
 +
Najpierw skasuj całe repozytorium czyli pliki pobrane przez cvs. Tak, całe. Zaloguj się do cvs i ściągnij od nowa. Przydatne polecenia, jeśli nie używasz klientów graficznych:
 +
cvs login
 +
cvs co all (co=checkout) albo zamiast all: narzedzia, POLSKA, EUROPA, UMP-Egipt
 +
cvs co -c; sprawdzenie modułów
 +
cvs com (com=commit) - pamiętaj o dopisywaniu opisów do wysyłek
 +
cvs logout
 +
Jeśli to pominiesz, to potem nie uda się próba wysłania na serwer, bo CVS zapisuje sobie nazwę użytkownika w plikach o nazwie "Root", więc jeśli miałeś repozytorium ściągnięte z konta "guest", to taka informacja tam została zapisana i próba wysłania się nie powiedzie.
 +
 
 +
* Co czytać?<br/>Na pewno listę dyskusyjną ump@, gdzie (poza dyskusjami) są wysyłane
 +
** raporty gorszych błędów, często blokujących przetwarzanie mapy lub jej prawidłowe działanie - wypada po sobie poprawić!
 +
** ogłoszenia o nowych narzędziach czy ich funkcjach, ustaleniach "politycznych" itp.<br/>Do tego możesz się zapisać na:
 +
** jeśli chcesz obrabiać także zgłoszenia innych: [http://ump.waw.pl/mailman/listinfo/ump-wrzuty listę Wrzuty] i/lub [http://ump.waw.pl/mailman/listinfo/ump-remonty Remonty]
 +
** [http://ump.waw.pl/mailman/listinfo/ump-devel listę developerską], gdzie są dyskusje o nowych narzędziach przed ich ogłoszeniem (często niestrawne dla nie-informatyka;)
 +
** [http://ump.waw.pl/mailman/listinfo/ump-wawa listę warszawską] albo [http://ump.waw.pl/mailman/admin/ump-krk listę krakowską]
 +
 
 +
* Jak często robić update
 +
Zawsze na początku pracy i tuż przed commitem (no, jeszcze wypada zmontować i rozmontować mapę pomiędzy update i commitem oraz sprawdzić, czy nie zostały jakieś błędy). Przy dłuższej pracy także podczas przerw, ale TYLKO WTEDY, gdy rozmontowałeś wcześniej źródła i umieściłeś poprawki w katalogu src.
 +
Jeśli zrobisz <code>cvs update</code> w trakcie edycji, zapiszesz swoje zmiany, a potem rozmontujesz źródła, to [[Nadpisanie|nadpiszesz]] poprawki wprowadzone przez <code>update</code>, a więc skasujesz czyjąś pracę.
 +
 
 +
*Jak często robić commit
 +
Po zakończeniu pracy stanowiącej jakąś całość. Najlepiej dzielić pracę na względnie małe kawałki, commit trwa tylko chwilę, a od razu pokazuje innym naszą pracę i zapobiega w ten sposób zderzeniom (patrz następny punkt).
 +
 
 +
*W pliku pojawiły się jakieś linijki z "<<<<<" "=====" i ">>>>>"
 +
To jest [[Konflikt|konflikt]]. Jednocześnie z kimś edytowałeś te same linijki pliku lub koniec pliku. Ty zrobiłeś update, cvs ściągnął drugą wersję tej samej linijki, i nie wie która jest lepsza. Między wspomnianymi linijkami widzisz swoją i czyjaś pracę. Sam wybierz którą zachować. Jeśli dwie osoby po prostu dopisały nowe obiekty na koniec pliku, to zachowuje się oczywiście wszystkie.
 +
W razie niepewności dopytaj kogoś doświadczonego.
 +
 
 +
*Używaj [[Paczuj|paczuj]]
 +
Tego narzędzia nie znasz, bo nie miałeś praw zapisu - zobaczysz jak prosto będzie się dało rysować i wrzucać zmiany korzystając z '''paczuj'''.
 +
 
 +
*Zacznij od czegoś prostego
 +
Brzmi jak banał - ale '''po prostu narysuj jedną drogę i spróbuj zsynchronizować źródła, i wysłać zmiany''' - czy przy pomocy [[CVS|cvs]], czy [[paczuj]], czy klienta graficznego [[CVS|cvs]]. Nawet jeżeli coś pójdzie nie tak, to ani dużo się "nie zepsuje", ani dużo nie stracisz, a każda kolejna zmiana będzie powtórzeniem tej pierwszej, której się nauczysz.
 +
 
 +
==Działania z cvs==
 +
[[CVS|Na osobnej stronie]].
 +
 
 +
==Przykazania edytora==
 +
# Czytać co wypisuje sprawdzacz przy demontowaniu, poprawiać błędy. Uruchomić co jakiś czas [[Sprawdz_bledy]] lub odpowiedni [[Makefile.common#Sprawdzanie_mapy|make]]. Jeżeli używasz [[Paczuj|paczuja]] to problem masz z głowy - błędy są sprawdzane przy każdym montowaniu mapy.
 +
# [[Co-czym#Wyszukiwanie_punkt.C3.B3w|Dopisywać miasto do POI]]
 +
# [[Znaczniki|Stawiać bojki]]
 +
# Poprawiać literówki i typy przy realizacji zgłoszeń z flyspraya. Nie wrzucać 1:1 wszystkiego co podesłano - to my wiemy, jakie są zasady i konwencje.
 +
# Dodawać dane adresowe i wszelkie możliwe do zgłoszeń z FlySpry o ile autor wrzutki o to nie zadbał.
 +
# Do plików dedykowanych wrzucać tylko to, co jest dla nich dedykowane (szczególnie stacje BP/Orlen, bankomaty, szlaki)
 +
# Remonty:
 +
## Nanosząc remont stawiać znacznik (punkt REMONT z opisem FS#numer) i otwierać zgłoszenie na Flyspray, projekt Remonty
 +
## Usuwając remont (znacznik REMONT z numerem FS# i wyłączenia ulic) zamykać zgłoszenie na Flyspray (ale dopiero po upewnieniu się, że to już wszystkie znaczniki i komentarze z tym numerem FS#)
 +
# Czytać diffy, nawet własne. Uważać co się wysyła do cvs. Nie wrzucać zmian z bzdurami, [[Konflikt|konfliktami]] albo z zaokrąglonymi współrzędnymi.
 +
# Dawać komentarze przy wysyłaniu zmian do cvs (domyślnie jest pusty notatnik co oznacza pusty komentarz). Komentarz powinien coś dawać, a nie np. "diffy kolegi".
 +
# Komentarze do cvs powinny być bez polskich znaków diakrytycznych.
 +
# Czytać listę ump@ i reagować na błędy, szczególnie własne.
 +
# '''NIGDY''' nie wykonywać aktualizacji źródeł mając zmontowaną mapę, edytując ją. Może dojść do [[Nadpisanie|nadpisania czyjejś pracy]]
== Sprawdzanie co i gdzie autor diffów namotał ==
== Sprawdzanie co i gdzie autor diffów namotał ==
czyli jak obejrzeć, co w tych diffach zostało podesłane.
czyli jak obejrzeć, co w tych diffach zostało podesłane.
-
Kroki poniżej automagicznie załatwia paczuj.bat pod system win32, jednak przeglądanie diffów zostaje.
+
'''Automatyczne dodanie diffów'''. Automagicznie załatwia to paczuj.bat pod system win32, jednak przeglądanie diffów zostaje. Z paczuj.bat wygląda to tak:
 +
# zadbaj o czysty katalog regionu - niech nie będzie żadnych diffów (jeżeli będą diffy to zostaną użyte przez paczuj.bat), żadnych plików źródłowych,
 +
# uaktualnij źródła - cvs_update.bat na Windows;
 +
# wrzuć do katalogu regionu diffy (nie do podkatalogu src, tylko w głównym regionu) - albo wszystkie diffy jeżeli jest ich niewielka ilość, albo dorzucaj po jednym lub np. same POI; paczuj.bat scalając dane usunie te diffy;
 +
# sprawdź co jest w diffach - byś wiedział gdzie ew. szukać zmian jeżeli zmian jest mało, możesz zauważyć podstawowe błędy, np. brak miasta, błędny zapis ulicy, cokolwiek;
 +
# uruchom paczuj.bat (**1**) - doda zmiany do źródeł najpierw na sucho - bez miany źródeł; przerwij lub naciśnij dowolny klawisz, później zmiana zostanie naniesiona (w katalogu src pliki będą zawierać już zmiany) - pliki diff znikają; jeszcze raz klawisz i następuje montowanie i edycja w domyślnym edytorze;
 +
# jak wygląda po zmontowaniu rzuć okiem niżej;
 +
# jak skończysz przeglądać i wydaje się, że jest ok to zamknij MapEdit - jeżeli wykonałeś zmiany i chcesz by były zachowane to zgódź się na zapis;
 +
# następuje rozmontowanie;
 +
# jeżeli po rozmontowaniu pojawiły się nowe diffy to paczuj to zasygnalizuje i poprosi o ponowne uruchomienie - tu działanie paczuj.bat się kończy, musisz wrócić do (**1**);
 +
# jeżeli po rozmontowaniu nie pojawiły się nowe diffy to po naciśnięciu dowolnego klawisza powinien uruchomić się proces wprowadzania zmian na serwer
 +
# jeżeli proces wprowadzania zmian nie uruchomi się automatycznie to musisz to wykonać ręcznie, czyli to co zwykle :)
-
Najpierw diffy po prostu przejrzyj, żeby wyłapać grube błędy albo takie niewidoczne pod Mapedit (np. zdublowanie komentarzy, albo edycja z włączonym Snap to grid).
+
'''Półautomatyczne dodanie diffów''' - najpierw diffy po prostu przejrzyj, żeby wyłapać grube błędy albo takie niewidoczne pod Mapedit (np. zdublowanie komentarzy, albo edycja z włączonym Snap to grid, którą widać jako zmianę większości współrzędnych na ostatniej cyfrze).
* Windows
* Windows
# zmontuj plik Rejon-wynik.mp ("mont-demont /mont" albo po prostu dwuklik w mont-demont i zamknij bez zmieniania)
# zmontuj plik Rejon-wynik.mp ("mont-demont /mont" albo po prostu dwuklik w mont-demont i zamknij bez zmieniania)
Linia 62: Linia 115:
# oglądaj i analizuj, pomagając sobie klawiszem E (ukrywa i pokazuje załączniki, w tym wypadku pogrubienia zmienianych miejsc)
# oglądaj i analizuj, pomagając sobie klawiszem E (ukrywa i pokazuje załączniki, w tym wypadku pogrubienia zmienianych miejsc)
# rozmontuj, i jeśli robiłeś poprawki, to zrób to co zwykle.
# rozmontuj, i jeśli robiłeś poprawki, to zrób to co zwykle.
-
 
-
== Sprawdzanie ogólnej kondycji regionu ==
 
-
Służy do tego skrypt "sprawdz_bledy.bat" - dwukliknij i czytaj.
 
-
Pod uniksem, analogiczny <code>make sprawdz</code>.
 
-
A więcej opisów jest [[Sprawdz_bledy|tam]].
 
-
 
-
==Jak już dostaniesz hasło do cvs==
 
-
Najpierw skasuj całe repozytorium czyli pliki pobrane przez cvs. Tak, całe. Zaloguj się do cvs i ściągnij od nowa. Przydatne polecenia:
 
-
cvs login
 
-
cvs co all (co=checkout)
 
-
cvs com (com=commit)
 
-
cvs logout
 
-
*Jak często robić update
 
-
Zawsze na początku pracy i tuż przed commitem (no, jeszcze wypada zmontować i rozmontować mapę pomiędzy update i commitem oraz sprawdzić, czy nie zostały jakieś błędy). Przy dłuższej pracy także podczas przerw, ale TYLKO WTEDY, gdy rozmontowałeś wcześniej źródła.
 
-
Jeśli zrobisz <code>cvs update</code> w trakcie edycji, zapiszesz swoje zmiany, a potem rozmontujesz źródła, to nadpiszesz poprawki wprowadzone przez <code>update</code>, a więc skasujesz czyjąś pracę.
 
-
*Jak często robić commit
 
-
Po zakończeniu pracy stanowiącej jakąś całość. Najlepiej dzielić pracę na względnie małe kawałki, commit trwa tylko chwilę, a od razu pokazuje innym naszą pracę i zapobiega w ten sposób zderzeniom.
 
-
*W pliku pojawiły się jakieś linijki z "<<<<<" "=====" i ">>>>>"
 
-
Jednocześnie z kimś edytowałeś te same linijki pliku. Ty zrobiłeś update, cvs ściągnął drugą wersję tej samej linijki, i nie wie która jest lepsza. Między wspomnianymi linijkami widzisz swoją i czyjaś pracę. Sam wybierz która wersja jest lepsza.
 
-
 
-
Jeśli obszar między "<<<<<" a ">>>>>" występuje na samym końcu pliku, to bardzo możliwe, że niezależnie od siebie dodaliście coś na końcu, tworząc nowe obiekty (jeśli to jest jedyny obszar konfliktowy, to jest na to bardzo duża szansa).
 
-
W takim wypadku prawdopodobnie należy zostawić wszystkie, zarówno te twoje, jak i cudze.
 
-
Ale nie zawsze! - jeśli jakiś obiekt zostanie podzielony na części, to te części trafiają na koniec pliku, a oryginalny obiekt jest kasowany.
 
-
Porównaj więc dokładnie obie wersje i wtedy dopiero zdecyduj.
 
-
 
-
*hinty
 
-
Na [[CVS|osobnej stronie]].
 
==Czym się można podpierać?==
==Czym się można podpierać?==
Zgłoszenie jest niejasne. Trak chaotyczny. Miejsce skomplikowane. Nie pamiętam jak tam dokładnie wyglądało. Kurcze, jak skołować więcej informacji?
Zgłoszenie jest niejasne. Trak chaotyczny. Miejsce skomplikowane. Nie pamiętam jak tam dokładnie wyglądało. Kurcze, jak skołować więcej informacji?
-
* [[Mapedit]] zarejestrowany wyświetla mapy Google
+
* [[Mapedit]] wyświetla różne podkłady (w tym google, OSM, a nawet masstracks)
* [http://mapa.ump.waw.pl/ump-www/ Mapa UMP na WWW] - korzystając z plusika po prawej stronie możesz obejrzeć wybrany obszar na UMPie, albo zmienić podkład na Google lub OSM i porównać. Jeśli oglądasz zgłoszenie z FlySpray-a, kliknij na opcji "Pokaż na mapie", żeby załączony ślad/punkty pojawiły się na podkładzie UMP-a.
* [http://mapa.ump.waw.pl/ump-www/ Mapa UMP na WWW] - korzystając z plusika po prawej stronie możesz obejrzeć wybrany obszar na UMPie, albo zmienić podkład na Google lub OSM i porównać. Jeśli oglądasz zgłoszenie z FlySpray-a, kliknij na opcji "Pokaż na mapie", żeby załączony ślad/punkty pojawiły się na podkładzie UMP-a.
* [http://maps.geoportal.gov.pl/webclient/ geoportal]
* [http://maps.geoportal.gov.pl/webclient/ geoportal]
 +
* [http://www.punktyadresowe.pl/ mapy punktów adresowych]
* [http://www.pkt.pl/map.html PKT] (bardzo szczegółowe i dość świeże zdjęcia!)
* [http://www.pkt.pl/map.html PKT] (bardzo szczegółowe i dość świeże zdjęcia!)
* [http://www.zumi.pl/ Zumi] i widok satelitarny
* [http://www.zumi.pl/ Zumi] i widok satelitarny
Linia 103: Linia 130:
**[http://www.mapa.lodz.pl/ Łódź]
**[http://www.mapa.lodz.pl/ Łódź]
**[http://www.gis.piotrkow.pl/piotrkowsip/ Piotrków Trybunalski]
**[http://www.gis.piotrkow.pl/piotrkowsip/ Piotrków Trybunalski]
 +
**[http://87.199.34.18:10081/portal/ Bełchatów]
**[http://www.city.poznan.pl/mapa_geopoz/index.php?action=1 Poznań]
**[http://www.city.poznan.pl/mapa_geopoz/index.php?action=1 Poznań]
**[http://gis.um.szczecin.pl/UMSzczecinGIS/chapter_85000.asp Szczecin]
**[http://gis.um.szczecin.pl/UMSzczecinGIS/chapter_85000.asp Szczecin]
Linia 111: Linia 139:
* jeśli nie obędzie się bez wizji lokalnej, można [http://www.garniak.pl/viewtopic.php?f=28&t=6978 poprosić kogoś o pomoc].
* jeśli nie obędzie się bez wizji lokalnej, można [http://www.garniak.pl/viewtopic.php?f=28&t=6978 poprosić kogoś o pomoc].
Pamiętaj, że zdjęcia satelitarne mają przynajmniej pół roku, często dużo więcej, a my chcemy mieć mapę aktualną. '''Nie podpieramy''' się obcymi mapami w kwestii routingu czy nawet przebiegu ulic. Drogowcy są szybsi, niż te produkty.
Pamiętaj, że zdjęcia satelitarne mają przynajmniej pół roku, często dużo więcej, a my chcemy mieć mapę aktualną. '''Nie podpieramy''' się obcymi mapami w kwestii routingu czy nawet przebiegu ulic. Drogowcy są szybsi, niż te produkty.
 +
 +
===Zapytaj w urzędzie===
 +
 +
Kilka tego typu pism jest [[Zewnętrzne_źródła_danych|tutaj]].
 +
 +
[http://forum.openstreetmap.org/viewtopic.php?pid=316690#p316690 Przykład z OSM].
===Inne mapy===
===Inne mapy===
Linia 123: Linia 157:
** [http://automapa.pl/ Automapa]
** [http://automapa.pl/ Automapa]
* z bazy [http://emapa.pl/ Emapy] korzystają:
* z bazy [http://emapa.pl/ Emapy] korzystają:
 +
** [http://emapi.pl/ emapi] (produkt Emapy)
** [http://www.docelu.pl DoCelu] (Wirtualna Polska)
** [http://www.docelu.pl DoCelu] (Wirtualna Polska)
** [http://www.imapa.pl/ IMapa]
** [http://www.imapa.pl/ IMapa]
Linia 128: Linia 163:
** MioMap
** MioMap
** [http://pkt.pl/ pkt.pl]
** [http://pkt.pl/ pkt.pl]
-
* z bazy [http://www.teleatlas.com/WhyTeleAtlas/ContactUs/Europe/Poland/index.htm Teleatlas] korzysta:
+
* z bazy [http://www.teleatlas.com/WhyTeleAtlas/ContactUs/Europe/Poland/index.htm Teleatlas] (obecnie TomTom) korzysta:
** [http://routes.tomtom.com/t/#/ TomTom]
** [http://routes.tomtom.com/t/#/ TomTom]
** [http://maps.google.pl/ Google] (także z [http://www.ppwk.pl/ PPWK] i [http://www.transnavi.com/ Trans Navicom])
** [http://maps.google.pl/ Google] (także z [http://www.ppwk.pl/ PPWK] i [http://www.transnavi.com/ Trans Navicom])
** [http://www.viamichelin.pl/viamichelin/pol/htm/hme/Homepage_lite.htm Via Michelin]
** [http://www.viamichelin.pl/viamichelin/pol/htm/hme/Homepage_lite.htm Via Michelin]
-
* z bazy [http://www.navteq.com/ Navteq] korzysta
+
* z bazy [http://www.navteq.com/ Navteq] (obecnie Nokia kupiona przez Microsoft) korzysta
** [https://buy.garmin.com/shop/shop.do?pID=6299 CNE]
** [https://buy.garmin.com/shop/shop.do?pID=6299 CNE]
** [http://maps.ovi.com/services/ Nokia]
** [http://maps.ovi.com/services/ Nokia]
 +
 +
[[Kategoria:Rysowanie]]
 +
[[Kategoria:Tworzenie mapy]]
 +
[[Kategoria:Linux]]
 +
[[Kategoria:Narzędzia]]

Aktualna wersja

Rzeczy potrzebne raczej dopiero edytorom z prawem zapisu w cvs.

Spis treści

Edycja kilku obszarów naraz

  • skrypt mdm-gui.pl (dostępny w cvs/narzedzia)

Grafika:mdm.png

sposób pracy:

  • uruchom (wymagany perl)
  • zaznacz wybrane obszary
  • kliknij na Montuj, edytuj, Demontuj

ALBO

Grafika:Jamond.png

sposób pracy:

  • uruchom (wymagana java)
  • sprawdź ew. popraw ustawienia (menu narzędzia)
  • zaznacz obszary, które chcesz edytować: menu regiony (jeśli nie ma żadnego, to poplątałeś ścieżki w ustawieniach)
  • edytuj: guzik mapedit
  • ...

ALBO

  • W systemie UNIX - ustaw zmienną "DIR" tak, aby zawierała nazwy kilku regionów, na przykład:
 export DIR="UMP-PL-JeleniaGora UMP-PL-GorzowWlkp UMP-PL-Szczecin"

a następnie dokonuj montowania/demontowania tak jak normalnie ("make mont", edycja, "make demont", "make commit"). Możesz też użyć mdm-gui.pl opisanego powyżej. Jeśli rysujesz drogi, które przechodzą przez granice obszaru z jednego na drugi, koniecznie przeczytaj Rysowanie_poza_obszar, żeby się dowiedzieć jak to robić poprawnie, a także Międzymapowy_routing_w_GARMIN-ie, by się dowiedzieć jak to działa.

Sprawdzanie ogólnej kondycji regionu

Służy do tego skrypt "sprawdz_bledy.bat" - dwukliknij i czytaj. Pod uniksem, analogiczny make sprawdz. A więcej opisów jest tam.

Jak już dostaniesz hasło do cvs

...to jeszcze tylko kilka drobiazgów, z którymi mogłeś się nie spotkać:

  • Ściągnięcie źródeł jako nazwany użytkownik, a nie gość bez praw

Najpierw skasuj całe repozytorium czyli pliki pobrane przez cvs. Tak, całe. Zaloguj się do cvs i ściągnij od nowa. Przydatne polecenia, jeśli nie używasz klientów graficznych:

cvs login
cvs co all (co=checkout) albo zamiast all: narzedzia, POLSKA, EUROPA, UMP-Egipt
cvs co -c; sprawdzenie modułów
cvs com (com=commit) - pamiętaj o dopisywaniu opisów do wysyłek
cvs logout

Jeśli to pominiesz, to potem nie uda się próba wysłania na serwer, bo CVS zapisuje sobie nazwę użytkownika w plikach o nazwie "Root", więc jeśli miałeś repozytorium ściągnięte z konta "guest", to taka informacja tam została zapisana i próba wysłania się nie powiedzie.

  • Co czytać?
    Na pewno listę dyskusyjną ump@, gdzie (poza dyskusjami) są wysyłane
    • raporty gorszych błędów, często blokujących przetwarzanie mapy lub jej prawidłowe działanie - wypada po sobie poprawić!
    • ogłoszenia o nowych narzędziach czy ich funkcjach, ustaleniach "politycznych" itp.
      Do tego możesz się zapisać na:
    • jeśli chcesz obrabiać także zgłoszenia innych: listę Wrzuty i/lub Remonty
    • listę developerską, gdzie są dyskusje o nowych narzędziach przed ich ogłoszeniem (często niestrawne dla nie-informatyka;)
    • listę warszawską albo listę krakowską
  • Jak często robić update

Zawsze na początku pracy i tuż przed commitem (no, jeszcze wypada zmontować i rozmontować mapę pomiędzy update i commitem oraz sprawdzić, czy nie zostały jakieś błędy). Przy dłuższej pracy także podczas przerw, ale TYLKO WTEDY, gdy rozmontowałeś wcześniej źródła i umieściłeś poprawki w katalogu src. Jeśli zrobisz cvs update w trakcie edycji, zapiszesz swoje zmiany, a potem rozmontujesz źródła, to nadpiszesz poprawki wprowadzone przez update, a więc skasujesz czyjąś pracę.

  • Jak często robić commit

Po zakończeniu pracy stanowiącej jakąś całość. Najlepiej dzielić pracę na względnie małe kawałki, commit trwa tylko chwilę, a od razu pokazuje innym naszą pracę i zapobiega w ten sposób zderzeniom (patrz następny punkt).

  • W pliku pojawiły się jakieś linijki z "<<<<<" "=====" i ">>>>>"

To jest konflikt. Jednocześnie z kimś edytowałeś te same linijki pliku lub koniec pliku. Ty zrobiłeś update, cvs ściągnął drugą wersję tej samej linijki, i nie wie która jest lepsza. Między wspomnianymi linijkami widzisz swoją i czyjaś pracę. Sam wybierz którą zachować. Jeśli dwie osoby po prostu dopisały nowe obiekty na koniec pliku, to zachowuje się oczywiście wszystkie. W razie niepewności dopytaj kogoś doświadczonego.

Tego narzędzia nie znasz, bo nie miałeś praw zapisu - zobaczysz jak prosto będzie się dało rysować i wrzucać zmiany korzystając z paczuj.

  • Zacznij od czegoś prostego

Brzmi jak banał - ale po prostu narysuj jedną drogę i spróbuj zsynchronizować źródła, i wysłać zmiany - czy przy pomocy cvs, czy paczuj, czy klienta graficznego cvs. Nawet jeżeli coś pójdzie nie tak, to ani dużo się "nie zepsuje", ani dużo nie stracisz, a każda kolejna zmiana będzie powtórzeniem tej pierwszej, której się nauczysz.

Działania z cvs

Na osobnej stronie.

Przykazania edytora

  1. Czytać co wypisuje sprawdzacz przy demontowaniu, poprawiać błędy. Uruchomić co jakiś czas Sprawdz_bledy lub odpowiedni make. Jeżeli używasz paczuja to problem masz z głowy - błędy są sprawdzane przy każdym montowaniu mapy.
  2. Dopisywać miasto do POI
  3. Stawiać bojki
  4. Poprawiać literówki i typy przy realizacji zgłoszeń z flyspraya. Nie wrzucać 1:1 wszystkiego co podesłano - to my wiemy, jakie są zasady i konwencje.
  5. Dodawać dane adresowe i wszelkie możliwe do zgłoszeń z FlySpry o ile autor wrzutki o to nie zadbał.
  6. Do plików dedykowanych wrzucać tylko to, co jest dla nich dedykowane (szczególnie stacje BP/Orlen, bankomaty, szlaki)
  7. Remonty:
    1. Nanosząc remont stawiać znacznik (punkt REMONT z opisem FS#numer) i otwierać zgłoszenie na Flyspray, projekt Remonty
    2. Usuwając remont (znacznik REMONT z numerem FS# i wyłączenia ulic) zamykać zgłoszenie na Flyspray (ale dopiero po upewnieniu się, że to już wszystkie znaczniki i komentarze z tym numerem FS#)
  8. Czytać diffy, nawet własne. Uważać co się wysyła do cvs. Nie wrzucać zmian z bzdurami, konfliktami albo z zaokrąglonymi współrzędnymi.
  9. Dawać komentarze przy wysyłaniu zmian do cvs (domyślnie jest pusty notatnik co oznacza pusty komentarz). Komentarz powinien coś dawać, a nie np. "diffy kolegi".
  10. Komentarze do cvs powinny być bez polskich znaków diakrytycznych.
  11. Czytać listę ump@ i reagować na błędy, szczególnie własne.
  12. NIGDY nie wykonywać aktualizacji źródeł mając zmontowaną mapę, edytując ją. Może dojść do nadpisania czyjejś pracy

Sprawdzanie co i gdzie autor diffów namotał

czyli jak obejrzeć, co w tych diffach zostało podesłane.

Automatyczne dodanie diffów. Automagicznie załatwia to paczuj.bat pod system win32, jednak przeglądanie diffów zostaje. Z paczuj.bat wygląda to tak:

  1. zadbaj o czysty katalog regionu - niech nie będzie żadnych diffów (jeżeli będą diffy to zostaną użyte przez paczuj.bat), żadnych plików źródłowych,
  2. uaktualnij źródła - cvs_update.bat na Windows;
  3. wrzuć do katalogu regionu diffy (nie do podkatalogu src, tylko w głównym regionu) - albo wszystkie diffy jeżeli jest ich niewielka ilość, albo dorzucaj po jednym lub np. same POI; paczuj.bat scalając dane usunie te diffy;
  4. sprawdź co jest w diffach - byś wiedział gdzie ew. szukać zmian jeżeli zmian jest mało, możesz zauważyć podstawowe błędy, np. brak miasta, błędny zapis ulicy, cokolwiek;
  5. uruchom paczuj.bat (**1**) - doda zmiany do źródeł najpierw na sucho - bez miany źródeł; przerwij lub naciśnij dowolny klawisz, później zmiana zostanie naniesiona (w katalogu src pliki będą zawierać już zmiany) - pliki diff znikają; jeszcze raz klawisz i następuje montowanie i edycja w domyślnym edytorze;
  6. jak wygląda po zmontowaniu rzuć okiem niżej;
  7. jak skończysz przeglądać i wydaje się, że jest ok to zamknij MapEdit - jeżeli wykonałeś zmiany i chcesz by były zachowane to zgódź się na zapis;
  8. następuje rozmontowanie;
  9. jeżeli po rozmontowaniu pojawiły się nowe diffy to paczuj to zasygnalizuje i poprosi o ponowne uruchomienie - tu działanie paczuj.bat się kończy, musisz wrócić do (**1**);
  10. jeżeli po rozmontowaniu nie pojawiły się nowe diffy to po naciśnięciu dowolnego klawisza powinien uruchomić się proces wprowadzania zmian na serwer
  11. jeżeli proces wprowadzania zmian nie uruchomi się automatycznie to musisz to wykonać ręcznie, czyli to co zwykle :)

Półautomatyczne dodanie diffów - najpierw diffy po prostu przejrzyj, żeby wyłapać grube błędy albo takie niewidoczne pod Mapedit (np. zdublowanie komentarzy, albo edycja z włączonym Snap to grid, którą widać jako zmianę większości współrzędnych na ostatniej cyfrze).

  • Windows
  1. zmontuj plik Rejon-wynik.mp ("mont-demont /mont" albo po prostu dwuklik w mont-demont i zamknij bez zmieniania)
  2. dwuklik w cvs_diff.bat
    1. to zrobi wyciąg w plikach new.plt, old.plt oraz chg.plt, oraz podepnie je pod wynik
  3. otwórz edycję Rejon-wynik.mp w Mapedit
  4. szukaj wzrokiem kolorowych wyróżników
    1. niebieskie - zmienione, czerwone - skasowane, zielone - dodane
  5. oglądaj i analizuj, pomagając sobie klawiszem E (ukrywa i pokazuje załączniki, w tym wypadku pogrubienia zmienianych miejsc)
  6. rozmontuj, i jeśli robiłeś poprawki, to zrób to co zwykle.

Czym się można podpierać?

Zgłoszenie jest niejasne. Trak chaotyczny. Miejsce skomplikowane. Nie pamiętam jak tam dokładnie wyglądało. Kurcze, jak skołować więcej informacji?

Pamiętaj, że zdjęcia satelitarne mają przynajmniej pół roku, często dużo więcej, a my chcemy mieć mapę aktualną. Nie podpieramy się obcymi mapami w kwestii routingu czy nawet przebiegu ulic. Drogowcy są szybsi, niż te produkty.

Zapytaj w urzędzie

Kilka tego typu pism jest tutaj.

Przykład z OSM.

Inne mapy

Źródeł danych geograficznych jest niedużo, map na ich bazie więcej. Krótkie zestawienie kto z jakich danych korzysta: