Jump to content

Help:Style (Magyar)

From ArchWiki
Fordítás állapota: Ez az oldal az angol Help:Style című oldal magyar nyelvre lefordított változata. Utolsó fordítás dátuma: 2026.05.01. Amennyiben a lefordítás időpontja óta az angol nyelvű oldalon történtek újabb módosítások, akkor Ön segíthet hozzászinkronizálni az angolhoz ezt a magyar nyelvű fordítást.

További oldalak az adott témakörben

Ezek a stíluskonvenciók elősegítik a rendezett, szervezett és vizuálisan következetes cikkeket. Kérjük Önt, hogy kövesse őket a lehető legszorosabban, amikor az ArchWiki weboldalt szerkeszti.

Cikkek

Cím

  • A cikkek címeinek Nagy kezdőbetűvel kell kezdődniük, például az "Új oldal címe" helyes, ám az "Új Oldal Címe" már egyáltalán nem helyes. Vegye figyelembe, hogy a tulajdonnévrészként vagy nagybetűs rövidítésként szereplő közönséges szavakat nagybetűvel kell írni, például az "Advanced Linux Sound Architecture" helyes, ám az "Advanced Linux sound architecture" nem helyes írásmód.
    A névterek nem képezik a címek részét, így az "ArchWiki:Example article" helyes, míg az "ArchWiki:example article" nem helyes. Az aloldalneveknek nagybetűvel kell kezdődniük, így az "Oldalam/Aloldalam" helyes, míg az "Oldalam/aloldalam" nem helyes írásmód.
  • Alapértelmezés szerint a címben a témanevet egyes számban kell használni. Többes számban a témanevet akkor kell használni, amikor egy csoportot vagy osztályt képvisel, és főnévnek vagy megszámlálható főnévnek tekinthető.
  • A cikk címében előnyben kell részesíteni a teljes név használatát, kivéve amikor a cikk tárgya elsősorban a rövidített névről ismert. A cikk címében ne szerepeljen egyszerre a teljes név és a rövidítés is (pl. zárójelben), ehelyett használjon átirányítóoldalt a rövidítés oldalán, amely átirányítóoldal már a teljes névvel ellátott cikkre mutat rá.
  • A magyar nyelvre lefordított oldalak címeinek követniük kell a Help:i18n#Oldalcímek irányelveit.
  • További információkért tekintse meg a Súgó:Cikkelnevezési irányelvek című cikket.

Elrendezés

  • Order elements in an article as follows:
  1. Varázsszavak (Opcionális)
  2. Kategóriák
  3. Nyelvek linkjei (Opcionális)
  4. Cikk státuszát jelölő sablonok (Opcionális)
  5. "További oldalak az adott témakörben" szövegdoboz (Opcionális)
  6. Előszó vagy bevezetés
  7. Tartalomjegyzék (Automatikus)
  8. Cikkspecifikus szakaszok

Varázsszavak

  • Viselkedést befolyásoló kapcsolók (és általában minden olyan varázsszó amely megváltoztatja azt, hogy miként jelenik meg vagy viselkedik egy szócikk, de önmagában nem ad hozzá tartalmat) mindig a szócikkek legfelső részére kerüljenek.
Ez a szabály különösen a {{DISPLAYTITLE:title}} és a Template:Lowercase title használatára vonatkozik, amely az előbbit használja.

Kategóriák

  • Minden cikket be kell sorolni legalább egy meglévő kategóriába.
  • Egy cikk több kategóriába is tartozhat, feltéve, hogy egyik sem őse a másiknak.
  • A kategóriákat minden cikk tetején kell feltüntetni, közvetlenül a varázsszavak alatt.
    Megjegyzés Ez eltér néhány más MediaWiki projekttől, például a Wikipédia módszerétől, ahol a kategóriák az oldal alján szerepelnek.
  • Nem lehet üres sor a kategóriák és a szöveg első sora (vagy a meglévő idegen nyelvű linkek) között, mert ez extra helyet hoz létre a cikk tetején.
  • További információkért tekintse meg a Súgó:Kategória című cikket.

Nyelvek linkjei

  • Ha a szóban forgó cikknek a helyi vagy egy külső Arch Linux Wikipédia weboldalon létezik másik nyelvre is lefordított változata, akkor a lefordított változat nyelvi linkjét a szóban forgó cikk kategóriái után, de a szóban forgó cikk szövegének első sora elé kell elhelyezni.
    Kérjük vegye figyelembe, hogy a cikk olvasásakor ezek a nyelvet váltó linkek ténylegesen felül, a cikk bal oldalán, a megfelelő oszlopban fognak megjelenni.
  • Nem szabad üres sorokat hagyni a nyelvet váltó linkek és a cikk szövegének első sora között, mert ez extra helyet hoz létre a cikk tetején.
  • Nyelvet váltó linkek hozzáadásakor vagy azok szerkesztésekor ügyeljen arra, hogy minden, már meglévő lefordított cikknél ismételje meg a műveletet.
  • Egy szóban forgó cikkhez ne adjon hozzá egynél több nyelvet váltó linket.
  • Ne adjon hozzá a szóban forgó cikkhez olyan nyelvet váltó linket amely nyelvet váltó link a cikk saját, önmaga nyelvére váltana.
  • A nyelvet váltó linkeket a nyelvi címke alapján kell ábécé sorrendbe rendezni. Nem szabad sorba rendezni a nyelvet váltó linket azáltal, ahogyan a nyelvet a saját maga nyelvén írják le az adott nyelven. Például a [[fi:Cikk címe]] megelőzi a [[fr:Cikk címe]] linket, még akkor is, ha a "Suomi" a "Français" után következne. Magyar nyelvet szintén ugyanígy a "hu" karakterek alapján rendezzük, nem a "magyar" karakterek alapján.
  • További információért tekintse meg a Súgó:i18n és Wikipedia:Help:Interlanguage links című cikkeket.

