Pomoc:Formatowanie

Pomoc / Dla edytorów / Formatowanie

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ż.

Akapity

Przykłady akapitów i nowych linii

Wpisujesz	Otrzymujesz
Słowo pierwsze Słowo drugie Słowo trzecie	Słowo pierwsze Słowo drugie Słowo trzecie
Wiersz pierwszy <br /> Wiersz drugi <br /> Wiersz trzeci <br /> Wiersz czwarty <br />	Wiersz pierwszy Wiersz drugi Wiersz trzeci Wiersz czwarty
<poem> Wiersz pierwszy Wiersz drugi Wiersz trzeci Wiersz czwarty </poem>
Akapit pierwszy Akapit drugi Akapit trzeci Akapit czwarty	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 <br /> 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 <poem> i </poem> – każdy enter wewnątrz tych znaczników będzie odpowiadał kolejnemu wierszowi w tekście.

Ś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: == Tytuł sekcji ==. 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: === Tytuł podsekcji ===. 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 przełącznika __NOTOC__ lub przemieszczony przy użyciu __TOC__.
• 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: <h2>Tytuł sekcji</h2>, <h3>Tytuł podsekcji</h3> 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.

Przykłady sekcji

Wpisujesz	Otrzymujesz
== Tytuł sekcji ==	Tytuł sekcji
=== Tytuł podsekcji ===	Tytuł podsekcji
==== Tytuł podsekcji drugiego stopnia ====	Tytuł podsekcji drugiego stopnia
===== Tytuł podsekcji trzeciego stopnia =====	Tytuł podsekcji trzeciego stopnia
<h2>Tytuł sekcji nieedytowalnej</h2>	Tytuł sekcji nieedytowalnej
<h3>Tytuł podsekcji nieedytowalnej</h3>	Tytuł podsekcji nieedytowalnej
<h4>Tytuł podsekcji nieedytowalnej drugiego stopnia</h4>	Tytuł podsekcji nieedytowalnej drugiego stopnia
<h5>Tytuł podsekcji nieedytowalnej trzeciego stopnia</h5>	Tytuł podsekcji nieedytowalnej trzeciego stopnia

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: ''.

• Jeżeli chcemy by tekst pisany kursywą miał długość kilku linii, to wewnątrz apostrof tekst dodatkowo otaczamy parą znaczników HTML-owych: <poem> oraz </poem>.

Przykłady kursywy

Wpisujesz	Otrzymujesz
''Ten tekst jest kursywą''	Ten tekst jest kursywą
''<poem> Ten tekst także jest kursywą A nawet ma kilka linii! O, tutaj kolejna Jeszcze jedną, jeszcze musisz! </poem>''	Ten tekst także jest kursywą A nawet ma kilka linii! O, tutaj kolejna Jeszcze jedną, jeszcze musisz!

Pogrubienie

Podstawowym sposobem wyróżniania tekstu jest jego pogrubienie.

