zhangdocs 0.3.0

package/lib/theme.js

@@ -0,0 +1,57 @@
+/**
+ * 选择主题命令
+ */
+var inquirer = require('inquirer');
+var file = require('./file');
+var path = require('path');
+var build   = require('./build');
+var server  = require('ssr');
+
+var template = path.dirname(__dirname);
+
+var theme = module.exports = {
+    runTask:runTask,
+    themeList:themeList
+}
+
+function runTask(commander){
+
+    var pkg = require(path.resolve('package.json'));
+
+    if(commander.theme && commander.args.length > 0){
+        build(commander);
+        server();
+    }else{
+
+        inquirer.prompt([{
+            type: "list",
+            name: "theme",
+            message: " Choose a theme.",
+            choices: themeList()
+        }],function(answers){
+            pkg.idoc.theme = answers.theme;
+            file.write(process.cwd() + '/package.json',JSON.stringify(pkg, null, 4));
+            build(commander);
+        })
+
+    }
+
+}
+
+/**
+ * [themeList 获取主题列表]
+ * @return {[type]} [array]
+ */
+function themeList(){
+    var _def = file.currentDir(template + '/theme/');
+
+    var _m = file.currentDir(process.cwd() + '/')
+    
+    for (var i = 0; i < _m.length; i++) {
+        if(/^idoc\-theme./.test(_m[i])){
+            _def.push(_m[i])
+        }
+    };
+
+    return _def
+}

package/lib/toc.js

@@ -0,0 +1,119 @@
+var cheerio = require('cheerio');
+var hljs = require("highlight.js");
+var log = console.log;
+
+module.exports = toc
+
+function toc(str,cb){
+
+    var option = {}
+    $ = cheerio.load(str)
+
+    // 代码高亮使用 highlight.js 
+    // 网站 http://adilapapaya.com/docs/highlight.js/#nodejs
+    // 官网 https://highlightjs.org/
+    $('pre code').each(function(i, e) {
+        var htstr,el = $(this),lang = el.attr('class');
+        lang = lang?lang.replace('lang-',''):'';
+        if(lang){
+            try{
+                htstr = hljs.highlight(lang,$(this).text()).value;
+            }catch(e){
+                htstr = $(this).text();
+            }
+            $(this).html(htstr);
+        }
+    });
+
+    // 1. markd模块 中文标题生成 ID bug；
+    // 2. 序列号一个导航菜单
+    tocCreate($('h1,h2,h3,h4,h5,h6').attr('id',function(idx,elm){
+        return 't'+idx+$(this).text();
+    }).map(function(idx,itm){
+        return {
+            title:$(itm).text(),
+            tag:$(itm).get(0).tagName.replace(/^(h)/g,''),
+            id:$(itm).attr('id')
+        }
+    }), function(op){
+        option.toc = op.tocHTML;
+        option.tocJSON = op.tocJSON;
+    });
+    $('h1,h2,h3,h4,h5,h6').each(function(i){
+        $(this).html($(this).text() + ' <a href="#'+'t'+i+ $(this).text() +'"> # </a>')
+    })
+
+    //github 中的任务列表增强
+    $('ul li').each(function(idx,el){
+        var txt = $(this).html();
+        var chtml = '';
+        if(/^(\[x\])/.test(txt)){
+            chtml = 'checked="checked"';
+        }else if(/^(\[\ \])/.test(txt)){
+            chtml = '';
+        };
+
+        if(/^(\[x\]|\[\ \])/.test(txt)){
+            txt = txt.replace(/^(\[x\]|\[\ \])/g,'')
+            $(this).html('').prepend('<input type="checkbox" class="task-list-item-checkbox" '+ chtml +' disabled="disabled">'+txt)
+            $(this).addClass('task-list-item').parent().addClass('task-list-item');
+        };
+
+    });
+    // 回调返回 菜单静态页面
+    cb&&cb(option);
+    // 返回HTML
+    return $.html();
+}
+
+// 树形菜单 - 序列化成JSON，生成 HTML
+// tocJSON 返回toc的JSON
+// tocHTML 返回toc的HTML静态页面
+function tocCreate(arr,cb){
+    // console.log("message:arr",arr);
+    var newArr = []
+    for (var i = 0; i < arr.length; i++) {
+        if(i===0) newArr.push(arr[i]);
+        else{
+           newArr = pushArr(newArr,arr[i])
+        }
+    };
+    var html = tocCreatHTML(newArr);
+    cb&&cb({
+        tocJSON:newArr,
+        tocHTML:html
+    });
+}
+
+// 树形菜单 - 序列化成JSON
+function pushArr(_group,_new){
+    var last = _group[_group.length-1]
+    var tag = last.tag
+    if(tag === _new.tag || tag > _new.tag){
+        _group.push(_new)
+    }else{
+        if(last.submenu){
+            pushArr(last.submenu,_new);
+        }else{
+            last.submenu = [];
+            last.submenu.push(_new);
+        }
+    }
+    return _group;
+}
+
+// 树形菜单 - 生成HTML
+function tocCreatHTML(arr){
+    // console.log("arr:",arr);
+    var str = '<ul>';
+    for (var i = 0; i < arr.length; i++) {
+        toc_num = (i+1);
+        str += '<li><a href="#' + arr[i].id +'">' + arr[i].title + '</a>';
+        if(arr[i].submenu){
+           str += tocCreatHTML(arr[i].submenu);
+        }
+        str += '</li>';
+    };
+    str += '</ul>';
+    return str;
+}

