查看“︁建站/WIKI功能/基础功能”︁的源代码

= 内容编辑 =

=== 可视化编辑器 ===
<sup>※ 顶部菜单栏右侧“<code>？</code>”--“<code>快捷键</code>”。</sup>

可视化编辑器菜单栏支持的功能、以下快捷键支持的功能就构成了绝大多数可行的操作<sup>（有些拓展如<code><syntax</code>在启用后才出现在列表中）</sup><html><img loading="lazy" style="width: 600px;" src='https://scio.eu.org/WIKI/图片/建站相关/Mediawiki快捷键.avif' /></html>

　

=== wikitext ===
参考：[[mediawikiwiki:Help:Editing/zh|Help:编辑]]，我就挑一些值得专门介绍的常用功能说一下：

* <code>&#x3C;nowiki&#x3E;内容&#x3C;/nowiki&#x3E;</code>：不会被解析为wikitext语法；
* <code><nowiki><center>内容</center></nowiki></code>：文本居中显示<sup>（自成一行，这个被html5弃用了但mediawiki保留了解析）</sup>；
* <code>:</code>：缩进符可以重复使用增加缩进量<sup>（每次两个全角字符）</sup>，好处是内容如果一行放不下，第二行的开始是缩进后的位置而不是最左侧。

==== 预排格式 ====
可以实现一个回车换一行，目前是有两种形态。

<u>基本形态</u>：在可视化编辑器中插入的预排格式<sup>(ctrl+7)</sup>在源代码视图中查看是“  <code>xxx</code>”（前缀是一个空格），跟<code><poem></code>效力一致，正常解析wikitext标记，被灰色的内容框包裹。

* 可视化编辑器模式下可以通过“<code>shift+回车</code>”实现多行预排格式，示例：

 第一行 https://scio.icu/image/touxiang.gif
 
 q 第三行
<u>标签形态</u>：<code><nowiki><pre>……</pre></nowiki></code>，被此元素包裹的内容多了“nowiki”标签的效力，不会解析内容，只是展现纯文本，示例：<pre>
第一行 https://scio.icu/image/touxiang.gif

# q 第三行
</pre><sup>※ 可视化编辑器下可以插入和编辑标签形态，顺序输入“<code><pre</code>”会弹出插入窗口；也可以设置为“允许文本样式”，就是变成了基本形态。</sup>

　

