zhangdocs 0.3.0

package/lib/file.js

@@ -0,0 +1,148 @@
+var fs = require('fs');
+var path = require('path');
+var _ejs = require('ejs');
+var _ = require('underscore');
+
+var file = module.exports = {
+    mkdirs:mkdirs,
+    exists:exists,
+    read:read,
+    write:write,
+    ejs:ejs,
+    isDir:isDir,
+    isFile:isFile,
+    readMDSync:readMDSync,
+    readMDJSONSync:readMDJSONSync,
+    mkdirsSync:mkdirsSync,
+    currentDir:currentDir,
+    currentFile:currentFile,
+    relativePath:relativePath
+};
+//判断是否存在这个方法
+if(!String.repeat ){
+    //创建 repeat 方法: 重复复制字符串
+    String.prototype.repeat = function(num){
+        return new Array(isNaN(num)? 1 : ++num).join(this);
+        //创建元素值为空、个数为重复次数+1的数组，用字符串自身做为分隔符连接起来，返回连接后的值。
+    }
+}
+// 返回相对路径
+// from 文件绝对路径
+// to 指定到目录的相对目录
+function relativePath(from,to){
+    return path.relative(from,to).replace(/\\/g,'/').replace(/\.\.$/g,'');
+}
+
+// 波浪号的绝对路径
+function tildePath (string) {
+    if (string.substr(0,1) === '~')
+    string = process.env.HOME + string.substr(1);
+    return path.resolve(string)
+}
+
+// 同步循环创建所有目录 resolvePath
+function mkdirsSync(dirpath, mode) {
+    if(fs.existsSync(dirpath)){
+        return true;
+    }else{
+        if(mkdirsSync(path.dirname(dirpath), mode)){
+            fs.mkdirSync(dirpath, mode);
+            return true;
+        }
+    }
+};
+// 异步循环创建所有目录
+function mkdirs(dirpath, mode, callback) {
+    //Call the standard fs.mkdir
+    fs.mkdir(dirpath, mode, function(error) {
+        //When it fail in this way, do the custom steps
+        if (error && error.errno === 34) {
+            //Create all the parents recursively
+            !exists(path.dirname(dirpath))&&mkdirs(path.dirname(dirpath), mode, callback);
+            //And then the directory
+            !exists(dirpath)&&mkdirs(dirpath, mode, callback);
+        }
+        //Manually run the callback since we used our own callback to do all these
+        !error&&callback && callback(error);
+    });
+};
+//读取文件内容，路径不存在返回空
+function read(filepath) {
+    return fs.readFileSync(filepath, 'utf8');
+};
+
+//返回 MD 所有路径的 Array
+function readMDSync(filepath, ret){
+    var ret = ret || [],
+        files = fs.readdirSync(filepath);
+    for (var i = 0; i < files.length; i++) {
+        if(isDir(filepath + files[i])) readMDSync(filepath+files[i] + '/', ret);
+        else if(/\.(md)$/.test(files[i])) {
+            ret.push(filepath + files[i]);
+        }
+    }
+    return ret;
+}
+
+//返回 MD JSON，路径拆分
+function readMDJSONSync(filepath){
+    var arr = [],_json,files = fs.readdirSync(filepath);
+    for (var i = 0; i < files.length; i++) {
+        if(isDir(filepath+files[i])) {
+            _json = {};
+            _json[files[i]]=readMDJSONSync(filepath+files[i]+'/');
+            arr.push(_json)
+        }else if(/\.(md)$/.test(files[i])){
+            arr.push(files[i])
+        }
+    };
+    return arr;
+}
+
+//写文件
+function write(filepath, content) {
+    mkdirsSync(path.dirname(filepath));
+    return fs.writeFileSync(filepath, content);
+};
+
+//模板输出 HTML 代码
+function ejs(_path,data){
+
+    return _ejs.compile(file.read(_path), {filename: _path})(data);
+    return _ejs.render(file.read(_path),_.extend({filename: _path},data) );
+}
+
+//检查指定路径的文件或者目录是否存在
+function exists(_path){
+    return fs.existsSync(_path);
+}
+
+//判断是不是文件
+function isFile(_path){
+    return exists(_path) && fs.statSync(_path).isFile();
+}
+
+//判断是不是目录
+function isDir(_path){
+    return exists(_path) && fs.statSync(_path).isDirectory();
+}
+
+//获取路径下面的所有dir
+function currentDir(_path){
+    if(!exists(_path)) return [];
+    return _.filter(fs.readdirSync(_path),function(dirname){
+        return isDir(_path+dirname);
+    })
+}
+//获取路径下面的所有file
+function currentFile(_path){
+    if(!exists(_path)) return [];
+    return _.filter(fs.readdirSync(_path),function(dirname){
+        return isFile(_path+dirname);
+    })
+}
+
+//获取目录下所有md文件的相对路径
+function getMdPaths(_path){
+
+}

