设置

以下设置可用于通过您的项目进行配置。所有设置均通过前置自定义 WIKI_ ，所以例如 URL_CASE_SENSITIVE 应配置为 WIKI_URL_CASE_SENSITIVE .对于插件来说，前置是 WIKI_PLUGINNAME_ ，例如 WIKI_IMAGES 用于图像插件。

wiki.conf.settings.ACCOUNT_HANDLING = True: 注册、登录和注销视图应可访问。

wiki.conf.settings.ACCOUNT_SIGNUP_ALLOWED = True: 允许注册吗？如果不允许，登录的超级用户仍然可以访问注册页面创建新用户。

wiki.conf.settings.ANONYMOUS = True: 将匿名（即未登录）用户视为“其他”用户组。

wiki.conf.settings.ANONYMOUS_CREATE = False: 在全球范围内为匿名用户启用创建访问权限。默认为 ANONYMOUS_WRITE .

wiki.conf.settings.ANONYMOUS_UPLOAD = False: 允许匿名用户上传访问的默认设置。用于plugins.attachments和plugins.images，并且可以在这些插件中覆盖。

wiki.conf.settings.ANONYMOUS_WRITE = True: 如果真正的匿名用户将被视为models.Article上的others_writer布尔字段，则在全球范围内为匿名用户启用写访问。

wiki.conf.settings.CACHE_TIMEOUT = 600: 更新项目缓存之前有秒的超时。每当发生编辑时，文章就会自动更新，但文章内容可能会从更改的其他对象生成。

wiki.conf.settings.CAN_ADMIN = None: 如果用户有权限为维基创建新组和用户，则返回True/False的函数。

wiki.conf.settings.CAN_ASSIGN = None: 如果用户有权分配文章的权限，则返回True/False的函数。相关性：更改所有者和组成员资格。

wiki.conf.settings.CAN_ASSIGN_OWNER = None: 如果文章的所有者有权将组更改为用户自己的组，则返回True/False的函数。相关性：更改群组成员资格。

wiki.conf.settings.CAN_CHANGE_PERMISSIONS = None: 如果用户有权更改组和其他人的读/写访问权限，则返回True/False的函数。

wiki.conf.settings.CAN_DELETE = None: 指定用户是否有权软删除文章。

wiki.conf.settings.CAN_MODERATE = None: 一个函数，如果用户有权限更改权限，则返回True/False。锁定文章并永久删除内容。

wiki.conf.settings.CAN_READ = None: 如果用户有权限读取文章和插件的内容，则返回True/False的函数。相关性：查看文章和插件。

wiki.conf.settings.CAN_WRITE = None: 如果用户有权更改内容（即向文章添加新修订），则返回True/False的函数。通常，插件也会使用此功能。相关性：编辑文章、更改修订版、编辑插件。

wiki.conf.settings.CHECK_SLUG_URL_AVAILABLE = True: 当为True时，这会阻止解析为非维基视图的新slug，从而阻止用户创建与其他应用程序的重叠URL冲突的文章。

wiki.conf.settings.EDITOR = 'wiki.editors.markitup.MarkItUp': 要使用的编辑器类--可能是第三方或您自己的.？您可以随时扩展内置编辑器并自定义它！

wiki.conf.settings.GROUP_MODEL = 'auth.Group': 选择要用于权限处理的组模型。作者：Django的作者。Group。

wiki.conf.settings.LOG_IPS_ANONYMOUS = True: 我们要记录匿名用户的IP吗？

wiki.conf.settings.LOG_IPS_USERS = False: 我们要记录登录用户的IP吗？

wiki.conf.settings.LOST_AND_FOUND_SLUG = 'lost-and-found': 如果文章已被删除，则会在URLPath中使用此slug。该文章的URLPath的子项目将移至lost and found。他们保留他们的权限和所有内容。