Cikk státuszát jelölő sablonok

  • A státuszsablonok (amelyek a teljes szócikkre vonatkoznak) a kategóriák linkjei (vagy ha vannak, akkor a nyelvi linkek) alatt, és a bevezető (vagy ha van, akkor a "További oldalak az adott témakörben" című szövegdoboz) felett kell, hogy szerepeljenek.
  • Azok az állapotsablonok, amelyek a cikk egy adott részére vonatkoznak, a lehető legközelebb kell, hogy elhelyezkedjenek az adott rész fölött, miközben ügyelni kell arra, hogy ne törjék meg a bekezdéseket, kódblokkokat vagy más, már meglévő sablonokat.
  • Mindig kísérje a cikk állapotsablonját néhány magyarázó szó a kijelölt mezőben (példák minden sablon oldalán megtalálhatók), szükség esetén akár vita megnyitásával a vitalapon.

"További oldalak az adott témakörben" szövegdoboz

  • Egyszerű listát biztosít a kapcsolódó (Arch Wiki weboldalán belüli) cikkekről.
  • Opcionálisan elhelyezhető közvetlenül a kategóriák alatt (vagy a nyelvi linkek, illetve a cikkállapotsablonok alatt, amennyiben azok jelen vannak).
  • Kizárólag a Template:Related articles start (Magyar), Template:Related és Template:Related articles end sablonokból állhat. Tekintse meg az irányelveket az említett lapokon.
  • Nem angol nyelvű cikkek esetén használható a Template:Related2 a horgony szövegének a lefordítására.
  • Kérjük Önt, hogy használja a #"További olvasnivaló a témában" című szakaszt a még teljesebb és részletesebb lista megjelentése érdekében, amely szakasz már tartalmazhatja a linkek leírásait, valamint tartalmazhatja az wiki oldalon belüli vagy a wiki oldalon kívüli linkeket is.

Előszó vagy bevezetés

  • Közvetlenül a cikk első szakasza fölött szerepel.
Kérjük Önt, hogy ne hozzon létre == Bevezetés == vagy == Előszó == szakaszt: Hagyja, hogy ezek a szakaszok automatikusan megjelenjenek az első szakaszcím fölött. Ha az adott cikkben elegendő szakasz található, akkor a tartalomjegyzék automatikusan megjelenik az előszó és az első szakasz között.
  • A cikk témáját írja le.
Ahelyett, hogy Ön a saját szavaival (esetleg elfogultan) írná le egy szoftver jellemzését, használhatja a fejlesztő hivatalos leírását, amely általában megtalálható az adott projekt honlapján, vagy az adott szoftver "about" weboldalán (ha létezik ilyen weblap a weboldalon belül). Például a WireGuard című cikk is így csinálja. Továbbá, felhasználhatja a Wikipédia leírását is. Például az ImageMagick című cikk is ezt teszi.

További információkért tekintse meg a Súgó:Cikkbevezetők írása című leírást.

Standard szakaszok

"Telepítés" szakasz
"Ismert problémák" szakasz
  • Az Ismert problémák című szakaszokat olyan ismert hibák vagy használati problémák leírására szoktuk használni, amelyeknek még nincs megoldásuk. Tekintse meg a: #"Hibaelhárítás" szakasz című szakaszt.
  • Használja a szabványos Ismert problémák címet, és helyezze a szerkesztésben lévő cikk elejére.
  • Ha a neten már létezik hibajelentés az ismert problémával kapcsolatban, akkor nagyon ajánlott, hogy adjon meg rá legalább egy linket. Ha nem létezik hibajelentés, akkor Önnek kell jelentenie, így növelve annak esélyét, hogy a hiba kijavításra kerül.
  • Amikor csak lehetséges, tartózkodjon a dátumok vagy verziószámok említésétől. (Például: "A Linux kernel 3.17 még nem támogatja az XYZ eszközt 2014 októberében."). Ehelyett inkább linkeket, például hibajelentéseket adjon meg a további információkhoz.
"Tippek és trükkök" szakasz
  • A Tippek és trükkök című szakaszok a szoftver használatára vonatkozó haladószintű tippeket vagy példákat tartalmaznak.
  • A szabványos Tippek és trükkök címet használja.
  • Alcímekbe kell rendezni a különféle tippeket és trükköket.
"Hibaelhárítás" szakasz
  • A Hibaelhárítás szakaszt használjuk az adott szoftverrel kapcsolatos gyakran ismételt kérdésekhez vagy a gyakori problémák megoldásaihoz. Tekintse meg az #"Ismert problémák" szakasz leírását.
  • Kérjük Önt, hogy ennek a szakasznak a címeként használja a szabványosított Hibaelhárítás elnevezést. Kerülendő gyakori helytelen írásmódok: Hiba elhárítás, Hiba-elhárítás és HibaElhárítás.
  • Ismert hibákkal kapcsolatban Ön ideiglenes megoldásokat is leírhat ebben a szakaszban. Ebben az esetben kötelező, hogy linket is adjon a hibajelentésre (vagy más megfelelő forrásokra, például egy fórumhozzászólásra, amely tartalmazza a leírt megoldást). Ha még nem jelentették a hibát, akkor Önnek kell bejelentenie, így növelve annak esélyét, hogy a hiba megfelelően ki lesz majd javítva.
    Amennyiben lehetséges, tartózkodjon a dátumok vagy verziószámok említésétől. Nagy előnye van annak, hogy külső linkeket, például hibajelentéseket kapcsol össze az olvasók és szerkesztők számára:
    • Az olvasók számára a Wiki nem válik végállomássá: További információt találhatnak a forráshoz közel, amelyet keresési erőfeszítéseik során esetleg elmulasztottak volna.
    • Ez a szakasz ezt a Wikipédiát szerkesztők számára megkönnyíti a takarítást azáltal, hogy csökkenti annak erőfeszítését, hogy a szerkesztők kiderítsék, vajon egy bejelentett hiba még mindig fennáll-e. Ha az olvasó új információt talál, akkor ez akár nagyobb önállósághoz is vezethet és az olvasó könnyen visszatérhet ezen Wikipédia szerkesztéséhez.
