Navboks/dokumentacja

Szablon pozwalający na szybkie i łatwe tworzenie jednolitych szablonów nawigacyjnych.

Szablon korzysta z modułu NavboxBuilder do generowania szablonu. Jeśli szablon nie działa, może być to spowodowane brakiem rozszerzenia Scribunto. Jeśli tak jest, wyślij prośbę o włączenie przez Specjalna:Kontakt.

## Użycie

Szablon posiada wiele parametrów o różnych zastosowaniach. Poniżej znajduje się przykładowa składnia użycia.

```
{{Navboks

}}
```

## Parametry

Below is the list of all available parameters. At least one list is required for the navbox to show up. Apart from that, all other parameters are optional.

### Main

* `Tytuł` – main title of the navbox.
* `Linki` – links that appear on left side of the title bar.
	+ You can put any wikisyntax here.
	+ `Tytuł` is required for it to work.
* `Stan` – should the navbox be collapsed or expanded by default
	+ Values: *`zwinięty`* or *`rozwinięty`* (case insensitive)
	+ Empty or unrecognized values will disable collapsing.
	+ `Tytuł` is required for it to work
* `Góra` and `Dół` – fields above and below sections and images.
* `Lewy obraz` and `Prawy obraz` – fields beside sections, most commonly used to add images.
	+ You can put any content here, not only images.

### Sections

Sections include all lists with the same or higher number up to the next section.

* `Nagłówek n` – heading of a section
	+ n – any positive integer
	+ Requires at least one list to be included to show up
* `Stan n` – should the section be collapsed or expanded by default
	+ n – number of an existing header
	+ Values: *`zwinięty`* or *`rozwinięty`* (case insensitive)
	+ Empty or unrecognized values will disable collapsing.
* `Stan nagłówków` – same as above, but affects all headers
	+ Values: *`zwinięty`* or *`rozwinięty`* (case insensitive)
	+ Empty or unrecognized values will disable collapsing.
	+ Can be overridden by `Stan n`
* `Układ n` – selects layout for that section
	+ n – any positive integer
	+ Can be used without `Nagłówek n` to create a separate section without a header
	+ Values: *`tabela`* or *`poziomy`* (case insensitive)
	+ Empty or unrecognized values will use default (*`tabela`*).

#### Table layout (*`tabela`*)

Standard layout with lists and sublists.

* `Lewy obraz n` and `Prawy obraz n` – fields beside sections lists in that section, most commonly used to add images.
	+ n – number of an existing header
	+ You can put any content here, not only images.

#### Horizontal layout (*`poziomy`*)

Horizontal layout with lists forming columns. Sublists are not supported and will be treated as regular lists.

* `Na wiersz n` – maximum number of lists per row.
	+ n – number of an existing section.
	+ Value: any number above 1.
	+ Number of columns is still limited by space needed. You can't go higher than flexbox allows.
* `Rozpiętość n` – how many columns should the list span.
	+ n – number of an existing list.
	+ Value: any number between 0 and corresponding `Na wiersz n`

### Lists

* `Lista n` – single row with a list of links
	+ n – any positive integer
* `Grupa n` – heading of a list
	+ n – number of an existing list or sublist

Sublists will appear as sub entries of the group with same n.

* `Lista n.m` – single row with a list of links
	+ n and m – any positive integers
* `Grupa n.m` – heading of a sublist
	+ n and m – numbers of an existing sublist

### Styling

* `Navbox class` and `Navbox style` – applied to the main navbox element
* `Tytuł class` and `Tytuł style` – applied to the title bar
* `Baza class` and `Baza style` – applied to all groups, subgroups, headers, *above* and *below* fields
* `Góra class` and `Góra style` – applied to the above field
* `Dół class` and `Dół style` – applied to the below field
* `Obraz class` and `Obraz style` – applied to all image fields
* `Lewy obraz class` and `Lewy obraz style` – applied to the main left image field
* `Prawy obraz class` and `Prawy obraz style` – applied to the main right image field
* `Nagłówek class` and `Nagłówek style` – applied to all headers
* `Nagłówek n class` and `Nagłówek n style` – applied to the header specified with n
* `Lewy obraz n class` and `Lewy obraz n style` – applied to the left image field in the section specified with n
* `Prawy obraz n class` and `Prawy obraz n style` – applied to the right image field in the section specified with n
* `Grupa class` and `Grupa style` – applied to all groups
* `Podgrupa class` and `Podgrupa style` – applied to all subgroups
* `Grupa n class` and `Grupa n style` – applied to the group specified with n
* `Grupa n.m class` and `Grupa n.m style` – applied to the subgroup specified with n and m
* `Lista class` and `Lista style` – applied to all lists
* `Lista n class` and `Lista n style` – applied to the list specified with n
* `Lista n.m class` and `Lista n.m style` – applied to the list specified with n and m

## Domyślne wartości parametrów

Wszystkie powyższe parametry mogą zostać użyte przy wywoływaniu modułu Moduł:NavboxBuilder (tj. `{{#invoke:NavboxBuilder|create}}`). Parametry podane w ten sposób mogą zostać nadpisane przez podanie parametrów do szablonu, który wywołał moduł.

Oznacza to, że można podać domyślne parametry poprzez edycję szablonu {{Navboks}}, które w razie potrzeby zostaną nadpisane, gdy dany parametr zostanie podany ponownie przy użyciu szablonu.

## Kategoryzacja

Rozważ dodanie powstałego szablonu nawigacyjnego do kategorii Szablony nawigacyjne dodając poniższy kod na końcu kodu szablonu:

```
<noinclude>[[Kategoria:Szablony nawigacyjne]]</noinclude>
```

## Przykłady

Poniżej znajdziesz kilka przykładów pokazujących co oraz jak można osiągnąć.

### Tytuł i kilka wierszy

```
{{Navboks

}}
```

### Zwijany navboks

```
{{Navboks
...
}}

```

### Linki do szablonu

```
{{Navboks
...
}}

```

### Tytuł i grupy nie są wymagane

```
{{Navboks

}}
```

### Pola *góra* i *dół*

```
{{Navboks
...
...
}}
```

### Sekcje

```
{{Navboks
...

}}

```

### Zwijane sekcje

```
{{Navboks
...

}}

```

### Obrazy

```
{{Navboks
...
...
...
...
}}

```

### Podgrupy

```
{{Navboks

}}
```

### Stylowanie

```
{{Navbox
...
}}
```

### Trochę wszystkiego

```
{{Navboks

}}
```