Wiki 常见问题解答

关于本站的说明

什么是 Wiki？

Wiki 是 WikiWiki 的简称，中文通常叫做维基，是一种将网站内容开放给所有使用者共同编辑，适用于内容分享与合作类型的网站，比如著名的维基百科。在这种模式下，任何人都可以添加或者修改网页内容，从而使得网站内容更丰富更适合它所面向的使用群体。

Wiki 的编辑模式有两个特点：

• 一个是对 HTML 格式的简化，更贴近纯文本的格式，让大部分非技术背景的使用者容易上手使用。
• 另一个方便直接建立页面之间的链接，这样使得内容之间的联系更紧密。

本站的宗旨是方便广大书友共享书籍文本资料，采用 Wiki 方式来整理原始文本，以利于修正和勘误，达到真正的资源共享，不仅仅是提供下载而已。

为什么要注册账号？忘记了用户名或者密码怎么办？

本站要求只有注册账号才能够修改网站内容，这一方面是一个阻止恶意篡改的简单措施，另一方面是为了保持翔实的修改纪录，以便参考与交流。

所有在本站注册账号的用户在通常情况下并不会收到本站发送的邮件，如果发生了忘记用户名或者密码的情况，请使用原始注册的邮箱给管理员发信，才可以进行密码重设。本站不会在任何情况下公布使用者的邮箱及私人信息。

为什么要提供电子书的原始文本？

本站提倡直接将电子书的原始文本制作成 wiki 页面，一方面是方便网上浏览和修改，另一方面也有利于生成不同电子书阅读器适用的 PDF 文件。很多其它网站提供的电子书下载，要么是仅适合某一种阅读器的版本，要么是无法改变页面大小的 PDF，又或者是 HTML 和 word 文档，无法以共享的方式来修正。

所以本站鼓励使用最简单最有效的原始文本，仅采用少量的 Wiki 格式制作目录和章节，就可以自动生成适用于各类阅读器的精美 PDF 文件，其中还有交叉链接以方便阅读。而且文档在网站上随时都可以修改错别字，或者增补缺失的部分，群策群力来获取最佳的最终阅读效果。另外，对排版有更高要求的用户还可以下载所生成的电子书 tex 文档，自己进行后续制作。

目前本站也提供自动制作图片书籍的功能，只要图片是以附件形式上传的即可。对于普通 URL 形式的图片，在网站上可以正常显示，但是目前不予以制作成书。

网站内容是否有版权问题？

因为本站是开放性的 Wiki 网站，由公众提供资料，与公众分享电子书。如果出现版权纠纷问题，版权所有方请联系原始提供方，或者直接更正页面来维权。本站不介入任何使用者之间的纠纷，所提供的功能仅为制作电子书 PDF 一项，并不涉及内容或法律方面的判定。

本站 Wiki 的使用法则

由于 Wiki 网站的实现方式有很多，语法规则也各有不同，这方面并没有同一标准。本站的 Wiki 文法的出发点是简单易用，尽量符合使用者原来的习惯。

如何编辑页面和建立链接？

使用者在登录之后，点击页首菜单里自己的名字，即可访问属于自己的页面，此页面及所有从属的子页面均只能由本人来编辑。非用户名的页面则开放给所有其他用户公开编辑。

最初的个人页面的内容为空，可以从页首菜单选取[编辑此页]，然后在输入框里输入内容即可。

如果需要创建新页面，先修改你的个人页（或者已有的书籍分类页面）在适当的位置加入新页面的名字，保存后会显示为带问号(?)的链接，然后点击此链接开始编辑新页面。

欢迎各位修改测试页来尝试书写 Wiki 的方法。

基本 Wiki 文法是什么？

每个页面开头第一行会被当做是此页的标题，正常显示时以一号大标题显示出来。如果不想显示标题，可以第一行留空。

自然段开头顶行书写，段落之间以空行分隔开。

需要项目列表时，本行开头必须是空格，空格的数目用于区分列表的层次。列表有四种方式：

1. 行首以西文数字 1 开头的，正常显示时将以递增的数字标识。
2. 行首以西文符号 * 开头的，正常显示时以园点标识。
3. 行首以西文符号 # 开头的，正常显示时本行内容为词目，续行的内容为解释内容。
4. 行首只有空格而没有以上标识的，正常显示时没有标识。

在书写文字时可以嵌入页面链接，以西文方括号 [ 和 ] 来表示。

