Edytujesz „Pomoc:Formatowanie”

{{Pomoc nagłówek|Dla edytorów}}
Na tej stronie Pomocy znajdziesz informacje o tym, jak formatować tekst na Nonsensopedii. Jeśli szukasz stron opisujących inne elementy wikitekstu (grafiki, tabele, filmy, linki), zajrzyj do sekcji ''[[#Zobacz też|Zobacz też]]''.

== Akapity ==
{| class="wikitable floatright"
|+ Przykłady akapitów i nowych linii
! Wpisujesz
! Otrzymujesz
|-
|
<code><poem>
Słowo pierwsze
Słowo drugie
Słowo trzecie
</poem></code>
|
Słowo pierwsze
Słowo drugie
Słowo trzecie
|-
|
<code><poem>
Wiersz pierwszy &lt;br /&gt;
Wiersz drugi &lt;br /&gt;
Wiersz trzeci &lt;br /&gt;
Wiersz czwarty &lt;br /&gt;
</poem></code>
| rowspan="2" |
Wiersz pierwszy <br />
Wiersz drugi <br />
Wiersz trzeci <br />
Wiersz czwarty <br />
|-
|
<code><poem>
&lt;poem&gt;
Wiersz pierwszy
Wiersz drugi
Wiersz trzeci
Wiersz czwarty
&lt;/poem&gt;
</poem></code>
|-
|
<code><poem>
<nowiki>Akapit pierwszy

Akapit drugi

Akapit trzeci

Akapit czwarty
</nowiki></poem></code>
|
Akapit pierwszy

Akapit drugi

Akapit trzeci

Akapit czwarty
|}

Znaki nowej linii (entery) w źródle strony nie pokrywają się z kolejnymi liniami w tekście.
* Pojedynczy enter w źródle jest traktowany jako jedna spacja (odstęp) w artykule.
* Podwójny enter w źródle oznacza akapit – służący do rozdzielania dwóch myśli (wątków) w tekście jednej sekcji.
* Jeżeli chcesz wymusić rozpoczęcie nowej linii, możesz zrobić to na dwa sposoby:
** Wstawiając znacznik <code>&lt;br /&gt;</code> w miejscu, gdzie ma się rozpocząć kolejny wiersz.
** W przypadku konieczności wymuszenia wielu nowych linii pod rząd tekst można wsadzić między znaczniki <code>&lt;poem&gt;</code> i <code>&lt;/poem&gt;</code> – każdy enter wewnątrz tych znaczników będzie odpowiadał kolejnemu wierszowi w tekście. 

<br clear="all" />

== Śródtytuły (nagłówki) ==
W hasłach możemy stosować cztery poziomy śródtytułów, sygnalizowane odpowiednią liczbą znaków równości.
* Aby utworzyć sekcję, należy umieścić na jej początku jej nagłówek. Robimy to, umieszczając tytuł sekcji pomiędzy dwiema parami znaków równości: <code><nowiki>== Tytuł sekcji ==</nowiki></code>. Należy pamiętać, że w tej samej linii nie może się znajdować nic innego.
* W podobny sposób wstawiamy nagłówki podsekcji, jednak dla każdego kolejnego stopnia zagnieżdżenia dokładamy po jednym znaku równości w obu parach: <code><nowiki>=== Tytuł podsekcji ===</nowiki></code>. '''Podsekcja musi znajdować się wewnątrz sekcji''', więc nagłówka podsekcji nie można umiejscowić przed pierwszym nagłówkiem sekcji.
* Spis treści (''Table of Contents'') domyślnie pojawia się pod pierwszym nagłówkiem sekcji w artykule, o ile ów się pojawia, spisy treści nie są wyłączone w preferencjach użytkownika, nie został wyłączony w artykule przez użycie [[Pomoc:Magiczne słowa|przełącznika]] <code><nowiki>__NOTOC__</nowiki></code> lub przemieszczony przy użyciu <code><nowiki>__TOC__</nowiki></code>.
* Jeżeli nagłówek sekcji ma być elementem szablonu, na przykład dyskusji użytkownika, wtedy zamiast znaków równości używamy znaczników HTML: <code><nowiki><h2>Tytuł sekcji</h2></nowiki></code>, <code><nowiki><h3>Tytuł podsekcji</h3></nowiki></code> i tak dalej, za każdym razem zwiększając cyfrę w znaczniku o jeden. Usunie to przycisk „edytuj” z nagłówka sekcji, którego kliknięcie otworzyłoby okno edycji nie sekcji dyskusji, lecz samego szablonu. Te znaczniki nie muszą mieć osobnej linii.

<center>
{| class="wikitable"
|+ Przykłady sekcji
! Wpisujesz
! Otrzymujesz
|-
| <code><nowiki>== Tytuł sekcji ==</nowiki></code>
|
== Tytuł sekcji ==
|-
| <code><nowiki>=== Tytuł podsekcji ===</nowiki></code>
|
=== Tytuł podsekcji ===
|-
| <code><nowiki>==== Tytuł podsekcji drugiego stopnia ====</nowiki></code>
|
==== Tytuł podsekcji drugiego stopnia ====
|-
| <code><nowiki>===== Tytuł podsekcji trzeciego stopnia =====</nowiki></code>
|
===== Tytuł podsekcji trzeciego stopnia =====
|-
| <code><nowiki><h2>Tytuł sekcji nieedytowalnej</h2></nowiki></code>
| <h2>Tytuł sekcji nieedytowalnej</h2>
|-
| <code><nowiki><h3>Tytuł podsekcji nieedytowalnej</h3></nowiki></code>
| <h3>Tytuł podsekcji nieedytowalnej</h3>
|-
| <code><nowiki><h4>Tytuł podsekcji nieedytowalnej drugiego stopnia</h4></nowiki></code>
| <h4>Tytuł podsekcji nieedytowalnej drugiego stopnia</h4>
|-
| <code><nowiki><h5>Tytuł podsekcji nieedytowalnej trzeciego stopnia</h5></nowiki></code>
| <h5>Tytuł podsekcji nieedytowalnej trzeciego stopnia</h5>
|}</center>

== Wyróżnianie pisma ==
Fragmenty tekstu znajdujące się w artykule mogą być wyróżniane na wiele sposobów – poprzez zmianę wyglądu liter go tworzących.

=== Kursywa ===
''Kursywa'' (tekst pochylony) jest tworzona przez wkładanie tekstu pomiędzy dwie pary apostrof: <code><nowiki>''</nowiki></code>.
* Jeżeli chcemy by tekst pisany ''kursywą'' miał długość kilku linii, to wewnątrz apostrof tekst dodatkowo otaczamy parą znaczników [[HTML]]-owych: <code>&lt;poem&gt;</code> oraz <code>&lt;/poem&gt;</code>.

<center>
{| class="wikitable"
|+ Przykłady kursywy
! Wpisujesz
! Otrzymujesz
|-
| <code><nowiki>''Ten tekst jest kursywą''</nowiki></code>
| ''Ten tekst jest kursywą''
|-
|
<code><poem><nowiki>''</nowiki>&lt;poem&gt;
Ten tekst także jest kursywą
A nawet ma kilka linii!
O, tutaj kolejna
[[Nonźródła:Jestem Hardkorem|Jeszcze jedną, jeszcze musisz!]]
&lt;/poem&gt;<nowiki>''</nowiki></poem></code>
|
''<poem>
Ten tekst także jest kursywą
A nawet ma kilka linii!
O, tutaj kolejna
[[Nonźródła:Jestem Hardkorem|Jeszcze jedną, jeszcze musisz!]]
</poem>''
|}</center>

=== Pogrubienie ===
Podstawowym sposobem wyróżniania tekstu jest jego '''pogrubienie'''.
* Tworzone poprzez wkładanie tekstu pomiędzy parę potrójnych apostrof: <code><nowiki>'''</nowiki></code>.
* Tak jak w przypadku ''kursywy'', jeśli chcemy by nasz '''pogrubiony''' tekst rozciągał się na kilka wierszy, to wewnątrz apostrof otaczamy tekst parą znaczników <code>&lt;poem&gt;</code> oraz <code>&lt;/poem&gt;</code>.

<center>
{| class="wikitable"
|+ Przykłady pogrubienia
! Wpisujesz
! Otrzymujesz
|-
| <code><nowiki>'''Ten tekst jest pogrubiony'''</nowiki></code>
| '''Ten tekst jest pogrubiony'''
|-
|
<code><poem><nowiki>'''</nowiki>&lt;poem&gt;
[[Życie]] nie trwa wiecznie
Ale [[miłość]] tak
Nie zostawaj w tyle
Czytaj [[Fakt (gazeta)|Fakt]]!
&lt;/poem&gt;<nowiki>'''</nowiki></poem></code>
|
'''<poem>
[[Życie]] nie trwa wiecznie
Ale [[miłość]] tak
Nie zostawaj w tyle
Czytaj [[Fakt (gazeta)|Fakt]]!
</poem>'''
|}</center>

=== Podkreślenie ===
Kolejnym sposobem wyróżniania tekstu jest jego <u>podkreślenie</u>. Tworzymy je poprzez włożenie tekstu pomiędzy <code>&lt;u&gt;</code> oraz <code>&lt;/u&gt;</code>.

<center>
{| class="wikitable"
|+ Przykład podkreślenia
! Wpisujesz
! Otrzymujesz
|-
| <code>&lt;u&gt;Ten tekst jest podkreślony&lt;/u&gt;</code>
| <u>Ten tekst jest podkreślony</u>
|}</center>

=== Kod ===
Cytowanie kodu.
* Jest tworzone poprzez włożenie tekstu pomiędzy <code>&lt;code&gt;</code> oraz <code>&lt;/code&gt;</code>.
* Jeżeli chcemy rozciągnąć to na kilka wierszy, to tak jak w poprzednich przypadkach – opatrzamy wewnątrz (po <code>&lt;code&gt;</code>) tekst znacznikami <code>&lt;poem&gt;</code>.
* Jednakże zamiast tego warto również rozważyć użycie <code>&lt;source&gt;</code> lub <code>&lt;pre&gt;</code>, opisanych niżej.
* Służy do ogólnego cytowania kodu źródłowego, czasami jest stosowane jako zwykłe wyróżnienie tekstu. 
* Jest pisane czcionką o stałej szerokości – przez co niektóre znaki mogą w nim wyglądać tak samo (z reguły dywizy i półpauzy).

<center>
{| class="wikitable"
|+ Przykłady kodu
! Wpisujesz
! Otrzymujesz
|-
|<code>&lt;code&gt;Ten tekst jest kodem&lt;/code&gt;</code>
|<code>Ten tekst jest kodem</code>
|-
|
<code><poem>&lt;poem&gt;&lt;code&gt;
user@host$ cd katalog
user@host$ ls
plik
user@host$ rm plik
&lt;/code&gt;&lt;/poem&gt;</poem></code>
|
<code><poem>
user@host$ cd katalog
user@host$ ls
plik
user@host$ rm plik
</poem></code>
|}</center>

=== Kod podświetlany ===
Cytowanie kodu z podświetlaniem składni.
* Aby utworzyć, należy włożyć tekst pomiędzy <code>&lt;source lang="'''''nazwa'''''"&gt;</code> oraz <code>&lt;/source&gt;</code>, gdzie w miejscu <code>'''''nazwa'''''</code> należy wpisać odpowiednią nazwę języka, którego składnia ma być podświetlana w tekście.
* Jest podobne do <code>&lt;code&gt;</code>, ale pozwala podświetlać składnię języka, w jakim jest kod pisany – jednakże uniemożliwia inną stylizację.
** Tak jak <code>&lt;code&gt;</code> może zawierać wiele linii.
* Lista języków i ich <code>'''''nazw'''''</code> znajduje się [[mw:Extension:SyntaxHighlight GeSHi#Supported languages|tutaj]].

<center>
{| class="wikitable"
|+ Przykład kodu podświetlanego
! Wpisujesz
! Otrzymujesz
|-
|
<code><poem><nowiki>&lt;source lang="lua"&gt;
local sum = 0
for i = 1, #arg do
  if tonumber(i) then
    sum = sum + i
  end
end
print(sum)
&lt;/source&gt;</nowiki></poem></code>
|
<source lang="lua">
local sum = 0
for i = 1, #arg do
  if tonumber(i) then
    sum = sum + i
  end
end
print(sum)
</source>
|}</center>

=== Preformatowanie ===
Cytowanie kodu „na twardo”.
* Aby uzyskać, należy rozpocząć linię od spacji, lub wsadzić tekst w parę znaczników <code>&lt;pre&gt;</code> oraz <code>&lt;/pre&gt;</code>, jeżeli tekst rozciąga się na kilka wierszy.
* Służy do cytowania dłuższych fragmentów kodu, bez podświetlania składni lub jakiejkolwiek stylizacji.

<center>
{| class="wikitable"
|+ Przykłady preformatowania
! Wpisujesz
! Otrzymujesz
|-
| <code>&nbsp;Ta linia zaczyna się od spacji</code>
|
 Ta linia zaczyna się od spacji
|-
|
<code><poem>&lt;pre&gt;
Róże są czerwone
Fiołki są niebieskie
[[Cukier]] jest słodki
A [[alkohol]] niezdrowy
&lt;/pre&gt;</poem></code>
|
<pre>
Róże są czerwone
Fiołki są niebieskie
Cukier jest słodki
A alkohol niezdrowy
</pre>
|}</center>

== Listy ==
{| class="wikitable floatright"
|+ Przykłady list
! Wpisujesz
! Otrzymujesz
|-
|
<code><poem>
<nowiki>* Punkt
** Podpunkt
*** Podpodpunkt
</nowiki></poem></code>
|
* Punkt
** Podpunkt
*** Podpodpunkt
|-
|
<code><poem>
<nowiki># Jeden
## Jeden kropka jeden
# Dwa
Bum
# Ojej
</nowiki></poem></code>
|
# Jeden
## Jeden kropka jeden
# Dwa
Bum
# Ojej
|-
|
<code><poem>
<nowiki>* Normalny punkt
*# Numerowany podpunkt
*#* Normalny podpodpunkt
*# Kolejny numerowany podpunkt
</nowiki></poem></code>
|
* Normalny punkt
*# Numerowany podpunkt
*#* Normalny podpodpunkt
*# Kolejny numerowany podpunkt
|-
|
<code><poem>
<nowiki># Numerowany punkt
#* Normalny podpunkt
#*# Numerowany podpodpunkt
# Kolejny numerowany punkt
</nowiki></poem></code>
|
# Numerowany punkt
#* Normalny podpunkt
#*# Numerowany podpodpunkt
# Kolejny numerowany punkt
|}

Listy służą do wymienienia i ewentualnego krótkiego opisania pokrewnych elementów danego zagadnienia, np. członków zespołu, listy utworów, szeregu dat, czy kolejnych kroków jakiegoś działania. Są dwa rodzaje list – wypunktowana i numerowana.
* Lista wypunktowana charakteryzuje się punktem przed elementem listy (również zwanym punktem). Używamy go, gdy elementy są sobie równorzędne i mogą mieć dowolną kolejność, np. podgatunki zwierzęcia. Aby wstawić taki punkt, stawiamy asterysk (gwiazdkę, *) na początku nowej linii. Ta strona składa się z list wypunktowanych.
** Lista taka może mieć podpunkty, które mogą dalej rozwijać dany element lub stanowić uwagi go dotyczące. Podpunkty uzyskujemy stawiając na początku nowej linii dwa asteryski (<code>**</code>). Rzecz jasna, unikamy podpunktów bez punktów.
*** Podpunkty również mogą mieć swoje podpunkty, które tworzymy znów dostawiając kolejny asterysk. Można tak w nieskończoność, choć staramy się tego unikać.
** Kolejne punkty oddzielamy nie jak akapity podwójnymi enterami, lecz tak, jak wewnątrz <code>&lt;poem&gt;</code> pojedynczymi.
* Lista numerowana służy wymienieniu elementów o konkretnej kolejności, np. ciąg przyczynowo-skutkowy, lista utworów lub klasyfikacja w zawodach sportowych. Aby dodać punkt listy numerowanej stawiamy kratkę zwaną także hashem (<code>#</code>) na początku linii.
** Tak samo, jak w przypadku listy wypunktowanej, tak i lista numerowana może mieć podpunkty. Tworzymy je stawiając w nowej linii dwie kratki (<code>##</code>). Tak samo działają i kolejne rzędy podpunktów.
** Lista numerowana jest dość wrażliwa i musi zostać zachowana sekwencja kratek w każdej kolejnej linii, by lista nie została nagle przerwana, tzn. tylko jeden enter przed kolejnym punktem.
* Listy mogą być mieszane, tj. lista wypunktowana ma numerowane podpunkty, lub lista numerowana ma wypunktowane podpunkty.
** Aby lista wypunktowana mogła mieć numerowane podpunkty, w podpunkcie zamiast dwóch asterysków (<code>**</code>) stawiamy asterysk i kratkę (<code>*#</code>).
** Aby lista numerowana mogła mieć podpunkty robimy na odwrót – kratka przed asteryskiem (<code>#*</code>).
** Takie listy mogą mieć i dalsze podpunkty kolejnych rodzajów.

=== Wcięcia ===
Możesz wreszcie stosować wyróżniające wcięcia, używając znaków dwukropka.

<center>
{| class="wikitable"
|+ Przykłady wcięć
! Wpisujesz
! Otrzymujesz
|-
|<pre>To jest tekst bez wcięcia.
:To jest wcięty akapit.
::Jeszcze bardziej wcięty akapit.
:To jest kolejny wcięty akapit.
I znowu akapit bez wcięcia.</pre>
|To jest tekst bez wcięcia.
:To jest wcięty akapit.
::Jeszcze bardziej wcięty akapit.
:To jest kolejny wcięty akapit.
I znowu akapit bez wcięcia.
|}</center>

=== Definicje ===
Specyficznym rodzajem list są definicje, w których nazwę definicji poprzedza się znakiem średnika, zaś wyjaśnienie definicji znakiem dwukropka.

<center>
{| class="wikitable"
|+ Przykłady definicji
! Wpisujesz
! Otrzymujesz
|-
|<pre>;Warszawa : stolica Polski
;Praga : stolica Czech
;Berlin : stolica Niemiec</pre>
|
;Warszawa : stolica Polski
;Praga : stolica Czech
;Berlin : stolica Niemiec
|}</center>

== Przypisy ==
* Aby wstawić przypis używamy znaczników <code>&lt;ref&gt;Treść przypisu&lt;/ref&gt;</code>.
* Aby przypisy działały, musimy wstawić w artykule szablon {{s|Przypisy}}. Umiejscawiamy go zawsze na dole artykułu, nad szablonami nawigacyjnymi i kategoriami, gdyż znajdujący się w szablonie znacznik <code>&lt;references /&gt;</code> ignoruje wszystkie przypisy poniżej niego oraz powyżej poprzedniego znacznika <code>&lt;references /&gt;</code>, co pozwala utworzyć kilka sekcji przypisów w jednym artykule.
* Można umieścić odnośniki do tego samego przypisu w wielu miejscach w artykule.
** Aby to zrobić musimy w miejscu, w którym pojawia się po raz pierwszy wpisać <code>&lt;ref name="'''''nazwa'''''"&gt;Przypis&lt;/ref&gt;</code>, gdzie <code>'''''nazwa'''''</code> to krótka nazwa przypisu, która '''musi''' składać się z liter i '''może''' zawierać cyfry.
** Przy każdym kolejnym odwołaniu wpisujemy tylko <code>&lt;ref name="'''''nazwa'''''" /&gt;</code>, co utworzy odnośnik do tego samego przypisu.

<center>
{| class="wikitable"
|+ Przykłady przypisów
! Wpisujesz
! Otrzymujesz
|-
| <code>Zdanie&lt;ref&gt;Przypis&lt;/ref&gt;</code>
| Zdanie<ref>Przypis</ref>
|-
|
<code><poem>
Zdanie&lt;ref name="p1"&gt;Powtarzający się przypis&lt;/ref&gt;
Inne zdanie&lt;ref name="p1" /&gt;
</poem></code>
|
<poem>
Zdanie<ref name="p1">Powtarzający się przypis</ref>
Inne zdanie<ref name="p1"/>
</poem>
|-
|<code><nowiki>{{Przypisy}}</nowiki></code>
|{{Przypisy}}
|}</center>

== Cytaty ==
* Cytaty wprowadzamy z pomocą szablonu {{s|cytat}}, wpisując <nowiki>{{cytat|cytowany fragment|krótki opis}}</nowiki>. Należy również pamiętać o postawieniu kropki na końcu cytatu, '''nigdy''' zaś w opisie. Wszystkie zalecenia odnośnie wprowadzania cytatów znajdują się [[Nonsensopedia:Formatowanie/cytaty|tutaj]].
* Możesz też wprowadzić bardziej dekoracyjną wersję szablonu – {{s|cytat2}} lub {{s|cquote}}. Nie powinna jednak zaburzać układu graficznego strony.

== Kolory ==
Czasem zdarza się, że chcemy ożywić kolorami nasz artykuł. Jest to całkiem proste, o ile znamy komendy odpowiedzialne za to.

=== Tekst ===
Na początek zmiana koloru tekstu. Aby to zrobić, należy wpisać <nowiki><span style="color:###"></nowiki>. W miejsce trzech kratek wpisujemy nazwę koloru, którego chcemy użyć. Uwaga! Jego nazwa musi być napisana po angielsku! Na przykład: green, red, white…

Gdy wpiszemy tę komendę, każdy tekst napisany po niej będzie w takim kolorze, jaki jest w komendzie. Poniżej przykład koloru ''red''.<br />
<span style="color: red">Ten tekst jest czerwony.<br />
Ale ten tekst także jest czerwony! Co w takim razie zrobić? Jeśli chcemy zmienić kolor na ten poprzedni, nie musimy wpisywać <nowiki><span style="color: black"></nowiki>. Wystarczy <nowiki></span></nowiki>.</span>

Jak widać, ten tekst jest już normalny. Oprócz kolorów typu red, orange czy blue, można skorzystać z innych, niestandardowych. Muszą być one wpisywane w systemie szesnastkowym, czyli '''hex'''. Wpisujemy je następująco: <nowiki><span color="#/przykładowe sześć cyfr lub liter/"></nowiki>. Na przykład, chcąc użyć koloru oliwkowego, użyjemy #808000. Kody kolorów możesz otrzymać na wiele sposobów (np. z Gimpa lub innego edytora grafiki). [https://www.w3schools.com/colors/colors_picker.asp Na tej stronie] znajdziesz proste narzędzie do wybierania kolorów, a jeśli chcesz zbudować od razu całą ładnie komponującą się paletę, to możesz skorzystać z [https://color.adobe.com/create tego narzędzia].

Innym sposobem na kontrolę koloru tekstu może być użycie szablonu {{s|c}}, którego użycie wyjaśnione jest w dołączonej do niego treści.

=== Tło strony ===
Bywa, że możemy chcieć zmienić kolor całej strony. Do tego potrzebna jest zupełnie inna, dłuższa komenda. Brzmi ona:<br />
<nowiki><div style="text-align: justify; background: /KOD W HEX/; margin: 1em 0px; padding: 16px; border: /KOD W HEX/; 4px solid;"></nowiki><br />
Pierwszy /KOD W HEX/ odpowiada za kolor tła strony, a drugi /KOD W HEX/ za kolor ramki tła.

== Poziome linie ==
Pozioma linia jest wstawiana za pomocą czterech kresek (znaków ''minus''):

'''<nowiki>----</nowiki>'''

Efekt jest następujący:

----

Nie nadużywaj poziomych linii; staraj się je stosować oszczędnie i w wyjątkowych wypadkach.

== Kody HTML i CSS ==
MediaWiki zostało tak pomyślane, aby tworzenie hasła było jak najmniej kłopotliwe, a użytkownik w jak najmniejszej mierze zaprzątał sobie głowę sprawami technicznymi. Do zdecydowanej większości zastosowań wystarczą funkcje wbudowane w wikitekst.

Możliwe jest jednak stosowanie także tagów języka HTML, jeśli tylko je znamy. Nie zalecamy używania tagów HTML, do których są odpowiednie znaczniki MediaWiki (na przykład <nowiki><b> oraz <i></nowiki>). Używane są natomiast tagi <source lang="html" inline><div></source> oraz <source lang="html" inline><span></source>, najczęściej z CSS-em.

== Zobacz też ==
* [[Pomoc:Tworzenie linków|Tworzenie linków]]
* [[Pomoc:Wstawianie grafik|Wstawianie grafik]]
* [[Pomoc:YouTube|Wstawianie filmów z YouTube]]
* [[Pomoc:Tabele|Tworzenie tabel]]

<br clear="all" />

{{Pomoc navbox}}

[[Kategoria:Pomoc – dla edytorów]]