微雪维基百科编辑手册

来自Waveshare Wiki
跳转至: 导航搜索


新建页面

如果搜索一个不存在的页面,会得到一个链接去创建新页面;也可以用wiki的URL创建新页,如想新建一个名为HelloWorld的页面,则可在地址栏输入:https://www.waveshare.net/w/index.php/HelloWorld,在出现的页面中点击"创建",输入内容后点击"保存页面"即可,如下图所示。

页面格式化

可以通过使用wiki标记来格式化文本,下文描述了部分wiki标记,更多详情可查阅http://www.mediawiki.org/wiki/Help:Formatting

字符格式化

如,文本内容用两对单引号括起来(italic)可实现斜体效果,用三对单引号括起来(bold)可实现粗体效果,用 strike标签括起来(strike)实现删除线效果;使用标签nowiki括起来则会忽 略上述标记。

章节格式化

(1)标题

MediaWiki页面中的标题使用等号标记,用几对等号括起来则表示是几级标题。

== Level 2 ==
=== Level 3 ===
==== Level 4 ====
===== Level 5 =====
====== Level 6 ======

注: #1. 不建议用一对等号,它表示页面自身。#2. 页面中有4级及更多标题时,会自动生成目录。

(2)水平线

如果想在页面内容之间插入分割线,可在要分割的地方使用"----",如下所示: 水平线之前

----

水平线之后

(3)无序列表

文本前加"*"号可以实现无序列表效果,"*"号的个数表示列表对应的级别,如

*1

**11

**12

*2

**21

**22

效果:

  • 1
    • 11
    • 12
  • 2
    • 21
    • 22

(4)有序列表

文本前加"#"号可以实现有序列表效果,"#"号的个数表示列表对应的级别,如

#1
##11
##12
#2
##21
##22

效果:

  1. 1
    1. 11
    2. 12
  2. 2
    1. 21
    2. 22

分段

MediaWiki不识别换行。要另起一段,需要使用一空行;在段落中可通过HTML标签<br/>强制换行。

HTML标签

在MediaWiki中允许使用部分HTML标签。如使用<u>标签实现下划线效果,<s>标签实现删除线效果等。

链接

下文仅简要描述内部链接和外部链接的用法,更多信息可查阅http://www.mediawiki.org/wiki/Help:Links

内部链接

内部链接,即链接到wiki中其他页面的链接。将目标页面名使用两对方括号括起来表示一个内部链接(如[[HelloWorld]])。保存后,如链接指向的页面已存在,链接会显示为蓝色,否则显示为红色。

如果想将链接显示为文字信息,需使用格式[[页面名|文字]],如[[HelloWorld|到HelloWorld页面]]。

外部链接

外部链接,即链接到其他网站的链接。输入网站地址并以空格结束,就可以生成一个外部链接。保存后,链接后会有一个箭头,表示指向外部。

