Pakiet edycyjny

Z UMP

(Różnice między wersjami)
Aktualna wersja (16:27, 30 sty 2022) (edytuj) (anuluj zmianę)
(aktualizacja)
 
(Nie pokazano 19 wersji pośrednich.)
Linia 1: Linia 1:
 +
==Zastrzeżenie==
 +
Poniższy sposób cały czas jest możliwy do zrealizowania ale od 2022 roku mamy narzędzie [[mdm-py]], pozwalające z jednego miejsca ogarnąć całość pracy nad źródłami.
 +
== Cel ==
== Cel ==
Opis pobrania źródeł mapy i przystosowania środowiska do pracy na nich.
Opis pobrania źródeł mapy i przystosowania środowiska do pracy na nich.
-
 
-
strona [http://ump.waw.pl/startup-pack.html z głównego www] - w trakcie przenoszenia
 
== Ściągnięcie źródeł ==
== Ściągnięcie źródeł ==
Linia 9: Linia 10:
Utwórz w wybranym miejscu folder na wszystkie pliki mapowe. Ściągnij
Utwórz w wybranym miejscu folder na wszystkie pliki mapowe. Ściągnij
-
[http://ump.waw.pl/pliki/instaluj.zip pakiet startowy] (110kB) i rozpakuj zawartość do tego folderu. Przeczytaj opis "instaluj.txt", szczególnie wtedy, jeśli masz słabsze łącze, i nie chcesz ściągać wszystkich obszarów (ponad 1GB!), ale tylko 'swój'.
+
[http://ump.waw.pl/pliki/instaluj.zip pakiet startowy] (110kB) i rozpakuj zawartość do tego folderu. Przeczytaj opis "instaluj.txt", szczególnie jeśli nie chcesz ściągać wszystkich obszarów (ponad 5GB!), ale tylko 'swój'.
-
Uruchom programik "instaluj".
+
-
''Uważny czytelnik zauważy, że już tu liczymy na Jego inteligencję, i nie podpowiadamy '''wszystkich''' kroków - tutaj nie było wspomniane, że jeżeli nie chce się ściągać wszystkich obszarów, to przeczytanie pliku z opisem nie wystarczy. Trzeba się zastosować do tego, co jest w nim napisane.''
+
Lista możliwych do pobrania obszarów jest [[Rejon|tutaj]].
-
''Wersje Mapedit-a zmienia się na tyle często że pakiet startowy może już go nie pobrać, wtedy musisz samemu go pobrać z http://www.geopainting.com/en/#last i wypakować mapedit.exe do katalogu gdzie uruchamiałeś instaluj.bat''
+
''Oczywiście samo przeczytanie pliku z opisem nie wystarczy. Trzeba się zastosować do tego, co jest w nim napisane.''
 +
 
 +
Uruchom programik "instaluj". Do folderu ze źródłami skopiuj plik ''setenv.bat'' z folderu ''narzędzia'' pobranego z pakietem edycyjnym.
 +
 
 +
Jeśli już masz konto w cvs UMP, a tylko instalujesz środowisko od nowa, zajrzyj do pkt. 4.
 +
 
 +
''Wersje Mapedit-a zmienia się na tyle często że pakiet startowy może już go nie pobrać, wtedy musisz samemu go pobrać z http://www.geopainting.com/en/#last i wypakować do katalogu gdzie uruchamiałeś instaluj.bat''
'''Linux:'''
'''Linux:'''
-
W jakimś katalogu, np. domowym, robimy katalog, w którym będą pliki źródeł mapy.
+
W jakimś katalogu, np. domowym, robimy katalog, w którym będą pliki źródeł mapy - raczej w okienku tekstowym (Terminal), bo potem większość operacji będzie też w ten sposób:
-
cd
+
mkdir ~/ump
-
mkdir ump
+
cd ~/ump
-
cd ump
+
-
Jeśli chcesz ściągnąć wszystkie źródła map, wystarczy teraz wykonać "checkout .", jeśli interesuje cię tylko pojedynczy region, to ściągnij tylko katalog "narzedzia" oraz ten rejon, czyli:
+
Ustaw jako kto będziesz ściągał:
 +
export CVSROOT=:pserver:'''nazwa_usera'''@cvs.ump.waw.pl/home/cvsroot
 +
zamiast słów nazwa_usera wpisujemy naszą nazwę użytkownika, albo guest
 +
cvs login
 +
po wydaniu tego polecenia zostaniemy poproszeni o hasło do naszego konta. Musimy je podać, chyba że masz już plik ~/.cvspass.
-
cvs -z5 -d:pserver:guest@cvs.ump.waw.pl/home/cvsroot checkout .
+
Jeśli nie masz polecenia cvs, to zainstaluj zależnie od swojego środowiska, np.
 +
sudo apt-get install cvs
-
lub:
+
Ściągnij obowiązkowy zestaw
 +
cvs co narzedzia
 +
oraz te fragmenty, które Cię interesują:
 +
cvs co -c # sprawdzenie możliwości
 +
cvs co UMP-PL-Bialystok # lub inny region, lub
 +
cvs co POLSKA # lub
 +
cvs co EUROPA # itp.
 +
cvs co all ## uwaga: to jest ponad 5GB danych
 +
po wydaniu tego polecenia rozpocznie się pobieranie źródeł.
-
cvs -z5 -d:pserver:guest@cvs.ump.waw.pl/home/cvsroot checkout narzedzia
+
Jeśli lubisz make, to przeczytaj [[Makefile.common]].
-
cvs -z5 -d:pserver:guest@cvs.ump.waw.pl/home/cvsroot checkout UMP-PL-JakisRejon
+
-
Istnieje też inna metoda na pobranie źródeł
+
'''Oba:'''
-
Podobnie jak poprzednio na przykład w katalogu domowym tworzymy katalog w którym będziemy przechowywać źródła.
+
-
W tym celu po kolei wykonujemy:
+
-
cd #to polecenie powoduje że przechodzimy do katalogu domowego
+
Masz już "wersję podstawową" źródeł UMP – co najmniej jeden folder ''UMP-PL-Rejon'', oraz folder ''narzedzia''.
-
mkdir ump #to polecenie tworzy nam katalog o nazwie ump
+
Można zacząć (próbować) rysować: [[Pierwsze]].
-
cd ump #za pomocą tego polecenia wchodzimy do katalogu ump
+
-
Gdy już jesteśmy w katalogu ump to wydajemy po kolei polecenia
+
== Konfiguracja środowiska ==
 +
Niemal żadna. Poczytaj o [[Mapedit|ustawieniach programu do edycji źródeł]].
-
export CVSROOT=:pserver:'''nazwa_usera'''@cvs.ump.waw.pl/home/cvsroot #zamiast słów które zostały pogrubione nazwa_usera wpisujemy naszą nazwę użytkownika
+
== Praca na źródłach: wiersz poleceń, WinCVS i TortoiseCVS==
-
cvs login #po wydaniu tego polecenia zostaniemy poproszeni o hasło do naszego konta. Musimy je podać.
+
Po uzyskaniu dostępu do źródeł, najwygodniejszą formą ich aktualizowania, wysyłania zmian na serwer są nakładki [[Mdm-gui]] albo [[Mdm-py]].
-
cvs co all #po wydaniu tego polecenia rozpocznie się pobieranie wszystkich źródeł.
+
-
Gdy nie chcemy pobierać wszystkich źródeł to wszystko robimy jak poprzednio tylko zamiast '''cvs co all''' wpisujemy
+
Opcjonalne formy to:
-
cvs co -c sprawdzenie modułów
+
'''- wiersz poleceń Windows'''
-
cvs co narzedzia
+
-
cvs co UMP-PL-Bialystok #zamiast Bialystok możemy podać dowolnie inny region lub
+
-
cvs co POLSKA lub
+
-
cvs co EUROPA
+
-
+
-
Następnie w podkatalogu "głównym" ump-a utwórz katalog roboczy i utwórz w nim link do pliku Makefile.common znajdującego się w podkatalogu narzedzia:
+
-
cd ~/ump
+
Instalując środowisko od nowa, w oknie folderu z zainstalowanym pakietem edycyjnym, po kliknięciu w ścieżkę adresu (u mnie: ''Komputer-Dysk lokalny D-UMP'') i wpisaniu ''cmd'' uzyskasz otwarcie wiersza poleceń dla źródeł.
-
mkdir tmp
+
-
cd tmp
+
-
ln -s ../narzedzia/Makefile.common Makefile
+
-
Więcej informacji na temat wykorzystania/konfigurowania pliku Makefile znajdziesz na stronie [[Makefile.common]].
+
[[Grafika:Okno cmd2.jpg|thumb|none]]
-
Kolejny krok to przygotowanie środowiska - plik Makefile.common wymaga dwóch zmiennych:
+
Wpisz komendę logowania się (nazwa to oczywiście Twój nick, który masz nadany po uzyskaniu uprawnień do edycji źródeł):
-
* '''DIR''' – wskazującej, które fragmenty UMPa nas interesują
+
-
* '''CVS''' – wskazującej, gdzie znajduje się katalog główny repozytorium
+
-
Możemy utworzyć sobie plik (u mnie ''env.sh'') który pomoże pamiętać o zainicjowaniu zmiennych środowiskowych. Jego zawartość (lub dla osób nie używających pliku – polecenia do wykonania):
+
-
export DIR=UMP-PL-Wroclaw
+
-
export CVS=/home/user/ump
+
-
Użytkownicy tcsh piszą tak:
+
-
setenv DIR "UMP-PL-Opole UMP-PL-Katowice"
+
-
setenv CVS /home/user/ump
+
-
Jeśli chcemy montować więcej niż jeden kawałek mapy – w cudzysłowie umieszczamy listę montowanych elementów.
+
-
'''Oba:'''
+
cvs.exe -d:pserver:nazwa@cvs.ump.waw.pl/home/cvsroot login
-
Masz już "wersję podstawową" źródeł UMP-pcPL – co najmniej jeden folder ''UMP-PL-Rejon'', oraz folder ''narzedzia''.
+
Pojawi się wiersz:
-
Można zacząć (próbować) rysować: [[Pierwsze]].
+
-
== Konfiguracja środowiska ==
+
CVS password:
-
Niemal żadna.
+
-
Jeśli używasz systemu Linux - zajrzyj na stronę [[Edycja_w_systemie_Linux]], jeśli brak jakiegoś pakietu (np. dos2unix).
+
Wpisując hasło zauważysz, że nie pojawia się ono w linii a kursor nie zmienia położenia - tak ma być.
-
Między innymi plikami ściągnął Ci się [[Mapedit]]. Uruchom go "na pusto", wybierz menu Tools-Options, i odznacz opcję Snap to grid. Zaś Stick to neighbours lepiej mieć zaznaczone.
+
Po zatwierdzeniu, przy pierwszorazowym logowaniu się, w systemie Windows pojawi się plik ''.cvspass''. Możesz go wyszukać przez ''Start -> wyszukaj programy i pliki ->.cvspass''. Obecność tego pliku daje stałe wejście do źródeł, dzięki czemu nie musisz przy każdorazowym rozpoczynaniu pracy logować się na serwer.
-
== WinCVS ==
+
To wszystko. Mając już źródła możemy je aktualizować, pobierać brakujące obszary oraz wysyłać to cośmy zmienili używając przykładowych, poniższych komend:
-
Poprzednio na stronie [http://ump.waw.pl/startup-pack.html#wincvs]. W trakcie migracji.
+
-
''autor opisu: Wojtek Nowiński''
+
cvs.exe -d:pserver:nazwa@cvs.ump.waw.pl/home/cvsroot checkout UMP-Slowacja (pobierzemy obszar Słowacji)
 +
cvs.exe -d:pserver:nazwa@cvs.ump.waw.pl/home/cvsroot update UMP-PL-Warszawa (zaktualizujemy obszar Warszawy)
 +
 +
cvs.exe -d:pserver:nazwa@cvs.ump.waw.pl/home/cvsroot commit UMP-PL-Krakow (wyślemy na serwer to, co zmieniliśmy w Krakowie)
 +
 +
 +
 +
'''- TortoiseCVS''' omówiony szczegółowo [[TortoiseCVS|tutaj]].
 +
 +
'''- WinCVS''':
Co potrzebujemy:
Co potrzebujemy:
* ze [http://cvsgui.sourceforge.net/download.html#wincvs_recommended strony CvsGui] ściągamy plik opisany jako: "Latest Development Release: WinCvs 2.0.9 (released 2007-01-30)"
* ze [http://cvsgui.sourceforge.net/download.html#wincvs_recommended strony CvsGui] ściągamy plik opisany jako: "Latest Development Release: WinCvs 2.0.9 (released 2007-01-30)"
Linia 110: Linia 112:
Protocol: pserver
Protocol: pserver
Repository path: /home/cvsroot
Repository path: /home/cvsroot
-
Poprzez dwukrotne klikniecie na słowie Hostname otworzy się kolejne małe okno w którym wpisujemy ump.waw.pl; analogicznie wypełniamy pola Username i Password. Jeśli chcemy tylko odczytywać repozytorium projektu UMP-pcPL i nie posiadamy własnego konta w systemie, jako użytkownik wpisujemy słowo guest. Pole Password pozostawiamy wówczas niewypełnione. Jeżeli posiadamy konto, wpisujemy tu odpowiednio nadany nam identyfikator i hasło we właściwe pola, zatwierdzamy i gotowe.
+
Poprzez dwukrotne klikniecie na słowie Hostname otworzy się kolejne małe okno w którym wpisujemy ump.waw.pl; analogicznie wypełniamy pola Username i Password. Jeśli chcemy tylko odczytywać repozytorium projektu UMP i nie posiadamy własnego konta w systemie, jako użytkownik wpisujemy słowo guest. Pole Password pozostawiamy wówczas niewypełnione. Jeżeli posiadamy konto, wpisujemy tu odpowiednio nadany nam identyfikator i hasło we właściwe pola, zatwierdzamy i gotowe.
 +
 
[[Kategoria:Rysowanie]]
[[Kategoria:Rysowanie]]

Aktualna wersja

Spis treści

Zastrzeżenie

Poniższy sposób cały czas jest możliwy do zrealizowania ale od 2022 roku mamy narzędzie mdm-py, pozwalające z jednego miejsca ogarnąć całość pracy nad źródłami.

Cel

Opis pobrania źródeł mapy i przystosowania środowiska do pracy na nich.

Ściągnięcie źródeł

Windows:

Utwórz w wybranym miejscu folder na wszystkie pliki mapowe. Ściągnij pakiet startowy (110kB) i rozpakuj zawartość do tego folderu. Przeczytaj opis "instaluj.txt", szczególnie jeśli nie chcesz ściągać wszystkich obszarów (ponad 5GB!), ale tylko 'swój'.

Lista możliwych do pobrania obszarów jest tutaj.

Oczywiście samo przeczytanie pliku z opisem nie wystarczy. Trzeba się zastosować do tego, co jest w nim napisane.

Uruchom programik "instaluj". Do folderu ze źródłami skopiuj plik setenv.bat z folderu narzędzia pobranego z pakietem edycyjnym.

Jeśli już masz konto w cvs UMP, a tylko instalujesz środowisko od nowa, zajrzyj do pkt. 4.

Wersje Mapedit-a zmienia się na tyle często że pakiet startowy może już go nie pobrać, wtedy musisz samemu go pobrać z http://www.geopainting.com/en/#last i wypakować do katalogu gdzie uruchamiałeś instaluj.bat

Linux:

W jakimś katalogu, np. domowym, robimy katalog, w którym będą pliki źródeł mapy - raczej w okienku tekstowym (Terminal), bo potem większość operacji będzie też w ten sposób:

mkdir ~/ump
cd ~/ump

Ustaw jako kto będziesz ściągał:

export CVSROOT=:pserver:nazwa_usera@cvs.ump.waw.pl/home/cvsroot

zamiast słów nazwa_usera wpisujemy naszą nazwę użytkownika, albo guest

cvs login

po wydaniu tego polecenia zostaniemy poproszeni o hasło do naszego konta. Musimy je podać, chyba że masz już plik ~/.cvspass.

Jeśli nie masz polecenia cvs, to zainstaluj zależnie od swojego środowiska, np.

sudo apt-get install cvs

Ściągnij obowiązkowy zestaw

cvs co narzedzia

oraz te fragmenty, które Cię interesują:

cvs co -c   # sprawdzenie możliwości
cvs co UMP-PL-Bialystok     # lub inny region, lub
cvs co POLSKA   # lub
cvs co EUROPA   # itp.
cvs co all   ## uwaga: to jest ponad 5GB danych

po wydaniu tego polecenia rozpocznie się pobieranie źródeł.

Jeśli lubisz make, to przeczytaj Makefile.common.

Oba:

Masz już "wersję podstawową" źródeł UMP – co najmniej jeden folder UMP-PL-Rejon, oraz folder narzedzia. Można zacząć (próbować) rysować: Pierwsze.

Konfiguracja środowiska

Niemal żadna. Poczytaj o ustawieniach programu do edycji źródeł.

Praca na źródłach: wiersz poleceń, WinCVS i TortoiseCVS

Po uzyskaniu dostępu do źródeł, najwygodniejszą formą ich aktualizowania, wysyłania zmian na serwer są nakładki Mdm-gui albo Mdm-py.

Opcjonalne formy to:

- wiersz poleceń Windows

Instalując środowisko od nowa, w oknie folderu z zainstalowanym pakietem edycyjnym, po kliknięciu w ścieżkę adresu (u mnie: Komputer-Dysk lokalny D-UMP) i wpisaniu cmd uzyskasz otwarcie wiersza poleceń dla źródeł.

Wpisz komendę logowania się (nazwa to oczywiście Twój nick, który masz nadany po uzyskaniu uprawnień do edycji źródeł):

cvs.exe -d:pserver:nazwa@cvs.ump.waw.pl/home/cvsroot login

Pojawi się wiersz:

CVS password: 

Wpisując hasło zauważysz, że nie pojawia się ono w linii a kursor nie zmienia położenia - tak ma być.

Po zatwierdzeniu, przy pierwszorazowym logowaniu się, w systemie Windows pojawi się plik .cvspass. Możesz go wyszukać przez Start -> wyszukaj programy i pliki ->.cvspass. Obecność tego pliku daje stałe wejście do źródeł, dzięki czemu nie musisz przy każdorazowym rozpoczynaniu pracy logować się na serwer.

To wszystko. Mając już źródła możemy je aktualizować, pobierać brakujące obszary oraz wysyłać to cośmy zmienili używając przykładowych, poniższych komend:

cvs.exe -d:pserver:nazwa@cvs.ump.waw.pl/home/cvsroot checkout UMP-Slowacja (pobierzemy obszar Słowacji)
cvs.exe -d:pserver:nazwa@cvs.ump.waw.pl/home/cvsroot update UMP-PL-Warszawa (zaktualizujemy obszar Warszawy)
cvs.exe -d:pserver:nazwa@cvs.ump.waw.pl/home/cvsroot commit UMP-PL-Krakow (wyślemy na serwer to, co zmieniliśmy w Krakowie)


- TortoiseCVS omówiony szczegółowo tutaj.

- WinCVS: Co potrzebujemy:

  • ze strony CvsGui ściągamy plik opisany jako: "Latest Development Release: WinCvs 2.0.9 (released 2007-01-30)"
  • możemy (ale nie musimy) zainstalować Pythona ze strony programu - ściągamy plik opisany jako .Windows installer.

Jeśli ściągnęliśmy Pythona, to uruchamiamy instalator i instalujemy akceptując wszystkie domyślne ustawienia. Uruchamiamy instalator Wincvs i również akceptujemy wszystkie domyślne ustawienia.

Konfiguracja WinCVS Uruchamiamy WinCVS, oglądamy powitalny obrazek, i wita nas główne okno programu. [ nie ma obrazka ] Pierwszą rzeczą do wykonania będzie dodanie nowego repozytorium (czyli zdalnej bazy źródeł). W tym celu wybieramy kolejno Remote -> create new repository:

Grafika:wincvs-create-repo.jpg

Otwiera się nam tak wyglądające okienko:

Grafika:wincvs-create-repo-2.jpg

Wybieramy przycisk ... nad Pomoc i przechodzimy do kolejnego okna. Tu wybieramy kolejno: Protocol: pserver Repository path: /home/cvsroot Poprzez dwukrotne klikniecie na słowie Hostname otworzy się kolejne małe okno w którym wpisujemy ump.waw.pl; analogicznie wypełniamy pola Username i Password. Jeśli chcemy tylko odczytywać repozytorium projektu UMP i nie posiadamy własnego konta w systemie, jako użytkownik wpisujemy słowo guest. Pole Password pozostawiamy wówczas niewypełnione. Jeżeli posiadamy konto, wpisujemy tu odpowiednio nadany nam identyfikator i hasło we właściwe pola, zatwierdzamy i gotowe.