Mikuz11_Offset_Guide_Tłumaczenie

Wstęp do offsetów

Offsety powszechnie uważane są za nieprzystępne i zrozumiałe tylko dla wybrańców, którzy pojęli ich tajniki. Wielu twórców bardzo chce skorzystać z offsetów w swoich pracach, jednak boi się zagmatwanego procesu ich implementacji. Niektóre najpopularniejsze strony na wiki używają offsetów, dzięki czemu mają wysokie oceny. Niektóre szczególnie złożone kodowo prace korzystają z offsetów, żeby jeszcze tej złożoności dodać. Nie dziwne więc, że większość ludzi patrzy na takie artykuły i myśli, że nie podołałaby samemu. Ten poradnik jednak ma zamiar to zmienić.

Czym są offsety?

Po pierwsze, czym tak w ogóle są offsety? Jest to sposób na przeniesienie czytelnika na inną stronę, nie tracąc przy tym ocen i komentarzy głównej strony. Ta funkcja może okazać się przydatna do spajania elementów fabularnych artykułu bez używania gorzej wyglądających metod. Może to być na przykład odświeżona wersja wpisu po jakimś nowym odkryciu, zwykłe przejście służące aparycji strony, czy cokolwiek innego. Kliknij tutaj, żeby zobaczyć, jak działają offsety.

Offsety są wbudowaną funkcją Wikidota używaną za pomocą modułu zwanego ListPages. Funkcja ta używa specjalnego typu stron na wiki zwanych "fragmentami". Fragmenty są kolejną wbudowaną funkcją Wikidota, używaną najczęściej w offsetach, jednak znajdzie się je także w motywach czy w kodzie pozwalającym na zawarcie jednej strony w drugiej. Są one niewidzialne dla każdego, kto nie posiada linku bezpośrednio do nich ani nie pojawią się na liście "Najnowszych Stron" na stronie głównej po wstawieniu.

Jak używać offsetów?

W porządku, wiemy już, jak działają offsety i wytłumaczyliśmy sobie pewne pojęcia, więc czas teraz użyć je w twoim artykule. Gdzie masz zacząć? Najpierw musisz stworzyć stronę nadrzędną. Będzie się ona zachowywać jako "scena", na której będą prezentować się twoje fragmenty. Do wytłumaczenia tego najlepsza będzie analogia talerza. Wyobraź sobie, że strona nadrzędna jest pustym talerzem — jako jedyny na stole nic nie wskóra. Musisz więc położyć na nim jakieś danie, w tym wypadku nasze fragmenty. Jak i fragmenty, danie którego nie da się na niczym zaserwować, jest niczym. Tutaj właśnie cała na biało przychodzi strona nadrzędna. Ani ona, ani fragmenty same nie mają prawa bytu, jednak razem tworzą idealną parę.

Żeby stworzyć stronę nadrzędną, najpierw musisz stworzyć zwykłą stronę. Dla przykładu strona, na której się teraz znajdujesz to http://pl-backrooms-wiki.wikidot.com/poradnik-offsetow. Jeśli chcesz stworzyć offsety na sandboxie, przez błąd Wikidota musisz dodać "collab:" przed nazwą strony. Bez tego offsety na sandboxie mogą nie działać. Dla przykładu więc link dla tej samej strony tylko na sandboxie wyglądałby tak: http://backrooms-pl-piaskownica.wikidot.com/collab:poradnik-offsetów.

Po stworzeniu swojej strony musisz ją teraz odpowiednio ustawić pod offsety. Pamiętaj, że zawartość strony zawsze znajdzie się na wszystkich podpiętych pod nią fragmentach, co za chwilę omówimy. By dobrze sformatować stronę nadrzędną, wykorzystaj szablon poniżej:


(JEŚLI UŻYWASZ JAKIEGOŚ MOTYWU, WSTAW GO TUTAJ)

[[module css]]
(Tutaj wstaw moduł CSS, którego chcesz użyć na wszystkich stronach)
[[/module]]


[[include :backrooms-wiki:component:open]]
Tutaj wstaw ostrzeżenia o zawartości i cokolwiek co chcesz tutaj dodać. Jeśli będziesz chciał wstawiać tutaj jakiekolwiek ostrzeżenia, musisz dodać |cw=1 przed zamykającą linijką komponentu.
[[include :backrooms-wiki:component:close]]




[[module ListPages category="fragment" parent="." limit="1" order="created_at" offset="@URL|0"]]
%%content%%
[[/module]]



------

[[div class="footer-wikiwalk-nav"]]
[[=]]
@< [[[Poziom n-1]]] | Poziom n | [[[Poziom n+1]]] >@
[[/=]]
[[/div]]

