設定

Overview

Configuration of the DekiWiki Api service is handled a startup xml file (/etc/dekiwiki/mindtouch.deki.startup.xml) and the database table 'config'.  The xml file is used by Dream to start the Deki Wiki service and setup the environment while the 'config' table holds options that can generally be set via the control panel (/Admin:Config). Both are described here.

Deki Wiki Settings

Setting Descriptions

admin/email string - available in PHP as $wgAdminEmail

Email address of person to contact for technical problems

admin/contact-threshold integer - available in PHP as $wgAdminContactThreshold

Number of hours before emailing admin in case of a 502 "Service Not Available" error

cache/pages boolean

Whether or not to cache pages in memory to reduce database hits

cache/permissions boolean

Whether or not to cache user permissions in memory to reduce database hits

cache/roles boolean

Whether or not to cache role info in memory to reduce database hits

cache/services boolean

Whether or not to cache extension service info in memory to reduce database hits

cache/users boolean

Whether or not to cache users in memory to reduce database hits

editor/safe-html boolean

Whether or not to remove potentially unsafe html tags

files/blocked-extensions string, as comma separated list

Unallowed extensions as file attachments

files/imagemagick-extensions string, as comma separated list

File extensions that will generate image previews

files/imagemagick-max-size integer

Maximum image size for preview generation (setting this value too high may choke your memory usage)

files/max-file-size integer

Maximum file size for file attachments (checked on upload); ensure that this value matches post_max_size and upload_max_filesize in php.ini

mail/smtp-serversstring - available in PHP as $wgSMTPServers

SMTP servers; separate multiple servers with semicolons

mail/smtp-usernamestring - available in PHP as $wgSMTPUser

SMTP authentication username

mail/smtp-passwordstring - available in PHP as $wgSMTPPwd

SMTP authentication password 

security/allow-anon-account-creation boolean

Whether or not new accounts can be self-created from the login page

security/cookie-expire-secs integer

Sets the authentication expiration time in seconds

security/new-account-role string

Default role for new accounts

storage/fs/cache-path string

Location for storing image previews on disk. Default is {deki-path}/attachments/.cache

storage/fs/path string

Location for storing file attachments on disk. Default is {deki-path}/attachments

storage/s3/bucket string

S3 bucket to use for storage (ensure this exists)

storage/s3/privatekey string

Secret access key for your S3 account

storage/s3/publickey string

Access key for your S3 account

storage/s3/prefix string

Directory within your bucket that contains all attachments. You can set this to the name of your wiki.

storage/s3/timeout integer

Timeout in seconds for S3 requests

storage/typestring

File storage type: filesystem (fs) or Amazon S3 (s3)

ui/analytics-key string

Google Analytics account key for traffic logging

site/search-disabled string - available in PHP as $wgDisableTextSearch

Disable site searching

ui/banned-words string, as comma separated list

Comma seperated list of words not allowed in page content - these values will be automatically stripped out

ui/language string - available in PHP as $wgLanguageCode

Language to use for the user interface of the wiki in the format language-variant (example: en-us for English or de-de for German)

ui/comment-count integer - available in PHP as $wgCommentCount

The number of comments to show on first page

ui/custom/css string - available in PHP as $wgCustomCss

CSS styles that define the template's styles (not used for loading the editor)

ui/custom/bodycss string - available in PHP as $wgCustomBodyCss

CSS styles that define the content's body styles (used for viewing & editing)

ui/dynamic-nav string - available in PHP as $wgNavPaneEnabled

Enable dynamic behavior of navigation pane

ui/logo string - available in PHP as $wgLogo

Path to site logo

ui/sitename string - available in PHP as $wgSitename

Site title

ui/skin string - available in PHP as $wgActiveSkin

Name of template skin to use

ui/template string - available in PHP as $wgActiveTemplate

Name of template to use

ui/use-cdn string - available in PHP as $wgUseCDN

Enabling will use Yahoo!'s CDN to speed up delivery of Javascript files - this may not work depending on your ability to access Yahoo!'s servers.

mindtouch.deki.startup.xml

