本Wiki採用MediaWiki 系統,可以使用HTML代碼 、Wiki標記 實現各種功能。
本系列頁面用於介紹Wiki標記 以及部分常用的HTML代碼 。
如果您擁有相關html或wiki編輯經驗,您可以跳過本系列幫助,並參照常用模板列表 進行編輯。
更高級的功能說明可以參閱解析函數功能列表 或在擴展幫助文檔分類 中檢索。
概述
您或許使用過記事本、Word等文本編輯器,也或許編輯過百度百科,但是mediawiki與它們有所不同,後者會從源代碼,並在服務器進行處理,最終呈現為閱讀頁面的樣子。
譬如,要加粗文字 ,只要將文字放在三個單引號之間→'''像这样'''。
對於wiki的所有編輯,均需要在源代碼頁面完成。本系列幫助頁面即是幫助您了解如何進行源代碼的編寫。
當您操作不夠熟練時,您還可以使用編輯框頂部的小工具進行編輯(不過並不推薦使用,不但編輯速度較慢而且無法移動到其它文本編輯器進行編輯)。
由於源代碼內容為文本,您可以在喜歡的文本編輯器進行編輯,然後複製到對應頁面的編輯區。我們強烈推薦您在提交代碼前先複製到本地並保存,以避免不必要的編輯內容丟失。
在編輯完成後,我們推薦您首先使用「顯示預覽」按鈕查看您的編輯是否如您所期望的那樣,以避免不必要的反覆修改操作。 請尤其注意需要配對使用的標籤是否已配對好。大部分情況下代碼充滿屏幕都是因為這類bug。
不必死記硬背本頁面的內容——在需要時您可以隨時查閱。 如果您對編輯技術不太自信,我們推薦您使用Help:沙盒 頁面進行編輯練習。在這個頁面您可以隨意進行編輯。 如果您不知道在其它某個頁面中編輯會獲得怎樣的效果,也可以在Help:沙盒 頁面進行編輯。Help:沙盒 (在如此的再三重複之下,您應該牢記Help:沙盒 這個頁面了。)
基礎編輯功能
描述
使用方法
效果
創建新頁面
直接在搜索框輸入要創建的新頁面的名字,或者直接在「calcwiki.org/」後面輸入,就會提示是否創建新頁面了。 目前只有以上的方法創建。
模板
{{}}表示一个模板。一个模板是一串代码的整合,使用模板可以节省很多编写代码的时间。
如果您不会使用某个模板,推荐您找一个编写完毕的模板并进行内容替换。
"{{"右边、"|"左边的一段文字是模板的名称。
进入模板:(模板名称)页面(如:[[模板:Navbox]]) 可以看到该模板的详细信息。
常用模板请参见[[帮助:常用模板]]。
{{}}表示一個模板。一個模板是一串代碼的整合,使用模板可以節省很多編寫代碼的時間。
如果您不會使用某個模板,推薦您找一個編寫完畢的模板並進行內容替換。
"{{"右邊、"|"左邊的一段文字是模板的名稱。
進入模板:(模板名稱)頁面(如:模板:Navbox )可以看到該模板的詳細信息。
常用模板請參見幫助:常用模板 。
標題
<nowiki>== 2級標題 ==
=== 3級標題 ===
==== 4級標題 ====
請不要跳躍標題等級,例如2級標題之下直接就是4級標題,而沒有3級標題。
1級標題是當前頁面的標題(如本頁為 幫助:常用代碼),請不要使用1級標題。
標題最多為6級。
當頁面超過四個標題時會自動創建目錄。
2級標題
3級標題
4級標題
請不要跳躍標題等級,例如2級標題之下直接就是4級標題,而沒有3級標題。
1級標題是當前頁面的標題(如本頁為 幫助:常用代碼),請不要使用1級標題。
標題最多為6級。
當頁面超過四個標題時會自動創建目錄。
鏈接
[[TI-Nspire]] 双方括号可以链接calcwiki内页面
[[计算器|电卓]] 也可以加上“|”更改显示文字
[http://education.ti.com 德州仪器教育] 单方括号以处理完整的url。这样更改显示文字。
如果没有加上显示文字,会变成[1]
http://casio.com 单独出现的地址也会被解析为网址。
#重定向[[目标页面]]会使进入该页面后自动跳转到目标页面。
请首先建立目标页面,再设置重定向。
插入表格
这是表格的开始
{| class="wikitable"
|+ 这样添加表格标题
|一道竖线是一个单元格 || 同一行如果要继续书写,之后的都要两个竖线
|另一行开头的话就只需要一个
|-----
|这样换行(-有几个都可以) ||align="center" colspan=2|这样添加css信息
|- align="center"
| style="background:black; color:white"|行首添加css方法相同
! 用叹号代替竖线会获得标题效果的表格
|}这样结束表格。
* 表格中可以嵌套表格,但可能会造成一些bug。
* 常用的css参数还有width=50%(宽度为整个页面50%) 、height=200px(高度限定为200像素)等。
* 可以用 class="sortable"进行排序,参考wikipedia 可排序表格
* HTML标记(<table>、<tr>、<td>、<th>)亦可使用,但在这些HTML标记中不能使用wiki标记。
這是表格的開始
這樣添加表格標題
一道豎線是一個單元格
同一行如果要繼續書寫,之後的都要兩個豎線
另一行開頭的話就只需要一個
這樣換行(-有幾個都可以)
這樣添加css信息
行首添加css方法相同
用嘆號代替豎線會獲得標題效果的表格
這樣結束表格。
表格中可以嵌套表格,但可能會造成一些bug。
常用的css參數還有width=50%(寬度為整個頁面50%) 、height=200px(高度限定為200像素)等。
可以用 class="sortable"進行排序,參考wikipedia 可排序表格
HTML標記(<table>、<tr>、<td>、<th>)亦可使用,但在這些HTML標記中不能使用wiki標記。
添加分類
[[分类:帮助文档]] 这样就会给页面添加一个分类。
在页面的最下方,注明了本页面所属的分类。
点进去,就可以看到同名分类下的所有页面和文件。
[[分类:帮助文档]] 這樣就會給頁面添加一個分類。
在頁面的最下方,註明了本頁面所屬的分類。
點進去,就可以看到同名分類下的所有頁面和文件。
注釋
用<ref>注释文本</ref>进行注释。
如果相同内容的注释多<ref name="说明">在最前面的Ref里写下name="",
之后的ref都直接加上name=""/</ref>,可以这样<ref name="说明" />
注释内容还会在<references />处出现。如果页面没有,会默认加在页尾。
字體與段落
描述
使用方法
效果
保持文字排版格式
在HTML代码中,大段的半角空格会被忽略为一个,
换行会被当做一个普通的空格(不过在表格里,和回车两次的效果是一样的)
回车两次(↑中间有一个空行)会产生一个新的段落,并不是换行,因而并不推荐使用。<br />标签会使文本进入新的一行。
<nowiki>标签会将其中的全部wiki标记(比如'''这个''')以及全部HTML标记(如<br />)保留原样。
在HTML代碼中,大段的半角空格會被忽略為一個, 換行會被當做一個普通的空格(不過在表格里,和回車兩次的效果是一樣的)。
回車兩次(↑中間有一個空行)會產生一個新的段落,並不是換行,因而並不推薦使用。 標籤會使文本進入新的一行。
<nowiki>标签会将其中的全部wiki标记(比如'''这个''')以及全部HTML标记(如<br />)保留原样。
編輯注釋
<!-- 写在这里面的字不会被显示。 -->
粗體字
'''粗体'''
粗體
斜體字
''斜体''
斜體
粗斜體文字
'''''粗斜体'''''
粗斜體
HTML標籤
某些 HTML 標籤是MediaWiki可以使用的,例如<code>、<font>、<div>、 <span>(使用style=""添加css)以及全套表格相关代码。(更多內容參見:wikipedia HTML幫助 如果您你對HTML熟悉,可以嘗試使用。不過如果有效果相同的模板,我們推薦您使用對應的模板。 以下是若干示例:
<center>可以使内容居中。<br />内容可以是文本或表格,其中也可以加上其它标签。</center>
{{color|颜色名|文字|}}可以设置字体颜色。例如:{{color|red|红色文字}}
<s>删除线</s>,<u>下划线</u>,<code>源代码</code>,<blockquote>引用文本(会与上下都空出一部分,并在行首有一个缩进)</blockquote>
用<big>和<small>可以调整字体大小。例如:
<big>big</big> <big><big>bigger</big></big> and<small>small</small>
如果您认为字不够大或者不够小,可以连续套用<big>和<small>。比如:
<big><big><big><big>THAT IS SO BIIIIG!</big></big></big></big>
然而,我們有必要提示您,不要在詞條裡面使用過大或過小的文字,這會嚴重影響閱讀體驗。
数学公式里,经常需要<sup>上标</sup>和<sub>下标</sub>。
可以使內容居中。 內容可以是文本或表格,其中也可以加上其它標籤。
{{color|颜色名|文字|}}可以设置字体颜色。例如:紅色文字
刪除線 ,
下劃線 ,
源代码,
引用文本(會與上下都空出一部分,並在行首有一個縮進)
用<big>和<small>可以调整字体大小。例如:
big bigger andsmall
如果您认为字不够大或者不够小,可以连续套用<big>和<small>。比如:
THAT IS SO BIIIIG!
然而,我們有必要提示您,不要在詞條裡面使用過大或過小的文字,這會嚴重影響閱讀體驗。
數學公式里,經常需要上標 和下標 。
列表
*普通列表——该行前会出现一个蓝色圆点。
**也可以这样递进
**#或者在其中加上些数字顺序(#与*的用法相同)
*或者这样跳到上一级
*****但是请注意这样跨级会出现多个图标。
没有星号代表列表结束。
*星号一定要是第一个字符*这个星号不会转换为列表。
普通列表——該行前會出現一個藍色圓點。
也可以這樣遞進
或者在其中加上些數字順序(#與*的用法相同)
或者這樣跳到上一級
沒有星號代表列表結束。
星號一定要是一行第一個字符*這個星號不會轉換為列表。
縮進
;这样会使本行加粗
:这样会使本行缩进(半角冒号)
這樣會使本行加粗
這樣會使本行縮進(半角冒號)
引用框
如果一行开头是空格,那么该行文本会在引用框内显示。
它会自带<poem>的效果<br />也可以用这个连续。
<pre>使用它是相同的效果,只是里面不能使用'''wiki标记'''。</pre>
如果一行开头是空格,那么该行文本会在引用框内显示。
会自带<poem>的效果 也可以用这个连续。
使用它是相同的效果,只是里面不能使用'''wiki标记'''。
水平線
单独的一行、四个短横线。
----
虽然与标题效果类似,但请不要用这个“模拟”标题。请使用==标题==
單獨的一行、四個短橫線。
雖然與標題效果類似,但請不要用這個「模擬」標題。請使用==標題==
簽名
~~~ 这样显示编辑者的名字。
~~~~ 这样显示编辑者的名字和编辑时间。
警告:這個功能僅用於在討論頁中標明是誰的評論。不要把您的尊姓大名簽在詞條中!
DemoUser (討論 ) 這樣顯示編輯者的名字。
DemoUser (討論 ) 2016年1月9日 (六) 11:03 (CST) 這樣顯示編輯者的名字和編輯時間。
警告:這個功能僅用於在討論頁中標明是誰的評論。不要把您的尊姓大名簽在詞條中!
插入圖片
'描述
使用方法
效果
上傳圖片
點擊側邊欄的【上傳文件】 可以上傳。 在「摘要」中寫入的內容會成為頁面的一部分。應當填寫圖片的大概內容或是用處。
插入圖片(此處用Ndless Logo這張圖片做示範)
插入图片就是插入图片文件的地址。
不希望展示的话,是[[Media:Ndless Logo.png ]]
希望直接显示完整图片的话,是[[File:Ndless Logo.png]]
希望从某段文字起不环绕图片而是在图片下方出现的话,使用{{-}}
在图片上面写的文字会默认在图片上方。
如果您希望在词条中插入一个缩略图,并在点击缩略图时能看到它的大图,可以输入这样的代码:
[[File:Ndless Logo.png|200px|thumb|right|Ndless Logo]]
注意:为了规范词条风格,缩略图都应该插在右侧(上述代码默认是插在右侧的),而不是左侧,更不能左一个右一个,这会严重影响阅读体验。
大多数情况下图片都是浮动的。这时就容易出现这个问题:
=== 错误显示在图片旁边的下一段标题 ===
{{-}}
=== 正确显示的下一段标题 ===
这里的文字会显示在图片和前面所有东西下方,文字以外,== 标题 ==类型的标题也应该这样写。
文件插入命令的具体参数说明:
[[文件:文件名.后缀名|可以添加的参数1|2|3|4...|图片标题]]
没有参数的情况下,默认为在原处放置、文字不会环绕图片。
none、center会使其独占一行,center还会使图片居中。
left、right会使文字环绕图片,同时使图片居左/右。
frame、thumb会使图片有外框并显示标题,thumb还会使图片变为缩略图。
link= 会为图片添加超链接。
[[File:Wiki.png|100px]]会使图片宽度为100px,
[[File:Wiki.png|x100px]]会使图片高度为100px。会根据原图宽高比成比例缩小。
[[File:Wiki.png|100x100px]]会使图片最长的一边等比缩放到100px。
如果希望多个图片按一定方式排列,最常见的办法是使用表格。
插入圖片就是插入圖片文件的地址。
不希望展示的話,是[[Media:Ndless Logo.png ]]Media:Ndless Logo.png
希望直接顯示完整圖片的話,是[[File:Ndless Logo.png]]
希望從某段文字起不環繞圖片而是在圖片下方出現的話,使用{{-}}
在圖片上面寫的文字會默認在圖片上方。
如果您希望在詞條中插入一個縮略圖,並在點擊縮略圖時能看到它的大圖,可以輸入這樣的代碼:[[File:Ndless Logo.png|200px|thumb|right|Ndless Logo]]
Ndless Logo
注意:為了規範詞條風格,縮略圖都應該插在右側(上述代碼默認是插在右側的),而不是左側,更不能左一個右一個,這會嚴重影響閱讀體驗。
大多數情況下圖片都是浮動的。這時就容易出現這個問題:
錯誤顯示在圖片旁邊的下一段標題
正確顯示的下一段標題
這裡的文字會顯示在圖片和前面所有東西下方,文字以外,== 標題 ==類型的標題也應該這樣寫。
文件插入命令的具体参数说明:
[[文件:文件名.后缀名|可以添加的参数1|2|3|4...|图片标题]]
没有参数的情况下,默认为在原处放置、文字不会环绕图片。
none、center会使其独占一行,center还会使图片居中。
left、right会使文字环绕图片,同时使图片居左/右。
frame、thumb会使图片有外框并显示标题,thumb还会使图片变为缩略图。
link= 会为图片添加超链接。
[[File:Wiki.png|100px]]会使图片宽度为100px,
[[File:Wiki.png|x100px]]会使图片高度为100px。会根据原图宽高比成比例缩小。
[[File:Wiki.png|100x100px]]会使图片最长的一边等比缩放到100px。
如果希望多个图片按一定方式排列,最常见的办法是使用表格。