# MDwiki_zh

**Repository Path**: Tech_Query/MDwiki_zh

## Basic Information

- **Project Name**: MDwiki_zh
- **Description**: 基于 MarkDown 语法的轻量级 Wiki 引擎，完全运行在网页浏览器中（本项目是 原作的非官方中文版）
- **Primary Language**: JavaScript
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: http://www.mdwiki.info
- **GVP Project**: No

## Statistics

- **Stars**: 28
- **Forks**: 16
- **Created**: 2015-08-02
- **Last Updated**: 2023-08-03

## Categories & Tags

**Categories**: doc-tools

**Tags**: None

## README

# MDwiki 大中华版  v0.6.2


项目概述
----

**MDwiki** 是一个**基于 MarkDown 语法的轻量级 Wiki 引擎**，完全运行在网页浏览器中。

**MDwiki 大中华版**（非官方）对原作核心代码的改动 ——
 1. `已完成` 将其依赖的所有基础库的引用 URL 改为 **中国大陆地区 CDN**，并更新到最新版
 2. `已完成` **独立、整理、修补 其发布版的 CSS、JS、MD 代码**
 3. `进行中` **翻译 官方网站的文档**
 4. `待实施` 替换其依赖的国外**开放服务 SDK** 为 中文互联网同行的同类服务
 5. `待实施` 优化核心逻辑，提高加载性能

【文档、演示】—— [mdwiki.oschina.cnpaas.io](http://mdwiki.oschina.cnpaas.io/)


特别鸣谢
----

【原作官网】—— [www.mdwiki.info](http://www.mdwiki.info/)

【墙内 CDN】—— [www.bootcdn.cn](http://www.bootcdn.cn/)（感谢 **BootStrap 中文网** - 开放 CDN 服务）

【异步加载器】—— [EasyImport.js](http://git.oschina.net/Tech_Query/EasyImport.js)（简单、好用的**文件级加载器**）


译者感言
----

译者曾是一个**百科站长**，自己创立的百科站 先后用 HDwiki、MediaWiki 驱动，期间的整站迁移、二次开发 还自己开发了一些工具。最早为 互动百科 在国内的一些努力而激动，但又为它的沉沦而气愤；后来又为 **MediaWiki “一切皆为词条”的 UNIX 式模型、强大的 API** 所折服，但却又被它 **复杂的扩展 Wiki 代码、庞杂的 API 参数、扩展依赖库启用困难、前后端性能低下**等问题搞得十分疲倦……

最近工作中又需要搭建文档系统，想想虽然国内外很多 IT 公司的**对外文档系统** 都基于 MediaWiki + 自己设计的前端界面，但从维护成本的角度，还是选择了**基于 MarkDown 语法的 Wiki 引擎**。

**MarkDown 代码** 有一些很实在的优势 ——
 1. 虽与 **Wiki 代码**一样，没有国际标准、只有流行的实现（比如 Github、Wikipedia），但有**更广泛的应用领域**（比如 代码文档、博客、百科）
 2. 虽其各种应用实现与 MediaWiki 一样，做了各种强大的**扩展插件**，但**代码语法一直保持简单**，依然可以作为**纯文本文件**让人轻松阅读
 3. 正因其简单，各种编程语言、平台上都涌现了很多好用的 **MarkDown 编辑器、解析引擎**，特别是 **Web 前端界**（MediaWiki 只能依赖其 PHP 解析引擎）

而在**版本管理**方面，Git 这样基于**文件系统模型**设计的**分布式版本控制系统**，管理文本文件的版本变化非常可靠、高效。再结合上 MarkDown 的优势，一个**轻量、易用、兼容的文档系统** 的构建、维护就很轻松了~