Segítség:Wiki jelölőnyelv alapjai

A HamWiki wikiből

Eddigiekben legtöbbünk csak olyan szövegszerkesztővel dolgozott, amely egyfelhasználós volt és alakhűen jelenítette meg a szöveget, a betüméretet egyetlen egérkattintással állította. Ezzel szemben van egy - szintén sokunk által kedvelt - másik elv, amely az a leírónyelv nevet viseli. Ez utóbbit használja a wiki is.

A leírónyelv alapelve, hogy a formázáshoz normál szöveges vezérlő karaktereket, vezérlőszavakat használ. A leírónyelv előnye abban rejlik, hogy nincsenek rejtett formázások benne és minden egyes szövegbeli vagy formázásbeli változtatás a szöveges különbség megjelenítésével a felszínre kerül. Ezért bármilyen hihetetlen, de csoportos szerkesztésre alkalmasabb, mint például egy MS Word-szerű (egyfelhasználós) megoldás.

Azonban nem mindegy, hogy a jelölőnyelv vezérlőkarakterei, vezérlőszavai milyen könnyen jegyezhetők meg. A wiki-ben ezeket megpróbálták a lehető leg könnyebben megjegyezhetőre választani. Erre meg is volt a lehetőség, ugyanis a HTML, amire szoftver megjelenítéskor konvertálja a szöveget, viszonylag keveset tud, így a vezérlőkaraktereknek sem kell túl nagy komplexitás. A HTML egyéb lehetőségeit pedig szükség esetén a HTML leíró nyelvből kölcsönözhetik a haladó felhasználók. Szerencsére erre ritkán van szükség.

Fejezetcím, alfejezetcím, al-alfejezetcím

= Főcím =

== Fejezetcím ==

=== Alfejezetcím ===

==== Al-alfejezetcím ====

Szövegformázás

Új bekezdés

Üres sor hagyása új bekezdést fog létrehozni.

Szókiemelés

A szimpla idézőjel ( aposztróf )

  • duplán alkalmazva (''duplán alkalmazva'')
  • triplán alkalmazva('''triplán alkalmazva''').

Formázatlan, kiemelt hátterű szöveg

Amennyiben a szöveget nem a sor elején kezdjük el, akkor szürke keretbe foglalva, formázatlan szövegként jelenik meg.

Mint például ez.

Ezt viszonylag ritkán használjuk, mivel az üres soroknál véget ér a szürke háttér.

Ha szürke hátteret akarunk, akkor inkább táblázatot érdemes csinálni például az első sorba írt bgcolor="#e0e0e0" opcióval.

Listák

A listák a sor elején elhelyezett * vagy # vagy : jelekkel kezdődnek. Ezek a jelek tetszőleges kombinációban alkalmazva igen változatos listák készítését teszik lehetővé. Az alábbiakban ezek lesznek ismertetve.

Számozatlan lista: * (csillag jel), számozott lista: # (kettőskereszt). Többszintű lista az előbb ismertetett két alapelem megfelelő sorrendben történő egymás után írásával történik. Fontos megemlíteni, hogy egyazon lista az első üresen hagyott sorig generálódik. Tehát az üres sor egyben a lista végét is jelenti.

Számozatlan 2 szintű példa:

  • Első szint: *
  • Első szint: *
    • Második szint: **
    • Második szint: **

Számozatlan-számozott 2 szintű példa:

  • Első szint: *
    1. Második szint: *#
    2. Második szint: *#

Számozott-számozatlan kétszintű példa:

  1. Első szint: #
    • Második szinten #*
    • Második szinten #*
  2. Első szint: #
    • Második szinten #*
    • Második szinten #*

A : (kettőspont) tabulálást, a ; (pontosvessző) pedig kiemelést eredményez. Így a

pontosvessző
kettőspont
kettőspont
pontosvessző
kettőspont
kettőspont pontvessző
kettőspont kettőspont

is egész jól kinéző listát eredményez. Azonban hivatalosan a számozott és a számozatlan listatípus a két alap lista.

