人生蓝图

“Wiki 书写规范”的版本间的差异

Wiki 书写规范 (编辑)

2022年3月19日 (六) 18:10的版本

删除3,944字节 、 2022年3月19日 (六) 18:10
小
无编辑摘要
（创建页面，内容为“== 安装 == PHP环境，mediawiki 安装程序、MySQL环境、 == 基础配置 == 1、左侧导航栏设置　　在右上角搜索栏中输入“mediawiki:sideb…”）
 
小
 
（未显示3个用户的43个中间版本）
第1行： 第1行：
== 安装 ==
[[分类:运营]]  [[分类:Wiki]]
PHP环境，mediawiki 安装程序、MySQL环境、


<gallery mode="packed-hover" caption="运营">
文件:C23e51db036418217ba5f43e775a66961636031981537.jpg|alt=运营
</gallery>本文主要介绍，wiki文档的书写规范。


== 基础配置 ==
== 书写规则 ==
1、左侧导航栏设置　　在右上角搜索栏中输入“mediawiki:sidebar”
*段首为一段话，对主题进行解释，形成一段摘要。
*多用标题，注意层级分明。多梳理条例，使用列表，和内部链接尽量有些条例。
*文章，优先使用文字，增加图片会影响操作者的体验。
*如果对3-5秒的等待时间可以忍受，则可以适当增加配图，图标优先流程图和思维导图。推荐走学术风格和插画可爱风格，排版尽量简洁。
*真正喜欢本站的人，推荐使用'''源代码进行编辑，建议学会wiki语法，享受编辑的过程。'''
*笔记协同，电子笔记和wiki结合，电子笔记为其收藏素材。wiki为输出，反复修改揣摩更改，否则会经常积灰。
*在协同方面，可以使用腾讯文档、飞书、语雀、石墨文档等软件。
*笔记一定要分好类，最好归档，整理。
*注意链接，相互联系。
*使用合适的插件，做好知识体系。
==本站倡议==
*对熟悉有感悟的知识，建立词条，在编写中学习，鼓励大家编辑。
*如果有数据分析类的，会编程语言，或者其他作图工具（PS、PPT）可视化最好。增加信息密度，让人们可以理解。
*当知识体量大的时候，很多作者已经记录的很全了。可以合理搬运，借鉴，摘录但一定要多加工和打磨。
*从外文搬运也很好，机器翻译和人工效验，也可以做做。提倡自发编辑，有能力的人记录，普通人在其中学习。
*希望大家可以自发形成手册，遵守操作规范。可以借鉴，其他站点的书写规则。
*帮助所有人，在文档中找到答案。可能我们是个开荒的团队，或者只是自己一个人搞搞事情。但尽量打磨，做出一个完整的开源共享产品。


确认后进行编辑（需要以站长或管理员身份登录）。
相关文章：[[思考wiki]] [[Wiki作用]] [[友链记录]]  [[编写源码]] [[官方教程]]
 
格式：<blockquote>* navigation
 
** mainpage|mainpage
 
** <nowiki>http://bbs.zzbaike.com|论坛</nowiki>
 
** currentevents-url|currentevents
 
** recentchanges-url|recentchanges
 
** randompage-url|randompage
 
** helppage|help
 
 
*推荐网站
 
** <nowiki>http://www.idcspy.com|美国主机侦探</nowiki>
 
** <nowiki>http://www.alexacn.org|Alexa中文资讯</nowiki>
 
** <nowiki>http://down.zzbaike.com|站长下载</nowiki>
 
** <nowiki>http://site.zzbaike.com|站长网址</nowiki>
 
** <nowiki>http://edu.zzbaike.com|站长学院</nowiki></blockquote>
 
 
第一行（一个前导*）表示导航栏的名称，其提示文本在“mediawiki:navigation”页面中修改，也可以直接输入文字信息（文字不能与内部mediawiki参数页面重名）。
    后续行（两个前导*）表示实际导航栏的内容，其格式为“链接网址|显示文本”。其中，链接网址有三种类型：
直接输入http网址，例如直接输入“http://www.allwiki.com/bbs”
 
文章页面标题，例如输入“辅助平台”代表站内文章“[[辅助平台]]”的网址mediawiki名字空间的参数页，例如输入“mainpage”代表文字信息参数页面“[[mediawiki:mainpage]]”的网址。此类字串还有 helppage、portal-url等，可到special:allmessages里面查看更多的此类字串。
 
