Wikidot单页元素

页面布局

下图展示的是适用于所有Wikidot驱动站点的页面结构。本参考指南旨在为希望开发自定义CSS主题的用户提供帮助。

• div#container
  • div#header
    • h1
      • a
        • span（包含网站名称）
    • h2（如果存在副标题）
      • span（包含网站副标题）
    • div#top-bar（如果存在顶部导航元素）
    • div#login-status
    • div#header-extra-div-1（用于CSS设计的额外div）
      • span
    • div#header-extra-div-2（用于CSS设计的额外div）
      • span
    • div#header-extra-div-3（用于CSS设计的额外div）
      • span
  • div#content-wrap
    • div#side-bar（如果侧栏导航元素存在）
    • div#main-content
      • div#action-area-top
      • div#page-title
      • div#breadcrumbs
      • div#page-content（页面的主要内容）
      • div#page-info
      • div#page-options-bottom.page-options-bottom
      • div#page-options-bottom-2.page-options-bottom
      • div#action-area
    • div#footer
      • div.options
    • div#license-area
  • div#extra-div-1（用于CSS设计的额外div）
    • span
  • div#extra-div-2
    • span
  • div#extra-div-3
    • span
  • div#extra-div-4
    • span
  • div#extra-div-5
    • span
  • div#extra-div-6

自定义布局

拥有专业版订阅的用户可以创建自定义布局，即 Wiki 中每页在 <body> …… </body> 标签内的 HTML 结构。换句话说，上述提供的默认布局可以进行修改，以满足用户创建复杂且高度自定义主题的特定需求。

出于安全原因，用户不能使用 <body> 标签或 id="" 元素。在布局中，您可能需要使用所谓的模块（独立于这些模块），即负责渲染关键页面和界面元素的元素。

可用模块列表：

[[module NaviBar]] - Wikidot 品牌顶部栏
[[module FooterBar]] - Wikidot 推荐站点
[[module LoginStatus]] - 登录/创建账户按钮或已登录用户信息
[[module PageOptionsBottom]] - 页面选项：编辑、标签等
[[action_area]] - 指示 PageOptionsBottom 在需要显示额外内容（例如文件上传表单）时在页面上的位置。这是 PageOptionsBottom 模块正常运行所必需的

[[module AdModuleAboveContent]] - Pro 用户广告位
[[module AdModuleBelowContent]] - Pro 用户广告位
[[module AdModuleAboveSidebar]] - Pro 用户广告位
[[module AdModuleBelowSidebar]] - Pro 用户广告位
[[module AdModuleBelowFooter]] - Pro 用户广告位
[[module Ad label="custom_location"]] - Pro 用户广告位（支持自定义位置）

[[site_name]] - 站点标题，原 <h1>
[[site_subtitle]] - 站点副标题，原 <h2>
[[content]] - 页面内容，显而易见
[[search_box]] - 站内搜索框
[[site_locked]] - 站点锁定信息
[[page_title]] - 页面标题
[[breadcrumbs]] - 面包屑导航元素
[[tags]] - 显示标签列表
[[topbar]] - 顶部导航
[[sidebar]] - 侧边导航，启用时显示
[[ssl_warning]] - Pro 订阅到期时关于 SSL 禁用的警告
[[page_not_exists]] - 页面不存在时显示的信息
[[license_text]] - 许可证文本（在管理面板中设置）
[[footer]] - 插入页脚，可为默认或自定义

布局中可能的 if 语句

[[if name]]
if code …
[[/if]]

[[if !name]]
if code …
[[/if]]

[[if name]]
if code …
[[else]]
else code …
[[/if]]

可用的 if 语句列表：

[[if site_subtitle]]
[[if site_locked]]
[[if page_title]]
[[if breadcrumbs]]
[[if tags]]
[[if topbar]]
[[if sidebar]]
[[if ssl_warning]]
[[if page_exists]]
[[if license_text]]
[[if custom_footer]]

论坛结构

论坛元素嵌入在 div#page-content 元素中。仅列出该元素以下的元素。

论坛开始视图（组和分类列表）

• div.forum-start-box
  • div.forum-group - 对于每个组（最高级论坛结构）
    • div.head
      • div.title
      • div.description
    • div
      • table
        • tr.head - 字段描述
          • td
          • td
          • td
          • td
        • tr - 对于组中的每个类别
          • td.name
            • div.title
            • div.description
          • td.threads
          • td.posts
          • td.last

分类视图（主题列表）

主题视图