package/lib/imgPath.js

@@ -0,0 +1,20 @@
+var cheerio = require('cheerio');
+var file = require("./file");
+var log = console.log;
+
+module.exports = imgPath
+
+function imgPath(str,_path){
+    
+    var $ = cheerio.load(str),
+        imgsrc = '';
+
+    $('img').each(function(i, e) {
+        imgsrc = $(e).attr('src');
+        if(!/^(http:\/\/|https:\/\/)/.test(imgsrc))
+        $(e).attr('src',file.relativePath(_path,process.cwd()) + imgsrc );
+    });
+
+    // 返回HTML
+    return $.html();
+}

package/lib/init.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+var fs = require('fs');
+var path = require('path');
+var inquirer = require('inquirer');
+var semver = require('semver');
+var _ = require('underscore');
+var color = require('colors-cli')
+var copy = require('./copy');
+var file = require('./file');
+var theme  = require('./theme');
+var menu_json = require('./menu_json');
+var log = console.log;
+
+var template = path.dirname(__dirname);
+var default_package = {}
+/**
+ * 这里执行 init 任务
+ */
+function runTask(commander){
+    if(commander.Create) file.mkdirsSync(commander.Create,0777);
+    inquirer.prompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: 'Package name',
+            validate: function(input) {
+                //检测只准输入小写字母，数字，横线或者英文句号
+                if (/^[A-z][A-z0-9\-\.]*$/.test(input)) {
+                    return true;
+                }
+                return 'Must be only lowercase letters, numbers, dashes or dots, and start with lowercase letter.';
+            }
+        },{
+            type: 'input',
+            name: 'version',
+            message: 'Version',
+            default: '1.0.0',
+            validate: function(input){
+                //分析版本是否正确或者null
+                if (!semver.valid(input)) {
+                    return 'Must be a valid semantic version (semver.org).';
+                }
+                return true;
+            }
+        },{
+            message: 'Description',
+            name: 'description'
+        },{
+            type: "input",
+            name: 'keywords',
+            message: 'keywords'
+        },{
+            type: "list",
+            name: 'licenses',
+            message: 'Licenses',
+            default: ["MIT"],
+            choices: ["MIT", "Apache", "GPL", "Artistic", "BSD", "Affero", "LGPL", "EPL", "LGPL", "MPL"]
+        },{
+            type: "list",
+            name: "idoctheme",
+            message: "Choose a theme.",
+            choices: theme.themeList()
+        },{
+            message: 'Author',
+            name: 'author',
+            //获取我的git上的名字和邮箱
+            default: require('./whoami')
+        }
+    ]).then(function(answers){
+        if(typeof(answers) === "string") answers = JSON.parse(answers);
+
+        var pk = require('./pk.json');
+        var todir = ''
+        //关键词、关键字
+        answers.keywords = answers.keywords.split(',');
+        answers.idoc = {}
+        // console.log("该行代码所在的目录::",__dirname);
+        // console.log("返回一个路径的目录名称::",path.dirname(__dirname));
+        // console.log("命令传进来的目录::",commander.Create);
+        // console.log("当前目录名字::",path.basename(process.cwd()));
+        // console.log("当前目录::",process.cwd());
+        //指定生成的目录位置
+        if(commander.Create){
+            todir = commander.Create;
+        }else{
+            //记录当前目录位置
+            todir = process.cwd();
+        }
+
+        // 处理指定目录路径
+        if(!/\/$/.test(todir)) todir = todir + '/';
+
+        // 记录皮肤名字
+        if(answers.idoctheme){
+            answers.idoc.theme = answers.idoctheme;
+            delete answers.idoctheme;
+        }
+
+        //需要生成的md文件路径
+        if(commander.init){
+            var mdurl = path.normalize(todir + '/md');
+            // 判断md 目录存在不生成目录
+            if( !file.exists(mdurl) ) file.mkdirsSync(mdurl,0777);
+
+            if(commander.args.length>0){
+                // 判断是否指定某个目录里面 md 拷贝到当前项目目录下
+                commander.args.forEach(function(item,idx){
+                    copy(path.resolve(item),todir+'md/',{
+                        filter:function(_file){
+                            if(/\.(md)$/.test(_file)) return true;
+                            else false;
+                        }
+                    },function(err,_file){
+                        if(err) return console.log(err);
+                        // console.log("复制成功！:",_file);
+                    })
+                })
+            }
+
+            //移动根目录的md文件到md目录中，并解决冲突
+            _.filter(file.currentFile(todir),function(_filename){
+                if(/README\.(md)$/.test(_filename))return false;
+                return /\.(md)$/.test(_filename)
+            }).forEach(function(_fname){
+                var pt = todir+'md/'+_fname;
+                var _nname = "";
+                if(file.exists(pt)) _nname = path.basename(pt, '.md') + parseInt(Math.random()*1000000) + '.md';
+                else _nname = _fname;
+
+                //复制到指定目录更改名字
+                fs.renameSync(todir+_fname,todir+'md/'+_nname);
+            })
+
+            //递归获取 md 下面所有的md文件 返回json
+            answers.idoc.md = menu_json(todir + 'md/');
+        }
+
+        //package.json合并输出
+        default_package = _.extend(pk,answers);
+
+        // 生成目录
+        file.write(todir + 'package.json',JSON.stringify(default_package, null, 4));
+
+        // 皮肤路径
+        var themeurl = template + '/theme/' + default_package.idoc.theme;
+
+        // 初始化到指定目录或者当前目录
+        var todir = default_package.idoc.todir?default_package.idoc.todir:__dirname;
+
+        log()
+        log(color.green('Initialization is successful! Please run "idoc build" command!'));
+        log()
+
+    })
+    return;
+}
+
+function init(commander){
+    if(fs.existsSync(template + '/theme/default/')){
+        runTask(commander);
+    }else{
+        log(color.red("Initialization failed!"));
+    }
+}
+
+module.exports = init;