• Tworzone poprzez wkładanie tekstu pomiędzy parę potrójnych apostrof: '''.
• 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 <poem> oraz </poem>.

Przykłady pogrubienia

Wpisujesz	Otrzymujesz
'''Ten tekst jest pogrubiony'''	Ten tekst jest pogrubiony
'''<poem> Życie nie trwa wiecznie Ale miłość tak Nie zostawaj w tyle Czytaj Fakt! </poem>'''	Życie nie trwa wiecznie Ale miłość tak Nie zostawaj w tyle Czytaj Fakt!

Podkreślenie

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

Przykład podkreślenia

Wpisujesz	Otrzymujesz
<u>Ten tekst jest podkreślony</u>	Ten tekst jest podkreślony

Kod

Cytowanie kodu.

• Jest tworzone poprzez włożenie tekstu pomiędzy <code> oraz </code>.
• Jeżeli chcemy rozciągnąć to na kilka wierszy, to tak jak w poprzednich przypadkach – opatrzamy wewnątrz (po <code>) tekst znacznikami <poem>.
• Jednakże zamiast tego warto również rozważyć użycie <syntaxhighlight> lub <pre>, 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).

Przykłady kodu

Wpisujesz	Otrzymujesz
<code>Ten tekst jest kodem</code>	Ten tekst jest kodem
<poem><code> user@host$ cd katalog user@host$ ls plik user@host$ rm plik </code></poem>	user@host$ cd katalog user@host$ ls plik user@host$ rm plik

Kod podświetlany

Cytowanie kodu z podświetlaniem składni.

• Aby utworzyć, należy włożyć tekst pomiędzy <syntaxhighlight lang="nazwa"> oraz </syntaxhighlight>, gdzie w miejscu nazwa należy wpisać odpowiednią nazwę języka, którego składnia ma być podświetlana w tekście.
• Jest podobne do <code>, ale pozwala podświetlać składnię języka, w jakim jest kod pisany.
  • Tak jak <code> może zawierać wiele linii.
• Lista języków i ich nazw znajduje się 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ę tutaj.

Przykład kodu podświetlanego

Wpisujesz	Otrzymujesz
<syntaxhighlight lang="lua"> local sum = 0 for i = 1, #arg do   if tonumber(i) then     sum = sum + tonumber(i)   end end print(sum) </syntaxhighlight>	local sum = 0 for i = 1, #arg do if tonumber(i) then sum = sum + tonumber(i) end end print(sum)

Preformatowanie

Cytowanie kodu „na twardo”.

• Aby uzyskać, należy rozpocząć linię od spacji, lub wsadzić tekst w parę znaczników <pre> oraz </pre>, 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.

Przykłady preformatowania

Wpisujesz	Otrzymujesz
Ta linia zaczyna się od spacji	Ta linia zaczyna się od spacji
<pre> Róże są czerwone Fiołki są niebieskie Cukier jest słodki A alkohol niezdrowy </pre>	Róże są czerwone Fiołki są niebieskie Cukier jest słodki A alkohol niezdrowy

Listy

Przykłady list

Wpisujesz	Otrzymujesz
* Punkt ** Podpunkt *** Podpodpunkt	Punkt Podpunkt Podpodpunkt
# Jeden ## Jeden kropka jeden # Dwa Bum # Ojej	Jeden Jeden kropka jeden Dwa Bum Ojej
* Normalny punkt *# Numerowany podpunkt *#* Normalny podpodpunkt *# Kolejny numerowany podpunkt	Normalny punkt Numerowany podpunkt Normalny podpodpunkt Kolejny numerowany podpunkt
# Numerowany punkt #* Normalny podpunkt #*# Numerowany podpodpunkt # Kolejny numerowany punkt	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 (**). 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 <poem> 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 (#) 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 (##). 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 (**) stawiamy asterysk i kratkę (*#).
  • Aby lista numerowana mogła mieć podpunkty robimy na odwrót – kratka przed asteryskiem (#*).
  • 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.

Przykłady wcięć

Wpisujesz	Otrzymujesz
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.	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.

Definicje

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

Przykłady definicji

Wpisujesz	Otrzymujesz
;Warszawa : stolica Polski ;Praga : stolica Czech ;Berlin : stolica Niemiec	Warszawa stolica Polski Praga stolica Czech Berlin stolica Niemiec

Przypisy

• Aby wstawić przypis używamy znaczników <ref>Treść przypisu</ref>.
• Aby przypisy działały, musimy wstawić w artykule szablon {{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 <references /> ignoruje wszystkie przypisy poniżej niego oraz powyżej poprzedniego znacznika <references />, 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ć <ref name="nazwa">Przypis</ref>, gdzie nazwa 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 <ref name="nazwa" />, co utworzy odnośnik do tego samego przypisu.

Przykłady przypisów

Wpisujesz	Otrzymujesz
Zdanie<ref>Przypis</ref>	Zdanie
Zdanie<ref name="p1">Powtarzający się przypis</ref> Inne zdanie<ref name="p1" />	Zdanie Inne zdanie
{{Przypisy}}	Przypisy

Cytaty

• Cytaty wprowadzamy z pomocą szablonu {{cytat}}, wpisując {{cytat|cytowany fragment|krótki opis}}. 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) znajdują się tutaj.
• Możesz też wprowadzić bardziej dekoracyjną wersję szablonu – {{cytat2}} lub {{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ć <span style="color:###">. 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.
Ten tekst jest czerwony.
Ale ten tekst także jest czerwony! Co w takim razie zrobić? Jeśli chcemy zmienić kolor na ten poprzedni, nie musimy wpisywać <span style="color: black">. Wystarczy </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: <span color="#/przykładowe sześć cyfr lub liter/">. 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). 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 tego narzędzia.

Innym sposobem na kontrolę koloru tekstu może być użycie szablonu {{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:
<div style="text-align: justify; background: /KOD W HEX/; margin: 1em 0px; padding: 16px; border: /KOD W HEX/; 4px solid;">
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):

----

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 <b> oraz <i>). Używane są natomiast tagi <div> oraz <span>, najczęściej z CSS-em.

Zobacz też

• Tworzenie linków
• Wstawianie grafik
• Wstawianie filmów z YouTube
• Tworzenie tabel