Ubuwiki:Közösségi portál

A Ubuwiki wikiből

Üdvözlünk a magyar Ubuntu dokumentációs wiki szerkesztői között!

A magyar Ubuntu dokumentációs wiki célja az Ubuntu legutóbbi stabil és legutóbbi LTS kiadásának használatakor felmerülő problémák megoldásainak összegyűjtése. Ezen az oldalon az ebben való részvétellel kapcsolatos információkat találhatod meg.

Hogyan működhetsz közre?

  • Először is, keress egy problémát, amely (feltételezhetően) számos felhasználót érint.
  • Ha magad nem találkozol ilyennel, akkor kitűnő vadászterület az ubuntu.hu fóruma.
    • Probléma alatt a hivatalos súgóban (ennek része a kiszolgáló kézikönyv is) meg nem található, „hogyan üzemelhető be ez a hardver/hogyan használható adott program adott feladatra” stb. típusú kérdéseket értjük.
  • Ha a probléma megvan, akkor már csak a megoldását kell megtalálni, ez jó esetben a fórumtémák valamelyikében már megvan.
    • Ha nincs megoldás, akkor keresd meg! ;)
  • Ha megvan a probléma és a megoldása is, akkor nyiss egy új wikioldalt a címlapon található témakör-oldalak egyikéről, és töltsd fel tartalommal.

Hogyan írj dokumentációt?

Ebben a szakaszban összegyűjtöttük a legfontosabb irányelveket, ajánlásokat és tudnivalókat a dokumentációkat, útmutatókat készítők számára. Kérjük, ezeket tartsd szem előtt, amikor dolgozol:

  • Törekedj az érthető fogalmazásra, és az egyértelmű terminológiára.
  • Figyelj oda a helyesírásra, nyelvhelyességre és az áttekinthető tördelésre.
  • Ahol lehet, használj magyar kifejezéseket - de nem mindenáron: ha a gyakorlatban az angol kifejezés terjedt el (például kernel) használd nyugodtan azt.
  • Mindig a magyar felhasználói felület kifejezéseid használd - kivéve, ahol ez értelemszerűen nem lehetséges (mert az adott alkalmazás nem érhető el magyar nyelven), vagy értelmetlen lenne (például arról írsz, hogy hogyan lehet egy angol rendszerre a magyar nyelvi támogatást telepíteni utólag).
  • Grafikus felületen a synaptic, konzolon az apt-get a preferált csomagkezelő, így a leírásokban is ezek szerepeljenek.
  • Az alapértelmezett disztribúció az Ubuntu. Vagyis hacsak nem kifejezetten Kubuntu vagy Xubuntu specifikus a téma, akkor mindig az Ubuntu-t vedd alapul, és erről készüljenek a képernyőképek is.
  • Grafikus alkalmazásokat grafikus csomagkezelővel (synaptic), konzolos alkalmazásokat konzolos csomagkezelővel (apt-get) telepítsd.
  • Külső forrásból származó csomagokat csak akkor használj, ha ez tényleg elkerülhetetlen (például ABEVJava).
  • Konzolos alkalmazásokat a

sudo

, grafikus alkalmazásokat a

gksu

(Ubuntu és Xubuntu esetében) vagy a

kdesudo

(Kubuntu esetében) paranccsal indítsd, ha rendszergazdai jogosultságot igényelnek. Vagyis

sudo nano ...

vagy

gksu gedit ...

, esetleg

kdesudo kate ...

- tehát például a

sudo gedit

forma kerülendő.

  • Ha fájlokat kell másolgatni a könyvtárstruktúra különböző helyeire, akkor azt konzolon, a megfelelően paraméterezett

cp

parancs segítségével tedd, hogy a felhasználónak csak be kelljen másolnia a megfelelő sorokat a konzolba.

  • Ha mellékelsz képeket, a [[Fájl:valami.png|thumb|none|alt=altszöveg]] szintaxist használd: ekkor balra igazított bélyegkép jelenik meg, az altszöveg helyettesítő szöveggel, amely a látássérültek számára is követhetővé teszi a leírást.
  • A képernyőképeket PNG, a fotókat JPEG formátumban töltsd fel.
  • Figyelj a licencekre és a jogszerűségre! Jelöld a felhasznált forrásokat, és ha más dokumentációjából használsz fel részleteket, akkor azt tedd jogszerűen: például a GNU-FDL (Free Documentation License) és a CC-by-sa licenc nem kompatibilis egymással. Vagyis ha az útmutatódban szerepelnek GNU-FDL alatt kiadott részletek, akkor az egész dokumentumot GNU-FDL licenc hatálya alá kell helyezni.
  • Alapesetben minden, az oldalra beküldött dokumentáció a Creative Commons Nevezd meg!-Így add tovább! 3.0 Magyarország Licenc alá kerül. Kérlek jelezd, ha ez valamilyen okból (például mert a felhasznált anyagok ezt nem teszik lehetővé) nem felel meg - és nevezd meg a dokumentum felhasználási feltételeit.
  • Az írásod úgy tudod a felhasználók számára egyszerűen elérhetővé tenni, ha felveszed a címlapon található valamelyik témagyűjtő oldalra. Figyelj oda, hogy a megfelelő szekcióba tedd, és igyekezz úgy elhelyezni a sorban, hogy a felhasználók számára a legáttekinthetőbb legyen.
  • Ha bizonytalan vagy valamivel kapcsolatban (például hogy miről írj, milyen megoldási utat válassz, hova helyezd el a dokumentumot) akkor kérdezz bátran a levelezőlistán - végül is ezért van.

A wikiszoftver használatával kapcsolatos súgó

Logó
Személyes eszközök