<script>
  <!-- register Deki services -->
  <action verb="POST" path="/host/load?name=mindtouch.deki" />
  <action verb="POST" path="/host/load?name=mindtouch.deki.services" />
  <action verb="POST" path="/host/load?name=mindtouch.indexservice" />

  <!-- start Deki services -->
  <action verb="POST" path="/host/services">
    <config>

      <!-- Service startup -->
      <!-- deki: relative path for deki-api service. I.e., http://host/deki -->
      <!-- sid: the serviceid points to a class that represents the service for startup-->
      <path>deki</path>
      <sid>http://services.mindtouch.com/deki/draft/2006/11/dekiwiki</sid>
      
      <!-- Global settings -->
      <!-- deki-path: full path to dekiwiki php (pointed to by web server) -->
      <!-- imagemagick-ignore-list: comma separated list of file extensions to bypass image preview -->
      <!-- imagemagick-convert-path: full path to imagemagick convert (used to generate image previews) -->
      <!-- imagemagick-identify-path: full path to imagemagick identify (used to determine image dimensions) -->
      <!-- deki-resources-path: path to deki-wiki resources directory containing txt files with localized strings. 
              Resource files are searched in the order "resources.custom.txt" -> "resources-[language]-[culture].txt" -> "resources-[language].txt" -> "resources.txt" 
              where [language] and [culture] are standard two letter abbreviations such as en-us -->
      <!-- dblogging-conn-string: DB connection string for detailed logging of deki-api requests/responses. Comment out to disable this logging -->
      <deki-path>/var/www/deki-hayes</deki-path>
      <imagemagick-convert-path>/usr/bin/convert</imagemagick-convert-path>
      <imagemagick-identify-path>/usr/bin/identify</imagemagick-identify-path>
      <deki-resources-path>/var/www/mks-wiki/resources</deki-resources-path>
      <!-- dblogging-conn-string>Server=localhost;Port=3306;Database=wikidb;Uid=wikiuser;Pwd=password;pooling=true; Connection Timeout=5; Protocol=sockets; Min Pool Size=1; Max Pool Size=100; Connection Reset=false;character set=utf8;ProcedureCacheSize=25;Use Procedure Bodies=true;</dblogging-conn-string -->
               
      <!-- Per instance and multi-instance settings -->
	<wikis>
 	<config>
 		<config id="default">
          	<host>*</host>

 		<!-- db-server: hostname/ip of database for this instance-->
 		<!-- db-port: db port (default 3306 for mysql)-->
 		<!-- db-catalog: catalog or database name for this instance -->
 		<!-- db-user: db account to use. Ensure full access to the catalog and rights to exec stored procs.-->
 		<!-- db-password: password for db account-->
 		<!-- db-options: other connection string settings. Ensure db connection pooling is enabled and that the connection supports utf8 encoding-->

 		<db-server>dbhostname</db-server>
 		<db-port>3306</db-port>
 		<db-catalog>wikidb</db-catalog>
 		<db-user>wikiuser</db-user>
 		<db-password hidden="true">password</db-password>
 		<db-options>pooling=true; Connection Timeout=5; Protocol=socket; Min Pool Size=2; Max Pool Size=50; Connection Reset=false;character set=utf8;ProcedureCacheSize=25;Use Procedure Bodies=true;</db-options>
 	</config>

 	<config id="foowiki">
 		<host>foo</host> 
 		<host>foowiki</host>
 		<host>foowiki.hostname.com</host>

 		<db-server>dbhostname</db-server>
 		<db-port>3306</db-port>
 		<db-catalog>foowiki</db-catalog>
 		<db-user>foowikiuser</db-user>
 		<db-password hidden="true">password</db-password>
 		<db-options>pooling=true; Connection Timeout=5; Protocol=socket; Min Pool Size=2; Max Pool Size=50; Connection Reset=false;character set=utf8;ProcedureCacheSize=25;Use Procedure Bodies=true;</db-options>
 	</config>
 	</wikis>

 	<indexer>
        	<path.store>/usr/local/var/luceneindex</path.store>
        	<filter-path extension="doc">/opt/deki/bin/filters/wvText</filter-path>
        	<filter-path extension="pdf">/opt/deki/bin/filters/pdf2text</filter-path>
        	<filter-path extension="xhtml">/opt/deki/bin/filters/html2text</filter-path>
        	<filter-path extension="html">/opt/deki/bin/filters/html2text</filter-path>
        	<filter-path extension="htm">/opt/deki/bin/filters/html2text</filter-path>
        	<filter-path extension="docx">/opt/deki/bin/filters/docx2txt</filter-path>
        	<filter-path extension="odt">/opt/deki/bin/filters/odt2txt</filter-path>
        	<filter-path extension="odp">/opt/deki/bin/filters/odp2txt</filter-path>
        	<filter-path extension="ppt">/opt/deki/bin/filters/ppt2txt</filter-path>
        	<filter-path extension="pptx">/opt/deki/bin/filters/pptx2txt</filter-path>
        	<filter-path extension="xls">/opt/deki/bin/filters/xls2txt</filter-path>
        	<filter-path extension="pl"></filter-path>
        	<filter-path extension="c"></filter-path>
        	<filter-path extension="h"></filter-path>
        	<filter-path extension="inc"></filter-path>
        	<filter-path extension="php"></filter-path>
        	<filter-path extension="cs"></filter-path>
        	<filter-path extension="txt"></filter-path>
        	<filter-path extension="csv"></filter-path>
        	<filter-path extension="xml"></filter-path>
        	<filter-path extension="xsl"></filter-path>
        	<filter-path extension="xslt"></filter-path>
 	</indexer>

    </config>
  </action>
</script>