package/lib/watch.js

@@ -0,0 +1,76 @@
+var fs = require('fs');
+var chokidar = require('chokidar');
+var color = require('colors-cli');
+var path    = require('path');
+var file    = require('./file');
+var log = console.log;
+
+function watch(commander,build){
+
+    // 过滤文件
+    var filter = function(pattern, fn) {
+        return function(filename) {
+            if (pattern.test(filename)) {
+                fn(filename);
+            }
+        }
+    }
+
+    var file = fs.readdirSync(process.cwd());
+
+    log(color.green("Waiting...") );
+    log(color.blue("idoc is running. Press Ctrl+C to stop."));
+    log();
+
+    var now = new Date();
+
+    var watcher = chokidar.watch(process.cwd()+'/md', {
+        // ignored: /[^\.md]$/, //正则过滤哪些被监控
+        persistent: true,
+        ignoreInitial:true// 初始化不执行事件
+    });
+
+    var _path = '';
+    var _root = path.normalize(process.cwd()+'/md')
+    
+    watcher
+        .on('add', function(_path) { // 添加文件
+
+            changMenuBuild(commander,build, color.blue('File') + _path.replace(_root,'') + 'has been added');
+
+        })
+        .on('change', function(_path) { // 文件更改
+            
+            build(commander,_path);
+            log( color.blue('File'), _path.replace(_root,''), color.blue('has been changed!') );
+            
+        })
+        .on('unlink', function(_path) { // 删除文件
+
+            changMenuBuild(commander,build, color.blue('File') + _path.replace(_root,'') + 'has been removed');
+
+        })
+        // More events. 
+        .on('addDir', function(_path) { // 添加文件夹
+
+            changMenuBuild(commander,build, color.blue('Directory') + _path.replace(_root,'') + 'has been added');
+            
+        })
+        .on('unlinkDir', function(_path) {// 删除文件夹
+
+            changMenuBuild(commander,build, color.blue('Directory') + _path.replace(_root,'') + 'has been removed');
+
+        })
+        .on('error', function(error) { log('Error happened', error); })
+        .on('ready', function() { log('Initial scan complete. Ready for changes.\n'); })
+        .on('raw', function(event, _path, details) { 
+            // log('\n Raw event info:', event, path, details,'\n');
+        });
+}
+module.exports = watch;
+
+function changMenuBuild(commander,build, str){
+    require('./menu_update')();
+    log(str);
+    build(commander);
+}

package/lib/whoami.js

@@ -0,0 +1,23 @@
+var shell = require('shelljs');
+require('shelljs/global');
+
+var name = shell.exec('git config --get user.name', {
+    silent: true
+}).stdout.trim();
+
+var email = shell.exec('git config --get user.email', {
+    silent: true
+}).stdout.trim();
+
+var result = name ? name : process.env.USER;
+
+if (!which('git')) {
+    result = 'Pick a name';
+    email = 'Your email';
+}
+
+if (email) {
+    result += ' <' + email + '>';
+}
+
+module.exports = result;

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "zhangdocs",
+  "version": "0.3.0",
+  "description": "Simple document generation tool. Dependence Node.js run.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jaywcjlove/idoc.git"
+  },
+  "main": "index.js",
+  "bin": {
+    "idoc": ".bin/idoc.js"
+  },
+  "keywords": [
+    "idoc",
+    "markdown",
+    "api",
+    "document",
+    "tool"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "kenny wang <wowohoo@qq.com>",
+  "license": "MIT",
+  "dependencies": {
+    "autoprefixer-stylus": "^0.13.0",
+    "cheerio": "^0.22.0",
+    "chokidar": "^1.6.1",
+    "colors-cli": "^1.0.7",
+    "commander": "^2.9.0",
+    "ejs": "^2.5.6",
+    "highlight.js": "^9.9.0",
+    "inquirer": "^3.0.5",
+    "marked": "^0.3.6",
+    "semver": "^5.3.0",
+    "shelljs": "^0.7.6",
+    "ssr": "^1.0.15",
+    "stylus": "^0.54.5",
+    "underscore": "^1.8.3"
+  }
+}

