[Faq-workers] Prijedlog strukture FAQ-a

Bok vas (sedam na listi koliko vidim za sada). Sastavio sam draft kostura kako bi tematski trebao biti organiziran FAQ. Ideje i prijedlozi su dobrodošli, ako netko ima kakvu ideju ili želi nešto dodati neka to i napravi. Moj prijedlog je da izradimo osnovni kostur sa sekcijama, u kojega onda možemo dodavati u budućnosti nove Q/A parove bez potrebe za reorganizacijom dokumenta. FAQ bi imao uvod i predgovor. Ovdje idu standardne stvari koje ljudi stave u predgovor, opis ideje, što sadrži dokument, posvete narodnim herojima ... Sekcija "konvencije" ne bi bila kratka, već bi sadržavala puno toga što često zbunjuje putnike-namjernike u svijet unixa, tu se mogu inkorporirati dijelovi uvodne sekcije FAQ-a v1.X (FAQ v1.X je Mozgyjev FAQ, a moj prijedlog je da krenemo od major broja 2, tj njegovih beta. Sekcija "osnove" sadržavala bi ne samo osnove, već sve i svašta, od osnovnog rada u shellu, odabira editora. Sekcija o konfiguraciji sistema za sada je prazna, a tu bi išli neki djelovi FAQv1 i prevedeni važniji djelovi "configuration howto"-a. Sekcija o grafičkom sučelju i userland programima bi trebala biti opširna velika i bogata, te koncipirana tako da može prihvaćati puno izmjena i dopuna, uočite i sami. Puno KDE-a, GNOME-a, s time da o tim stvarima ipak ne bi trebali pisati potpuni početnici. Josipe, pitaj Tvrtka da li bi želio malo poraditi na KDE Q/A, bolje netko tko zna što piše ... Sekcija Razno je za stvari koje se ne mogu nekako utrpati u ostale sekcije tematski. Sekcija o networkingu je mješavina osnova i srednje naprednih taskova, administracijske stvari i naprednije opcije idu u URL-ove prema specifičnoj dokumentaciji. Sistemski servisi i napredno može koristiti dobar dio Mozgyjevog FAQ-a, a neke stvari treba napisati ili prepisati sa neta. Sekcija o kompiliranju i developmentu pokriva osnove makeanja, gcc-a, editore "radne okoline", env varijable, configure, objašnjenje kriptičnijih errora ... uglavnom ono što pokriva isto tako česta pitanja sa h.c.o.l. Sekcija o Vendor/Distribution specific problemima i alatima je posebna. Ovdje se mogu opisati grafički alati (i to samo oni koji ne rade veliku štetu) specifični za neku pojedinu distribuciju, recimo redhatov authconfig za PAM, kbdconfig ... inače cijeli ostali dio FAQ-a trebao bi biti distribution transparent i generički, s time da se kod pojedinih odgovora može dati interni link na neko mjesto u distra-specifičnoj sekciji. Ova sekcija je svojevrsna baza dist-specific odgovora. Sekcija o hardware vendorima bi trebala opisivati instalaciju OSS/Free ili proprietary drivera za graf. kartice, kontrolere i tzv. "winmodeme". Ovdje se također može dereferencirati koji interni link iz 6 i 8 sekcije. Slijede razne stvari vezane uz licence, software, GNU, OSS, pošalice, skečevi, gegovi, i na kraju zahvale. Premda će FAQ imati i tekstualnu verziju za slanje na grupu i mailove, osnovni format bi bio HTML, jer mislim da su nam direktni URL-ovi do pojedinih odgovora *najvažniji* fičur FAQ-a, direktni i točni URL-ovi mogu se davati njubijima kao definitivni odgovori za čepljenje usta! :-) Moj draft uglavnom ne sadrži sekcije, subsekcije i subsubsekcije u obliku pitanja, već kao neki info dokument ili vodič. To je zato što ima puno sličnih pitanja koja mogu pointati na neki odgovor. S toga bi FAQ nakon predgovora, a prije konvencija trebao imati masu pitanja koja bi bili interni linkovi na dijelove FAQ-a. Ako mislite da to nije dobra ideja, vičite i obrazložite, u tom slučaju ćemo prepravljati imena subsubsekcija, krajnjih subsekcija bez subsubsekcija (ali ne i sekcija kao takvih). Nakon što se dogovorimo oko designa dokumenta, možemo se sa Turbom dogovoriti oko tehničkog dijela uploada (smisli nešto, samo da je praktično :-) ...) Q/A parova i tkanja u kostur, a moramo se i dogovoriti tko će commitati (2-3 čovjeka bi trebala samo komitati da se to ne pretvori u košmar). FAQ bi bio dostupan na recimo http://faq.linux.hr/newfaq koji ne bi bio direktno stavljen na klikabilni link ili vidljiv dok ne dospije u neku razumnu beta fazu - i ovo je otvoreno za diskusiju. Ako se dogovorimo i ako ustanovimo da ćemo ga koristiti/trebati, Kost nam može dati i CVS modul. Ja sam mu rekao da za sada ne treba. ----------------------- O samoj listi ukratko: Konfigurirana je prilično liberalno, s time da popis članova mogu vidjeti samo članovi, potrebna je potvrda subscribeanja, a mailove ne-članova odobrava listmaster, članovi piče O_DIRECT. Kontaktirat ću još jednom server admina da pogleda zašto muljanje adresa sudionika u web arhivi ne radi. Naime to treba omogućiti (manglanje mail adresa) da spam roboti ne skupljaju adrese, ja sam probao preko administrativnog web sučelja, ali meni ne radi(TM). Kost još bih te molio samo to da pogledaš, to i zašto se ISO8859-2 dijakritici na webu pretvaraju u SCO enkripciju (base64). Za one koji još nisu subscribeani: http://lists.linux.hr/listinfo/faq-workers ----------------------- Ovo dole što slijedi jest moj draft sadržaja FAQ-a. Molio bih prijedloge, sugestije bla ... -------------------------------------------------------------------------------- FAQ 1. Uvod 2. Predgovor 2.1 Što je FAQ 2.2 Tko ga je napravio, a tko još davno započeo 2.3 Čemu služi FAQ 3. Konvencije 3.1. Postanje na usenet i pisanje maila - netiquette, URL na catb.org/~esr/smart_questions. 3.2. Što je to kada mi netko kaže "vidi foo(1)" 3.3. Što su to info stranice i kako se koriste. 3.3. Što je HOWTO, a što info stranice i gdje se mogu naći 3.4. Što su to README i INSTALL fileovi i što u njima obično piše. 3.5. Termini korišteni u ovom dokumentu, njihova objašnjenja i URL-ovi na jargon file kada je to potrebno. 3.6. Linux vs "Linuxi" i Mandrake vs "mendrejksi" - jednom za svagda. 3.7. Kako čitati dokumentaciju i kako pristupati problemima. 3.7.1. Debugiranje 3.7.2. Logovi 3.7.3. Lociranje problema, artikulacija pitanja i točan opis poduzetih radnji. 3.7.4. Pretraživanje WWW-a u potrazi za riješenjem problema - mini HOWTO. 4. Osnove i Razno 4.1. Što je to GNU/Linux (XXX - da li ga možemo tako zvati?) 4.2. Što su to distribucije i što one u principu sadrže, te koje distribucije su više preferirane od kojih skupina ljudi. 4.3. Od čega se sastoji jedan Unix sistem (kernel, libc, shell, programi ...), kako se boota i kako se logiramo na njega. 4.4. Što su to particije i kako radimo sa PC particijama. 4.4.1. fdisk(8) 4.4.2. Partition Magic (jebiga mora se opisati) 4.5. Filesystemi, ext2/3 reiser, vfat, ntfs, čitanje i pisanje po istima pod linuxom, nove nade: XFS, JFS ... 4.5.1. Kako podjeliti particije (M) 4.6. Instalacija - generalno. 4.6.1. Instalacija Debiana 4.6.2. Instalacija Mandrakea 4.6.3. Instalacija Gentooa 4.6.4. Instalacija Slackwarea 4.6.5. Instalacija Red Hata 4.6.6. Instalacija SUSE-a 4.6.7. Linkovi do svih distribucija i njihove engleske dokumentacije, linkovi do rasprava koja je distra bolja i nekoliko riječi o tim raspravama i njihovom (be)smislu. 4.7. Rad u bash shellu, osnove, &, &&, ;, |, ||, >, >>, !$, !!, jobs, fg, bg, C-k, C-r, C-l, C-v, C-p, C-e, C-a, C-z ... 4.8. ls(1), cp(1), mv(1), rm(1), id(1), ps(1), vi(1), cat(1), grep(1), tail(1), head(1), tar(1), gzip(1), bzip2(1), ln(1), chgrp(1), chmod(1), chown(1), cut(1), date(1), env(1), kill(1), mkdir(1), rmdir(1), su(1), sort(1), uniq(1) passwd(1), useradd(8), usermod(8), userdel(8), chfn(1), ... pajpanje, redirekcija i stdin/stdout/stderr 4.9. Odabir editora 4.9.1. Vi - najnužnije osnove 4.9.2. Emacs - najnužnije osnove 4.9.3. Joe 4.9.3. Pico 4.9.3. Kedit 4.9.3. Nedit 4.9.3. Štatijaznamedit 4.10. Što je gdje na filesystemu, kako izgleda filesystem, što je moutanje, što je `/', (malo prepričati hier(7)). 4.10.2. Kako koristiti locate(1) i find(1). 5. Osnovna konfiguracija sistema (koristiti Mozgyjev FAQ intenzivno) 6. Grafičko sučelje pod Unix sistemima i userland programi 6.1. Što je to X server. 6.2. Što su to window manageri i desktop environmenti. 6.3. Što je GNOME 6.3.1 Kako se u GNOME-u ona kvačica na prozorčiću ... 6.3.2 Kako se u GNOME-u ... 6.3.3 ... 6.4. Što je KDE 6.4.1 Kako se u KDE-u ona kvačica na prozorčiću ... 6.4.2 Kako se u KDE-u ... 6.4.3 ... 6.5. GNOME vs KDE 6.6. Mogu li se koristiti zajedno aplikacije jednog i drugog 6.7. Što su to GTK, QT, Motif, Xaw*, Xt, wxwindows ... 6.8. Ponašanje X11 programa, njihova interakcija sa serverom. 6.9. X11 autentifikacija - xauth(1), .Xauthority, xdm, kdm i gdm. 6.10. .Xdefaults i .xinitrc/.xsession 6.11. WWW Browseri, pros, cons, a vs b ... 6.11.1. Kako se u Mozilli ono ... 6.11.2. Mozilla mi neće ... 6.11.3. Fontovi u Galeonu su mi bla. 6.12. Uredski paket - OpenOffice, osnove, nešto uvoda, "alternativni" načini pisanja na kompjuteru (TeX, troff) ... 6.12.1. Kako instalirati hrvatski spell u OOo 6.12.2. Gdje se može skinuti krvatski lokalizirani OOo 6.12.3. Lokalizirani OOo, pros cons, rasprave na tu temu ... 6.12.4. 6.12.5. 6.12.6. 6.12.7. 6.12.8. 6.12.9. 6.12.10. 6.13. Mail readeri 6.13.1. Mozilla mail 6.13.2. Kmail 6.13.3. Sylpheed 6.13.4. Evolution 6.13.5. mutt(1) 6.13.6. mailx(1) 6.13.7. (X)emacs/Gnus 6.14. InterNetNews iliti Usenet (krasti recenzije iz članaka sa weba) 6.14.1. Mozilla 6.14.2. Pan 6.14.3. slrn 6.14.4. (X)emacs/Gnus 6.14.3. tin 6.14.5. Lokalni off line news spool mini howto. 6.15. IRC, ICQ, mcq, CCCP ... 6.15.1. licq ... 6.15.2. ... 6.15.3. ... 6.15.4. ... 6.16. Programi za gledanje videa, mpeg-a, avija, obradu ... 6.16.1. Mplayer 6.16.2. aviplay 6.16.3. 6.17. Programi za slušanje i obradu muzike i ripanje 6.17.1. Što je ogg format 6.17.1. xmms(1) 6.17.2. itd itd ... 6.18. Prženje cdromova, teorija i konkretni programi. 6.18.1. Help, ne prepoznaje mi pržilicu 6.18.2. Koji program za prženje ... 6.18.3. Što je cdrecord i kako je povezan sa ostalim programima. 6.18.4. 6.18.5. 6.19. Obrada slike, gimp i ImageMagick, preglednici ... 6.20. P2P programi, gdje ih nabaviti i kako ih instalirati. 6.20.1. xMule, aMule, edonkey, mldonkey ... 6.21. Fino podešavanje slike X servera, geometrija, DPI, Depth ... 6.22. GL, 2D i 3D akceleracija, XF86Config, vendori: nvidia, ati ... 6.23. Miš: tipovi, brzina, akceleracija, X mouse, gpm(8), protokoli ... 6.24. Razni c00l programi i kratak opis - (korisno za upućivanje njubija), kalendari, zezalice, beskorisni GUI-ji ... 6.25. Gdje nabaviti Acrobat Reader. 6.26. Igre (nemam pojma o tome) 6.26.1. Popis popularnijih, gdje nabaviti igre ... 6.26.2 Igra foo 6.26.3 Igra bar 6.26.4 Igra baz 6.27. Fontovi: xfm(8), TrueType, Type1, fixni, proporcionalni, konzolni ... instalacija, mkfontdir, ttmkfdir ... 7. Razno 7.1. Kako mountati vfat/ntfs/cifs/NFS/hfs ... 8. Networking 8.1. Modem 8.1.1 Externi modemi, interni modemi (krasti iz modem howto). 8.1.2 Winmodemi 8.2. ISDN, PPP, DSL, PPPOE, Frame Relay, HDLC, ATM ... 8.2.1. Kako podesiti pppd(8) - (M. FAQ uglavnom) 8.3. Ethernet/802.3, Token Ring, FDDI, 802.1Q, 802.1d, 802.2, ... 8.4. NFS, SMBFS/Samba, CIFS, AFS ... 8.5. NIS, LDAP, automounter ... 8.6. Debugiranje, ping, traceroute, strace -econnect,bind, ... 8.7. Firewalling, iptables(8) i gui wrapperi za isti, samo osnove, informacije kako radi i par primjera, tcp wrapperi, ostalo hyperlinkovi. 8.8. Ssh, telnet, scp, ftp, ntp ... klijenti. 9. Sistemski servisi i napredno konfigurirati (koristiti Mozgy FAQ pretežno). 9.0. Kako gasiti i paliti servise 9.1. sshd 9.2. sendmail/exim/postfix (sendmail dio iz Mozgy FAQ-a sa malo izmjena) 9.3. (x)(rl)(p)inetd i njegovi servisi 9.4. Bind 9.5. Baze (samo instalacija, dizanje spuštanje, ostalo URL-ovi) 9.5.1. Postgresql 9.5.2. MySQL 9.5.3. Oracle 9.6. NFS, portmap ... 9.7. LPD, LprNG vs CUPS, kako namjestiti printer (ulong*) 9.8. ... 9.9. Kako filtrirati mail sa procmailom, a kako sa sieve. 9.X. Ostalo ... 10. Development, programi i kompiliranje. 10.1. Što je Kernel i kako ga iskompilirati (Mozgyjev + 2.6 izmjene) 10.2. Kompiliranje autoconf-based sourceva 10.3. Kompiliranje X poroject (Imake) based sourceva 10.4. Što je to kompajler, kako se zove, čemu služi 10.5. Linker ... 10.6. CPPFLAGS, LDFLAGS, LD_RUN_PATH, LIBS, CC, CFLAGS, CXX, CXXFLAGS, 10.7. Makefile 10.8. Gdje pronaći API dokumentaciju, kako koristiti perl i CPAN 10.9. Python, Perl, C, PHP, Java, C++ ... URL-ovi, par riječi. 10.10. Kako prijaviti neuspješno kompiliranje 10.11. Kako koristiti gdb(1), ltrace(1) i strace(1). 10.12. Objašnjenje češćih gcc/ld compile errora (stucture has no member called bla, undefined reference to ..., cannot find Xm.h ..., previous declaration of sys_errlist, parse error ...) 10.13. Objašnjenje kriptičnijih error outputa (cannot stat, not a directory, file exists, access denied, operation not supported, segmentation fault, bus error, killed, unable to handle kernel paging request on virtual address 0X..., printing EIP ...) 10.14. Editori i IDE-ovi ... 11. Vendor/Distribution specific problemi i alati 11.1 Debian 11.1.1 11.1.2 11.2 Mandrake 11.2.1 11.2.2 11.3 SUSE 11.3.1 11.3.2 11.4 Red Hat 11.4.1 11.4.2 Note: u ovu sekciju bi trebali voditi linkovi iz ostalih sekcija kada je to primjenjivo. 12. Hardware vendori i driveri, NVidia, ATI, IBM, Lucent, Cisco (instalacija drivera - idiot proof copy/paste-ovi) 13. Zaključci, filozofija, clippete ... 14. Zahvale i EOF -------------------------------------------------------------------------------- Eto ja to onako ukratko ... :-) -- The Network is the Filesystem.