wiki.conf.settings.MARKDOWN_HTML_ATTRIBUTES = {'a': ['href', 'title', 'class', 'id', 'target', 'rel'], 'abbr': ['title', 'class', 'id', 'target', 'rel'], 'acronym': ['title', 'class', 'id', 'target', 'rel'], 'b': ['class', 'id', 'target', 'rel'], 'blockquote': ['class', 'id', 'target', 'rel'], 'br': ['class', 'id', 'target', 'rel'], 'code': ['class', 'id', 'target', 'rel'], 'dd': ['class', 'id', 'target', 'rel'], 'details': ['class'], 'div': ['class', 'id', 'target', 'rel'], 'dl': ['class', 'id', 'target', 'rel'], 'dt': ['class', 'id', 'target', 'rel'], 'em': ['class', 'id', 'target', 'rel'], 'figcaption': ['class', 'id', 'target', 'rel'], 'figure': ['class', 'id', 'target', 'rel'], 'h1': ['class', 'id', 'target', 'rel'], 'h2': ['class', 'id', 'target', 'rel'], 'h3': ['class', 'id', 'target', 'rel'], 'h4': ['class', 'id', 'target', 'rel'], 'h5': ['class', 'id', 'target', 'rel'], 'h6': ['class', 'id', 'target', 'rel'], 'hr': ['class', 'id', 'target', 'rel'], 'i': ['class', 'id', 'target', 'rel'], 'img': ['class', 'id', 'target', 'rel', 'src', 'alt'], 'li': ['class', 'id', 'target', 'rel'], 'ol': ['class', 'id', 'target', 'rel'], 'p': ['class', 'id', 'target', 'rel'], 'pre': ['class', 'id', 'target', 'rel'], 'span': ['class', 'id', 'target', 'rel'], 'strong': ['class', 'id', 'target', 'rel'], 'sup': ['class', 'id', 'target', 'rel'], 'table': ['class', 'id', 'target', 'rel'], 'tbody': ['class', 'id', 'target', 'rel'], 'td': ['class', 'id', 'target', 'rel', 'align'], 'th': ['class', 'id', 'target', 'rel'], 'thead': ['class', 'id', 'target', 'rel'], 'tr': ['class', 'id', 'target', 'rel'], 'ul': ['class', 'id', 'target', 'rel']}: Markdown文章内容中允许的属性的字典。

wiki.conf.settings.MARKDOWN_HTML_STYLES = []: Markdown文章内容中允许内联样式，默认为没有样式（空列表）。

wiki.conf.settings.MARKDOWN_HTML_WHITELIST = frozenset({'a', 'abbr', 'acronym', 'b', 'blockquote', 'br', 'code', 'dd', 'details', 'div', 'dl', 'dt', 'em', 'figcaption', 'figure', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'hr', 'i', 'img', 'li', 'ol', 'p', 'pre', 'span', 'strong', 'summary', 'sup', 'table', 'tbody', 'td', 'th', 'thead', 'tr', 'ul'}): Markdown文章内容中允许的标签列表。

wiki.conf.settings.MARKDOWN_KWARGS = {'extension_configs': {'wiki.plugins.macros.mdx.toc': {'title': 'Contents'}}, 'extensions': ['markdown.extensions.footnotes', 'markdown.extensions.attr_list', 'markdown.extensions.footnotes', 'markdown.extensions.attr_list', 'markdown.extensions.def_list', 'markdown.extensions.tables', 'markdown.extensions.abbr', 'markdown.extensions.sane_lists']}

Markdown实例的参数（作为字典）。“extensions”键应该是除了内置的django-wiki扩展之外要使用的额外扩展列表，而“extension_Delivers”应该是一个字典，指定要传递给每个扩展的关键字参数。

有关Python-Markdown官方支持的扩展列表，请参阅：https://python-markdown.github.io/extensions/

要设置目录的自定义标题，请在Django项目设置中指定以下内容：：

WIKI_MARKDOWN_KWARGS = {
    'extension_configs': {
        'wiki.plugins.macros.mdx.toc': {'title': 'Contents of this article'},
    },
}