Speciális karakterek

A wiki jelölőnyelve sem tud mindent, ezért néha a HTML szintaktikához kell nyúlni.

  • soremelés: <br>
  • felső index: m2 : m<sup>2</sup>
  • alsó index: Ut : U<sub>t</sub>
  • ± : &plusmn; vagy egérrel átmásolni innen.
  • Ω : &Omega; vagy egérrel átmásolni innen.
  • λ : &lambda; vagy egérrel átmásolni innen.
  • π : &pi; vagy egérrel átmásolni innen.
  • μ : &mu; vagy egérrel átmásolni innen.
  • € : &euro; vagy egérrel átmásolni innen.

A fentiek használata néha jól jön, de komolyabb képletek szerkesztéséhez a Matematikai képletek szerkesztése részben ismertetett megoldást célszerű alkalmazni.

Kép beszúrása

  1. A baloldali menöben található Fájl felküldése opcióval felküldjük a képet. Képnévnek lehetőleg tömör, de beszédes nevet adjunk. Ez később jól fog jönni.
  2. Szerkesztőablakban felül a 6. ikon segítségével vagy közvetlen beírva a [[File:feluletszerelt_ellenallas.jpg|left]] szöveget illetszettük be a feluletszerelt_ellenallas.jpg-t. A left, center, right szavak értelemszerűen balra, középre, jobbra igazítanak.
Feluletszerelt ellenallas.jpg
A frame|Keretbe_írandó_szöveg kiegészítés a képet keretessé teszi és a Keretbe_írandó_szöveget beleírja. Vessd össze a baloldali képpel.
A thumb opció lekicsinyítí és keretessé teszi. Egyúttal jobbra illeszti.

Ha a nagyobb képet át szeretnénk megjelenítéskor méretezni, de oly módon, hogy rákattintva a nagyobb kép legyen látható, akkor thumb|90px|Keretbe_írandó_szöveg kiegészítéssel tehetjük meg. A 90px esetünkben a szélességet jelenti, amekkorára kicsinyítse. Ha nem adjuk ezt meg, akkor alapértelmezett, jól használható méretre kicsinyít.

Kép beillesztésekor az Előnézet megtekintése használata mentés előtt mindenképp ajánlott.

Kép feltöltése esetén törekedjünk arra, hogy a lényeg legyen felküldve és a tárhelytakarékosság miatt egy-egy indokolt esetet leszámítva 320x240 pixel méretű képnél felesleges nagyobbat felküldeni. Ezért a képből vágjuk ki a lényeget illetve kicsinyítsük le egy tetszőleges képszerkesztő, például GIMP képszerkesztő program segítségével. A feltöltött képnek mindig adjunk beszédes nevet, mivel a 1.jpg nem fejez ki semmit a képlistában. Ha nem beszédes a név, nehéz lesz a jövőben megtalálni a képet, ha másik szócikkbe is be szeretnénk illeszteni.

Szócikkek közötti hivatkozások

A wiki az egyik szócikk adja a másikat elvre épít. Ezért nagyon fontos az, hogy bármely ismeretlen kifejezést egy azt ismertető szócikkre való hivatkozással lássunk el. Ezért a wiki-ben nagyon egyszerűen, az alábbiakban ismertetettek szerint helyezhetőek el hivatkozások:

  • Wiki másik szócikkre: [[példa]], illetve ha a szócikk címe más, akkor [[Kezdőlap|nagyonkezdőlap]]. Példa: nagyonkezdőlap, mint belső kereszthivatkozás.
  • Külső URL-re: [http://www.ham.hu érdekes lap]. Ekkor a szövegben az "érdekes lap" szópár fog megjelenni. Példa: érdekes lap

Lap átirányítása: előfordulhat hogy egy szócikkre más néven érdemes hivatkozni. Például a logaritmikus egységek szócikkre szeretnénk decibel néven. Ekkor nincs más dolgunk, mint létrehozni egy decibel szócikket és a legelejére egy #REDIRECT [[Logaritmikus egységek]] kifejezést elhelyezni.