上面文章《NodeBlog(一) - node.js安装及Express框架简介》 中我已经做好了准备工作,接下来需要快速构建起第一篇博文,当然这个博文是基于markdown于语法。
Markdown语法的CheatsSheet附件有下载:
http://dl.iteye.com/topics/download/2cca1dea-14a2-35d5-bb05-78e03a87b437
express 并不直接支持markdown语法,需要为项目添加markdown-js模块的依赖.
目录/文件 | 说明 |
./ | 根目录,我们的node.js代码都会方这个目录 |
package.json | npm依赖配置文件, 类似ruby中的Gemfile, java Maven中的pom.xml文件. 一会需要在这里添加 markdown-js 项目依赖 |
app.js | 项目的入口文件 |
public/ javascript/ stylesheets/ images/ |
存放静态资源文件, jquery/prettify.js等静态库会方这里,当然自己编写的前端代码也可以放这里 |
views/ | 模板文件, express默认采用jade, 当然,你也可以使用自己喜欢的haml,JES, coffeeKup, jQueryTemplate等模板引擎 |
node_modules/ | 存放npm安装到本地依赖包,依赖包在package.json文件中声明,使用npm install指令安装 |
原package.json文件
{ "name": "application-name" , "version": "0.0.1" , "private": true , "dependencies": { "express": "2.4.6" , "jade": ">= 0.0.1" } }
我们修改成:
{ "name": "nodeblog" , "version": "0.0.1" , "private": true , "dependencies": { "express": "2.4.6" , "jade": ">= 0.0.1" , "markdown-js": ">= 0.0.1" } }
name: 指定我们app的名称,
dependesies: 中定义依赖库,这里添加了对markdown-js的依赖,
private: 制定是否将程序发布到npm全局仓库中
$ npm installl
控制台 写道
此时在 ./node_modules 目录下会多出一个 mardown-js 目录
xVim:
gVim/MacVim, 需要自行配置插件, 下面个人推荐一些
默认提供markdown语法支持, jade 和 node.js 需要安装bundles
打开app.js开始编写node.js代码, 在没写任何代码前的 app.js 大致如下:
var express = require('express'); var app = module.exports = express.createServer(); app.configure(function(){ // set some config }); app.get('/', function(req, res){ res.render('index', { title: 'Express' }); }); app.listen(3000);
第一行导入 express 模块, 可以理解成java中的 import [packagename]。一会需要用这个语法来导入markdown-js模块模块
(node.js的模块管理基于CommonJS规范,详细内容可以参考CommonJS Wiki。)
var express = require('express'); var markdown = require('markdown-js'); var app = module.exports = express.createServer(); // ... some code app.listen(3000);
到这里已经可以在express中渲染markdown格式的字符(就这么简单? 是的,这个是最简单的情况). 我们来写个例子看看:
URL地址 | 描述 |
/markdown | 当用户从浏览器访问这个页面的时候,输出一个指向JavaEye的超链接: markdown 字符串:
[Java Eye](http://www.iteye.com/ "Click")
生成的html代码: <a href="http://www.iteye.com" title="Click">JavaEye</a> |
http://localhost:3000/
app.get('/markdown', function(req, res) { var html = markdown.makeHtml("[Java Eye](http://www.iteye.com/ \"Click\") "); res.send(html) res.end(); })
$ node app.js
var express = require('express'); var markdown = require('markdown-js'); var app = module.exports = express.createServer(); // ... ... some configuration code app.register('.md', { compile: function(str, options){ var html = markdown.makeHtml(str); return function(locals){ return html.replace(/\{([^}]+)\}/g, function(_, name){ return locals[name]; }); }; } }); app.get('/markdown', function(req, res) { var html = markdown.makeHtml("[Java Eye](http://www.iteye.com/ \"Click\") "); res.send(html); }); app.listen(3000);
var fs = require('fs');
// ...
// Express 3.x 中不再提供register方法, 这个方式由 flovex 提供
app.engine('md', function(path, options, fn){
fs.readFile(path, 'utf8', function(err, str){
if (err) return fn(err);
str = markdown.parse(str).toString();
fn(null, str);
});
});
app.get('/markdown', function(req, res) { res.render('index.md', {layout: false}); })
This is a demo page =================== [Java Eye](http://www.iteye.com/ \"Click\")