Na dole strony musisz dodać License Boxa.

Użyj tego, jeśli NIE używasz żadnych zdjęć czy innych materiałów:

[[include :pl-backrooms-wiki:component:license-box]]
=====
=====
[[include :pl-backrooms-wiki:component:license-box-end]]

Ale jeśli używasz zdjęć bądź innych materiałów, dodaj to dla każdego jednego używanego przez ciebie zdjęcia/materiału pomiędzy dwoma liniami "=====" :

> **Nazwa:**
> **Autor:**
> **Licencja:**
> **Link Źródłowy:**
> **Zdjęcie Oryginalne:** (Jeśli używasz przeróbki)
> **Dodatkowe Uwagi:** (Opcjonalne)


Pochylmy się trochę nad tym szablonem. Jeśli chcesz użyć motywu, musisz go zawrzeć na samej górze tekstu. Jeśli twój artykuł używa podstawowego motywu "Liminal" lub planujesz użyć osobnym motywów dla każdego offseta, pomiń tę część. Poniżej znajduje się moduł CSS. Tam możesz wprowadzić jakikolwiek kod CSS, który chcesz wprowadzić na wszystkie swoje fragmenty. Najczęściej używa się go do czcionek, personalizowanych Divów i kodów związanych z motywami, jak na przykład zmiana koloru tekstu. Jeśli nie planujesz wprowadzać żadnych modułów CSS wykorzystywanych we wszystkich offsetach, pomiń tę część szablonu. Jeszcze niżej znajduje się moduł ocen. Jest on wymagany na wszystkich offsetach, więc najlepiej jest dodać go od razu na stronie nadrzędnej, żeby nie wprowadzać go za każdym razem na każdej stronie. Poniżej znajduje się kod, który sprawia, że dzieje się magia. Jest on potrzebny do poprawnego działania offsetów. Niżej jest też collaps autora. On również jest wymagany na wszystkich offsetach, więc najlepiej będzie dodać go na stronie nadrzędnej, zamiast przekopiowywać go za każdym razem. Gdy już skończysz formatować stronę nadrzędną, czas stworzyć fragmenty.

By stworzyć stronę pod fragment, po frazie "wikidot.com/" w nazwie strony nadrzędnej musisz po prostu dodać "fragment:". Na końcu jej nazwy natomiast, musisz dodać numer. Dla pierwszego fragmentu będzie to "0". Kontynuując na przykładzie tej strony, pierwszy jej fragment będzie się nazywać http://pl-backrooms-wiki.wikidot.com/fragment:poradnik-offsetow-0. Na sandboxie fragmenty działają dokładnie w ten sam sposób. By podłączyć tę stronę pod stronę nadrzędną, musisz zejść na dół strony, wcisnąć Opcje, a następnie Strona Nadrzędna, tak jak jest to pokazane poniżej:


screen_tlum.png

Gdy pojawi się menu, musisz wpisać nazwę strony nadrzędnej, a następnie wybrać ją z listy, która pojawi się poniżej. Po jej wybraniu kliknij Zapisz. Teraz, po ustawieniu fragmentu, możesz dodać do niego zawartość. Wszystko, co będzie we fragmencie zerowym, pojawi się jako pierwsze gdy czytelnik otworzy stronę, więc zawrzyj w nim wszystko, co chcesz, by zobaczył przed wejściem na kolejne offsety.

WAŻNE: PO KAŻDEJ EDYCJI FRAGMENTU MUSISZ ODŚWIEŻYĆ STRONĘ NADRZĘDNĄ POPRZEZ OTWARCIE EDYCJI I ZAPISANIE JEJ. ISTNIEJE BŁĄD, KTÓRY PRZEZ BRAK ODŚWIEŻENIA CAŁOŚCI POWODOWAŁ PROBLEMY NA STRONIE. PAMIĘTAJ, BY ODŚWIEŻYĆ STRONĘ PO KAŻDEJ EDYCJI KAŻDEGO FRAGMENTU.