"További olvasnivaló a témában" szakasz
  • A További olvasnivaló a témában szakasz a linkeket és a további információforrások listáját tartalmazza.
  • Ez a szakasz egy olyan lista legyen, ahol minden bejegyzés * jellel kezdődik, amely MediaWiki felsorolásjelet hoz létre.
  • Kérjük Önt, hogy a szabványos További olvasnivaló a témában címet használja, és a cikken belül ezt a szakaszt az utolsó helyre helyezze el. Kerülendők más hasonló címek, mint például Külső hivatkozások, További források stb.

Cikkekben az egyes szakaszok címsorai

  • A cikkekben az egyes szakaszok címsorai a kettes szinttől kell, hogy kezdődjenek (==), mert az egyes szint az adott cikk címének van fenntartva.
  • Kérjük Önt, hogy ne hagyjon ki szinteket az alfejezetek létrehozásakor, tehát egy kettes szintű fejezet alfejezete hármas szintű címsort igényel, és így tovább.
  • A címsorok mondatkezdő nagybetűs formát használnak, nem az angol stílusú címformát: Az én új címsorom a helyes. Az Én Új Címsorom nem helyes.
  • Kerülje a linkek használatát a címsorokban, mert megtörik a stílus egységességét, és nem emelkednek ki eléggé. Általában a linkelt szöveg a szóban forgó szakasz tartalmában található meg. Továbbá, az adott szakasz szövegében (nem a címében) Ön használhat egy egyszerű mondatot is a belinkelés érdekében, például:
További információkért tekintse meg a Kapcsolódó cikk című cikket.
Ugyanezen okból kerülje bármilyen HTML vagy wiki markup programkód használatát, beleértve a #Programkód formázása sablonokat. Tekintse meg a Súgó:Stílus/Szövegformázás és az írásjelek helyes használata című cikket.

Formázás

Programkód formázása

  • Használja a Template:ic sablont rövid programkódsorokhoz, fájlnevekhez és elérési utakhoz, beállítási paraméterekhez, változókhoz és egyéb esetekhez, amelyeket inline kell megjeleníteni. Például:
    Futtassa a parancssorban: sh ./helló_világ.sh.
  • Egyetlen kódsor (parancssori bemenet vagy kimeneti kód, illetve fájltartalom) megfelelő keretben való megjelenítéséhez egyszerűen kezdje a sort egyetlen szóköz karakterrel. További részletekért tekintse meg a Súgó:Szerkesztés#Programkód című leírást. Példa:
$ sh ./helló_világ.sh

Helló világ
  • Használja a Template:bc sablont több kódsorhoz (parancssori bemenet vagy kimeneti kód, illetve fájltartalom) annak érdekében, hogy megfelelő keretben jelenjenek meg. Például:
#!/bin/sh

# Demó
echo "Helló világ"
  • Használja a Template:hc sablont, amikor szükséges a parancssori bemenet és a kimenet együttes megjelenítése. Például:
$ sh ./helló_világ.sh
Helló világ
  • Használja a Template:hc sablont, amikor fájltartalmat kell megjeleníteni, és úgy érzi, hogy az olvasóknak nehéz lehet megérteni, melyik fájlra vonatkozik a kód. Ilyenkor a fájlnév a fejlécben is megjeleníthető. Például:
~/helló_világ.sh
#!/bin/sh

# Demó
echo "Helló világ"
  • Beállításfájlhoz hasonló kódblokkok esetén érdemes az olvasót a releváns sorokra összpontosítani, és a környező, nem releváns tartalmat ellipszissel (...) jelölni.
  • További információért és a sablontörő karakterek (például = vagy |) hibáinak elhárításához tekintse meg a Súgó:Sablon című cikket.

Parancssori szöveg

  • Amennyiben Ön cikkszerkesztéskor inline kódot használ (Template:ic), ne jelenítsen meg prompt szimbólumot. Minden megjegyzést a jogosultságokkal kapcsolatban a környező szövegnél kell hozzáadni.
  • Amennyiben Ön cikkszerkesztéskor kódblokkot használ (Template:bc vagy szóközzel kezdődő sorokat használ), akkor használja a $ jelet a normál felhasználói parancsokhoz. Használja a # jelet a root parancsokhoz.
    Megjegyzés Mivel a # jelet szövegfájlokban megjegyzések jelölésére is használják, mindig ügyeljen arra, hogy elkerülje a félreértéseket, általában úgy, hogy leírja: Futtassa a parancsot vagy szerkessze a szövegfájlt.
    • A parancsblokkot bevezető mondatnak általában : jellel kell végződnie.
    • Cikkszerkesztéskor használja a következő írásmódot: 
      # parancs
      Ne használja a következő írásmódot: 
      $ sudo parancs
    • A cikkek szerkesztésekor ne használja a root parancssort együtt a sudo paranccsal. Például így nem helyes a használat: 
      # sudo parancs
    • Amennyiben Ön egy bizonyos parancsot másik felhasználó nevében futtatja, akkor szögletes zárójelben tegye a prompt elé a felhasználónevet: 
      [archie]$ parancs
    • Ugyanabban a parancsdobozban ne adjon hozzá megjegyzéseket. Például: 
      # pacman -S foo  #Telepítse az xyz szoftvercsomagot
    • Cikkszerkesztéskor kerülje a túl hosszú kódsorok írását: Amikor lehetséges, használjon sortörési technikákat.
  • Ne feltételezze azt, hogy a cikket olvasó felhasználó sudo vagy más jogosultságnövelő segédprogramot használ (pl. gksu, kdesu).

