Skocz do: nawigacji, wyszukiwania

Formatowanie struktury dokumentu: Różnice pomiędzy wersjami

m (Zabezpieczył(a) „Formatowanie struktury dokumentu” ([edytowanie=Dozwolone tylko dla administratorów] (na zawsze) [przenoszenie=Dozwolone tylko dla administratorów] (na zawsze)))
 
(Brak różnic)

Aktualna wersja na dzień 12:46, 4 gru 2015


Formatowanie struktury dokumentu

Formatowanie artykułów zamieszczanych w portalu wymiany wiedzy projektu MICLAB [*]


Tytuły i sekcje

Wikikod pozwala dzielić tekst na sekcje. Każda sekcja posiada swój tytuł, który jest widoczny odpowiednio dużą czcionką. Sekcje tworzy się poprzez wstawienie na ich początku tytułu.

Tytuły tworzy się za pomocą wikikodu "=". Tytuły posiadają hierarchię od poziomu 1. (jeden znak "=") do poziomu 6. (sześć znaków "="). Tytuły coraz niższych poziomów są wyświetlane coraz mniejszą czcionką. Poziom 5. wyświetlany jest taką samą czcionką jak zwykły tekst, 6. poziom wyświetlany jest czcionką o połowę mniejszą od normalnej. Poziomy 1. i 2. są dodatkowo wyróżnianie poziomą kreską.

Sekcje mogą być zagłębiane jedna w drugiej i tworzyć w ten sposób hierarchiczną strukturę. Co więcej, oprogramowanie tworzy z tytułów sekcji automatycznie spis treści, który standardowo jest umieszczany zaraz nad pierwszą, utworzoną w dokumencie sekcją. Standardowo, spis treści pojawia się automatycznie, gdy na stronie jest więcej niż 2 sekcje tego samego poziomu.

Każdą sekcję można oddzielnie edytować, bez konieczności ładowania do okna edycji kodu pozostałej części strony, co jest szczególnie przydatne przy bardzo obszernych dokumentach. Robi się to klikając na mały link [edytuj], który znajduje się po prawej stronie ekranu na wysokości danej sekcji. W przypadku sekcji posiadających podsekcje, kliknięcie na "[edytuj]" spowoduje wczytanie do pola edycji także kodu wszystkich podsekcji.

Przykładowy kod:

= 1 poziom =
== 2 poziom ==
=== 3 poziom ===
==== 4 poziom ====
===== 5 poziom =====
====== 6 poziom ======

Aby uniknąć rozbicia struktury tego dokumentu, który również jest pisany z użyciem mechanizmu sekcji i tytułów, rezultat przykładowego użycia tytułów znajduje się w dodatku Przykład stosowania tytułów.

Umiejscowieniem spisu treści można sterować za pomocą tzw. magicznego słowa __TOC__. Słowo __TOC__ określa miejsce gdzie w tekście ma wystąpić spis treści. Spis treści można też wyłączyć przez napisanie w tekście __NOTOC__.

Przykład użycia zmiennej __TOC__ jest pokazany we wcześniej wspomnianym dodatku: Przykład stosowania tytułów.


Spisy

Wikikod spisów zwanych też listami umożliwia tworzenie automatycznie formatowanych "wyliczanek". Kody te należy wstawiać na początku linii tekstu, w przeciwnym razie zostaną zinterpretowane przez system jako zwykłe znaki. Istnieją dwa rodzaje takiego kodu.

  • "*" - to lista nienumerowana, w której kolejne pozycje są oznaczane tzw. "bombą", czyli grubym kwadracikiem lub kulką
  • "#" - to lista numerowana, w której kolejne pozycje są oznaczane standardowo kolejnymi liczbami arabskimi, poczynając od "1"

Przykładowy kod listy nienumerowanej:

* pozycja z "bombą"
* pozycja z "bombą"
* pozycja z "bombą"

i efekt:

  • pozycja z "bombą"
  • pozycja z "bombą"
  • pozycja z "bombą"

Przykładowy kod list numerowanej:

# pozycja 1
# pozycja 2
# pozycja 3

i efekt:

  1. pozycja 1
  2. pozycja 2
  3. pozycja 3

Listy można z sobą mieszać i tworzyć ich piętrowe struktury.

Przykład złożonej, piętrowej i mieszanej listy:

# pozycja 1
## pozycja 1.1
### pozycja 1.1.1
##* pozycja 1.1.1. z "bombą"
# pozycja 2
#* pozycja 2 z "bombą"
# pozycja 3

i efekt:

  1. pozycja 1
    1. pozycja 1.1
      1. pozycja 1.1.1
      • pozycja 1.1.1. z "bombą"
  2. pozycja 2
    • pozycja 2 z "bombą"
  3. pozycja 3

Aby utrzymać ciągłość numeracji list nie wolno rozdzielać jej żadną linią tekstu - również pustą. Zerwanie ciągłości listy powoduje, że numeracja zaczyna się ponownie od 1.

Przykład:

#pozycja 1
#pozycja 2
przerwa
#pozycja 3
#pozycja 4

i efekt:

  1. pozycja 1
  2. pozycja 2

przerwa

  1. pozycja 3
  2. pozycja 4

Zgodnie z zasadą, że znak zakończenia linii tekstu (przyciśnięcie klawisza "enter") powoduje wyłączenie wszelkich otwartych wikikodów, nie wolno użyć tego znaku w ramach jednej pozycji w liście, bo wtedy tekst po "enter" będzie wyświetlony w osobnej linii, w dodatku zaburzającej ciągłość numeracji.

Przykład:

#W tym rozdziale znajduje się instrukcja jak stworzyć od 
 podstaw prostą stronę w  MediaWiki, na przykładzie artykułu 
 "Krówka destylacyjna" w Wikipedii.
#W tym rozdziale znajduje się instrukcja jak stworzyć od 
 podstaw prostą stronę w  MediaWiki, na przykładzie artykułu 
 "Krówka destylacyjna" w Wikipedii. 

i rezultat:

  1. W tym rozdziale znajduje się instrukcja jak stworzyć od

podstaw prostą stronę w MediaWiki, na przykładzie artykułu "Krówka destylacyjna" w Wikipedii.

  1. W tym rozdziale znajduje się instrukcja jak stworzyć od

podstaw prostą stronę w MediaWiki, na przykładzie artykułu "Krówka destylacyjna" w Wikipedii.


Pozioma linia

Pozioma linia przydaje się czasami do rozdzielania fragmentów tekstu, których nie chce się umieszczać w osobnych sekcjach. W wielu projektach nadużywanie poziomej linii nie jest mile widziane, gdyż mylą się one wizualnie z podkreśleniami tytułów sekcji 1. i 2. poziomu.

Poziomą linię wstawia się w tekst przy pomocy kodu w postaci czterech myślników: "----".

Przykład:

----

rezultat:





[*] - materiały pochodzą z poradnika MediaWiki w obrazkach