package/theme/default/footer.ejs

@@ -0,0 +1,3 @@
+
+</body>
+</html>

package/theme/default/gitignore

@@ -0,0 +1,22 @@
+*.iml
+.idea/
+.ipr
+.iws
+*~
+~*
+*.diff
+*.patch
+*.bak
+.DS_Store
+Thumbs.db
+.project
+.*proj
+.svn/
+*.swp
+*.swo
+*.pyc
+*.pyo
+.build
+node_modules
+.cache
+idoc-theme-*/

package/theme/default/head.ejs

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title><%=title%></title>
+        <%if(pkg.idoc&&pkg.idoc.logo){ var iconurl = pkg.idoc.logo %>
+        <%if(/\.png$/.test(iconurl)){%>
+        <link rel="shortcut icon" href="<%=relative_path%><%=pkg.idoc.logo%>" type="image/x-png">
+        <%}else if(/\.ico$/.test(iconurl)){%>
+        <link rel="shortcut icon" href="<%=relative_path%><%=pkg.idoc.logo%>" type="image/x-icon">
+        <%}%>
+    <%}%>
+    <link rel="stylesheet" type="text/css" href="<%=relative_path%>static/css/main.css">
+</head>
+<body>
+<% include header.ejs %>

package/theme/default/header.ejs

@@ -0,0 +1,34 @@
+<div class="navbar <%if(!index){%>navbar-line<%}%>">
+    <div class="container">
+        <div class="logo">
+            <%if(pkg.idoc.logo){%>
+                <img src="<%=relative_path%><%=pkg.idoc.logo%>">
+            <%}else{%>
+                <%= title %>
+            <%}%>
+        </div>
+        <input type="checkbox" id="idoc_nav" />
+        <div class="menu_tree">
+        <%- menu_html %>    
+        </div>
+        
+        <% if(pkg&&pkg.repository&&pkg.repository.url) {%>
+        <div class="forkgithub"><a target="_blank" href="<%=pkg.repository.url%>">fork on github</a></div>
+        <%}%>
+
+        <section class="idoc_nav_btn">
+            <label for="idoc_nav"><span></span></label>
+        </section>
+    </div>
+    
+</div>
+
+
+<% if(index){ %>
+<div class="bs-docs-header">
+    <div class="container">
+        <h1><%= title %></h1>
+        <p><%= pkg.description %></p>
+    </div>
+</div>
+<% } %>

package/theme/default/layout.ejs

@@ -0,0 +1,16 @@
+<% include head.ejs %>
+
+<div class="container">
+
+    <div class="page-toc">
+        <%- toc_html %>
+    </div>
+    
+    <div class="content markdown-body">
+        <%- markdown_html %>
+        <div class="copyright">Powered by <a href="https://github.com/jaywcjlove/idoc" target="_blank">idoc</a>. Dependence <a href="https://nodejs.org">Node.js</a> run.</div>
+    </div>
+
+</div>
+
+<% include footer.ejs %>

package/theme/default/source/css/_partial/head_nav.styl

