请使用下列bash命令下载编译和运行本项目：

Posted 2020-09-13

　　快速上手
　　
　　请使用下列bash命令下载、编译和运行本项目：
　　
　　$ git clone https://github.com/PerfectExamples/Perfect-Markdown-Editor.git
　　
　　$ cd Perfect-Markdown-Editor
　　
　　$ swift build
　　
　　$ ./.build/debug/PerfectMarkdownEditor
　　
　　4
　　
　　如果运行成功，则终端会显示：
　　
　　[INFO] Starting HTTP server localhost on 0.0.0.0:7777
　　
　　1
　　
　　1
　　
　　这意味着服务器已经成功启动，现在您可以使用浏览器查看地址】，如下图所示：
　　
　　作为教学程序，这里采用了没有任何附加页面特效和色彩的素颜html，以将代码简化到最为容易理解的程度。当然您可以随时将喜爱的CSS主题加入到源程序。
　　
　　源代码简介
　　
　　本项目是在 PerfectTemplate 基础上编制完成的。如果您还不熟悉如何使用Swift编写服务器应用程序，请首先查看这个项目。
　　
　　Package.swift
　　
　　即SPM软件包管理器在编译项目时标准的源程序，核心代码如下：
　　
　　.Package(url: "http://www.gouyily.cn /PerfectlySoft/Perfect-WebSockets.git", majorVersion:2),
　　
　　.Package(url: http://www.dwhxsl.cn / /PerfectlySoft/Perfect-Markdown.git", majorVersion: 1)
　　
　　1
　　
　　2
　　
　　3
　　
　　1
　　
　　2
　　
　　3
　　
　　上述依存关系中， Perfect-HTTPServer 包括了启动一个Swift语言在 mac / Linux 上开发HTTP服务器的所有必要功能；而 Perfect-Markdown 用于Swift语言将Markdown字符串转换为HTML文本。最后的 Perfect-WebSocket 用于服务器支持HTML5/WebSocket扩展。
　　
　　main.swift
　　
　　main.swift 是该服务器的门户入口，是一个典型的PerfectTemplate 模板程序。该服务器只提供两个路由资源：
　　
　　/editor - WebSocket 处理器，即能够处理来自浏览器端的 WebSocket 请求：
　　
　　public class EditorHandler: WebSocketSessionHandler {
　　
　　public let socketProtocol : String? = "editor"
　　
　　// 如果窗口关闭等事件发生则需要关闭socket
　　
　　public func handleSession(request: HTTPRequest, socket: WebSocket) {
　　
　　socket.readStringMessage { input, _, _ in
　　
　　guard let input = input else {
　　
　　socket.close()
　　
　　return
　　
　　}//end guard
　　
　　// 就这一行代码，把输入的Markdown内容转换为HTML
　　
　　let output = input.markdownToHTML ?? ""
　　
　　// 将转化好的HTML文本返回给客户端
　　
　　socket.sendStringMessage(string: output, final: true) {
　　
　　self.handleSession(request: request, socket: socket)
　　
　　}//end send
　　
　　}//end readStringMessage
　　
　　}//end handleSession
　　
　　}//end Handler
　　
　　/ - 根路由，即一个静态的HTML主页页面。但是客户端的行为 - 输入任何Markdown内容都可以立刻看到HTML渲染效果 - 是由在该主页中嵌入的一小段 WebSocket 脚本控制的。
　　
　　`
　　
　　var input, output;
　　
　　function init(){
　　
　　input = document.getElementById(‘textInput‘);
　　
　　output = document.getElementById(‘results‘);
　　
　　//这一句话是创建WebSocket，并且将目标指向当前服务器，采用/editor路由和editor协议（碰巧重名）
　　
　　sock = new WebSocket(‘ws://‘ + window.location.host + ‘/editor‘, ‘editor‘);
　　
　　sock.onmessage = function(evt) { output.innerText = evt.data; }
　　
　　}//end init
　　
　　function send() {
　　
　　sock.send(input.value);
　　
　　12
　　
　　最后，配置并启动服务器：
　　
　　// 只需填写服务器名称、端口，以及上述两个路由句柄
　　
　　let configuration = [ "servers": [[ "name":"localhost", "port":PORT,
　　
　　"routes":[
　　
　　["method":"get", "uri":"/", "handler":handler],
　　
　　["method":"get", "uri":"/\(API)", "handler":socketHandler]
　　
　　]]]
　　
　　]//end configuration