差分
このページの2つのバージョン間の差分を表示します。
両方とも前のリビジョン前のリビジョン次のリビジョン | 前のリビジョン | ||
wiki:config [2005/11/30 00:35] – osamu | wiki:config [2013/08/06 16:22] (現在) – 削除 osamu | ||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== 設定 ====== | ||
- | [[DokuWiki]]のほとんどの機能は'' | ||
- | |||
- | 設定(config)ファイルについての注意事項です。このファイルはPHPのプログラムファイルで、PHPの文法にのっとって記述しないといけません。たとえば、それぞれの行の終わりは必ずセミコロンで終わっていることなどです。また、設定する変数は次のような種類があります。 | ||
- | |||
- | * **数値**はそのまま数字を記入します。例:'' | ||
- | * **文字列**はアポストロフィで囲みます。例:'' | ||
- | * **論理値**は'' | ||
- | * **配列**には、上の種類のいずれかを複数セットにして格納します。 | ||
- | |||
- | **ヒント:** もし'' | ||
- | |||
- | **conf/ | ||
- | |||
- | <code php> | ||
- | <?php | ||
- | $conf[' | ||
- | ?> | ||
- | </ | ||
- | |||
- | [[install|インストール]]済みのDokuWikiの動作をカスタマイズできる箇所は、このほかに[[interwiki]]、[[include hooks]]、[[wiki: | ||
- | |||
- | ===== Datastorage and Permissions ===== | ||
- | |||
- | ==== umask ==== | ||
- | |||
- | This parameter influences the file permissions which new files will get. See [[man> | ||
- | |||
- | * Type: Number | ||
- | * Default: '' | ||
- | |||
- | ==== dmask ==== | ||
- | |||
- | This works like umask above but sets the permissions of new directories. The default creates directories with permissions of '' | ||
- | |||
- | * Type: Number | ||
- | * Default: '' | ||
- | |||
- | |||
- | ==== basedir ==== | ||
- | |||
- | Usually DokuWiki can detect the directory that it is installed in on its own. But sometimes this does not work for various reasons. | ||
- | |||
- | The path you should set here, is the path from the server root to your DokuWiki installation. Eg. if your wiki is available at '' | ||
- | |||
- | * Type: String | ||
- | * Default: '''' | ||
- | |||
- | ==== lang ==== | ||
- | |||
- | ユーザーインターフェースの言語を指定します。[[doku> | ||
- | |||
- | * 型: 文字列 | ||
- | * 既定値: '' | ||
- | |||
- | |||
- | ==== savedir ==== | ||
- | |||
- | This is the path were all files will be stored. This is a filesystem path. It needs to be writable by the webserver. | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | Inside this directory are multiple subdirectories and the changelog. You can override their position by the following config parameters: | ||
- | |||
- | ^ Parameter ^ default inside savedir ^ | ||
- | | datadir | ||
- | | olddir | ||
- | | mediadir | ||
- | | cachedir | ||
- | | lockdir | ||
- | | changelog | changes.log | ||
- | | metadir | ||
- | |||
- | ===== Display options ===== | ||
- | |||
- | |||
- | |||
- | ==== start ==== | ||
- | |||
- | This is the name of the default page which is loaded when no page was given also known as "The Homepage" | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | ==== title ==== | ||
- | |||
- | This is the name of your Wiki installation. Change it to whatever you like. If you want to run multiple installations of [[DokuWiki]] on the same server they need to have different titles! | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | |||
- | ==== template ==== | ||
- | |||
- | The name of the template used by your Wiki installation. For more details refer [[wiki: | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | ==== fullpath ==== | ||
- | |||
- | Enable this to see the full filesystem path of the displayed document. | ||
- | |||
- | * Type: boolean | ||
- | * Default: 1 | ||
- | |||
- | ==== recent ==== | ||
- | |||
- | Defines the number of documents to show in the //Recent changes// | ||
- | |||
- | * Type: Number | ||
- | * Default: '' | ||
- | |||
- | ==== breadcrumbs ==== | ||
- | |||
- | Defines the number of recently visited pages to show in the [[breadcrumbs]] trail | ||
- | |||
- | * Type: Number | ||
- | * Default: '' | ||
- | |||
- | ==== typography ==== | ||
- | |||
- | Enable to convert certain character combinations to their typographically correct counterpart. | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== htmlok ==== | ||
- | |||
- | Defines if embedding HTML using the '' | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== phpok ==== | ||
- | |||
- | Defines if embedding PHP using the '' | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== dformat ==== | ||
- | |||
- | Configures how dates are formated. This is directly passed to the [[phpfn> | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | ==== signature ==== | ||
- | |||
- | Configures how the signature string of logged in users should look like. You can use all variables defined by the [[phpfn> | ||
- | |||
- | ^ variable ^ gets replaced with ^ | ||
- | | @USER@ | ||
- | | @NAME@ | ||
- | | @MAIL@ | ||
- | | @DATE@ | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | Some people may prefer to use something shorter like: '' | ||
- | |||
- | ==== maxtoclevel ==== | ||
- | |||
- | Set this variable to the maximum number of heading levels to include in the automatically generated Table of Contents. | ||
- | |||
- | * Type: Number (0-5) | ||
- | * Default: '' | ||
- | |||
- | ==== maxseclevel ==== | ||
- | Set this variable to the maximum number of heading levels deep to create as separate, editable, sections. | ||
- | |||
- | * Type: Number (0-5) | ||
- | * Default: '' | ||
- | |||
- | ==== camelcase ==== | ||
- | |||
- | Enable this for [[wp> | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== deaccent ==== | ||
- | |||
- | When this is enabled, accented chars in page names will be replaced by their unaccented ASCII equivalents. Eg. '' | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== useheading ==== | ||
- | |||
- | When this option is enabled, a link to a wiki page name will automatically use the first heading in the page for each of the following: | ||
- | |||
- | * The title of the page, as shown in the browser or in search engine results. | ||
- | * The text for a link to the page, unless the link specification contains an explicit title. | ||
- | * The title of RSS feed entries for the page ([[develonly]]). | ||
- | |||
- | For more information, | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ===== Antispam features ===== | ||
- | |||
- | ==== usewordblock ==== | ||
- | |||
- | Enables the use of a [[blacklist]] against [[meatball> | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== mailguard ==== | ||
- | |||
- | This configures if and how email addresses will be obfuscated against harvesting bots. Possible options are: | ||
- | |||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | ===== Authentication Options ===== | ||
- | |||
- | ==== useacl ==== | ||
- | |||
- | Enable this, to use a [[wiki: | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== openregister ==== | ||
- | |||
- | This has only an effect when '' | ||
- | |||
- | If '' | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== autopasswd ==== | ||
- | |||
- | DokuWiki supports two methods of password handling after a new user has been registered. | ||
- | |||
- | - automatically generated passwords ('' | ||
- | - user defined passwords ('' | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== authtype ==== | ||
- | |||
- | This specifies which backend should be used to authenticate against. | ||
- | |||
- | DokuWiki supports several authentication backends. For full list see DokuWiki Manual, Chapter [[wiki: | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | ==== passcrypt ==== | ||
- | |||
- | Passwords should always be saved as an encrypted hash. DokuWiki supports multiple hash methods, which one it should use is defined by this option. What you choose here depends on your security needs and if you want to use an existing authentication database. DokuWiki is able to determine which method was used from an encrypted password, so you can always change the used method as long as your authentication backend supports this. | ||
- | |||
- | The following hash methods are available: | ||
- | |||
- | ^ Option ^ Description | ||
- | | smd5 | Salted MD5 hashing | ||
- | | md5 | Simple MD5 hashing (this was the method used in older Releases) | | ||
- | | sha1 | SHA1 hashing | ||
- | | ssha | Salted SHA1 hashing (as used in LDAP) | | ||
- | | crypt | Unix crypt | | ||
- | | mysql | Password as used in MySQL before Version 4.1.1 | | ||
- | | my411 | Password as used in MySQL 4.1.1 or higher | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | ==== defaultgroup ==== | ||
- | |||
- | If a user signs up (using '' | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | ==== superuser ==== | ||
- | |||
- | Specifies who has superuser rights in DokuWiki. Superusers have always all permissions regardless of [[ACL]] restrictions and are allowed to edit ACL restrictions (think root). | ||
- | |||
- | You can set either a username or the name of a group by prepending an '' | ||
- | |||
- | * Type: String | ||
- | * Default: '' | ||
- | |||
- | ==== profileconfirm ==== | ||
- | |||
- | [[wiki: | ||
- | |||
- | Require a user to confirm their current password when updating their Dokuwiki user profile. | ||
- | |||
- | * Type: Boolean | ||
- | * Default: 1 | ||
- | |||
- | ===== Advanced options ===== | ||
- | |||
- | ==== userewrite ==== | ||
- | |||
- | Enable this to use rewriting for nicer URLs. Either using the Apache mod_rewrite module or by letting DokuWiki rewrite the URLs itself- | ||
- | |||
- | * Type: Number | ||
- | * Default: '' | ||
- | |||
- | You can set the following values: | ||
- | |||
- | ^ Value ^ Info ^ Example URL ^ | ||
- | | 0 | No URL rewriting is used. This is the default. | ||
- | | 1 | URL rewriting is done with an Apache module. You need to edit the .htaccess file | %%http:// | ||
- | | 2 | The rewriting is done by DokuWiki. | ||
- | |||
- | The included .htaccess example has the correct rules for option 1, they are uncommented below. | ||
- | |||
- | >It seems the rewriting only works for standard characters while nonstandard ones like öäü for example mess up the system and can't be found. Is there a workaround or are there any plans to fix this? | ||
- | |||
- | .htaccess entry for option 2 would be good: | ||
- | > A .htaccess entry for option 2 is not necessary. The whole point of option 2 is it doesn' | ||
- | |||
- | <code apache> | ||
- | ## Enable this to restrict editing to logged in users only | ||
- | |||
- | #disable indexes | ||
- | Options -Indexes | ||
- | |||
- | ## make sure nobody gets the htaccess files | ||
- | <Files ~ " | ||
- | Order allow,deny | ||
- | Deny from all | ||
- | Satisfy All | ||
- | </ | ||
- | |||
- | ## Comment these rules in if you want to have nice URLs | ||
- | RewriteEngine on | ||
- | RewriteBase /dokuwiki | ||
- | |||
- | RewriteRule ^_media/ | ||
- | RewriteRule ^_detail/ | ||
- | RewriteRule ^$ doku.php | ||
- | |||
- | RewriteCond %{REQUEST_FILENAME} !-f | ||
- | RewriteCond %{REQUEST_FILENAME} !-d | ||
- | RewriteRule ^(.*)$ doku.php? | ||
- | </ | ||
- | |||
- | |||
- | > Apache' | ||
- | |||
- | ==== useslash ==== | ||
- | |||
- | If you enabled the rewrite option above, you can use this option to use a slash instead of a colon as [[namespace]] separator in URLs. | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== sepchar ==== | ||
- | |||
- | This variable determines the character that separates words in a page ID and that replaces characters not valid in a page ID. | ||
- | |||
- | The page ID is the component of the URL that specifies the page. For example, by default the link [[doesn' | ||
- | |||
- | By changing sepchar to another character, you can change the ' | ||
- | |||
- | //Be careful with this variable.// | ||
- | |||
- | * Type: Character (letter, digit, ' | ||
- | * Default: '' | ||
- | |||
- | ==== canonical ==== | ||
- | |||
- | When this is enabled, all links are created as absolute URLs in the form '' | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== autoplural ==== | ||
- | |||
- | This option is probably only useful in English Wikis. If set to '' | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== usegzip ==== | ||
- | |||
- | When set to '' | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== cachetime ==== | ||
- | |||
- | Configures the maximum age of a cached paged in seconds. See [[caching]]. | ||
- | |||
- | * Type: Number | ||
- | * Default: '' | ||
- | |||
- | ==== purgeonadd ==== | ||
- | |||
- | Configures if the cache is purged on adding a new page. See [[caching]]. | ||
- | |||
- | * Type: Boolean | ||
- | * Default: '' | ||
- | |||
- | ==== locktime ==== | ||
- | |||
- | Defines the maximum age for lockfiles in seconds. See [[locking]]. | ||
- | |||
- | * Type: Number | ||
- | * Default: '' | ||
- | |||
- | ==== notify ==== | ||
- | |||
- | This option may contain an email address to which notifications about page adds and changes will be sent. No mails are sent when this is a blank string. To add more than one email address, use the comma to separate the entries (',' | ||
- | |||
- | * Type: String | ||
- | * Default: | ||
- | |||
- | ==== mailfrom ==== | ||
- | |||
- | This address will be used as sender address for all mails which are sent through [[DokuWiki]]. Make sure your Mailserver accepts the address you supply here. If you leave this empty the default PHP address will be used (usually webserveruser@webserverhostname) | ||
- | |||
- | * Type: String | ||
- | * Default: | ||
- | |||
- | ==== gdlib ==== | ||
- | |||
- | For resizing [[images]] DokuWiki uses PHP's libGD if available. DokuWiki tries to detect the availability and version of libGD automatically. However, in older PHP versions, this does not work. You can force a version by setting this variable. Possible values are: ''' | ||
- | |||
- | * Type: Number | ||
- | * Default: 2 | ||
- | |||
- | ==== im_convert ==== | ||
- | |||
- | [[develonly]] | ||
- | |||
- | By default DokuWiki uses PHP's libGD (see above) however ImageMagick' | ||
- | |||
- | * Type: String | ||
- | * Default: | ||
- | |||
- | ==== spellchecker ==== | ||
- | |||
- | Enables the optional [[Spell Checker]] (Check the page for requirements). | ||
- | |||
- | * Type: Boolean | ||
- | * Default: 0 | ||
- | |||
- | ==== subscribers ==== | ||
- | |||
- | Allows to be notify of a specific page changes (similar to the **notify** option) . | ||
- | FIXME | ||
- | |||
- | * Type: Boolean | ||
- | * Default: 0 | ||
- | |||
- | ==== pluginmanager ==== | ||
- | |||
- | FIXME | ||
- | |||
- | * Type: Boolean | ||
- | * Default: 0 | ||
- | |||
- | ==== compress ==== | ||
- | |||
- | [[develonly]] - Enables simple whitespace and comment stripping in CSS and JavaScript files. | ||
- | |||
- | * Type: Boolean | ||
- | * Default: 0 | ||
- | |||
- | ==== hidepages ==== | ||
- | |||
- | [[develonly]] - This option accepts a Regular Expression to filter certain pages from all automatic listings (RSS, recent changes, search results, index). This is useful to exclude certain pages like the ones used in the sidebar templates. The regexp is matched against the full page ID with a leading colon. If it matches, the page is assumed to be a hidden one. | ||
- | |||
- | * Type: String | ||
- | * Default: | ||
- | |||
- | ==== rss_type ==== | ||
- | |||
- | FIXME | ||
- | |||
- | * Type: String | ||
- | * Default: ' | ||
- | |||
- | ==== rss_linkto ==== | ||
- | |||
- | FIXME | ||
- | |||
- | * Type: String | ||
- | * Default: ' | ||
- | |||
- | ==== target ==== | ||
- | |||
- | This configures the HTML TARGET value used for different link types. The target value tells the web browser where to open the requested link. If a target is empty, then the link will open in the same window. | ||
- | |||
- | * Type: Array | ||
- | * Default: All external and [[interwiki]] links are opened in an new window ('' | ||
- | |||
- | Possible keys for this array are : | ||
- | |||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | |||
- | Possible values for the target attribute : | ||
- | |||
- | * '' | ||
- | * '' | ||
- | * Other values such as '' | ||
- | |||
- | ==== proxy ==== | ||
- | |||
- | [[develonly]] | ||
- | |||
- | Use this to configure a Web-Proxy to use for outbound connections. See [[proxy]] for details. | ||
- | |||
- | * Type: Array | ||
- | * Default: no proxy is used | ||
- | |||
- | ==== safemodehack ==== | ||
- | |||
- | Enables the [[safemodehack]] - read the page for more info | ||
- | |||
- | * Type: Boolean | ||
- | * Default: 0 | ||
- | |||
- | |||
- | ==== ftp ==== | ||
- | |||
- | FTP-Options for the [[safemodehack]] - read the page for more info | ||
- | |||
- | * Type: Array | ||
- | * Default: not used | ||
- | |||
- | |||
- | |||
- | ==== pluginmanager ==== | ||
- | |||
- | [[experimental]] | ||
- | |||
- | Enable the [[plugin: | ||
- | |||
- | * Type: Boolean | ||
- | * Default: 0 |