====== Konfiguracja DokuWiki ====== Wiele cech DokuWiki może być dostosowanych przez liczne opcje konfiguracji. Najprostszym sposobem zmiany tych opcji jest wykorzystanie [[.plugin:config|Menadżera Konfiguracji]], który pozwala administratorom wiki w prosty sposób zmieniać ustawienia wiki przy użyciu ulubionej przeglądarki. By przejść do Menadżera Konfiguracji zaloguj się jako administrator lub superużytkownik i wciśnij przycisk Administracja u dołu strony. ===== Co można skonfigurować ===== Opcje "systemowe" DokuWiki znajdują się w pliku ''conf/dokuwiki.php''. Ten plik przechowuje tylko "domyślne" wartości systemu. By je dostosować, powinieneś zmienić plik ''conf/local.php'' lub też go utworzyć, jeśli nie istnieje. By dowiedzieć się, co możesz ustawić w pliku przejrzyj poniższą listę [[#dostepne opcje|dostępnych opcji|]]. Nazwy użytkowników, (zaszyfrowane) hasła i reguły Kontroli Dostępu są przechowywane w [[acl|users.auth.php i acl.auth.php]]. Podczas przesyłania nowego pliku przy użyciu Menadżera Mediów, Możesz spotkać się z komunikatem ''"Przesyłanie zabronione. To rozszerzenie pliku jest zabronione!"''. To działanie kontrolowane jest w pliku ''conf/mime.conf''. Aby przesłać nowy typ pliku, wskaż go w pliku [[mime|mime.conf]]. Podczas edycji strony wykonywane są pewne automatyczne zastąpienia. Niektóre generują dymki, emotki albo znaki specjalne. To zachowanie sterowane jest w plikach [[abbreviations|acronyms.conf]], [[smileys|smileys.conf]] lub [[entities|entities.conf]]. ===== Pliki konfiguracji ===== Wszystkie pliki konfiguracji znajdują się w folderze ''./conf'' lub ''/etc/dokuwiki'' o ile zainstalowano z pakietu Debiana. "Pliki podstawowe" zwykle zapewniane są przez DokuWiki, jednakże "pliki lokalne" muszą być utworzone przez administratora wiki. Jeśli zapewniane są pliki lokalne, powinieneś ich użyć zamiast zmieniać pliki podstawowe by uniknąć problemów podczas aktualizacji. ^plik podstawowy ^plik lokalny ^typ konfiguracji ^ krótka notka ^ |''dokuwiki.php'' |''local.php''\\ ''local.protected.php''|patrz poniżej | podstawowa konfiguracja dokuwiki | |''acronyms.conf'' |''acronyms.local.conf'' |[[abbreviations|skróty]] | automatyczne podpowiedzi skrótów | |''entities.conf'' |''entities.local.conf'' |[[entities|jednostki]] | automatyczne zamiany tekstu | |''interwiki.conf'' |''interwiki.local.conf'' |[[interwiki]] | linki skrótów interwiki | |''mime.conf'' |''mime.local.conf'' |[[mime]] | ustawienia typów mime dla przesłań plików | |''smileys.conf'' |''smileys.local.conf'' |[[smileys]] | zastępowanie obrazków | | |''acl.auth.php'' |patrz [[acl]] | ustawienia Kontroli Dostępu | | |''users.auth.php'' |patrz [[acl]] | Użytkownicy i hasła | |''license.php'' |''license.local.php'' |[[config:license]] | ista dostępnych licencji | |''scheme.conf'' |''scheme.local.conf'' |[[urlschemes]] | schematy URL rozpoznawane jako linki | |''mediameta.php'' | |[[exif]] | edytowalne metadane obrazków | |''wordblock.conf'' |''wordblock.local.conf'' |[[blacklist]] | czarna lista spamu | |''plugins.required.php'' |''plugins.local.php''\\ ''plugins.protected.php'' |patrz niżej | Włączanie/wyłaczanie wtyczek | | |''userscript.js'' |[[.devel:javascript]] | Rozszerzenia użytkownika JavaScript | | |''userstyle.css'' |[[.devel:css]] | Rozszerzenia użytkownika CSS | ===== Włączanie/wyłączanie wtyczek ===== Zainstalowane wtyczki są domyślnie włączone. Mogą zostać zablokowane przy użyciu [[.plugin:plugin|Menadżera wtyczek]], który pisze do pliku ''plugins.local.php''. Możesz chronić pewne wtyczki umieszczając je w ''conf/plugins.protected.php''. Domyślnie DokuWiki wczytuje pliki konfiguracyjne w następującej kolejności: - ''conf/plugins.local.php'' -- zmieniany przez menadżera wtyczek - ''conf/plugins.required.php'' -- te wtyczki podstawowe nie mogą być kontrolowane przez menadżera wtyczek - ''conf/plugins.protected.php'' -- nadpisuje ustawienia pierwszych dwóch plików Porządek wczytywania plików konfiguracyjnych jest sterowany przez globalną zmienną ''$config_cascade''. Możesz zmienić to zachowanie wykorzystując plik [[.devel:preload|preload.php]]. ===== Opcje konfiguracji ===== Większość funkcji [[DokuWiki]] może być ustawiona przez różne opcje konfiguracji. Najprostszym sposobem zmiany tych opcji jest użycie [[.plugin:config|Menadżera konfiguracji]]. Dostępne ustawienia są wymienione poniżej. Ich domyślne wartości przechowywane są w pliku o nazwie ''conf/dokuwiki.php''. Jeśli chcesz zmienić jakieś ustawienie, powinieneś zrobić to w pliku o nazwie ''conf/local.php'' -- zapewni to, że twoje specjalne ustawienia nie zostaną nadpisane podczas późniejszej aktualizacji. Menadżer konfiguracji korzysta również z tego pliku. Plik ''conf/local.protected.php'' może być wykorzystany do wprowadzenia ustawień, które nie mogą być zmieniane. Oto przykładowy ''conf/local.php'': Kilka uwag na temat pliku konfiguracyjnego. Plik jest częścią kodu PHP zatem musi być zachowana składnia PHP . Np. każda niepusta linia musi kończyć się średnikiem. Jest wiele typów zmiennych: * **Liczby** moga być pisane normalnie. Przykład: ''9'' * **Ciągi znaków** muszą być ograniczone apostrofami lub cudzysłowami. Przykład: ''%%'foo bar'%%'' * **Logiczne** mogą być albo ''1'' albo ''0'' * **Tabele** zawierają wiele wartości jednego z powyższych typów ==== Dostępne opcje ==== * **Ustawienia podstawowe ** * [[config:title]] * [[config:startpage|start]] * [[config:lang]] * [[config:template]] * [[config:license]] * [[config:savedir]] * [[config:basedir]] * [[config:baseurl]] * [[config:dmode]] * [[config:fmode]] * [[config:allowdebug]] * **Ustawienia wyświetlania** * [[config:recent]] * [[config:breadcrumbs]] * [[config:youarehere]] * [[config:fullpath]] * [[config:typography]] * [[config:dformat]] * [[config:signature]] * [[config:showuseras]] * [[config:toptoclevel]] * [[config:tocminheads]] * [[config:maxtoclevel]] * [[config:maxseclevel]] * [[config:camelcase]] * [[config:deaccent]] * [[config:useheading]] * [[config:refcheck]] * **Ustawienia autoryzacji** * [[config:useacl]] * [[config:autopasswd]] * [[config:authtype]] * [[config:passcrypt]] * [[config:defaultgroup]] * [[config:superuser]] * [[config:manager]] * [[config:profileconfirm]] * [[config:rememberme]] * [[config:registernotify]] * [[config:disableactions]] * [[config:sneaky_index]] * [[config:auth_security_timeout]] * [[config:securecookie]] * ** Ustawienia przeciwspamowe** * [[config:usewordblock]] * [[config:relnofollow]] * [[config:indexdelay]] * [[config:mailguard]] * [[config:iexssprotect]] * ** Ustawienia edycyjne ** * [[config:usedraft]] * [[config:htmlok]] * [[config:phpok]] * [[config:notify]] * [[config:subscribers]] * [[config:locktime]] * [[config:cachetime]] * ** Ustawienia linków ** * [[config:target|target (wiki, interwiki, extern, media, windows)]] * ** Ustawienia multimediów ** * [[config:gdlib]] * [[config:im_convert]] * [[config:jpg_quality]] * [[config:fetchsize]] * ** Opcje zaawansowane ** * [[config:updatecheck]] * [[config:userewrite]] * [[config:useslash]] * [[config:sepchar]] * [[config:canonical]] * [[config:fnencode]] * [[config:autoplural]] * [[config:mailfrom]] * [[config:compress]] * [[config:cssdatauri]] * [[config:gzip_output]] * [[config:hidepages]] * [[config:send404]] * [[config:compression]] * [[config:sitemap]] * [[config:rss_type]] * [[config:rss_linkto]] * [[config:rss_content]] * [[config:rss_update]] * [[config:recent_days]] * [[config:rss_show_summary]] * [[config:broken_iua]] * [[config:xsendfile]] * [[config:remote]] * [[config:remoteuser]] * [[config:renderer_xhtml]] * [[config:readdircache]] * ** Ustawienia sieciowe ** * [[config:proxy|proxy (host, port, user, pass, ssl)]] * [[config:safemodehack]] * [[config:ftp|ftp (host, port, user, pass, root)]]