Paweł Niemczuk: Paweł Niemczuk przeniósł stronę Strona główna/dokumentacja na Pomoc:Strona główna, bez pozostawienia przekierowania pod starym tytułem: właściwa przestrzeń nazw

2026-09-15T22:52:34Z

Paweł Niemczuk przeniósł stronę Strona główna/dokumentacja na Pomoc:Strona główna, bez pozostawienia przekierowania pod starym tytułem: właściwa przestrzeń nazw

Paweł Niemczuk: Utworzenie strony dokumentacji

2026-09-15T22:49:29Z

Utworzenie strony dokumentacji

Nowa strona

= Strona główna Enkolu =

Niniejsza strona opisuje budowę, sposób działania oraz zasady edycji [[Strona główna|strony głównej Enkolu]].

Strona główna została zbudowana z wykorzystaniem:
* szablonów MediaWiki,
* układu CSS Grid,
* klas zdefiniowanych w [[MediaWiki:Common.css]].

Treść poszczególnych paneli nie jest wpisana bezpośrednio do kodu strony głównej. Każdy panel korzysta z osobnego szablonu, dzięki czemu jego zawartość można aktualizować niezależnie.

== Ogólna budowa strony ==

Strona składa się z:
# górnego banera,
# dwóch równoległych kolumn,
# paneli umieszczonych w obu kolumnach.

Układ dwóch kolumn jest zachowywany również na urządzeniach mobilnych.

Za główny układ odpowiadają klasy CSS:

<pre>
.enkol-main-grid
.enkol-main-column
</pre>

Klasa <code>.enkol-main-grid</code> tworzy dwie równe kolumny:

<pre>
grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
</pre>

Nie należy dodawać reguły mobilnej zmieniającej układ strony na jedną kolumnę.

== Kod strony głównej ==

Aktualny schemat strony głównej:

<pre>
{{Banner-góra}}

<div class="enkol-main-grid">

<div class="enkol-main-column">

{{panel głównej
|[[Biblioteka:Katalog artykułów prasowych|Katalog artykułów prasowych]]
|{{Katalog artykułów}}
|#cfc28d
}}

{{panel głównej
|Interesujący artykuł
|{{Artykuł na medal}}
|#cfc28d
}}

{{panel głównej
|Ciekawa grafika
|{{Grafika na medal}}
|#cfc28d
}}

{{panel głównej
|Czy nie wiesz, że...
|{{czy wiesz}}
|#cfc28d
}}

</div>

<div class="enkol-main-column">

{{panel głównej
|Archiwista poleca
|{{Archiwista poleca}}
|#cfc28d
}}

{{panel głównej
|Najnowsze w archiwum
|{{Dodane do archiwum}}
|#cfc28d
}}

{{panel głównej
|O Archiwum
|{{o archiwum główna}}
|#cfc28d
}}

</div>

</div>

<noinclude>
[[Kategoria:Strona główna]]
</noinclude>

__NOTOC__
__NOEDITSECTION__
</pre>

== Szablon „panel głównej” ==

[[Szablon:panel głównej]] jest wspólnym szablonem odpowiadającym za wygląd pojedynczego panelu.

Aktualna konstrukcja:

<pre>
<includeonly><div class="main-panel">
<div class="main-panel-header" style="background-color:{{{3|#cfc28d}}};">{{{1|}}}</div>
<div class="main-panel-content">{{{2|}}}</div>
</div></includeonly>
</pre>

Parametry:

{| class="wikitable"
! Parametr
! Znaczenie
! Uwagi
|-
| 1
| tytuł panelu
| może zawierać wikilink
|-
| 2
| treść panelu
| najczęściej transkluzja innego szablonu
|-
| 3
| kolor tła nagłówka
| domyślnie <code>#cfc28d</code>
|}

Przykład:

<pre>
{{panel głównej
|Interesujący artykuł
|{{Artykuł na medal}}
|#cfc28d
}}
</pre>

Za wygląd panelu odpowiadają klasy:

<pre>
.main-panel
.main-panel-header
.main-panel-content
</pre>

== Górny baner ==

Za górną część strony odpowiada [[Szablon:Banner-góra]].

Zawiera:
* nazwę Enkolu,
* krótki opis serwisu,
* liczbę stron,
* liczbę plików,
* zestaw najważniejszych linków nawigacyjnych.

Baner korzysta z klas:

<pre>
.main-banner
.main-banner-intro
.main-banner-title
.main-banner-stats
.main-banner-links
</pre>