=== HTML ===
<sup>※ 此处指mediawiki支持的html标签部分，而非[[建站/WIKI功能/功能实现#嵌入html代码|嵌入html代码]]。</sup>

源代码编辑器下是支持使用部分html标签的，详见：[[mediawikiwiki:Help:HTML_in_wikitext|wikitext中的HTML]]

除了作为wikitext标签的替代品<sup>(功能重叠)</sup>，最常用的便是给内容设定高级样式<sup>（符合html/css规范即可）</sup>，譬如：

修改'''文本样式'''：
{| class="wikitable"
!源代码
!渲染结果
|-
|<code>‎<nowiki><div style="color:blue;font-size: 10px;">‎<p>将样式</p></nowiki><nowiki><span>应用到整个块中</span></nowiki><nowiki></div></nowiki></code>
|<div style="color:blue;font-size: 10px;">
将样式
应用到整个块中</div>
|-
|<code><nowiki><span style="color:red;font-size: 15px;">指定颜色与尺寸</span></nowiki></code>
|<span style="color:red;font-size: 15px;">指定颜色与尺寸</span>
|-
|<code><nowiki><mark>突出显示</mark></nowiki></code>
|<mark>突出显示</mark>
|}
修改'''表格文本样式'''<sup>（示例为表格宽度，对齐方式、颜色）</sup>：
{| class="wikitable"
!
!___占位___
!源代码部分：
|-
!姓名
| style="text-align:right;color:#F00" |桐间纱路
|<code><nowiki>| style="text-align:right;color:#F00" |</nowiki></code>
|-
!性别
| style="text-align:left;color:blue" |女
|<code><nowiki>| style="text-align:left;color:blue" |</nowiki></code>
|-
!爱好
| style="text-align:center;color:255,192,203" |圣王H
|<code><nowiki>| style="text-align:center;color:255,192,203" |</nowiki></code>
|}
修改'''表格样式'''：

代码：<syntaxhighlight lang="wikitext" line="1">
{| class="wikitable" style="text-align:center;width: 85%;"
! style="vertical-align:middle; color:#F00;width: 10%;" |编号
! style="vertical-align:middle; color:#F00;width: 20%;" |作品名称
! style="vertical-align:middle; color:#F00;width: 30%;" |类型
| style="vertical-align:middle; color:#F00;width: 40%;" |简介
|-
|1234567
|主站
|站点
!政治中心
|-
|0002
|WIKI
|站点
|style="text-align:left;" |关于我的百科全书
|-
|
|
|
|
|}
</syntaxhighlight>

* 第一行是全局设置，文本居中、宽度为浏览器的85%。
* 第二行的前面是垂直对齐方式<sup>(默认就是垂直居中)</sup>，后面是颜色与该列宽度。<sup>注意只有宽度这种牵一发而动全身的设定是作用于整列的，其他都只应用于当前单元格。</sup>
** 第一行的85%是相对于浏览器的，比如浏览器宽1000px，则这个表格整体850px；第二行的是相对于850px的，比如10%就是85px。
* 表格行以开头“<code>|</code>”表示普通格子，以“<code>!</code>”开头表示标题样式的格子<sup>（这个是wikitext的语法）</sup>。

渲染结果：
{| class="wikitable" style="text-align:center;width: 85%;"
! style="vertical-align:middle; color:#F00;width: 10%;" |编号
! style="vertical-align:middle; color:#F00;width: 20%;" |作品名称
! style="vertical-align:middle; color:#F00;width: 30%;" |类型
| style="vertical-align:middle; color:#F00;width: 40%;" |简介
|-
|1234567
|主站
|站点
!政治中心
|-
|0002
|WIKI
|站点
| style="text-align:left;" |关于我的百科全书
|-
|
|
|
|
|}
<sup>※ 如果某行内容为空，那么渲染结果会显示的非常矮，但可视化编辑器下是看是正常大小。</sup>

　

= 基础功能 =

=== 安装和启用扩展 ===
 缺少必要的组件会报错或为空白页面，若是报错安装需要的组件即可，若是空白请参考[[建站/MediaWiki#可能的问题|#可能的问题]]设置文件夹与文件权限。
主要是两步操作，'''安装插件'''和修改'''配置文件'''。

安装插件：将下载好的扩展文件夹放在“<code>mediawiki网站文件夹根目录/'''extensions'''</code>”文件夹中。

* 若可以，则 <code>git clone <u>github项目链接</u></code>，最为方便；
* 若提供了压缩包，则<code>wget <u>压缩包链接</u></code> 下载后再 <code>unzip <u>压缩包.zip</u></code> 次之；
* 若不习惯命令行，可以直接通过ftp传输文件，但有：无法访问站点或报错(文件权限问题)、传输大量小文件的高额时间成本的问题。
* 有些扩展解压后带版本号等标识，记得按照扩展官网的提示进行修改文件夹名。

配置文件：需要添代码以启用插件的地方就是指配置文件（<code>根目录/'''LocalSettings.php'''</code>），安装插件后都要在这里添加指令来启用插件。

* 一般为添加行：<code>wfLoadExtension( '<u>拓展的官方名称</u>' );</code>
* 通常会给出需要添加的行，但也建议移步提供的扩展链接页面查看是否有高级功能或设置为自己所需。

　

=== 模板 ===
请移步：[[建站/WIKI功能/二次元老婆墙#第二步 模板的基础应用|二次元老婆墙#第二步_模板的基础应用]] 通过实例了解它。

　

=== 子页面 ===

* 配置文件添加：<code>$wgNamespacesWithSubpages[NS_MAIN] = true;</code>
* 参考信息：[[mediawikiwiki:Help:Subpages|Help:Subpages]]、[[mediawikiwiki:Manual:$wgNamespacesWithSubpages|Manual:$wgNamespacesWithSubpages]]

示例的是给“NS_MAIN”（主命名空间）启用子页面，子页面就是 <code>标题'''/'''子页面标题</code> <sup>（支持多层分级）</sup>，不开启也能这样创建页面，但不会被认为是父子页面，开启后子页面文章顶部会有指向父页面的索引。

可以通过在源代码编辑器下插入：<code><nowiki>{{Special:PrefixIndex/{{FULLPAGENAME}}/}}</nowiki></code>来罗列出当前页面的所有子页面<sup>（包括子页面的子页面）</sup>。

　

=== 刷新页面缓存 ===
页面缓存分为浏览器缓存(用户端)、服务器缓存，前者保存在本地，后者保存在服务器。

* 对于前者，只需要<code>ctrl+shift+r</code>或<code>ctrl+f5</code>就能强制刷新缓存，重新从服务器请求数据；
* 而有时在未直接编辑页面的情况下产生了影响页面的变动<sup>(如创建已经在其他文章插入的不存在页面、引用/嵌入的其他页面数据)</sup>，就需要刷新服务器端的缓存，重新解析一遍数据，以使展示最新效果。
清除服务器端缓存（批量及更多信息请见：[[建站/WIKI功能/站点维护#清除缓存|#清除缓存]]、[[建站/WIKI功能/站点维护#空编辑|#空编辑]]）：

<u>空编辑</u>：点击编辑再(于源代码编辑器下)保存<sup>（未变动的不会被记录为修订）</sup>。

* 个别情况下或许编辑视图下的渲染为最新但保存后仍为滞后数据，可以刷新浏览器缓存后再看，若仍旧如此，可以随意变动下内容再保存以使服务器重新组织数据。
* 直接导入的页面，若其涉及cargo表之类的，purge或许会无效，但空编辑能有效使服务器/数据库重新组织数据。

<u>purge</u>：或使用<code>action=purge</code>参数从服务器端刷新页面缓存(重新从数据库组织页面)，mediawiki的url有两种格式，分别使用：

* <code>hxxps://wiki.scio.icu/index.php/圣王H的秘密基地导航页'''<u>?action=purge</u>'''</code>
* <code>hxxps://wiki.scio.icu/index.php'''?'''title=圣王H的秘密基地导航页'''<u>&action=purge</u>'''</code>

　

=== 注意事项 ===
很多框架都能将粘贴来的url文本直接以链接形式插入，而不需要专门url样式，其依赖是就是<code>http://</code> 前缀，通常都会截止到发现的第一个空格/换行符为止，因此在源代码编辑模式下记得链接后面手动加一个空格，也适用于使用bbcode、markdown(typora内url后面接中文字符，其文本不会有url的效果，但导出为html就有了）等，养成这个习惯就好很多。
[[Category:建站]]