Różnice

Różnice między wybraną wersją a wersją aktualną.

--- start:jak_edytowac [2024/12/31 00:07] – admin
+++ start:jak_edytowac [2024/12/31 15:54] (aktualna) – admin
@@ Linia 3: / Linia 3: @@
 W razie wątpliwości zawsze możesz zapytać się o pomoc na Discordzie lub przejrzeć oficjalną dokumentację (lub jej nowszą wersję)Jeśli chcesz wprowadzić jakąś zmianę (która wydaje ci się dobra) - zrób to! W razie czego edycje zawsze można cofnąć.
-Możesz też poeksperymentować w [[start:Piaskownica|MTM]]Piaskownicy.
+Możesz też poeksperymentować w [[playground:playground|Piaskownicy]].
-Podstawy
-Składnia jest wyjaśniona tutaj, ale warto zwrócić uwagę na kilka ogólnych zasad:
+=== Podstawy ===
-    Przede wszystkim, zachowujemy kulturę, piszemy poprawną polszczyzną (w szczególności np. nie wklejamy też angielskiego tekstu) - wiadomo.
+Składnia jest wyjaśniona [[wiki:syntax|tutaj]], ale warto zwrócić uwagę na kilka ogólnych zasad:
-    Staramy się zachować styl reszty strony.
-    Opisujemy linki do zewnętrznych stron - Jacuzzi w AGH, nie https://www.youtube.com/watch?v=atT64jiChb8
-    Omijamy polskie znaki w nazwach stron, plików, etc. - zdarzało się, że powodowało to kłopoty.
-    ???
-Nie każda strona jest edytowalna przez zwykłego użytkownika. Jeśli masz jakieś uwagi co do strony głównej - powiedz nam na Discordzie.
+      * Przede wszystkim, zachowujemy kulturę, piszemy poprawną polszczyzną w szczególności nie używamy angielskiego
-Wrzucanie plików
+      * Staramy się zachować styl reszty strony.
+      * opisujemy linki
+      * Omijamy polskie znaki w nazwach stron, plików, etc. oraz spacje zastępujemy "_".
+=== Nie każda strona jest edytowalna przez zwykłego użytkownika. ===
+=== Wrzucanie plików ===
 Pliki wrzucamy bezpośrednio na wiki! By to zrobić:
-    Rozpocznij edycję strony.
+Rozpocznij edycję strony.
-    Na pasku narzędzi u góry wybierz „Dodaj obrazek lub inny plik” - powinno otworzyć się okienko wgrywania plików. Jeśli nic się nie dzieje, odblokuj popupy.
+Na pasku narzędzi u góry wybierz „Dodaj obrazek lub inny plik” - powinno otworzyć się okienko wgrywania plików. Jeśli nic się nie dzieje, odblokuj popupy.
-    W okienku wgrywania wybierz katalog - domyślny powinien być dobry w większości przypadków. Zawsze możesz sprawdzić, w jakim katalogu się znajdujesz - szukaj napisu u góry.
+W okienku wgrywania wybierz katalog - domyślny powinien być dobry w większości przypadków. Zawsze możesz sprawdzić, w jakim katalogu się znajdujesz - szukaj napisu u góry.
-        Materiały do odpowiednich stron należy umieszczać w odpowiednim miejscu w hierarchii katalogów
+Materiały do odpowiednich stron należy umieszczać w odpowiednim miejscu w hierarchii katalogów
-        Hierarchia powinna odpowiadać hierarchii stron („fizycznie” nie jest to ta sama)
+Hierarchia powinna odpowiadać hierarchii stron („fizycznie” nie jest to ta sama)
-    Kliknij przycisk Wybierz pliki…
+Kliknij przycisk Wybierz pliki…
-    Potencjalnie zmień nazwę pliku(ów), jaka będzie mu nadana w Wiki, na więcej mówiącą. Sugerujemy np. przedmiot_prowadzacy_typmaterialu_2324.pdf, gdzie 2324 to rocznik 2023/2024.
+Potencjalnie zmień nazwę pliku(ów), jaka będzie mu nadana w Wiki, na więcej mówiącą. Sugerujemy np. przedmiot_prowadzacy_typmaterialu_2425.pdf, gdzie 2425 to rocznik 2024/2025.
-    Kliknij przycisk Przesłanie plików. Obok podanych nazw plików powinna ukazać się informacja o postępie (lub błędzie).
+Kliknij przycisk Przesłanie plików. Obok podanych nazw plików powinna ukazać się informacja o postępie (lub błędzie).
-    Po zakończonym wysłaniu pliku(ów) kliknij przycisk Zrobione. Pliki powinny pojawić się na liście. Kliknij nazwę pliku, aby wstawić link w tekście edytowanej strony.
+Po zakończonym wysłaniu pliku(ów) kliknij przycisk Zrobione. Pliki powinny pojawić się na liście. Kliknij nazwę pliku, aby wstawić link w tekście edytowanej strony.
-    Gdyby coś się nie zgadzało/nie działało/umieściło kilka razy poinformuj adminów!
+Gdyby coś się nie zgadzało/nie działało/umieściło kilka razy poinformuj adminów!
-Kod lepiej wrzucać na naszą instancję Gitlaba. Nie linkujemy do plików hostowanych gdzieś indziej! Jeśli coś jest przydatne, wrzucamy to tutaj.
+Nie linkujemy do plików hostowanych gdzieś indziej! Jeśli coś jest przydatne, wrzucamy to tutaj.
 Warto sobie wyrobić nawyk zbierania przydatnych materiałów od razu, jak wpadną w ręce. Albo od razu wrzucamy je na wiki, albo (jeśli nasz rocznik jest wystarczająco zgrany - raczej nie polecam na pierwszym semie) pod koniec semestru zbieramy wszystko do kupy i wrzucamy hurtem.