Teraz musisz po prostu powtórzyć ten proces dla każdego kolejnego fragmentu, który chcesz utworzyć. Dla drugiego offsetu link będzie wyglądał tak: http://pl-backrooms-wiki.wikidot.com/fragment:poradnik-offsetow-1, dla trzeciego tak: http://pl-backrooms-wiki.wikidot.com/fragment:poradnik-offsetow-2 i tak dalej. By przenieść czytelnika z jednego offsetu na następny, musisz użyć specjalnego linku. Jeśli wszystko powyżej zostało wykonane poprawnie, wtedy to zadziała, inaczej przeniesie cię on na pustą stronę. Niech znów za przykład posłuży ta strona. Link, który przeniesie czytelnika na drugi offset, będzie wyglądać tak:http://pl-backrooms-wiki.wikidot.com/poradnik-offsetow/offset/1. Tak samo wygląda to w przypadku łączenia offsetów w sandboxie. Gdy dodajesz swoje fragmenty na stronę po greenlightcie, każdy fragment powinien posiadać tylko tag fragment.

Częstym błędem popełnianym przez ludzi jest podawanie linku do fragmentu, zamiast do offsetu posiadającego już oceny oraz komentarze. Jeśli twój artykuł nie działa, upewnij się, że używasz linku nieposiadającego w sobie części "fragment:", a tego, który posiada część "/offset/". Co więcej, linki prowadzące do offsetów nie będą działać w ustawieniu [[[link]]]. Zamiast tego, musisz użyć pojedynczych nawiasów [link]. Jeśli jest to dla ciebie problemem, odwiedź Poradnik Składni Wikidot.

Uff! Wiem, że jest tego dużo, ale w końcu załapiesz, o co w tym biega. Pierwszy raz jest zawsze najgorszy, ale jak tylko uporasz się z tym po raz pierwszy, następnym razem pójdzie ci już gładko.

Częste Problemy

Poniżej wypisane są najczęstsze problemy oraz jak je rozwiązać. Tworzenie offsetów jest bardzo zawiłe i łatwo można przy nim popełniać błędy, więc jest bardzo prawdopodobne, że natkniesz się kiedyś na jakiś problem.

Oceny i komentarze nie zostają takie same

Jeśli twoje oceny i komentarze nie przenoszą się na inne offsety, upewnij się, że link przenoszący przenosi na offset a nie na fragment. Link prowadzący na następny offset powinien wyglądać tak: http://pl-backrooms-wiki.wikidot.com/poradnik-offsetow/offset/1, a NIE tak: http://pl-backrooms-wiki.wikidot.com/fragment:poradnik-offsetow-1.

Link do offsetu przenosi mnie na pustą stronę