package/lib/menu_json.js

@@ -0,0 +1,36 @@
+/**
+ * 获取某文件夹下的所有 `md` 文件的一个 json 数据
+ */
+
+var _ = require('underscore');
+var file = require('./file');
+
+module.exports = menu_json
+
+
+function menu_json(_path){
+    //_path = todir + 'md/'
+    //递归获取 md 下面所有的md文件
+    var files,mdArr = file.readMDJSONSync(_path);
+
+    //获取当前目录下的所有 md 文件
+    files = file.currentFile(_path).map(function(elem, index) {
+        if(/\.(md)$/.test(elem)) return elem;
+    });
+    // 去掉不存在的空或者 null | undefined 的元素
+    files = _.compact(files);
+
+    //如果当前目录下没有文件(非文件夹)自动生成 index.md （目录里面的除外）
+    //md 根目录必须有一个 md文件
+    if(mdArr.length <= 0 || files.length === 0){
+        file.write(_path + 'index.md','# idoc');
+        //添加到数组的第一个位置
+        mdArr.unshift('index.md');
+    }else{
+        // 将数组中的 md 移动到第一的位置 为默认生成index.html
+        mdArr = _.without(mdArr,files[0]);
+        mdArr.unshift(files[0]);
+    }
+
+    return mdArr;
+}

package/lib/menu_update.js