Baner jest wyświetlany na pełnej szerokości strony, ponad obiema kolumnami.

== Szablony zawartości paneli ==

=== Katalog artykułów prasowych ===

Szablon:

[[Szablon:Katalog artykułów]]

Wyświetlany w panelu:

'''Katalog artykułów prasowych'''

Zawiera krótki opis katalogu oraz automatycznie obliczaną liczbę skatalogowanych artykułów.

Liczba artykułów jest pobierana za pomocą zapytania Semantic MediaWiki.

Aktualizacja tekstu odbywa się bezpośrednio w tym szablonie.

=== Interesujący artykuł ===

Szablon:

[[Szablon:Artykuł na medal]]

Wyświetlany w panelu:

'''Interesujący artykuł'''

Zawiera:
* ilustrację,
* tytuł wybranego artykułu,
* krótki opis,
* odsyłacz do całego artykułu,
* link do archiwum,
* link do zgłaszania kandydatur.

Ilustracja korzysta z klasy:

<pre>
.main-featured-image
</pre>

Linki umieszczone w dolnej części panelu korzystają z:

<pre>
.main-panel-actions
</pre>

Zmiana wyróżnionego artykułu wymaga edycji wyłącznie tego szablonu.

=== Ciekawa grafika ===

Szablon:

[[Szablon:Grafika na medal]]

Wyświetlany w panelu:

'''Ciekawa grafika'''

Zawiera:
* wyróżnioną grafikę,
* podpis,
* link do archiwum grafik,
* link do zgłaszania kandydatur.

Wykorzystywane klasy:

<pre>
.main-featured-image
.main-featured-caption
.main-panel-actions
</pre>

Grafiki są automatycznie skalowane tak, aby nie przekraczały szerokości panelu.

=== Czy nie wiesz, że... ===

Szablon:

[[Szablon:czy wiesz]]

Wyświetlany w panelu:

'''Czy nie wiesz, że...'''

Zawiera krótką listę ciekawostek oraz linki do archiwum i zgłaszania propozycji.

Lista korzysta z klasy:

<pre>
.main-didyouknow
</pre>

Linki w dolnej części korzystają z:

<pre>
.main-panel-actions
</pre>

Nowe wpisy należy dodawać zgodnie z instrukcją umieszczoną w samym szablonie.

=== Archiwista poleca ===

Szablon:

[[Szablon:Archiwista poleca]]

Wyświetlany w prawej kolumnie.

Zawiera:
* ilustrację wybranego materiału archiwalnego,
* krótki opis,
* link do właściwej strony Archiwum.

Grafika korzysta z klasy:

<pre>
.main-featured-image
</pre>

Zmiana polecanego materiału odbywa się wyłącznie poprzez edycję tego szablonu.

=== Najnowsze w archiwum ===

Szablon:

[[Szablon:Dodane do archiwum]]

Wyświetlany w panelu:

'''Najnowsze w archiwum'''

Zawiera ręcznie aktualizowaną listę ostatnio dodanych lub szczególnie interesujących dokumentów.

Lista jest opakowana klasą:

<pre>
.main-archive-list
</pre>

Klasa ta ogranicza wcięcie listy i poprawia jej wygląd na wąskich ekranach.

=== O Archiwum ===

Szablon:

[[Szablon:o archiwum główna]]

Wyświetlany w panelu:

'''O Archiwum'''

Zawiera krótki tekst informacyjny zachęcający użytkowników do przekazywania i publikowania materiałów archiwalnych.

Szablon nie wymaga specjalnych klas CSS.

== Grafiki na stronie głównej ==

Grafiki znajdujące się w panelach powinny być umieszczane w:

<pre>
<div class="main-featured-image">
...
</div>
</pre>

W [[MediaWiki:Common.css]] obowiązuje:

<pre>
.main-featured-image img {
max-width: 100%;
height: auto;
}
</pre>

Dzięki temu można podać nominalną szerokość grafiki, np.:

<pre>
[[Plik:Nazwa.jpg|400px]]
</pre>

Na szerokim ekranie grafika może mieć 400 px, natomiast na telefonie zostanie automatycznie zmniejszona do szerokości panelu.

Nie należy używać:
* <code><center></code>,
* <code>align="center"</code>,
* sztywnych szerokości kontenerów,
* tabel wyłącznie do pozycjonowania grafiki.

== Linki akcji ==

Linki typu:

* Czytaj całość,
* Archiwum,
* Zgłoś kandydaturę

należy umieszczać w:

<pre>
<div class="main-panel-actions">
...
</div>
</pre>

Pozwala to zachować wspólne wyrównanie i sposób zawijania linków.

== CSS strony głównej ==

Wszystkie style strony głównej znajdują się w:

[[MediaWiki:Common.css]]

w sekcji:

<pre>
/* =========================================================
STRONA GŁÓWNA ENKOLU
========================================================= */
</pre>

Podstawowe klasy:

{| class="wikitable"
! Klasa
! Zastosowanie
|-
| <code>.enkol-main-grid</code>
| główny układ dwóch kolumn
|-
| <code>.enkol-main-column</code>
| pojedyncza kolumna strony
|-
| <code>.main-panel</code>
| pojedynczy panel
|-
| <code>.main-panel-header</code>
| nagłówek panelu
|-
| <code>.main-panel-content</code>
| zawartość panelu
|-
| <code>.main-featured-image</code>
| ilustracja w panelu
|-
| <code>.main-featured-caption</code>
| podpis pod ilustracją
|-
| <code>.main-panel-actions</code>
| linki akcji
|-
| <code>.main-didyouknow</code>
| lista ciekawostek
|-
| <code>.main-archive-list</code>
| lista nowych materiałów Archiwum
|-
| <code>.main-banner</code>
| górny baner
|}

== Zasady modyfikacji ==

Przy zmianach strony głównej należy zachować następujące zasady:

# Treści paneli powinny pozostać w osobnych szablonach.
# Na samej stronie głównej należy definiować przede wszystkim kolejność i rozmieszczenie paneli.
# Nie należy wracać do tabel jako mechanizmu tworzenia głównego układu strony.
# Nie należy stosować ujemnych marginesów ani elementów <code>float</code> do pozycjonowania kolumn.
# Nie należy dodawać sztywnych szerokości, które mogą powodować poziome przewijanie strony.
# Grafiki powinny pozostać responsywne.
# Po zmianie CSS należy sprawdzić stronę zarówno na komputerze, jak i na telefonie.
# Układ główny powinien pozostać dwukolumnowy również na telefonie.

== Dodawanie nowego panelu ==

Aby dodać nowy panel, najlepiej:

# utworzyć osobny szablon z jego treścią,
# dodać wywołanie <code>{{panel głównej}}</code> w odpowiedniej kolumnie.

Przykład:

<pre>
{{panel głównej
|Tytuł nowego panelu
|{{Nazwa nowego szablonu}}
|#cfc28d
}}
</pre>

Nie należy wpisywać rozbudowanej treści bezpośrednio do kodu strony głównej.

== Usuwanie lub przenoszenie panelu ==

Panel można przenieść między kolumnami poprzez przeniesienie całego wywołania:

<pre>
{{panel głównej
...
}}
</pre>

Nie wymaga to zmian w szablonie zawartości ani w CSS.

== Kontrola po zmianach ==

Po większej zmianie należy sprawdzić:

* widok desktopowy,
* telefon w orientacji pionowej,
* telefon w orientacji poziomej,
* poprawne skalowanie grafik,
* zawijanie długich tytułów,
* brak poziomego przewijania,
* działanie wszystkich linków,
* poprawność transkluzji szablonów.

W przypadku zmian w [[MediaWiki:Common.css]] może być konieczne odświeżenie pamięci podręcznej przeglądarki lub ResourceLoadera.

== Powiązane strony ==

* [[Strona główna]]
* [[MediaWiki:Common.css]]
* [[Szablon:Banner-góra]]
* [[Szablon:panel głównej]]
* [[Szablon:Katalog artykułów]]
* [[Szablon:Artykuł na medal]]
* [[Szablon:Grafika na medal]]
* [[Szablon:czy wiesz]]
* [[Szablon:Archiwista poleca]]
* [[Szablon:Dodane do archiwum]]
* [[Szablon:o archiwum główna]]

[[Kategoria:Pomoc]]

← poprzednia wersja	Wersja z 22:52, 15 wrz 2026
(Brak różnic)

Pomoc:Strona główna - Historia wersji

Paweł Niemczuk: Paweł Niemczuk przeniósł stronę Strona główna/dokumentacja na Pomoc:Strona główna, bez pozostawienia przekierowania pod starym tytułem: właściwa przestrzeń nazw

Paweł Niemczuk: Utworzenie strony dokumentacji