Standardy tworzenia dodatków

Z MaSzyna
Skocz do: nawigacja, szukaj

Pliki

Wszystkie pliki muszą pasować do obecnie przyjętej struktury katalogowej na repozytorium. Niedozwolone jest tworzenie nowych zbędnych folderów i umieszczanie plików w innym miejscu niż starsze podobnego typu.

Struktura jest mocno niejasna. Wiele plików podobnych typów znajduje się w różnych miejscach. Dlatego póki co nie można ściśle określić co gdzie należy wsadzić. Pewnym wzorcem może być lista umieszczona poniżej poniżej.W razie wątpliwości należy skonsultować się z Wydziałem Repozytorium.

   • Elektryczne – elementy energetyki komunalnej, przemysłowej, sieci przesyłowych. Słupy oświetleniowe.
   • Eng – obiekty inżynieryjne. Mosty, wiadukty, przepusty.
   • Kolejowe – inne kolejowe, nie do zakwalifikowania precyzyjniej.
   • Miejskie – obiekty użyteczności publicznej i detale do krajobrazu miejskiego.
   • Mieszkalne – wszelka zabudowa mieszkaniowa.
   • Nastawnie – nastawnie i inne posterunki PKP.
   • Peronowe – ławki, wiaty, tablice z rozkładami. Do dekorowania peronów.
   • Pkp – wskaźniki z sieci PKP.
   • Plants – roślinność.
   • Pojazdy – pojazdy statyczne. Koparki, dźwigi i.t.p.
   • Posers – ludzie.
   • Przejazdy – elementy przejazdów kolejowych.
   • Przemysl – elementy zakładów przemysłowych, taśmociągi, rury ciepłownicze.
   • Przytorowe – elementy ze szlaków kolejowych. Słupki hektometrowe, rezonatory, czujniki, szafy sterujące automatyką.
   • Stacje – budynki dworców.
   • Tr/tra/trakcja – sieć trakcyjna.
   • Wiejskie – zabudowa gospodarcza, detale polne.

Przykładami złej struktury w obecnej paczce to foldery: otoczenie\budynki, \ip i \szlakowe.




Pliki z nowych paczek nie mogą nadpisywać starszych (wydanych wcześniej) plików. W szczególnych przypadkach, gdy nadpisanie plików jest konieczne należy zapewnić kompatybilność wsteczną.

Nienadpisywanie plików mam nadzieję jest zrozumiałe. Za przykład zachowania kompatybilności wstecznej może posłużyć plik: scenery\rainsted\lwzmp_l.inc

Dla zgodności z SCSem, autor użył komend zmiany stanu rozjazdu w formacie nazwa:stan. Zostawił jednak zdarzenia dla starego systemu.

event (p1)+ multiple 0 none (p1)_dzwiek (p1)_0 (p1)_Vmax (p1)_suwak0 (p1)_latarnia0 (p1)_walek0 endevent event (p1)- multiple 0 none (p1)_dzwiek (p1)_1 (p1)_V40 (p1)_suwak1 (p1)_latarnia1 (p1)_walek1 endevent event (p1):+ multiple 0 none (p1)_dzwiek (p1)_0 (p1)_suwak0 (p1)_latarnia0 (p1)_walek0 endevent event (p1):- multiple 0 none (p1)_dzwiek (p1)_1 (p1)_suwak1 (p1)_latarnia1 (p1)_walek1 endevent




Wszystkie pliki muszą mieć nazwy zapisane małymi znakami bez spacji i znaków diakrytycznych.

Nie Mój Domek.inc tylko moj_domek.inc. Odnosi się to także do plików tablic relacyjnych. Nie Dąbrowa Górnica.tga a dabrowa_gornicza.tga.




Pliki tekstowe muszą być zapisywane w formacie ANSI Windows-1250 z windowsowym końcem wiersza \r\n.

Szczególnie dla użytkowników Linuxa. Nie UTF-8, nie sano \n (LF). Wiele narzędzi wymaga takiego formatu i nie trawi linuksowych znaczników. Poniżej te ustawienia w Notepadzie++.


Wytyczne 1.png

Wytyczne 2.png