Jeśli link do offsetu prowadzi na pustą stronę, upewnij się, że nie ma w nim żadnych literówek. Link do offsetu powinien być identyczny jak link do strony nadrzędnej, na końcu tylko posiadając dodatkowo frazę "/offset/". Jeśli nadal link nie prowadzi do poprawnej strony, upewnij się, że kod linku wygląda tak: [http://pl-backrooms-wiki.wikidot.com/poradnik-offsetow/offset/1 JAKIŚ TEKST], a NIE tak: [[[http://pl-backrooms-wiki.wikidot.com/poradnik-offsetow/offset/1|JAKIŚ TEKST]]]. Jeśli link wciąż będzie zły, sprawdź, czy fragment jest podłączony do poprawnej strony nadrzędnej na Wiki. Jeśli to także nie pomaga, bardzo możliwe, że powinieneś odświeżyć swoją stronę nadrzędną.

Nie mogę podłączyć fragmentu do strony nadrzędnej

Czy wyświetla ci się taka wiadomość (albo przynajmniej coś w tym stylu), gdy próbujesz nadać fragmentowi stronę nadrzędną?


screen_tlum2.png

Jeśli tak, oznacza to, że nie dodałeś frazy "collab:" w nazwie strony nadrzędnej. Żeby ominąć ten problem, wejdź w opcje, następnie w Zmień Nazwę i dodaj "collab:" w nazwie strony. Gdy już to zrobisz, będziesz w stanie podłączyć wszystkie swoje fragmenty do strony nadrzędnej. Ten błąd występuje tylko w sandoxie i nie musisz się nim przejmować, gdy będziesz już wstawiać stronę na Wiki po greenlightcie.

Strona offsetu jest pusta, chociaż że fragment jest podłączony

Jeśli natkniesz się na taki błąd, w pierwszej kolejności sprawdź, czy strona nadrzędna, do której podłączone są fragmenty, została poprawnie wpisana. Jeśli to nie zadziała, oznacza to, że fragmenty zostały wstawione przed stroną nadrzędną. Robiąc stronę z offsetami, kolejność, w jakiej wstawiasz strony, ma znaczenie ze względu na to, jak działa kod "ListPages", przez co musisz iść zgodnie z kolejnością przez cały czas. NAJPIERW wstawiasz stronę nadrzędną, dopiero potem wstawiasz fragmenty według kolejności, w jakiej chcesz, żeby były ustawione. Na przykład, fragment 0 musi być po stronie nadrzędnej drugą wstawioną stroną. Fragment 1 musi być trzecią, fragment 2 czwartą i tak dalej. Jeśli fragmenty zostały wstawione na Wiki w złej kolejności, musisz je wszystkie usunąć i zacząć cały proces od nowa, tym razem trzymając się kolejności.

Porada: Jeśli chcesz w łatwy sposób ominąć ten błąd, najlepiej będzie w pierwszej kolejności otworzyć z odpowiadającym im linków wszystkie strony, które planujesz stworzyć, a następnie we wszystkich na raz otworzyć edycję. Następnie możesz przekleić do każdej strony odpowiadającą jej zawartość z twojego sandboxa i zapisać je wszystkie naraz, zachowując ich odpowiednią kolejność. Tak samo zrób z ustawianiem dla nich strony nadrzędnej. Upewnij się także, że sandboxowe linki, które wstawiasz, są zmienione na te działające na Wiki.

Moje offsety są w złej kolejności

To jest bardzo podobna sytuacja do tej wyżej. Jeśli twoje offsety są w złej kolejności, oznacza to, że wstawiłeś w złej kolejności swoje fragmenty. Na przykład, jeśli najpierw wstawiłeś fragment 1, a dopiero potem fragment 0, strona będzie myśleć, że fragment 1 jest fragmentem 0 i wyświetli najpierw go, czego oczywiście nie chcesz. Jeśli masz ten problem w sandboxie, najprostszym sposobem będzie zamiana kodów źródłowych w obu fragmentach. Możesz użyć porady w rozwiązaniu problemu wyżej, żeby nie mieć tego problemu, gdy wstawiasz już stronę na Wiki.


Porady i Offsetowe Sztuczki

Poniżej znajduje się kilka porad i wskazówek, których możesz użyć przy tworzeniu strony z offsetami! Jeśli chcesz użyć ich na swojej stronie droga wolna.

Zmiana Motywu

Jedną z najlepszych zalet offsetów jest możliwość zmiany motywu w zależności od offsetu. Możesz tego używać do najróżniejszych celów jak na przykład stopniowa korozja strony, czy do przedstawienia dwóch zupełnie różnych od siebie perspektyw na stronie.

Przykład

Strona Motywów

Zmiana Czcionki

Może i jest sposób, żeby zmieniać ją bez przechodzenia między offsetami przy użyciu kodu CSS i HTML, ale jest to jeszcze trudniejsze niż same offsety. Prawdziwa Sigma użyje offsetu. Jeśli nie chcesz babrać się w skomplikowanym kodzie, najłatwiej będzie skorzystać właśnie z nich.

Przykład

Poradnik:

Hasła:

Kolejną popularną sztuczką używaną z offsetami są hasła! Dzięki MyrandFoxMyrandFox mamy dostęp do niesamowitego kodu w JavaScript, który przenosi na inną stronę po wpisaniu dobrego hasła. Kod ten może być używany, by przenieść czytelnika na inny offset, dzięki czemu można nadać więcej aury tajemniczości w artykule. Spróbuj, kod nie gryzie!

Przykład:

Instrukcja:

Kod CSS Dla Innych Wyskakujących Okienek

Kolejną sztuczką, którą offsety mają w rękawie, jest wyświetlanie kilkusekundowego filmiku, który może wprowadzić atmosferę do twojego artykuły. Może i wymaga to dużo roboty od strony edytowania filmiku, ale gdy już skończysz, będzie rozpierać cię duma. Używaj jednak tej sztuczki z rozwagą, by nie irytować czytelników jej nadużywaniem.

Zobacz, jak to robią w angielskiej filii!

Instrukcja:

Podsumowanie

Gratulacje! Przeszedłeś szybki kurs z używania offsetów. Ich możliwości są praktycznie nieskończone, więc idź w świat i twórz arcydzieła dzięki swoim nowym umiejętnościom. Miejmy nadzieję, że dzięki temu poradnikowi więcej osób zacznie używać offsetów. Jeśli masz jeszcze jakieś problemy, odezwij się do naszego kodowego świra Cpt_FoxxlerCpt_Foxxler. Możesz także odezwać się na discordzie na kanale #pomoc-techniczna. Pomyślnego kodowania!

Tutaj znajduje się link do fragmentu, jeśli chcesz zobaczyć kod użyty na tej stronie. Pamiętaj tylko, że nie możesz go edytować bez zgody.


O ile nie zaznaczono inaczej, treść tej strony objęta jest licencją Creative Commons Attribution-ShareAlike 3.0 License