Billentyűgombok

  • A billentyűgombok cikkekben történő ábrázolásának szabványos módja a Template:ic sablon használata.
  • A billentyűgombokat kisbetűvel kell ábrázolni: a. A nagybetűk ábrázolásához használja a Shift+a írásmódot, ne használja a Shift+A vagy az A írásmódot.
  • A billentyűgombok kombinációjának helyes ábrázolásmódja a + szimbólum használatával történik, amely szóközök nélkül kapcsolja össze a billentyűgombokat, egyetlen sablonpéldányban: Ctrl+c.
    A Ctrl + c, Ctrl+c, Ctrl-c nem szabványos formák, így azok használata kerülendő.
  • A billentyűgombok sorozatainak helyes ábrázolása lehet bővebb, pl. "nyomja meg a g billentyűt, majd a Shift+t billentyűgomb kombinációt", vagy tömörebb, amikor a billentyűgombokat egy szóközzel választja el külön sablonpéldányokban: g Shift+t.
  • Az alábbiak a szabványos módjai néhány speciális billentyűgomb ábrázolásának:
    • Shift (nem SHIFT)
    • Ctrl (nem CTRL vagy Control)
    • Alt (nem ALT)
    • Super (nem Windows vagy Mod)
    • Enter (nem ENTER vagy Return)
    • Esc (nem ESC vagy Escape)
    • Space (nem SPACE)
    • Backspace
    • Tab
    • Ins (nem INS vagy Insert)
    • Del (nem DEL vagy Delete)
    • PrintScreen
    • Up (nem ↑ vagy Up Arrow) – Hasonlóan a többi nyílbillentyűgomb esetében.
    • PageUp
    • PageDown
    • Fn (nem FN vagy fn) – A funkcióbillentyű, amely sok laptopon megtalálható.
    • Home (nem HOME vagy Beginning)
    • End (nem END)

Megjegyzések, figyelmeztetések, tippek

  • A Note (Magyar) sablont olyan információkhoz kell használni, amelyek valamilyen módon eltérnek attól az információtól, amelyeket az olvasó természetes módon vár el a cikkben. Ez magába foglalja azokat az információkat, amelyek mélyebb tudást adnak valamiről, holott kissé mellékesnek számítanak a cikk szempontjából. Másik példa ennek a sablonnak a használatra, amikor ideiglenes közleményt kell jelezni. Például amikor jelezni kell egy szoftvercsomag nevének a megváltozását.
A Note sablon használható olyan információ kiemelésére is, amely fontos, de könnyen figyelmen kívül hagyható valaki számára, aki új a témában.
  • A Warning (Magyar) sablont olyan helyzetekben kell használni, amikor a leírt eljárás súlyos következményekkel járhat. Például amikor a leírt eljárás nehezen visszafordítható, vagy az operációs rendszer károsodását okozhatja. A figyelmeztetéseknek általában jelezniük kell a legrosszabb forgatókönyveket, valamint azokat a feltételeket, amelyek ezekhez vezethetnek, vagy amely feltételekkel elkerülhetők.
Általánosságban ne éljen vissza a figyelmeztetésekkel: Ha bizonytalan, akkor nagy valószínűséggel Önnek inkább Note sablont kell használnia.
  • A Tip (Magyar) sablon olyan módszert vagy eljárást jelezzen, amely hasznos lehet és előnyöket hozhat valakinek, bár nem szükséges az adott művelet elvégzéséhez, így biztonságosan figyelmen kívül hagyható.
  • Ha kettő vagy több Note, Warning vagy Tip sablonnak egymás után, ugyanazon ponton kell megjelennie a cikkben, akkor célszerű a sablonok szövegeit egyetlen sablonon belül listába rendezni, és célszerű kerülni a sablonok egymásra halmozását, kivéve amikor teljesen különállóak. Például:
Tipp
  • Első példatipp.
  • Második példatipp.

Táblázatok

Tekintse meg az mw:Help:Tables című leírást a szintaxis áttanulmányozása érdekében.

  • A táblázatoknak általában a wikitable osztályt kell használniuk.
  • Az összehasonlító táblázatoknak ezen felül a sortable osztályt kell használniuk.
  • Amikor van értelme, használjon táblázatfejléceket és cellasablonokat.
  • A táblázatfejlécek mondatkezdő nagybetűs formában legyenek.
  • A táblázatmagyarázatok definíciós listát használjanak, és a táblázatok elé kerüljenek.
  • A lábjegyzetek vagy megjegyzések használják a <sup>1</sup>, <sup>2</sup> stb. formát, valamint egy számozott listát a táblázat alatt, ahelyett, hogy Unicode karaktereket alkalmaznának.

Utasítások