如果想将链接显示为文字信息,需使用格式[外部网址文字],如[http://www.baidu.com 百度]。

插入预览图片

方法:在对应的页面位置插入类似格式的语句:

[[File:XCore407I.png|thumb|right|300px |alt=XCore407I |nolink=https://{{SERVERNAME}}/shop/XCore407I.htm |XCore407I]]

效果见:XCore407I

参考资料
http://www.mediawiki.org/wiki/Help:Images


使用表格

参考资料
http://www.mediawiki.org/wiki/Help:Tables


如何重命名页面标题

方法:在对应的页面插入类似格式的语句:

{{DISPLAYTITLE:新标题}}

如插入:{{DISPLAYTITLE:微雪维基百科编辑手册}} 效果见本页面标题。

重定向标题

#REDIRECT [[OpenEP4CE10-C用户手册]]

上传更新资料

  1. 上传新文件:
    • 文件命名:可以参考其他类似文件的命名,如xxx_Manual.pdf、xxx_schematic.pdf等等。【注意:命名不要含中文】
    • 直接拖动到编辑器上方的"拖动文件到这里上传"
    • 然后点击上传,上传完成后插入文件链接,如:[[File:IO Expansion Shield Manual.pdf]] 【此处的路径还不是最终路径,需要再做修改】
  2. 更新pdf等文件版本:(下例以更新“XXX_CAPE_Manual.pdf”新版本为例)

Category分类方法说明

默认是字母的分类的。

自定义分类格式语法是: [[Category:name|sort]]

下例是都归类到“ ”分类下 [[Category:树莓派| ]]

效果:
Raspberry Pi Categories.jpg

特定模板样式

Foo
Foo
Foo
Foo
Foo

插入代码

AT+CPSI?

<syntaxhighlight lang="c"> hdmi_force_hotplug=1 config_hdmi_boost=10 hdmi_group=2 hdmi_mode=87 hdmi_cvt 1024 600 60 6 0 0 0 </syntaxhighlight>

或者

<source lang="c"> hdmi_force_hotplug=1 config_hdmi_boost=10 hdmi_group=2 hdmi_mode=87 hdmi_cvt 1024 600 60 6 0 0 0 </source>

效果同下:

hdmi_force_hotplug=1 
config_hdmi_boost=10
hdmi_group=2 
hdmi_mode=87 
hdmi_cvt 1024 600 60 6 0 0 0


章节段落使用说明

pink-color

<div class="wiki-pages pink-color"> 对应的章节内容... </div>

效果如下:

First section header

11

111

1111

This will be displayed on the first tab

cyan-color

<div class="wiki-pages cyan-color"> 对应的章节内容... </div>

效果如下:

First section header

11

111

1111

This will be displayed on the first tab

jet-green-color

<div class="wiki-pages jet-green-color"> 对应的章节内容... </div>

效果如下:

First section header

11

111

1111

This will be displayed on the first tab

arduino-green-color

<div class="wiki-pages arduino-green-color"> 对应的章节内容... </div>

效果如下:

First section header

11

111

1111

This will be displayed on the first tab

blue-color

<div class="wiki-pages blue-color"> 对应的章节内容... </div>

效果如下:

First section header

11

111

1111

This will be displayed on the first tab

black-color

<div class="wiki-pages black-color"> 对应的章节内容... </div>

效果如下:

First section header

11

111

1111

This will be displayed on the first tab

内容折叠用法

默认展开

代码:

{| class="mw-collapsible"
|-
! 标题文本
|-
| 示例
|-
| 示例
|-
| 示例
|}

效果:

标题文本
示例
示例
示例

默认折叠

代码:

{| class="mw-collapsible mw-collapsed"
|-
! 标题文本
|-
| 示例
|-
| 示例
|-
| 示例
|}

效果:

标题文本
示例
示例
示例

更多用法:https://www.mediawiki.org/wiki/Manual:Collapsible_elements


其他

把Excel/Word文档数据插入到wiki页面

下例的操作以插入Excel表格数据为例,插入其他Excel或Word数据同理:

方法:

  1. 打开excel表格,选中表格区域,复制;
  2. 打开DW软件,新建一个空白的Html网页,然后到转到"设计"编辑栏,右键选择"选择性粘贴",勾选"带结构的文本以及全部格式";
  3. 此时在拆分栏的代码区会自动生成对应的表格代码,右键"拷贝";
  4. 复制到wiki页面,并保存;
  5. 因为原代码中含有<col />属性无法被识别,所以只需要表格上端的含<col />属性内容去掉即可(此操作不会影响表格的显示效果);
  6. 效果图如下:
  7. 如果需要给表格增加一些线条,可在编辑源代码上加入:(wiki语言是:border="1" html语言是border="1px"),效果图如下。

图例演示:

效果见:Display Magic word

说明:在word文档中,对应设置的一级或二级标题会对应的体现在wiki上,但是若文档中有图片或者表格,则图片需要另外上传处理,而word中的表格需将表格属性的宽度设置为0.75磅(1px == 0.75磅)会正常显示,否则可能会无线条。

图片集效果