1. 括号内容为页面名的，正常显示时为指定页面名的链接。
   • 页面名为英文字符，可以有数字或空格，前后需要顶格紧跟方括号，比如 [Chinese Classic]
   • 当前修改页的子页面在前面用西文符号 : 区分，比如 [:sub page]
   • 其他页面的子页面则在页面名后面跟上 : 符号，然后紧跟子页面名，比如 [test:sub page]
2. 如果页面当中有西文点符号 . 则被视为附件，附件的命名也遵循子页面的方式，点符号 . 的后面为文件扩展名。
3. 正常显示时链接的名字为页面名，如以双括号 [[ 和 ]] 标识的则可以直接显示页面标题，也即页面首行内容。如果双括号内为 jpg, gif, png 图片附件名，则会直接显示图片。
4. 如果希望链接显示时采用其他文字，则以 页面名 的方式标识，比如 [Chinese Classic|古典中国文学]
5. 指向其他网站的 HTTP 链接也可以放在 [ 和 ] 之间表示，分隔符 | 也同样适用。

正常显示时如果所链接的页面或附件并不存在，则会在所链页面名后面显示一个西文问号符 ? 来标明。点击 ? 号则可以开始编辑所链接的页面或者上传附件。这种方式普遍用于创建新页面。

如何书写大小标题，建立目录索引，摆放留言板等？

除开第一行会被视为页面名外，文章大小标题可以用顶行的 - 后面紧跟标题内容来标识。单个 - 为大标题，-- 为中标题，--- 为小标题，---- 则会生成分隔线。

本 Wiki 也支持一定的 HTML 标识，比如 <b>粗体</b>, <i>斜体</i>，<br> 断行等。在标识前附加反引号 ` 则会取消标识解释而显示标识本身。

另外本站特有的标识都是另起且独占一行的，例如：

1. <index> 会生成本页大小标题的索引。
2. <comment> 会生成一个本页固有的留言板，<comment order=reverse>则会把最新留言放在最上方。
3. <code lang=语言> 和 </code> 会使用 enscript 生成程序代码的段落，所支持的语言包括 sh, c, cpp, tex 等数百种。

如何以附件的方式上传文档？

创建新附件的方式和创建新页面的方式相同，在编辑的时候把附件英文名写在 `[ 和 ] 之间，然后显示时点击后面的问号，就可以直接上传附件。

需要注意的是普通页面名不能够含有 . 字符，而附件名则必须含有 . 以及后缀名。

为什么不可以删除附件？

由于功能所限，附件一旦上载完成，就无法删除，更改名字或内容。今后会考虑提供相关功能。

如果需要更新原有的附件，可以用一个新的文件名创建链接然后上载，然后把旧有的链接修改为此新文件名即可。

网站和页面的结构

Wiki 网站的内容原则上是可以自由整理的。为了便于分类和有一个清晰的层次结构，本站采取子页面的命名法则，请尽量使用贴近原意的英文词或拼音来命名一个页面，与之相关的内容则以子页面的形式安排。页面附件请在前面使用西文冒号 : 来指明相对当前页面的从属关系。

子页面改名后，为什么原来指向它的链接没有更新为新名字？

由于功能所限，从新命名顶级页面时会更新所有与它或它的子页面相关的链接，但是从新命名子页面时，有部分链接未能自动更改，需要手动调解。这个问题会尽快得到解决。

制作电子书的方法

本站提倡直接将电子书的原始文本制作成 wiki 页面，如果无法提供原始文本，也可以使用附件的方式上传。

要是上传一本新书，该从何处入手？

首先，上传新书也就是说需要创建一个全新的书籍页面，而一个全新的页面则是通过编辑一个新的链接获得的。要理解这一点，我们来举例说明。

假如现在要上传一本《三国外传》，那么需要从某个地方建立一个三国外传的链接。这可以通过编辑现成的页面，比如古典文学页面，在其中适当的地方加入一个链接 [[:sanguowaizhuan]]，存档后，古典文学页面上就会显示一个新链接 sanguowaizhuan?，点击后面那个问号(?)就可以开始编辑这个属于三国外传的新页面了。

在上面这个例子里，我们给新链接取名为 :sanguowaizhuan。注意这里使用了一个冒号 : ，也就是说是作为原页面，[[Chinese Classics]]，的子页面来创立的。它的页面全名为 Chinese Classics:sanguowaizhuan。

