Pomoc:CSS i JS społeczności

Poprzez CSS i JS społeczności lokalnI administratorzy mogą wpływać na wygląd strony i jej zachowanie dla wszystkich odwiedzających — zarówno zalogowanych, jak i niezalogowanych — wykraczając poza możliwości kreatora motywu.

Dostosowywanie wyglądu wiki, choć czasem wymagające, jest dla wielu edytorów ciekawym i satysfakcjonującym zadaniem. Jeśli chcesz spróbować swoich sił, warto najpierw zapoznać się z poniższymi informacjami:

• W pierwszej kolejności skorzystaj z Kreatora motywu – znacznie uprości to pracę z CSS-em.
• Miej na uwadze ograniczenia co do tego, co i jak możesz zmieniać — upewnij się, że Twoje zmiany nie naruszają polityki modyfikacji oraz Zasad Użytkowania.

CSS

Żeby dostosować CSS swojej społeczności, po prostu rozpocznij edycję jednego z dostępnych arkuszy CSS:

• MediaWiki:Fandomdesktop.css/MediaWiki:Common.css (wersja dla komputerów),

  Podczas ładowania obie strony są łączone ze sobą w jeden arkusz — najpierw wczytywany jest kod z Common.css, a dopiero potem z Fandomdesktop.css. W większości przypadków nie ma to znaczenia, jednakże jeśli używasz np. @import (np. do załadowania czcionek), umieść te reguły na początku Common.css.

• MediaWiki:FandomMobile.css (wersja mobilna).

Możesz się do nich dostać wpisując nazwy stron bezpośrednio w pole wyszukiwania na górze strony lub skorzystać z linków dostępnych z poziomu panelu administratora.

Fandom regularnie publikuje aktualizacje techniczne, które mogą mieć wpływ na wygląd Twojej wiki. W razie pytań lub problemów, odwiedź forum projektowania wiki.

JavaScript

Domyślnie Fandom pozwala jedynie na importowanie gotowych skryptów z Fandom Developers Wiki przez ImportJS. Jeśli chcesz dodawać własne skrypty JavaScript, najpierw musisz poprosić Fandom o włączenie tej funkcji korzystając z tego formularz kontaktowy.

Po włączeniu tej funkcji możesz dodawać własny JS poprzez edycję MediaWiki:Common.js i MediaWiki:Fandomdesktop.js. Kod, który się tam znajduje, zostanie załadowany dla wszystkich odwiedzających wiki z użyciem wersji dla komputerów

Kilka ważnych zasad:

• Ze względów bezpieczeństwa wszystkie zmiany w JS-ie muszą przejść przez procesie przeglądu kodu JavaScript.

  Uwaga:Importowanie już istniejących skryptów poprzez ImportJS nie wymaga tego przeglądu.

• Błędy JavaScript mogą zepsuć podstawowe funkcje strony – proszę, upewnij się, że Twój kod nie ma żadnych błędów.
• Staraj się unikać dodawania kodu JS, którego nie rozumiesz / ze źródeł, którym nie ufasz w pełni.
• Nie importuj kodu z osobistych stron JS ani ze stron niezabezpieczonych.

Uwagi techniczne

Zmiany wprowadzane w CSS lub JS zwykle nie są widoczne od razu po zapisaniu. Wynika to z mechanizmu zwanego „pamięcią podręczną” (cache). Jeśli robisz wiele edycji z rzędu, może być konieczne odświeżanie strony z pominięciem cache'u, aby zobaczyć aktualne zmiany.

Równie istotna jest kolejność wczytywania stylów i skryptów na Fandomie. Administratorzy powinni dobrze rozumieć ten mechanizm. Bardzo częstym powodem, dla którego jakieś modyfikacje „nie działają”, jest fakt, że strona wczytywana później nadpisuje lub unieważnia reguły zdefiniowane wcześniej.

Dodatkowo warto pamiętać, że dodawanie wielu reguł @import negatywnie wpływa na wydajność strony. Dobrą praktyką jest trzymanie całego kodu CSS w jednej głównej stronie, a jeśli to możliwe – importowanie tylko jej.

Kwestie dostępności

CSS i JS dają ogromne możliwości – jednakże z wielką mocą wiąże się wielka odpowiedzialność.

Za pomocą CSS można obejść mechanizm sprawdzania kontrastu używany przez Kreatora motywów i ręcznie ustawić kolory niemal wszystkich elementów wiki. W ten sam sposób da się zmieniać czcionki oraz ich rozmiary. Należy jednak pamiętać, że nieostrożne zmiany mogą sprawić, że strona stanie się mało czytelna, a nawet niemożliwa do odczytania dla innych użytkowników.

Własny JavaScript może nie tylko stwarzać zagrożenia związane z bezpieczeństwem, ale także negatywnie wpływać na działanie wiki. W szczególności może on:

• wydłużać czas ładowania stron,
• pogarszać płynność i responsywność interfejsu,
• powodować, że niektóre elementy strony staną się trudne w obsłudze lub całkowicie nieużywalne.

Strona Pomoc:Dostępność Twojej wiki oraz powiązana z nią lista kontrolna to bardzo dobre materiały, z którymi warto się zapoznać przed rozpoczęciem jakichkolwiek zaawansowanych prac nad wyglądem lub funkcjonalnością wiki.

Zobacz również

• Najlepsze praktyki w CSS – kilka najlepszych praktyk dotyczących modyfikowania CSS.
• Osobiste CSS i JS – jak tworzyć modyfikacje tylko dla siebie.
• Zaawansowane CSS i JS – więcej informacji dla chcących się zagłębić w świat edytowania CSS i JS.
• Dostosowywanie CSS i JS – strona zbierająca wszystkie szczegóły na temat CSS i JS.

Dalsze wsparcie

Szukasz dalszego wsparcia lub masz pytanie? Sprawdź poniższe linki, aby dowiedzieć się więcej.

• Dowiedz się więcej, sprawdzając inne strony pomocy.
• Uzyskaj pomoc od innych użytkowników Fandomu w Dyskusjach na Centrum Społeczności.
• Skontaktuj się ze wsparciem Fandomu poprzez formularz kontaktowy.