　　显示文本的设定与导航栏名称设定类似，可以：
 
　　直接输入文字信息
 
　　使用mediawiki名字空间参数页的标题缩写，例如上文默认文本中 的“randompage”、“sitesupoort”分别代 表“[[mediawiki:randompage]]”和“ [[mediawiki:sitesupport]]”。
 
　　保存后左侧导航栏随之改变：
 
2、目录控制　　当文章中含有3个以上标题时，mediawiki将自动在第一个标题之前生成目录（这是默认的设置）。
 
　　如果需要隐去目录，可以在文章中加入“”标记；
 
　　如果需要强制显示目录而不管标题数量，可以加入“”标记；
 
　　这两个wiki标记不限制出现位置，但一般出现在文章头部或尾部且单独成行。
 
3、文章分类
        在文本中嵌入“”的文字，会使本文自动归类到“文章分类”下面。一般习惯在文章末尾放置该语句；同一篇文章可以设置多个分类。
 
        编辑完成后，点击正文页面下端的分类名称，可以进入该分类页面查看更多的同类文章。同时，分类页面中也可以进行编辑，以进行必要的说明。
 
        分类是mediawiki中一种重要的内容关联手段，分类将同类文章在同一个页面上集中起来，为读者提供查看相关资料的方便。Mediawiki的分类还有上下级关系，使内容关联更有层次。
4、添加新页面　　通过搜索新页面名，若没有此页面，则新建此页面。如下图，点击引号内文章名称即可进行新建。
 
5、图片的上传及使用 5.1、图片上传
        1>设置images文件夹为可写；
 
    2>在配置文件LocalSetting.php中找到$wgEnableUploads，设置为true。
这样就启用了mediawiki的图片上传功能。然后进行文件的上传：
 
1>  当图片位于本机时，要把图片在Special:Upload页面上传后才能使用（该页面的链接可在“特殊页面”中找到，标注为“上载文件”）；
 
2>  图片文件不能使用中文名称，应在上传时指定英文名称；
 
3>   将图片上传后，在需要插入图片的位置输入“[[Image:Filename.jpg]]”即可（Filename为上传图片的文件名），即可出现无方框图片效果，如果需要添加方框效果，可以输入“[[Image:Filename.jpg|thumb]]”添加图片方框。
 
5.2、图片的使用
        在要插入图片的位置输入：[[Image:file.jpg]],就可以显示对应的图片了。
5.3、图片上传错误
        选择图片点击上传后，报错：
解决方法：
 
首先检查一下三个参数在LocalSetting.php配置是否正确
 
$wgEnableUploads = true;
 
$wgUseImageMagick = true;
 
$wgImageMagickConvertCommand = "/usr/bin/convert";
    如果没问题，可能是因为图片目录的权限不够造成的，在服务器的根目录下有个images的目录，把它的权限改成777就可以了。
chmod 777 images
 
再次上传，ok.
    使用图片时给图片加边框报错：
 
  说明convert程序没有安装。安装ImageMagick程序即可
 
    Apt-get install ImageMagick 
 
    图片引用格式如下图所示：
图片引用结果如下图：
 
6、编辑器
      MediaWiki自带的编辑器比较简单，用于页面编辑不太方便。从1.18版开始，MediaWiki集成了一款增强型编辑器WikiEditor,在LocalSettings.php中加入如下内容可启用WikiEditor。
7、文件上传设置 7．1允许上传文件
    更改/var/www/html/mediawiki/LocalSetting.php中的$wgEnableUploads,把false改为true。
 
    同时，/etc/php5/apache2/php.ini中的file_uploads,改为on
7．2允许上传的文件类型
      更改/var/www/html/mediawiki/includes/DefaultSettings.php里的$wgFileExtensions列表，加上自己要支持的类型。如：
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg','xls', 'doc','mp3', 'rmvb' );
 
7．3允许上传的文件大小　　除了更改/var/www/html/mediawiki/includes/DefaultSettings.php里的$wgFileUploadWarning的值（超过这个值的文件会警告，但可以成功上传），很重要的，还要更改/etc/php5/apache2/php.ini中的两项。
 
upload_max_filesize,最根本的，PHP允许上传的最大文件大小
 
post_max_size,这个参数的大小直接决定了上面一项。因为上传的数据，有的是POST上传上来的，如果这个项的值小于上一项，那会以这一项为准，导致根本上传不成功。
取自“http://wiki.pkzhidi.xyz/index.php?title=特殊:移动版差异/56...1802”