@@ -0,0 +1,239 @@
+.navbar
+    line-height: nav-height
+    ul  
+        list-style: none
+        position: relative
+        display: inline-table
+        float: left
+        @media mq-mobile
+            position: absolute
+        ul
+            display: none
+            background: #FFFFFF
+            border-radius: 0 0 5px 5px
+            padding: 3px
+            position: absolute
+            top: 100%
+            z-index: 9
+            li.active
+                a
+                    color: #463265
+                    background-color: #f9f9f9
+                    line-height:29px
+                    height:29px
+            li 
+                float: none
+                border-bottom: 1px solid #F7F2FF
+                position: relative
+                a:hover 
+                    color:#573E7D
+            a
+                color: #fff
+                line-height: 29px
+                white-space:nowrap
+                word-break:keep-all
+            ul
+                position: absolute
+                left: 100%
+                top:0
+                border-radius 0 5px 5px 5px
+        li
+            float: left
+            line-height: nav-height
+            a
+                display: block
+                color: #757575
+                text-decoration: none
+                padding: 0 15px
+                @media mq-mobile
+                    padding: 0 5px
+        li:hover
+            background: #F3F3F3
+            a
+                color: #333
+        li.active
+            a
+                color: #463265
+                background-color: #F3F3F3
+                height: nav-height
+    ul li:hover > ul
+        display: block
+        box-shadow: rgba(0, 0, 0, 0.26) 0px 2px 2px 1px
+    ul:after
+        content: ""
+        clear: both
+        display: block
+       
+#idoc_nav
+    display none
+
+@media mq-tablet
+    .navbar
+        z-index: 2
+        background-image: linear-gradient(to bottom,#fff 0,#f8f8f8 100%)
+        
+        section.idoc_nav_btn 
+            position relative
+            transition all 0.6s
+            z-index 999
+            display block
+            label
+                position fixed 
+                display block
+                right 7px
+                top 10px
+                cursor pointer 
+                z-index 99
+                width 26px
+                height 26px
+                overflow hidden
+                span,&:after,&:before
+                    content ''
+                    display block
+                    height 3px
+                    background #333
+                    margin 4px 4px 0 4px
+                    transform rotate(0deg)
+                    transition all 0.6s
+        .menu_tree 
+            transition all 0.6s
+            background #fff
+            position relative
+            width 100%
+            // display none
+            ul 
+                opacity 0
+                height 0
+                overflow hidden
+                display block
+                transition all 0.6s
+        input#idoc_nav:checked ~ section label span
+            display none
+        input#idoc_nav:checked ~ section label:before
+            margin 12px 4px 0 4px
+            transform rotate(45deg)
+            border-radius 3px
+            background #458
+        input#idoc_nav:checked ~ section label:after
+            margin -3px 4px 0 4px
+            transform rotate(-45deg)
+            border-radius 3px
+            background #458
+        input#idoc_nav:checked ~ .menu_tree 
+            display block
+            ul
+                width 100%
+                opacity 1
+                position relative
+                transition all 0.6s
+                padding-bottom 10px
+                display block
+                height inherit
+                li.active
+                    line-height 36px
+                    a
+                        line-height 36px
+                        height 36px
+                        background-color #D7D7D7
+                li 
+                    float initial
+                    line-height 30px
+                    &:hover
+                        background transparent
+                    &:hover > ul
+                        box-shadow #fff 0 0 0 0
+                    ul 
+                        display block
+                        position inherit
+                        border-radius 0
+                        float inherit
+                        background #EEE
+                        padding-left 7px
+                        padding-bottom 0px
+                        li 
+                            display inline-block
+@media mq-mobile
+    .navbar
+        z-index: 2
+        background-image: linear-gradient(to bottom,#fff 0,#f8f8f8 100%)
+        
+        section.idoc_nav_btn 
+            position relative
+            transition all 0.6s
+            z-index 999
+            display block
+            label
+                position fixed 
+                display block
+                right 7px
+                top 10px
+                cursor pointer 
+                z-index 99
+                width 26px
+                height 26px
+                overflow hidden
+                span,&:after,&:before
+                    content ''
+                    display block
+                    height 3px
+                    background #333
+                    margin 4px 4px 0 4px
+                    transform rotate(0deg)
+                    transition all 0.6s
+        .menu_tree 
+            transition all 0.6s
+            background #fff
+            position relative
+            width 100%
+            // display none
+            ul 
+                opacity 0
+                height 0
+                overflow hidden
+                display block
+                transition all 0.6s
+        input#idoc_nav:checked ~ section label span
+            display none
+        input#idoc_nav:checked ~ section label:before
+            margin 12px 4px 0 4px
+            transform rotate(45deg)
+            border-radius 3px
+            background #458
+        input#idoc_nav:checked ~ section label:after
+            margin -3px 4px 0 4px
+            transform rotate(-45deg)
+            border-radius 3px
+            background #458
+        input#idoc_nav:checked ~ .menu_tree 
+            display block
+            ul
+                width 100%
+                opacity 1
+                position relative
+                transition all 0.6s
+                padding-bottom 10px
+                display block
+                height inherit
+                li.active
+                    line-height 36px
+                    a
+                        line-height 36px
+                        height 36px
+                        background-color #D7D7D7
+                li 
+                    float initial
+                    line-height 30px
+                    &:hover
+                        background transparent
+                    &:hover > ul
+                        box-shadow #fff 0 0 0 0
+                    ul 
+                        display block
+                        position inherit
+                        border-radius 0
+                        float inherit
+                        background #EEE
+                        padding-left 7px
+                        padding-bottom 0px
+                        li 
+                            display inline-block