除了由“extensions”键启用的扩展之外，以下内置的django-wiki扩展还可以使用“extension_spreads”配置：“wiki.core.markdown.mdx.codehilite”、“wiki.core.markdown.mdx.previewlinks”、“wiki. core. markdown.mdx.responsivetable”、“wiki. plugins.macros. mdx.toc”、“wiki.plugins.macros.mdx.toc”、“wiki.plugins.macros.mdx.wikilinks”。

wiki.conf.settings.MARKDOWN_SANITIZE_HTML = True: 是否使用漂白剂。除非您知道自己在做什么并且不想使用其他选项，否则不建议关闭该选项。

wiki.conf.settings.MESSAGE_TAG_CSS_CLASS = {10: 'alert alert-info', 20: 'alert alert-info', 25: 'alert alert-success', 30: 'alert alert-warning', 40: 'alert alert-danger'}: 从Message.level到引导类名称的映射。

wiki.conf.settings.REVISIONS_MINUTES_LOOKBACK = 2: 回顾抬头的分钟数 REVISIONS_PER_MINUTES 和 REVISIONS_PER_MINUTES_ANONYMOUS .

wiki.conf.settings.REVISIONS_PER_HOUR = 60: 任何给定用户或IP每小时允许的最大修改量。

wiki.conf.settings.REVISIONS_PER_HOUR_ANONYMOUS = 10: 任何匿名用户和任何IP每小时允许的最大修改量。

wiki.conf.settings.REVISIONS_PER_MINUTES = 5: 任何给定用户或IP每分钟允许的最大修改量。

wiki.conf.settings.REVISIONS_PER_MINUTES_ANONYMOUS = 2: 任何匿名用户和任何IP每分钟允许的最大修订数。

wiki.conf.settings.SHOW_MAX_CHILDREN = 20: 在显示“+更多”之前，菜单中要显示的最大儿童数量。切勿将其设置为0，因为它会错误地通知用户没有孩子，例如可以安全删除文章。

wiki.conf.settings.STORAGE_BACKEND = <django.core.files.storage.DefaultStorage object>: 默认Django存储后端用于图像，附件等。

wiki.conf.settings.URL_CASE_SENSITIVE = False: 网址应该区分大小写吗？

wiki.conf.settings.URL_CONFIG_CLASS = None: 用于为维基构建urlpatterns的类的虚线名称。默认为wiki.urls.WikiURLPatterns。要自定义网址或视图处理程序，您可以从中派生。

wiki.conf.settings.USE_BOOTSTRAP_SELECT_WIDGET = True: 用户Bootstrap的选择小部件。如果您没有使用Bootstrap，请关闭！

wiki.conf.settings.USE_SENDFILE = False: 使用django-sendfile发送文件？否则，首先将整个文件读取到内存中，然后根据该文件使用mime类型发送。

wiki.conf.settings.WIKILINKS_TRAILING_SLASH = True: 天气将尾随斜线添加到渲染的维基链接中。默认为true

插件附件

wiki.plugins.attachments.settings.ANONYMOUS = False: 允许匿名用户上传访问（在开放网络上不太好） WIKI_ATTACHMENTS_ANONYMOUS 可以覆盖此，否则默认为 wiki.conf.settings 采用了

wiki.plugins.attachments.settings.APPEND_EXTENSION = True: 存储文件时始终附加有.upload扩展名，以确保不会在服务器上执行一些令人讨厌的事情。安全第一！

wiki.plugins.attachments.settings.FILE_EXTENSIONS = ['pdf', 'doc', 'odt', 'docx', 'txt']: 允许附件扩展名，空则完全禁止上传。如果 WIKI_ATTACHMENTS_APPEND_EXTENSION 保存文件并在文件中附加“.upload”，以确保您的Web服务器实际上不会执行某些脚本。扩展不区分大小写。系统要求您显式输入您想要允许的所有文件扩展名。为了您自己的安全。注意：此设置称为WIKI_ATTACHMENS_EXTENSIONS，而不是WIKI_ATTACHMENS_PLE_EXTENTIONS