@@ -0,0 +1,73 @@
+var path = require("path");
+var menu_json = require('./menu_json');
+var file    = require('./file');
+
+
+Array.prototype.remove = function(val) {
+    var index = this.indexOf(val);
+    if (index > -1) {
+        this.splice(index, 1);
+    }
+};
+
+/**
+ * [moveElement 合并两个数组以及JSON，保留老的数组中元素的位置]
+ * @param  {[array]} _old [老的数组]
+ * @param  {[array]} _new [新的数组]
+ * @return {[array]}      [返回合并后的数组]
+ */
+function moveElement(_old,_new){
+    var _o_a = _old, _n_a = _new;
+
+    for (var i = 0; i < _new.length; i++) {
+        var idx = _old.indexOf(_new[i]),
+            item = _new[i];
+
+        if(typeof(item) === 'string'){
+            if(idx === -1) _o_a.push(item);
+        }else{
+            var key = Object.keys(item)[0];
+                idx = null;
+            for (var a = 0; a < _old.length; a++) {
+                if(typeof(_old[a]) === 'object' && key === Object.keys(_old[a])[0]) idx = a;
+            };
+            if(idx){
+                item[key] = moveElement(_old[idx][key],item[key])
+            }else{
+                _o_a.push(item);
+            }
+        }
+    };
+
+    for (var i = 0; i < _old.length; i++) {
+        var idx = _new.indexOf(_old[i]),
+            item = _old[i];
+
+        if(typeof(item) === 'string'){
+            if(idx === -1) _o_a.remove(item)
+        }else{
+            var key = Object.keys(item)[0];
+                idx = null;
+            for (var a = 0; a < _new.length; a++) {
+                if(typeof(_new[a]) === 'object' && key === Object.keys(_new[a])[0]) idx = a;
+            };
+            if(!idx) _o_a.remove(item);
+        }
+    };
+    return _o_a
+}
+
+module.exports = function(){
+    var pkg = require(path.resolve('package.json'));
+    var mddata = pkg.idoc.md;
+
+    // 初始化菜单
+    if(pkg&&pkg.idoc&&pkg.idoc.md){
+        //递归获取 md 下面所有的md文件 返回json
+        var mdjson = menu_json(process.cwd() + '/md/');
+        
+        pkg.idoc.md = moveElement(mddata,mdjson);
+        // 生成目录
+        file.write(process.cwd() + '/package.json',JSON.stringify(pkg, null, 4));
+    }
+};

package/lib/nav.js

@@ -0,0 +1,108 @@
+// 导航生成
+var path    = require('path')
+var file    = require('./file')
+var log = console.log;
+
+module.exports = nav;
+
+
+/**
+ * arr 导航json 
+ * current 当前页面的路径
+ * _url 所有url Array
+ * _sub 是否在回调的第一次，如果是为空
+ * floor 导航菜单是否为第一层
+ */
+
+var indexname = '';
+var floornum = 0;
+function nav(arr, current, _url, floor, _sub){
+    var html = '<ul>',url ='';
+    for (var i = 0; i < arr.length; i++) {
+
+        var s = _sub ? _sub+'/'+arr[i]:arr[i];
+
+        if(current.replace(process.cwd()+'/md/','') === s){
+            html+='<li class="active">';
+        }else{
+            html+='<li>';
+        }
+
+        if(typeof arr[i] === 'object'){
+            for (var a in arr[i]) {
+                html+='<a href="#"><span></span>'+ a +'</a>';
+                html+=nav(arr[i][a],current,_url,floor, (_sub? _sub + '/' + a:a));
+            };
+        }else{
+
+            // 获取首页 markdown 的文件名
+            if(i ===0 && !_sub) indexname = arr[i];
+            // 返回相对路径
+            url = pathto(_url,
+                (_sub ? _sub+'/'+ arr[i] : arr[i]),
+                current,indexname,floor);
+
+            html+='<a href="'+ url +'">'+ arr[i].replace(/\.md/,'') +'</a>';
+        }
+        html+='</li>';
+    };
+    html += '</ul>';
+    return html;
+}
+
+// 导航菜单跳转的 path
+// urlarr 所有url Array
+// basename url元素
+// current 当前页面的路径
+// index 首页name
+// floor 导航菜单目录层级
+function pathto(urlarr,basename,current,index,floor){
+    // console.log("pathto:",'\n',urlarr,'\n',basename,'\n当前:',current,'\n首页：',index);
+    // console.log("basename::",basename);
+    var url = '',temp='';
+    for (var i = 0; i < urlarr.length; i++) {
+        if(urlarr[i].indexOf('md/'+basename) > -1) url = urlarr[i];
+    };
+    // 传进来的 url 处理
+    url = url.replace(process.cwd()+'/md',process.cwd() + '/html').replace(/\.md/,'.html');
+
+    // 当前md 的 url 处理
+    current = current.replace(process.cwd()+'/md',process.cwd() + '/html').replace(/\.md/,'.html');
+
+    // 跳转首页相对地址 特殊处理
+    var _index = index;
+
+    index = index.replace(/\.md/,'.html');
+    if(url==='') url = 'index.html'
+    if(_index === basename){
+        url = url.replace(process.cwd()+'/html/','').replace(index,'index.html')
+    }else{
+        url = url.replace(process.cwd()+'/','')
+    }
+
+    // 获取相对路径
+    temp = file.relativePath(current ,process.cwd());
+    
+    // 首页跳转到其他页面的特殊处理
+    if(floor === 0) temp = "";
+
+    temp += url;
+    return temp;
+}
+
+
+// // 返回当前文件的url
+// function pathto(urlarr,basename,index){
+//     var url = '';
+//     for (var i = 0; i < urlarr.length; i++) {
+//         if(urlarr[i].indexOf(basename) > -1) url = urlarr[i];
+//     };
+
+//     // 首页判断
+//     if(index === 0){
+//         url = '/index.html';
+//     }else{
+//         url = url.replace(process.cwd()+'/md','/html').replace(/\.md/,'.html');
+//     }
+//     return url;
+// }