Fájlszerkesztési kérések

  • Ahol hasznos lehet, ott hozzáadható egy link a Súgó:Olvasás#Hozzáfűzés, hozzáadás, létrehozás, szerkesztés oldalhoz.
  • Amikor az adott cikkben arról van szó, hogy szöveget kell szerkeszteni a cikk olvasójának, Ön mint a cikk írója ne feltételezzen a cikk olvasójánál konkrét szövegszerkesztőt (nano, Vim, Emacs, stb.), kivéve amikor ez szükséges.
  • Általánosságban ne használjon parancsokat a szövegfájl szerkesztésének implicit kérésére. Például:
echo -e "clear\nreset" >> ~/.bash_logout helyett így kell:
Adja hozzá a következő sorokat a ~/.bash_logout fájlhoz:
clear
reset
Egy gyakori kivétel azok a parancsok, amelyek összetett, rendszerfüggő kimenetet generálnak. Például genfstab -U /mnt >> /mnt/etc/fstab.

Szoftvercsomagok kezelésével kapcsolatos utasítások

  • Minden szoftvercsomagkezelési utasításnál egyszerű kijelentést kell használni példaparancsok helyett.
  • Amikor egy bizonyos cikkben szoftvercsomag-feltelepítést kérünk a cikk olvasójától, ajánlott a szoftvercsomag-feltelepítési kérelem első előfordulási helyénél a feltelepítés linket vagy a feltelepítési link valamilyen változatát (pl. [[install (Magyar)|feltelepített]]) megadni az olvasónak.
  • Az érintett szoftvercsomagot (vagy szoftvercsomagokat, illetve szoftvercsomagcsoportokat) linkelni kell, lehetőleg változatok nélkül (általában olyan végződéssel jelölve, mint -bin, -git, vagy -nightly), kivéve amikor ezek valóban jelentős különbséget hordoznak.
  • Nem natív szoftvercsomag-kezelőkhöz ne adjon meg konkrét utasításokat (pl. Flatpak, make install), bár egy Tipp megadása elfogadható, amikor Ön eltérő szoftvercsomagra mutat. Például amikor a felsőbb szintű támogatás kizárólag az eltérő szoftvercsomagokra vonatkozik.
  • Ön a cikkek írásakor rugalmasságot kap a megfogalmazásban annak érdekében, hogy az adott cikkhez igazítsa a szoftvercsomag-kezelést. További példákért tekintse meg a #Hivatalos szoftvercsomagok című szakaszt.
Hivatalos szoftvercsomagok
  • Cikkek írásakor a hivatalos szoftvercsomagok feltelepítésének említésénél kerülje a pacman parancsok példáinak használatát: Egyrészt, kerülje az egyszerűség kedvéért (ugyanis minden Arch felhasználónak még álmában is tudnia kell a pacman című cikkben leírtakat). Másrészt, kerülje az olyan hibák elkerülése érdekében, mint a pacman -Sy szoftvercsomag, vagy a véget nem érő viták, például a pacman -S szoftvercsomag és a pacman -Syu szoftvercsomag közötti választás miatt. Még ennél is inkább nem javasolt felajánlani az olvasónak a pacman frontend programok vagy burkoló (wrapper) programok használatát.
Ehelyett használjon egyszerű megfogalmazást. Például:
Telepítse fel a számítógépre a szoftvercsomagneve szoftvercsomagot.
Vagy, ha például az alkalmazás neve eltér a szoftvercsomag nevétől:
AzÉnProgramom telepíthető az-én-programom szoftvercsomaggal.
Több szoftvercsomag feltelepítésére vonatkozó utasítás így jelenhet meg:
Telepítse a szoftvercsomagnév1, szoftvercsomagnév2 és szoftvercsomagnév3 szoftvercsomagokat.
Ön a következőt használhatja, amennyiben egy szoftvercsomagcsoportra hivatkozik:
Telepítse a szoftvercsomagcsoportnév szoftvercsomagcsoportot.
  • Használja a Template:Pkg sablont. Például: {{Pkg|szoftvercsomagnév}}.
Ha szoftvercsomagcsoportra hivatkozik, használja helyette a Template:Grp sablont. Például: {{Grp|szoftvercsomagcsoportnév}}.
  • Ha a szoftvercsomag a core vagy extra szoftvercsomag-tárolóban található, akkor ne hivatkozzon a szoftvercsomag-tárolóra: Ez növeli a karbantartási igényt, mivel nem ritka, hogy egy szoftvercsomagot áthelyeznek másik szoftvercsomag-tárolóba. Ha a szoftvercsomag egy hivatalos, de alapértelmezetten nem engedélyezett szoftvercsomag-tárolóban található (multilib, core-testing, stb.), akkor kötelező megemlíteni. Például így:
Telepítse fel a szoftvercsomagnév szoftvercsomagot a hivatalos multilib szoftvercsomag-tárolóból.
AUR szoftvercsomagok
  • Kerülje az AUR szoftvercsomagok feltelepítésének a példáit. Sem a hivatalos módszerrel, sem az AUR segédprogramok megemlítésével ne adjon meg példát a cikk olvasójának. Minden felhasználónak, aki nem hivatalos szoftvercsomagokat telepít fel a számítógépre, el kell olvasnia az Arch User Repository című cikket, és tisztában kell lennie az operációs rendszerére gyakorolt lehetséges következményekkel.
Ehelyett csak egy egyszerű kijelentést használjon, például:
Telepítse a szoftvercsomagneveAUR szoftvercsomagot.
  • Használja a Template:AUR sablont. Például: {{AUR|szoftvercsomagneve}} .