新页面的链接可以通过编辑任意的已有页面获得，当然也可以从编辑个人页面开始。所采用的页面名，可以是子页面的方式，也可以是全名。

在新书页面创建之后，可以进一步标识书名，作者等，并添加附属章节页面，和书籍内容等。这里可以看出编辑的方式是由上而下，先有结构才有内容，和通常使用 Word 等软件先编写内容再整理出结构的方式正好相反。

如何标识书名，作者和副标题？

书名也即页面标题，顶格放在第一行。成书后会显示在第一页，以及以后每一页的页首左上方。

如果有作者名和副标题的话，可以分别放在第二和第三行，但是注意顶行必须是一个空格，这为了和普通段落区分开来。否则作者名和副标题缺省为空，不会显示在成书的首页。

如何分段？段首有空格怎么办？

如果是自然段的话，请务必在段落之间保留一个空行，段首如有西文空格，请务必删除。中文空格可以予以保留。

如果是已经排好的诗词，请在每句话前面加上西文空格，删除句与句之间的空行，排列整齐即可。

如何划分章节?

每一章的章节名使用顶行的 - 做成大标题，这样在生成电子书时会另起一页。成书后章节名也会出现在本章的页首右上方，点击它会回到目录页。

中标题也会另起一页，但是不会出现在页首右上方。小标题则不会另起一页。

章节过多，不适合放在同一页面怎么办？

可以在首页面章节命名处使用子页面链接，然后编辑此子页面，把章节内容放在子页面。

例如在首页面顶格写 -[[:chapter01]]，会在网页上显示子页面 :chapter01 的标题作为章节名。成书时则会把子页面内容也附在章节名后面。

如何生成目录索引？

同样是使用 <index> 的方式。中文书籍通常有的以回数命名，有的以章节命名。<index>全面展开可以写成：

• <index hidden style="回" indent="1in">

其中 hidden 表示不在网页里显示目录，仅在成书时显示。这对于经由子页面制作章节的书比较有效，因为首页仅剩章节名，再加上目录有点多余。

其中 style 可以为 "章" 或者 "回"，以中文数字标识。如果不指明的话，缺省以圆点标识。

最后 indent 表示在列目录时空出多少地方给章节标号，对于三国这样的有 "第一百一十一回" 标号的留出 1in 就可以了（1in 就是 1 英寸）。缺省的话仅适合圆点标识的长度。

为什么有的页面制成 PDF 内容不全？

很可能的一个原因是中文有乱码问题，造成制作 PDF 出错中断。这时如果检查一下 PDF 被中断的页面，通常能够查到是哪一章节哪一部分的错误，可以从网页上立刻修正，即时得到解决。

另外虽然本站所有页面均可制成 PDF，但是有些 Wiki 的文法并没有得到完全支持，比如图片和代码引用目前在 PDF 里面都缺失，这些功能在今后会逐一实现。

为什么我制作的书没有出现在书籍分类表里面？

目前书籍分类的页面都是人工整理的，你需要修改所需要的分类页面，把书籍的链接加入才可以。

如果你是从自己的个人页面上建立的新链接，然后编辑的书籍，那么可以拷贝此书的英文页面全名（在每页左上方显示的字串），然后把它加入到书籍分类的页面里做成链接，附上说明即可。

你还可以进一步更改你制作的书籍的页面名，把它做成已有的分类的子页面。当然这一步不是必须的，因为本站秉着 wiki 的原则，并不强加一个命名结构给任何页面。但是如果你希望自己的书也可以被他人编 辑，那么改成一个公共的名字比较好，因为如果还是作为你的个人页的子页面的话，他人无法参加编辑。

值得注意的是，通过更改页面名把它作为已有的分类的子面，这本身并不意为着它会出现在此分类里。

为什么我制作的页面段落显示不正确？

本 wiki 文法要求以空行来区分自然段，如果是来自其它地方的书籍原稿，可能段落之间没有空行，这样就会造成显示错误。

这个问题可以在编辑时，使用编辑框下方提供的中文整理辅助功能来解决。先使用中文段落自动整理，通常能够把原稿里的段落都整理出来。然后如果每段段首有英文空格的话，可以使用清除段首英文空格的功能来把它们去掉。中文空格则会予以保留。

在制作电子书 PDF 的过程中，每个自然段段首都会自动空上两格，所以在编写页面的时候，就没有必要在段首添加空格了。