package/lib/pdf.js

@@ -0,0 +1,66 @@
+// var phantom = require('phantom')
+var fs = require('fs')
+
+module.exports = pdf;
+
+function pdf(commander){
+    var wkhtmltopdf = require('wkhtmltopdf');
+
+    // URL
+// HTML
+var ht = wkhtmltopdf('<h1>Test</h1><p>Hello world</p>')
+
+// wkhtmltopdf(file.contents.toString(enc), options);
+
+console.log(ht);
+
+
+    // var html5pdf = require("html5-to-pdf");
+    // var fs = require("fs");
+    // html5pdf({
+    //     "cssPath" : process.cwd() + '/static/css/main.css'
+    // }).from(process.cwd() + '/index.html').to(process.cwd() + '/index.pdf', function () {
+    //     console.log("Done")
+    // });
+
+
+
+
+    // var pdf = require('phantomjs-pdf');
+
+    // var options = {
+    //     "html" : process.cwd() + '/index.html',
+    //     "css" : process.cwd() + '/static/css/main.css',
+    // }
+     
+    // pdf.convert(options, function(result) {
+        
+    //     /* Using a buffer and callback */
+    //     result.toBuffer(function(returnedBuffer) {});
+     
+    //     /* Using a readable stream */
+    //     var stream = result.toStream();
+     
+    //     /* Using the temp file path */
+    //     var tmpPath = result.getTmpPath();
+     
+    //     /* Using the file writer and callback */
+    //     result.toFile(process.cwd() + '/index.pdf', function() {});
+    // });
+
+
+
+
+
+    // require("jsreport").render({
+    //     template: {
+    //         content: "<h1>Hello world from </h1>",
+    //         recipe: "html"
+    //     },
+    //     data: { name: "jsreport" }
+    // }).then(function(out) {
+    //     //pipes plain text with Hello world from jsreport
+    //     out.stream.pipe(out);
+    // });
+
+}

package/lib/pk.json

@@ -0,0 +1,13 @@
+{
+    "name": "examples",
+    "version": "0.0.1",
+    "description": "---",
+    "keywords": [],
+    "homepage": "http://JSLite.io",
+    "author": "JSLite.io <wowohoo@qq.com>",
+    "repository": {
+        "type": "git",
+        "url": ""
+    },
+    "licenses": "ISC"
+}

package/lib/stylus.js

@@ -0,0 +1,36 @@
+var fs = require('fs');
+var file = require('./file');
+var _stylus = require('stylus');
+var path = require('path')
+var log = console.log;
+var autoprefixer = require('autoprefixer-stylus');
+var browserslist = ['Android 2.3', 'Android >= 4', 'Chrome >= 20', 'Firefox >= 24', 'Explorer >= 8', 'iOS >= 6', 'Opera >= 12', 'Safari >= 6'];
+
+module.exports = stylus
+
+function stylus(_path,cb){
+
+    var files = file.currentFile(_path)
+
+    for (var i = 0; i < files.length; i++) {
+
+        var _fileurl = _path + files[i],
+            _extname = path.extname(_fileurl),
+            _filename = path.basename(_fileurl, '.styl');
+
+        if(_extname === '.styl'){
+            
+            if(!file.exists(_fileurl)) return cb&&cb("no such file or directory '" + _fileurl +"'");
+
+            _stylus(file.read(_fileurl))
+                .set('filename',_fileurl)
+                .set('compress',true)
+                .use(autoprefixer())
+                .render(function(err, css){
+                    cb&&cb(err,css,_filename,_extname);
+                });
+        }
+
+    };
+
+}