-Najlepiej wrzucać materiały jako .pdf, jest to w miarę uniwersalny format i można go otwierać bez pobierania. Na wiki mamy listę przydatnych do tego narzędzi, a na Discordzie też pewnie ktoś ci z tym pomoże. Jeśli chcemy wrzucić kilka plików lub jeden spory, możemy go wrzucić jako .zip - innych archiwów raczej unikamy.
+Najlepiej wrzucać materiały jako .pdf, jest to w miarę uniwersalny format i można go otwierać bez pobierania. Jeśli chcemy wrzucić kilka plików lub jeden spory, możemy go wrzucić jako .zip - innych archiwów raczej unikamy.
 W przypadku np. zestawów zadań lub kolokwiów „złotym standardem” jest wrzucenie materiałów z całego semestru jako jeden PDF, najlepiej ze spisem treści. To jednak jest trochę ciężkie do zorganizowania, można więc równie dobrze wrzucać wszystko od razu jak się ma. Bonusowe punkty za wrzucanie obok pdfa kodu w .tex lub .typ.
@@ Linia 41: / Linia 42: @@
 Jeśli widzisz gdzieś dokument wrzucony jako np. link do Google Docs - popraw to! Wyeksportuj go do PDFa i wrzuć go obok. To może kogoś w przyszłości uratować, jeśli oryginalny link spadnie.
-Tworzenie stron
+=== Tworzenie stron ===
 Nie polecam tworzyć nowych stron jeśli nie masz jeszcze żadnego doświadczenia z edytowaniem wiki. Zwykli użytkownicy z reguły powinni raczej tworzyć nowe strony tylko prowadzącym.
@@ Linia 47: / Linia 49: @@
 To powiedziawszy, mamy kilka ogólnych zasad:
-    Dodajemy linki do nowych stron w pasujących miejscach - spisach, stronach przedmiotów, etc.
+Dodajemy linki do nowych stron w pasujących miejscach - spisach, stronach przedmiotów, etc.
-    Nowe strony bazujemy na już istniejących. W szczególności nie zmieniamy struktury szablonów, inaczej robi się pierdolnik.
+Nowe strony bazujemy na już istniejących. W szczególności nie zmieniamy struktury szablonów, będzie miszmasz.
-    ???
 Stronę tworzymy ręcznie zmieniając ID strony w linku (to po ?id=) - pokaże nam się informacja, że ta strona nie istnieje, po czym możemy ją utworzyć.
-Strony prowadzących
-Bazujemy je na szablonie, dodajemy linki do niej do spisu i stron przedmiotów, które owa osoba prowadzi. Stronę nazywamy studia:prowadzacy:jan_kowalski (bez polskich znaków).
+=== Strony prowadzących ===
+Bazujemy je na szablonie, dodajemy linki do niej do spisu i stron przedmiotów, które owa osoba prowadzi. Stronę nazywamy kierunek:prowadzacy:jan_kowalski (bez polskich znaków) (kierunek oznacza MTM lub elektrotechnika).
 Dane kontaktowe możemy wziąć ze SKOSa, warto wrzucić jakiś link do strony i ewentualnie zdjęcie.
@@ Linia 60: / Linia 62: @@
 Tytuł strony powinien zawierać tytuł naukowy - dzięki temu przy linkowaniu do prowadzącego z innych stron od razu będzie widoczny poprawny tytuł, a w przypadku zmiany tytułu nie będzie trzeba poprawiać dziesięciu linków.
 etc.
-Ta strona jest nowszą wersją instrukcji wrzucania materiałów napisaną prawie od zera (w ramach prokrastynacji podczas sesji).
 Jest też kilka rzeczy z których lepiej nie korzystać:
-    wbudowanych emotikonów - stare :-D zamieniło się na 😬, nie są one „stabline”
+wbudowanych emotikonów - stare :-D zamieniło się na 😬, nie są one „stabline”
-    pluginu do LaTeXa wewnątrz treści strony (do odwołania) - historycznie powodował on kilka problemów, jest on tylko dla kompatybliności ze starymi stronami
+pluginu do LaTeXa wewnątrz treści strony (do odwołania) - historycznie powodował on kilka problemów, jest on tylko dla kompatybliności ze starymi stronami