Ta strona zawiera informacje na temat zalecanych sposobów importowania CSS i JavaScript na wiki.
ImportJS[]
MediaWiki:ImportJS, która stanowi interfejs do prostego dodawania stron ze skryptami na wiki – zarówno lokalnych jak i z Dev Wiki
Użycie[]
MediaWiki:ImportJS stanowi prosty, tekstowy interfejs do importowania JS. Lokalne pliki muszą znajdować się w przestrzeni MediaWiki. Dotyczy to również importów z Dev Wiki. Przy podawaniu stron do importu, prefiks przestrzeni MediaWiki nie jest wymagany.
Kategorie.js
dev:AjaxRC.js
Kolejność skryptów[]
Strony dodane przez ImportJS będą wgrywane jako ostatnie. Pełna kolejność to:
- Common.js
- Fandomdesktop.js
- Importy dodane przez Common.js
- Importy dodane przez Fandomdesktop.js
- ImportJS
Importowanie CSS[]
@import[]
Użycie @import pozwala na importowanie plików CSS znajdujących się na wiki i innych stronach (zakończonych na .css). Składnia to:
@import url("path_to_file_to_import.css");
Używając przykładu podanego wyżej, aby zaimportować Local.css, należy dodać poniższą linijkę na samej górze MediaWiki:Common.css:
@import url("/load.php?articles=MediaWiki:Local.css&only=styles&mode=articles");
W przypadku wiki nieanglojęzycznych (w tym większości polskich wiki) należy podać /pl/ na początku adresu URL:
@import url("/pl/load.php?articles=MediaWiki:Local.css&only=styles&mode=articles");
Alternatywną metodą, która pozwala na łatwiejsze odnalezienie arkusza w miejscach jak karta „Sieć” narzędzi deweloperskich przeglądarek, jest użycie:
@import url("/MediaWiki:Local.css?ctype=text/css&action=raw");
Ale należy pamiętać, że arkusze importowane w ten sposób nie są minifikowane.
Więcej informacji na temat metody @import znajdziesz tutaj.
importArticles[]
W nawiązaniu do powyższej metody, zastosowanie metody importArticles zostanie opisane tylko z perspektywy importu CSS. Szczegóły na temat importowania w ten sposób skryptów JS znajdziesz na tej stronie.
importArticles może być nadal używany do importowania stylów CSS. Należy pamiętać, że dodanie arkusza w ten sposób będzie wymagało przejrzenia i zatwierdzenia zmodyfikowanego pliku JS.
W przeciwieństwie do @import, import poprzez importArticles może odbywać się w tle, co może skutkować szybszym czasem ładowania, ale może powodować niepożądany efekt migotania.
Wybór metody zależy od przypadku użycia. Jeśli stosujesz style, które drastycznie wpływają na wygląd każdej strony i chcesz uniknąć migotania, użyj metody @import. Jeśli style nie są ważne, muszą być ładowane warunkowo lub wpływają na części strony, które nie zawsze są widoczne natychmiast; użyj importArticles.
Aby zaimportować lokalny arkusz CSS za pomocą importArticles, poniższy kod musi zostać dodany do MediaWiki:Common.js lub MediaWiki:Fandomdesktop.js.
importArticles({
type: "style",
article: "MediaWiki:Local.css"
});
Zobacz również[]
- CSS i JS społeczności – jak tworzyć modyfikacje dla twojej społeczności.
- 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.
- Skontaktuj się ze wsparciem Fandomu w Dyskusjach na Centrum Społeczności.
- Sprawdź strony wsparcia: adopcja wiki, oflagowanie bota oraz linki językowe.