wiki.plugins.attachments.settings.STORAGE_BACKEND = <django.core.files.storage.DefaultStorage object>: 要使用的存储后台，默认使用与维基的其余部分相同，设置在 WIKI_STORAGE_BACKEND ，但您可以通过以下方式覆盖它 WIKI_ATTACHMENTS_STORAGE_BACKEND .

wiki.plugins.attachments.settings.UPLOAD_PATH = 'wiki/attachments/%aid/': 文章附件的存储位置，相对于 MEDIA_ROOT .您永远不应在中启用目录索引 MEDIA_ROOT/UPLOAD_PATH !事实上，如果您愿意，您可以完全禁用服务。文件通过读取和流式传输文件的Django视图发送给用户。

wiki.plugins.attachments.settings.UPLOAD_PATH_OBSCURIFY = True: 上传路径是否应该被模糊化？如果是这样，随机哈希将被添加到路径中，以便某人无法猜测文件的位置（如果您具有限制权限并且文件仍然位于Web服务器的文件系统中）。

wiki.plugins.attachments.settings.USE_LOCAL_PATH = True: 对于S3后台等重要信息：如果您的存储后台没有文件的.路径属性，而只有.url属性，则应使用False。这将显示直接下载URL，因此对于您希望保持私密的文件，它并不能完美地工作。

插件编辑部分

wiki.plugins.editsection.settings.LINK_TEXT = '[edit]': 用于节编辑链接的文本将出现在节标题旁边。这些链接仅允许编辑一个特定部分的文本。

wiki.plugins.editsection.settings.MAX_LEVEL = 3: 添加“ [edit] “链接到该级别之前的所有节标题。通过使用这些链接，只能编辑选定部分中的文本。

插件图片

wiki.plugins.images.settings.ANONYMOUS = False: 允许匿名用户上传访问（在开放网络上不好）。 WIKI_IMAGES_ANONYMOUS 可以覆盖此，否则默认为 wiki.conf.settings 采用了

wiki.plugins.images.settings.IMAGE_PATH = 'wiki/images/%aid/': 保存上传图像的位置。 %aid 被文章id替换。

wiki.plugins.images.settings.IMAGE_PATH_OBSCURIFY = True: 上传路径是否应该被模糊化？如果是这样，随机哈希将被添加到路径中，以便某人无法猜测文件的位置（如果您具有限制权限并且文件仍然位于Web服务器的文件系统中）。

wiki.plugins.images.settings.STORAGE_BACKEND = <django.core.files.storage.DefaultStorage object>: 要使用的存储后台，默认使用与维基的其余部分相同，设置在 WIKI_STORAGE_BACKEND ，但您可以通过以下方式覆盖它 WIKI_IMAGES_STORAGE_BACKEND .

wiki.plugins.images.settings.THUMBNAIL_SIZES = {'default': '250x250', 'large': '500x500', 'medium': '300x300', 'orig': None, 'small': '150x150'}: HTML文本中包含的图像缩略图的大小。如果markdown标记中没有给出特定的大小， default 使用大小。如果markdown标签中给出了特定的大小，则使用该大小。

插件链接

wiki.plugins.links.settings.LOOKUP_LEVEL = 2: 如果在维基降价链接中使用了相对slug，并且没有找到从当前文章级别开始的给定slug的文章，则会创建指向尚未存在的文章的链接。创建文章可以通过点击链接完成。此链接将相对于 LOOKUP_LEVEL .这应该是大多数文章创建的级别。

插件宏

wiki.plugins.macros.settings.METHODS = ('article_list', 'toc'): 此插件应该支持的降价扩展列表。 article_list 插入当前级别的文章列表。 toc 插入与标题匹配的目录。