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;syntaxhighlight&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;syntaxhighlight lang="'''''nazwa'''''"&gt;</code> oraz <code>&lt;/syntaxhighlight&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.

** 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]].

* Rozszerzenie do podświetlania kodu ma także inne możliwości jak np. pokazywanie numerów linii, używanie własnego CSS itp. Pełna lista znajduje się [[mw:Extension:SyntaxHighlight#Parameters|tutaj]].

<center>

{| class="wikitable"

|+ Przykład kodu podświetlanego

! Wpisujesz

! Otrzymujesz

|-

|

<code><poem><nowiki>&lt;syntaxhighlight lang="lua"&gt;

local sum = 0

for i = 1, #arg do

if tonumber(i) then

sum = sum + tonumber(i)

end

end

print(sum)

&lt;/syntaxhighlight&gt;</nowiki></poem></code>

|

<syntaxhighlight lang="lua">

local sum = 0

for i = 1, #arg do

if tonumber(i) then

sum = sum + tonumber(i)

end

end

print(sum)

</syntaxhighlight>

|}</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 ===

<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 ===

<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}}. Umieszczamy go zawsze na dole artykułu, pod sekcją „Zobacz też” oraz 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 tworzenia stron cytatów (w przestrzeni [[Cytaty:Strona główna|Cytaty]]) 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''):

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 <syntaxhighlight lang="html" inline><div></syntaxhighlight> oraz <syntaxhighlight lang="html" inline><span></syntaxhighlight>, 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]]