Nem hivatalos szoftvercsomag-tárolók
  • Amikor Ön azt javasolja a cikk olvasójának, hogy a cikk olvasója egy nem hivatalos szoftvercsomag-tárolót használjon annak érdekében, hogy a cikk olvasója egy előre elkészített szoftvercsomagot feltelepítsen a számítógépre, akkor Ön, mint a cikk írója, ne adjon meg a cikkben utasításokat a szoftvercsomag-tároló engedélyezésére, hanem adja hozzá a szoftvercsomag-tárolót a Nem hivatalos felhasználói szoftvercsomag-tárolók weboldalhoz, és a szerkesztett cikkben egy link segítségével hivatkozzon a megfelelő szoftvercsomag-tároló szakaszára. Például: [[Unofficial user repositories (Magyar)#példa|példa]].
  • Ugyanúgy, mint a hivatalos szoftvercsomagok esetében, a nem hivatalos szoftvercsomagok esetében se ne adjon hozzá pacman példaparancsokat. Példa a helyes megfogalmazásra:
Telepítse a szoftvercsomagneve szoftvercsomagot a példa szoftvercsomag-tárolóból.
Akkor is eszerint járjon el amikor a szóban forgó szoftvercsomag elérhető az AUR szoftvercsomag-tárolóból:
Telepítse a szoftvercsomagneveAUR szoftvercsomagot, amely szintén elérhető a példa szoftvercsomag-tárolóból.
Akkor is eszerint járjon el amikor a szóban forgó szoftvercsomag más néven érhető el az AUR szoftvercsomag-tárolóból:
Telepítse a szoftvercsomagneveAUR szoftvercsomagot, amely xyz néven is érhető a példa szoftvercsomag-tárolóból.

A systemd unit-fájlokkal kapcsolatos műveletek

  • Ne adjon példákat arra vonatkozóan, hogy miként kell engedélyezni, elindítani vagy bármilyen más alapvető műveletet végrehajtani a systemctl segítségével a systemd unit-fájlokon. Ehelyett használjon egy egyszerű mondatot, amely felsorolja az érintett unit-fájlokat. Esetleg, említse meg a cikkben az unit-fájlok függőségeit vagy ütközéseket más unit-fájlokkal. Valamint, említse meg a végrehajtandó műveletek leírását. Például:
Annak érdekében, hogy a GDM elinduljon a bootoláskor, engedélyezze a gdm.service szolgáltatást.
Illetve, amikor például az unit-fájl egy sablon, amelyet példányosítani kell:
Egy vezeték nélküli interfészen a netctl profilok automatikus váltásának engedélyezése érdekében engedélyezzen egy példányt a netctl-auto@.service unit-fájlból az interfész nevével. Például netctl-auto@wlan0.service.
Önnek meg van adva a rugalmasság ahhoz, hogy a megfogalmazást az adott cikkhez hozzáigazítsa.
  • Ön ne felejtsen el linkelni a Help:Reading (Magyar)#A systemd unit-fájlok vezérlése weboldalra egy dedikált, erre a célra létrehozott átirányító link segítségével, mint például [[start(Magyar)|elindít]], [[enable (Magyar)|engedélyez]] vagy [[stop (Magyar)|leállít]].

Kódolási stílus

  • Parancsok vagy szkriptek cikkhez történő hozzáadásakor használjon következetes kódolási stílust az egész cikken belül, esetleg hivatkozva más cikkekre is, különösen akkor, amikor vannak kapcsolódó cikkek. Ha lehetséges, akkor tartsa tiszteletben a nyelv hivatalos vagy legelterjedtebb kódolási stílus irányelveit.
  • Kerülje a használt programozási nyelv (szkript nyelv) elavult funkcióit. Például használja a $() szintaxist a shell parancs helyettesítésére a backtick/gravis (``) szintaxis helyett.
  • A szkripteknek csak a minimálisan szükséges feladatot kell elvégezniük a lehető legjobban érthető formában. Nem szabad őket rugalmasságra vagy bővíthetőségre tervezni, inkább használja a pszeudováltozókat tényleges változók helyett. A cikkekben ne adjon hozzá irreleváns funkciókat a például szolgáló kódokhoz. Például argumentumfeldolgozást vagy kimenetformázást ne adjon hozzá.
  • A szkripteket főként oktatási célból kell hozzáadni a cikkhez, amikor a cikk szövegében szereplő részletes magyarázat nem tehető elég világossá és tömörré. Hasznosak lehetnek például annak bemutatására, hogy miként kell egy összetett parancsot használni, vagy hogyan működnek együtt a kapcsolódó vagy egymástól függő parancsok.
  • Ha egy szkript értéket ad a cikkhez, de nem felel meg a fenti kritériumoknak, akkor külső hivatkozásként is megadható, például közzétéve gist formában.
  • Könyvtár nevének megadása vagy elérési útvonal megadása végződjön perjellel, vagy adjon hozzá egy jelzőt (például "könyvtár"). Például:
  • "Ellenőrizze, hogy létrejött-e a /sys/firmware/efi könyvtár" írásmód a helyes. Az "Ellenőrizze, hogy létrejött-e a /sys/firmware/efi" nem helyes.
  • Helyes a "Helyezzen egy .conf fájlt a /etc/modules-load.d/ könyvtárba" megfogalmazás. Helytelen a "Helyezzen egy .conf fájlt a /etc/modules-load.d könyvtárba" megfogalmazás.
  • A szóközt tartalmazó argumentumokat dupla idézőjelek közé kell tenni. Például a cd "valami példa" írásmód helyes. A cd valami\ példa írásmód nem helyes.

Parancssorok

  • Ne feltételezze, hogy a felhasználó egy bizonyos parancssort használ (például Bash). Kizárólag abban az esetben feltételezze, hogy a felhasználó egy bizonyos parancssort használ, amikor a feltételezés valóban szükséges. A cikkek megírásakor vagy a cikkek szerkesztésekor törekedjen a lehető legsemlegesebb parancsértelmezői megfogalmazásra.

Hiperszöveg-metafora

Tekintse meg a Súgó:Szerkesztés#Linkek című leírást a belső linkek, belső wiki-linkek és külső linkek megértése érdekében.

  • Próbálja meg az Ön saját cikkét a cikk szövegében szereplő szavak felhasználásával minél több másik belső cikkel összekapcsolni.
  • Egyedül a már létező cikkekre hozzon létre linket. Amennyiben Ön halott linkkel találkozik, próbálja azt megjavítani. Jelölje meg a Template:Dead link (Magyar) sablonnal az olyan külső linkeket, amelyek halottnak tűnnek.
  • Amikor csak lehetséges, kerülje el az implicit linkek használatát. Használjon inkább olyan utasításokat mint például: "További információkért tekintse meg a systemd című cikket", ahelyett, hogy a "További információkért tekintse meg ezt a cikket" utasítást használná.

Egy linket kétféleképpen lehet használni:

  • Használni lehet mint témára történő hivatkozás. Amikor a link egy kifejezés, amely a folyó szöveg része, és a szokásos nyelvtani szabályok vonatkoznak rá. Szükség esetén használjon linkelési címkét. A belső/belső-wiki linkeknek egy átirányításra kell mutatniuk amennyiben elérhető az átirányítás céloldala.
  • Használni lehet mint oldalra/szakaszra történő hivatkozás. Ne használjon linkelési címkét, és ahol alkalmazva van a cím, ott írja a címet a Template:Lowercase title szerint. Különösen ne rejtse el a # szimbólumot az ugyanazon oldalon belüli szakaszhivatkozásoknál. Például: [[#Hypertext metaphor|Hypertext metaphor]].

Tekintse meg a következő példákat:

Témára történő hivatkozás Oldalra/szakaszra történő hivatkozás
Használjon SSH ügynököt az azonosítás felgyorsítása érdekében. Kövesse az SSH kulcsok#SSH ügynökök című útmutatót az azonosítás felgyorsítása érdekében.
A legtöbb monitor által támogatva van a subpixel rendering. Engedélyezze a subpixel rendering lehetőséget a Font configuration#Subpixel rendering című leírás szerint.
Vegyen fel egy kulcsfájlt az initramfs fájlba. Az utasítások megtalálhatók a dm-crypt/Device encryption#Keyfiles című részben.
Legyen azzal tisztában, hogy az egérbillentyűk le vannak tiltva alapértelmezetten. A részletekért tekintse meg a Wikipedia:Mouse keys című oldalt.
Léteznek stílusszabályok a hivatkozások számára. A #Hiperszöveg-metafora című szakasz stílusszabályokat tartalmaz a hivatkozások számára.
  • Mielőtt egy konkrét eljárást írna le egy cikkben, vagy valamit részletesen bemutatna, mindig ellenőrizze, hogy létezik-e már olyan cikk, amely a szóban forgó részt részletesen tárgyalja. Ilyen esetben inkább hivatkozzon arra a cikkre, ahelyett hogy megismételné annak tartalmát. Továbbá:
    • Az ArchWiki weboldalon nem tárgyalt szakkifejezések esetén hivatkozzon a megfelelő Wikipédia weboldalra.
    • Ha a cikk tárgyához tartozó upstream dokumentáció jól megírt és karbantartott, akkor inkább csak Arch-specifikus adaptációkat írjon, és az általános információkhoz hivatkozzon a hivatalos dokumentációra.
Például: "Bootoláskor a kernelparaméterek rendszerhívások kiadására szolgálnak. A teljes listát megtekintheti a Linux kerneldokumentáció című weboldalon."
Általánosságban Ön tartsa meg az összhangot a Súgó:Olvasás#Szervezés című útmutatóval.
  • Ne hagyjon egy cikket zsákutcás oldalként (olyan cikk, amely nem hivatkozik másik cikkre), vagy árva oldalként (olyan cikk, amelyre egyetlen másik cikk sem hivatkozik). Nagyon ritka esetben szabad csak ilyet csinálni.
  • Ne használjon belső-wiki linkeket ugyanazon nyelvű, lefordított oldalakra a szerkesztett cikkben, mert ezek nem fognak megjelenni a Special:WhatLinksHere oldalakon. Például a [[:hu:Main page]] használata egy magyar cikkben helytelen, míg a [[Main page (Magyar)]] helyes.
    Az ilyen típusú linkek különböző nyelvek között elfogadhatók, mert ez megkönnyítené a cikkek áthelyezését egy külön wikibe (amennyiben a jövőben létrejönne egy külön wiki).
    Végül vegye figyelembe a különbséget ezek és a #Nyelvek linkjei között, amelyeknél nincs kettőspont az elején.
  • Részesítse előnyben a "Wikipedia:" belső-wiki előtagot a rövidebb "w:" előtaggal szemben.

Man súgóoldalak

Supported kernel versions

  • Do not remove any notes or adaptations regarding kernel versions greater than or equal to the minimum version between the current linux-lts package in the core repository, and the kernel on the latest installation media.

Non-pertinent content

  • Please do not sign articles, nor credit article authors: the ArchWiki is a work of the community, and the history of each article is enough for crediting its contributors.
    Note that reporting the sources used to write an article is good practice: you can use the "See also" section for this purpose.
  • Uploading files is disabled for normal users, and including images in articles is not allowed. As an alternative you can include links to external images or galleries, and if you need to draw simple diagrams you may use an ASCII editor like Asciiflow and Template:Text art; rationale:
    • Maintenance: Arch is rolling release, and images would make updating articles much more difficult.
    • Necessity: Arch does not develop nor maintain any sort of GUI application, so we do not need to display any screenshot.
    • Moderation: free image upload would require time to be spent removing oversized or inappropriate images.
    • Accessibility: we support users with slow connections, text-only browsers, screen readers and the like.
    • Efficiency: images waste server bandwidth and storage space.
    • Simplicity: text-only articles just look simpler and tidier.

Spelling

  • Avoid contractions: "don't", "isn't", "you've", etc. should be "do not", "is not", and "you have", for example.
  • Avoid unnecessary shortening of words: for example, instead of "repo", "distro", and "config", prefer "repository", "distribution", and "configuration".
    In the same fashion, prefer using the long form of uncommon command options instead of their single-character counterpart. See also Help:Style/Formatting and punctuation#Configuration parameters, variables, options, properties....
  • The names of projects, applications, executables etc. should be spelled, especially regarding capitalization, primarily according to their official documentation style. This includes the case where the documentation treats the name as a common noun, i.e. with an uppercase first letter when appearing at the beginning of a sentence, and lowercase otherwise. If the official documentation does not apply a consistent style, follow the style already used in the ArchWiki. If the name does not appear in the ArchWiki, or it still has inconsistent spelling, choose a style and conform to it throughout the article, also possibly updating the other pages that mention the name. Taking Git as an example you may choose to spell the name with the first letter uppercase ("Git") when talking about the project/software generally, and use all lowercase and italic ("git") when referring to the compiled program. When name capitalization can generate controversy, explicitly define a style in the article's talk page. See also Help:Style/Formatting and punctuation#Executable/application names
  • ArchWiki prefers no national variety of English over any other, adopting the same guidelines outlined in Wikipedia:Wikipedia:Manual of Style#National varieties of English; in case of conflict with any of ArchWiki's other explicitly defined guidelines, ArchWiki's prevail. When writing new content within an existing article it is recommended to maintain the spelling convention already prevalent in it; if the article does not have a clear prevalent spelling, write accordingly to the variant used in the edited section. Harmonizing the spelling around the edited content is acceptable; refrain from performing edits whose main purpose is changing or harmonizing the spelling standard of articles or series thereof.

Language register

  • Articles should be written using formal, professional, and concise language. Care should be taken to remove grammar and orthography errors through edit previews and proofreading.
  • Remember not only to answer how, but also why. Explanatory information always goes further toward imparting knowledge than does instruction alone.
  • Do not omit terms that are necessary to give an exact, unambiguous meaning to a sentence; for example, always add the word "repository" when mentioning the name of a repository.
  • Do not use indefinite time references such as "currently", "at the time of writing" or "soon"; replace them with definite expressions such as "as of May 2015" etc.
  • Write objectively: do not include personal comments on articles; use discussion pages for this purpose. In general, do not write in first person.
  • When editing content, be consistent with the style used in the rest of the article; for example, if the reader is always addressed using the second person, this style should be adopted by the added content; the same goes if third person or passive voice are clearly dominant throughout the article.
  • When offering a choice among different options (pieces of software, methods to do something, etc.) do not explicitly recommend one over the others, but objectively describe the advantages and disadvantages of each, thus helping the reader to make the best decision for their personal case.
  • Prefer neutral pronouns such as they/them when referring to the reader or people in general.

Kategóriaoldalak

  • Category name must use sentence case.
  • Every category must be appropriately categorized under at least one parent category, except for root categories, which are:
  • A category can be categorized under more than one category, provided one is not ancestor of the others.
  • Avoid circular relationships: two categories cannot be reciprocal ancestors.
  • Do not categorize a category under itself (self-categorized category).
  • Categories must be included at the top of the category page.
  • Categories should not redirect, except temporarily during renaming.
  • By default, category names should be in the singular form ("topic" categories, for example Category:Simulation); they should be in the plural form if the singular form can be used to describe one of its members ("set" categories, for example Category:Boot loaders).

Oldalak átirányítása

  • It is encouraged to create redirect pages for acronyms or grammatical variants of an existing article's title, or for a term or topic discussed in a subsection of a more generic article; for example ALSA, daemon or AIGLX. Redirects can simplify the source text by replacing labelled links, compare the previous examples with [[Advanced Linux Sound Architecture|ALSA]], [[daemons|daemon]] or [[Xorg#Composite|AIGLX]].
  • Redirect pages should contain only the redirect code and nothing else; the only exceptions are:
  • Redirect only to internal articles; do not use interwiki redirections.
Redirects using interlanguage links are exceptionally allowed in accordance with Help:i18n, and upon authorization from the ArchWiki:Maintenance Team.

User pages

  • Pages in the User namespace cannot be categorized.
  • Pages in the User namespace can only be linked from other pages in the User or talk namespaces, unless authorization to do otherwise is given by Administrators.
  • Pages in the User namespace cannot be targets of redirects from other namespaces.

Generic rules

Szerkesztési összefoglaló

Tekintse meg a ArchWiki:Contributing#The 3 fundamental rules című leírást.

HTML tags

  • Usage of HTML tags is generally discouraged; always prefer using wiki markup or templates when possible (see Help:Editing and related).
  • When tempted to use <pre>code</pre>, always resort to {{bc|code}}. When tempted to use <tt>text</tt> or <code>text</code>, always resort to {{ic|text}}.
  • Especially avoid HTML comments (<!-- comment -->): it is likely that a note added in a HTML comment can be explicitly shown in the article's discussion page. You can add an appropriate status template in place of the comment.
  • Use <br> only when necessary; to start a new paragraph or break a line, put a blank line below it.
Tipp Common exceptions to this rule are when it is necessary to break a line in a list item and you cannot use a sub-item, or inside a template and you cannot use a list.